Skip to main content

Class: Principal

common.v1.Principal

Principal is an authenticated caller identity computed by the server from trusted authentication context.

Implements

Constructors

constructor

new Principal(properties?): Principal

Constructs a new Principal.

Parameters

NameTypeDescription
properties?IPrincipalProperties to set

Returns

Principal

Properties

name

name: string

Identifier within that category (e.g., sub JWT claim, email address).

Implementation of

IPrincipal.name


type

type: string

Low-cardinality category of the principal (e.g., "jwt", "users").

Implementation of

IPrincipal.type

Methods

toJSON

toJSON(): Object

Converts this Principal to JSON.

Returns

Object

JSON object


create

create(properties?): Principal

Creates a new Principal instance using the specified properties.

Parameters

NameTypeDescription
properties?IPrincipalProperties to set

Returns

Principal

Principal instance


decode

decode(reader, length?): Principal

Decodes a Principal message from the specified reader or buffer.

Parameters

NameTypeDescription
readerUint8Array | ReaderReader or buffer to decode from
length?numberMessage length if known beforehand

Returns

Principal

Principal

Throws

If the payload is not a reader or valid buffer

Throws

If required fields are missing


decodeDelimited

decodeDelimited(reader): Principal

Decodes a Principal message from the specified reader or buffer, length delimited.

Parameters

NameTypeDescription
readerUint8Array | ReaderReader or buffer to decode from

Returns

Principal

Principal

Throws

If the payload is not a reader or valid buffer

Throws

If required fields are missing


encode

encode(message, writer?): Writer

Encodes the specified Principal message. Does not implicitly temporal.api.common.v1.Principal.verify|verify messages.

Parameters

NameTypeDescription
messageIPrincipalPrincipal message or plain object to encode
writer?WriterWriter to encode to

Returns

Writer

Writer


encodeDelimited

encodeDelimited(message, writer?): Writer

Encodes the specified Principal message, length delimited. Does not implicitly temporal.api.common.v1.Principal.verify|verify messages.

Parameters

NameTypeDescription
messageIPrincipalPrincipal message or plain object to encode
writer?WriterWriter to encode to

Returns

Writer

Writer


fromObject

fromObject(object): Principal

Creates a Principal message from a plain object. Also converts values to their respective internal types.

Parameters

NameTypeDescription
objectObjectPlain object

Returns

Principal

Principal


getTypeUrl

getTypeUrl(typeUrlPrefix?): string

Gets the default type url for Principal

Parameters

NameTypeDescription
typeUrlPrefix?stringyour custom typeUrlPrefix(default "type.googleapis.com")

Returns

string

The default type url


toObject

toObject(message, options?): Object

Creates a plain object from a Principal message. Also converts values to other types if specified.

Parameters

NameTypeDescription
messagePrincipalPrincipal
options?IConversionOptionsConversion options

Returns

Object

Plain object