Class ApplicationBasicServer

This is the default server implementation of ApplicationBasicBehavior.

Hierarchy (view full)

ApplicationBasicBehavior
- ApplicationBasicServer

Constructors

constructor

new ApplicationBasicServer(agent, backing): ApplicationBasicServer
Parameters
- agent: Agent
- backing: BehaviorBacking
Returns ApplicationBasicServer
Inherited from ApplicationBasicBehavior.constructor
- Defined in packages/node/dist/esm/behavior/cluster/ClusterBehavior.d.ts:119

Properties

[reference]

[reference]: Datasource<StateType>

agent

agent: Agent

cluster

cluster: never

The implemented cluster.

`Readonly`events

events: EventEmitter & Omit<Events, never> & {
    allowedVendorList$Changing: ClusterEvents.AttributeObservable<FixedAttribute<VendorId[], any>>;
    application$Changing: ClusterEvents.AttributeObservable<FixedAttribute<TypeFromFields<{
        applicationId: FieldType<string>;
        catalogVendorId: FieldType<number>;
    }>, any>>;
    applicationName$Changing: ClusterEvents.AttributeObservable<FixedAttribute<string, any>>;
    applicationVersion$Changing: ClusterEvents.AttributeObservable<FixedAttribute<string, any>>;
    status$Changing: ClusterEvents.AttributeObservable<Attribute<ApplicationBasic.ApplicationStatus, any>>;
} & {
    productId$Changing: undefined | ClusterEvents.AttributeObservable<OptionalFixedAttribute<number, any>>;
    vendorId$Changing: undefined | ClusterEvents.AttributeObservable<OptionalFixedAttribute<VendorId, any>>;
    vendorName$Changing: undefined | ClusterEvents.AttributeObservable<OptionalFixedAttribute<string, any>>;
} & {
    allowedVendorList$Changed: ClusterEvents.AttributeObservable<FixedAttribute<VendorId[], any>>;
    application$Changed: ClusterEvents.AttributeObservable<FixedAttribute<TypeFromFields<{
        applicationId: FieldType<string>;
        catalogVendorId: FieldType<number>;
    }>, any>>;
    applicationName$Changed: ClusterEvents.AttributeObservable<FixedAttribute<string, any>>;
    applicationVersion$Changed: ClusterEvents.AttributeObservable<FixedAttribute<string, any>>;
    status$Changed: ClusterEvents.AttributeObservable<Attribute<ApplicationBasic.ApplicationStatus, any>>;
} & {
    productId$Changed: undefined | ClusterEvents.AttributeObservable<OptionalFixedAttribute<number, any>>;
    vendorId$Changed: undefined | ClusterEvents.AttributeObservable<OptionalFixedAttribute<VendorId, any>>;
    vendorName$Changed: undefined | ClusterEvents.AttributeObservable<OptionalFixedAttribute<string, any>>;
} & {} & {}

Access the behavior's events.

features

features: TypeFromBitSchema<{}>

Supported features as a flag object.

session

session: SecureSession

`Readonly`state

state: Omit<{}, never> & {
    status: ApplicationBasic.ApplicationStatus;
} & {} & {
    allowedVendorList: VendorId[];
    application: TypeFromFields<{
        applicationId: FieldType<string>;
        catalogVendorId: FieldType<number>;
    }>;
    applicationName: string;
    applicationVersion: string;
} & {
    productId?: number;
    vendorId?: VendorId;
    vendorName?: string;
}

Access the behavior's state.

Type declaration

Readonlystatus: ApplicationBasic.ApplicationStatus
This attribute shall specify the current running status of the application.

See
MatterSpecification.v13.Cluster § 6.3.5.6

Type declaration

ReadonlyallowedVendorList: VendorId[]
This attribute is a list of vendor IDs. Each entry is a vendor-id.

See
MatterSpecification.v13.Cluster § 6.3.5.8
Readonlyapplication: TypeFromFields<{
applicationId: FieldType<string>;
catalogVendorId: FieldType<number>;
}>
This attribute shall specify a Content App which consists of an Application ID using a specified catalog.

See
MatterSpecification.v13.Cluster § 6.3.5.5
ReadonlyapplicationName: string
This attribute shall specify a human readable (displayable) name of the Content App assigned by the vendor. For example, "NPR On Demand". The maximum length of the ApplicationName attribute is 256 bytes of UTF-8 characters.

See
MatterSpecification.v13.Cluster § 6.3.5.3
ReadonlyapplicationVersion: string
This attribute shall specify a human readable (displayable) version of the Content App assigned by the vendor. The maximum length of the ApplicationVersion attribute is 32 bytes of UTF-8 characters.

See
MatterSpecification.v13.Cluster § 6.3.5.7

Type declaration

Optional ReadonlyproductId?: number
This attribute, if present, shall specify a numeric ID assigned by the vendor to identify a specific Content App made by them. If the Content App is certified by the Connectivity Standards Alliance, then this would be the Product ID as specified by the vendor for the certification.

See
MatterSpecification.v13.Cluster § 6.3.5.4
Optional ReadonlyvendorId?: VendorId
This attribute, if present, shall specify the Connectivity Standards Alliance assigned Vendor ID for the Content App.

See
MatterSpecification.v13.Cluster § 6.3.5.2
Optional ReadonlyvendorName?: string
This attribute shall specify a human readable (displayable) name of the vendor for the Content App.

See
MatterSpecification.v13.Cluster § 6.3.5.1

`Static` `Readonly`cluster

cluster: ApplicationBasic.Cluster

Base cluster state include all attribute values but may be extended by subclasses.

`Static` `Readonly`defaults

defaults: ClusterState.Type<ApplicationBasic.Cluster, typeof ClusterBehavior>

`Static` `Optional` `Readonly`dependencies

dependencies?: Iterable<Type, any, any>

`Static` `Readonly`early

early: boolean

`Static` `Readonly`Events

Events: ClusterEvents.Type<ApplicationBasic.Cluster, typeof ClusterBehavior>

`Static` `Readonly`ExtensionInterface

ExtensionInterface: {}

`Static` `Readonly`id

The behavior ID for ClusterBehaviors is the name of the cluster.

`Static` `Readonly`Interface

Interface: {
components: never[];
}

`Static` `Readonly`Internal

Internal: (new () => {})

Type declaration

- new (): {}
- Implementation of internal state. Subclasses may override to extend.
  
  Returns {}

`Static` `Readonly`name

name: string

`Static` `Optional` `Readonly`schema

schema?: Schema

`Static` `Readonly`State

State: (new () => ClusterState.Type<ApplicationBasic.Cluster, typeof ClusterBehavior>)

`Static` `Readonly`supervisor

supervisor: RootSupervisor

`Static`supports

supports: ((other: Type) => boolean)

Type declaration

- (other): boolean
- Does this behavior support functionality of a specific implementation?
  Parameters
  - other: Type
  Returns boolean

Methods

[asyncDispose]

[asyncDispose](): MaybePromise
Release resources. This is the public API for releasing application resources held by behaviors in internal state.

Returns MaybePromise
Inherited from ApplicationBasicBehavior.[asyncDispose]
- Defined in packages/node/dist/esm/behavior/Behavior.d.ts:115

asAdmin

asAdmin(fn): void
Execute logic with elevated privileges.

The provided function executes with privileges escalated to offline mode. This is not commonly necessary.

Elevated logic effectively ignores ACLs so should be used with care.

Note that interactions with the behavior will remain elevated until the synchronous completion of this call. You should only elevate privileges for synchronous logic.
Parameters
- fn: (() => void)
  the elevated logic
  - - (): void
    - Returns void
Returns void
Inherited from ApplicationBasicBehavior.asAdmin
- Defined in packages/node/dist/esm/behavior/Behavior.d.ts:77

assertAttributeEnabled

assertAttributeEnabled<This, K>(this, attributeName): void
Type Parameters
- This extends Behavior
- K extends string | number | symbol
Parameters
- this: This
- attributeName: K
Returns void
Inherited from ApplicationBasicBehavior.assertAttributeEnabled
- Defined in packages/node/dist/esm/behavior/cluster/ClusterBehavior.d.ts:112

`Protected`callback

callback<A, R>(reactor, options?): ((...args: A) => undefined | R)
Create a generic callback function that has the same properties as a Reactor.

Like a reactor, the callback's "this" will be bound to an active Behavior instance. Because of this: The reactor MUST be a real JS function - arrow functions will not work!
Type Parameters
- A extends any[]
- R
Parameters
- reactor: Reactor<A, R>
- Optionaloptions: Reactor.Options
Returns ((...args: A) => undefined | R)
- - (...args): undefined | R
  - Parameters
    - Rest...args: A
    Returns undefined | R
Inherited from ApplicationBasicBehavior.callback
- Defined in packages/node/dist/esm/behavior/Behavior.d.ts:132

initialize

initialize(_options?): MaybePromise
Behaviors are ephemeral and should not perform initialization in their constructor. They can override this method instead.

This method may be synchronous or asyncronous. If asynchronous, the behavior will not be available for external use until initialization completes.
Parameters
- Optional_options: {}
Returns MaybePromise
Inherited from ApplicationBasicBehavior.initialize
- Defined in packages/node/dist/esm/behavior/Behavior.d.ts:110

`Protected`reactTo

reactTo<O>(observable, reactor, options?): void
Install a Reactor.

Important: The reactor MUST be a real JS function - arrow functions will not work!
Type Parameters
- O extends Observable<any[], any>
Parameters
- observable: O
- reactor: Reactor<Parameters<O["emit"]>, ReturnType<O["emit"]>>
- Optionaloptions: Reactor.Options
Returns void
Inherited from ApplicationBasicBehavior.reactTo
- Defined in packages/node/dist/esm/behavior/Behavior.d.ts:125

requireAttributeEnabled

requireAttributeEnabled<This, K>(this, attributeName): Exclude<This["state"][K], undefined>
Type Parameters
- This extends Behavior
- K extends string | number | symbol
Parameters
- this: This
- attributeName: K
Returns Exclude<This["state"][K], undefined>
Inherited from ApplicationBasicBehavior.requireAttributeEnabled
- Defined in packages/node/dist/esm/behavior/cluster/ClusterBehavior.d.ts:111

toString

toString(): string
Description used in diagnostic messages.

Returns string
Inherited from ApplicationBasicBehavior.toString
- Defined in packages/node/dist/esm/behavior/Behavior.d.ts:119

`Static`alter

alter<This, const AlterationsT>(this, alterations): Type<WithAlterations<This["cluster"], AlterationsT>, This, ClusterInterface.InterfaceOf<This>>
Type Parameters
- This extends Type<ClusterType, Type, ClusterInterface<{}>>
- const AlterationsT extends Alterations<This["cluster"]>
Parameters
- this: This
- alterations: AlterationsT
Returns Type<WithAlterations<This["cluster"], AlterationsT>, This, ClusterInterface.InterfaceOf<This>>
Inherited from ApplicationBasicBehavior.alter
- Defined in packages/node/dist/esm/behavior/cluster/ClusterBehavior.d.ts:142

`Static`enable

enable<This, const FlagsT>(this, flags): Type<WithAlterations<This["cluster"], ElementFlagAlterations<FlagsT>>, This, ClusterInterface.InterfaceOf<This>>
Type Parameters
- This extends Type<ClusterType, Type, ClusterInterface<{}>>
- const FlagsT extends ElementFlags<This["cluster"]>
Parameters
- this: This
- flags: FlagsT
Returns Type<WithAlterations<This["cluster"], ElementFlagAlterations<FlagsT>>, This, ClusterInterface.InterfaceOf<This>>
Inherited from ApplicationBasicBehavior.enable
- Defined in packages/node/dist/esm/behavior/cluster/ClusterBehavior.d.ts:144

`Static`for

for<This, const ClusterT>(this, cluster, schema?): Type<ClusterT, This, ClusterInterface.InterfaceOf<This>>
Type Parameters
- This extends Type<ClusterType, Type, ClusterInterface<{}>>
- const ClusterT extends ClusterType
Parameters
- this: This
- cluster: ClusterT
- Optionalschema: Schema
Returns Type<ClusterT, This, ClusterInterface.InterfaceOf<This>>
Inherited from ApplicationBasicBehavior.for
- Defined in packages/node/dist/esm/behavior/cluster/ClusterBehavior.d.ts:140

`Static`set

set<This>(this, defaults): This
Type Parameters
- This extends Type
Parameters
- this: This
- defaults: Partial<RelaxTypes<InstanceType<This["State"]>>>
Returns This
Inherited from ApplicationBasicBehavior.set
- Defined in packages/node/dist/esm/behavior/cluster/ClusterBehavior.d.ts:143

`Static`with

with<This, const FeaturesT>(this, ...features): Type<WithFeatures<This["cluster"], FeaturesT>, This, ClusterInterface.InterfaceOf<This>>
Type Parameters
- This extends Type<ClusterType, Type, ClusterInterface<{}>>
- const FeaturesT extends FeatureSelection<This["cluster"]>
Parameters
- this: This
- Rest...features: FeaturesT
Returns Type<WithFeatures<This["cluster"], FeaturesT>, This, ClusterInterface.InterfaceOf<This>>
Inherited from ApplicationBasicBehavior.with
- Defined in packages/node/dist/esm/behavior/cluster/ClusterBehavior.d.ts:141

Class ApplicationBasicServer

Hierarchy (view full)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns ApplicationBasicServer

Properties

[reference]

agent

cluster

context

endpoint

env

Readonlyevents

features

session

Readonlystate

Type declaration

Readonlystatus: ApplicationBasic.ApplicationStatus

See

Type declaration

ReadonlyallowedVendorList: VendorId[]

See

Readonlyapplication: TypeFromFields<{ applicationId: FieldType<string>; catalogVendorId: FieldType<number>; }>

See

ReadonlyapplicationName: string

See

ReadonlyapplicationVersion: string

See

Type declaration

Optional ReadonlyproductId?: number

See

Optional ReadonlyvendorId?: VendorId

See

Optional ReadonlyvendorName?: string

See

Static Readonlycluster

Static Readonlydefaults

Static Optional Readonlydependencies

Static Readonlyearly

Static ReadonlyEvents

Static ReadonlyExtensionInterface

Static Readonlyid

Static ReadonlyInterface

Static ReadonlyInternal

Type declaration

Returns {}

Static Readonlyname

Static Optional Readonlyschema

Static ReadonlyState

Static Readonlysupervisor

Staticsupports

Type declaration

Parameters

Returns boolean

Methods

[asyncDispose]

Returns MaybePromise

asAdmin

Parameters

Returns void

Returns void

assertAttributeEnabled

Type Parameters

Parameters

Returns void

Protectedcallback

Type Parameters

Parameters

Returns ((...args: A) => undefined | R)

Parameters

Returns undefined | R

initialize

Parameters

Returns MaybePromise

ProtectedreactTo

`Readonly`events

`Readonly`state

`Readonly`status: ApplicationBasic.ApplicationStatus

`Readonly`allowedVendorList: VendorId[]

`Readonly`application: TypeFromFields<{
applicationId: FieldType<string>;
catalogVendorId: FieldType<number>;
}>

`Readonly`applicationName: string

`Readonly`applicationVersion: string

`Optional` `Readonly`productId?: number

`Optional` `Readonly`vendorId?: VendorId

`Optional` `Readonly`vendorName?: string

`Static` `Readonly`cluster

`Static` `Readonly`defaults

`Static` `Optional` `Readonly`dependencies

`Static` `Readonly`early

`Static` `Readonly`Events

`Static` `Readonly`ExtensionInterface

`Static` `Readonly`id

`Static` `Readonly`Interface

`Static` `Readonly`Internal

`Static` `Readonly`name

`Static` `Optional` `Readonly`schema

`Static` `Readonly`State

`Static` `Readonly`supervisor

`Static`supports

`Protected`callback

`Protected`reactTo

`Static`alter

`Static`enable

`Static`for

`Static`set

`Static`with