Class ApplicationPkcs7Mime

An S/MIME part with a Content-Type of application/pkcs7-mime.

Hierarchy (View Summary)

MimePart
- ApplicationPkcs7Mime

Constructors

constructor

new ApplicationPkcs7Mime(args: MimeEntityConstructorArgs): ApplicationPkcs7Mime
Parameters
- args: MimeEntityConstructorArgs
Returns ApplicationPkcs7Mime
Overrides MimePart.constructor
- Defined in src/smime/application-pkcs7-mime.ts:47
new ApplicationPkcs7Mime(
type: SecureMimeType,
stream: Stream,
): ApplicationPkcs7Mime
Parameters
- type: SecureMimeType
- stream: Stream
Returns ApplicationPkcs7Mime
Overrides MimePart.constructor
- Defined in src/smime/application-pkcs7-mime.ts:48

Properties

`Readonly`headers

headers: HeaderList

The headers belonging to this MIME entity.

`Readonly`contentType

contentType: ContentType

The entity's Content-Type value.

ensureNewLine

ensureNewLine: boolean = false

`Protected` `Readonly`lazyLoaded

lazyLoaded: Set<LazyField> = ...

content

content: MimeContent | null = null

The MIME content for this part.

Accessors

isDisposed

get isDisposed(): boolean
C#: internal IsDisposed (exposed publicly; upstream tests read it via InternalsVisibleTo).

Returns boolean
Inherited from MimePart.isDisposed
- Defined in src/mime-entity.ts:62

contentDisposition

get contentDisposition(): ContentDisposition | null
Gets or sets the Content-Disposition header value.

Returns ContentDisposition | null

Throws
The entity has been disposed.
Inherited from MimePart.contentDisposition
- Defined in src/mime-entity.ts:101
set contentDisposition(value: ContentDisposition | null): void
Sets the Content-Disposition header value.
Parameters
- value: ContentDisposition | null
Returns void
Inherited from MimePart.contentDisposition
- Defined in src/mime-entity.ts:118

contentBase

get contentBase(): string | null
Gets or sets the absolute Content-Base URI.

Returns string | null

Throws
value is not an absolute URI or the entity has been disposed.
Inherited from MimePart.contentBase
- Defined in src/mime-entity.ts:139
set contentBase(value: string | URL | null): void
Sets the absolute Content-Base URI.
Parameters
- value: string | URL | null
Returns void
Inherited from MimePart.contentBase
- Defined in src/mime-entity.ts:152

contentLocation

get contentLocation(): string | null
Gets or sets the Content-Location URI.

Returns string | null

Throws
The entity has been disposed.
Inherited from MimePart.contentLocation
- Defined in src/mime-entity.ts:167
set contentLocation(value: string | URL | null): void
Sets the Content-Location URI.
Parameters
- value: string | URL | null
Returns void
Inherited from MimePart.contentLocation
- Defined in src/mime-entity.ts:180

contentId

get contentId(): string | null
Gets or sets the Content-Id header value.

Returns string | null

Throws
value is not a valid message id or the entity has been disposed.
Inherited from MimePart.contentId
- Defined in src/mime-entity.ts:193
set contentId(value: string | null): void
Sets the Content-Id header value.
Parameters
- value: string | null
Returns void
Inherited from MimePart.contentId
- Defined in src/mime-entity.ts:209

isAttachment

get isAttachment(): boolean
Gets or sets whether this entity is marked as an attachment.

Setting this updates the Content-Disposition disposition between attachment and inline.

Returns boolean
Inherited from MimePart.isAttachment
- Defined in src/mime-entity.ts:233
set isAttachment(value: boolean): void
Sets whether this entity is marked as an attachment.
Parameters
- value: boolean
Returns void
Inherited from MimePart.isAttachment
- Defined in src/mime-entity.ts:239

contentDescription

get contentDescription(): string | null
Gets or sets the Content-Description header value.

Returns string | null

Throws
The part has been disposed.
Inherited from MimePart.contentDescription
- Defined in src/mime-part.ts:98
set contentDescription(value: string | null): void
Sets the Content-Description header value.
Parameters
- value: string | null
Returns void
Inherited from MimePart.contentDescription
- Defined in src/mime-part.ts:110

contentDuration

get contentDuration(): number | null
Gets or sets the Content-Duration value in seconds.

Returns number | null

Throws
value is not a non-negative integer.

Throws
The part has been disposed.
Inherited from MimePart.contentDuration
- Defined in src/mime-part.ts:123
set contentDuration(value: number | null): void
Sets the Content-Duration value in seconds.
Parameters
- value: number | null
Returns void
Inherited from MimePart.contentDuration
- Defined in src/mime-part.ts:136

contentMd5

get contentMd5(): string | null
Gets or sets the Content-MD5 checksum value.

Returns string | null

Throws
The part has been disposed.
Inherited from MimePart.contentMd5
- Defined in src/mime-part.ts:150
set contentMd5(value: string | null): void
Sets the Content-MD5 checksum value.
Parameters
- value: string | null
Returns void
Inherited from MimePart.contentMd5
- Defined in src/mime-part.ts:162

contentTransferEncoding

get contentTransferEncoding(): ContentEncoding
Gets or sets the Content-Transfer-Encoding value.

Returns ContentEncoding

Throws
value is not a valid content encoding or the part has been disposed.
Inherited from MimePart.contentTransferEncoding
- Defined in src/mime-part.ts:174
set contentTransferEncoding(value: ContentEncoding): void
Sets the Content-Transfer-Encoding value.
Parameters
- value: ContentEncoding
Returns void
Inherited from MimePart.contentTransferEncoding
- Defined in src/mime-part.ts:189

fileName

get fileName(): string | null
Gets or sets the file name from Content-Disposition or Content-Type.

Returns string | null
Inherited from MimePart.fileName
- Defined in src/mime-part.ts:200
set fileName(value: string | null): void
Sets the file name in Content-Disposition and Content-Type.
Parameters
- value: string | null
Returns void
Inherited from MimePart.fileName
- Defined in src/mime-part.ts:205

secureMimeType

get secureMimeType(): SecureMimeType
The value of the "smime-type" parameter.

Returns SecureMimeType
- Defined in src/smime/application-pkcs7-mime.ts:92

Methods

toString

toString(): string
Serializes the MIME entity to a string.

Returns string
The serialized MIME entity.
Inherited from MimePart.toString
- Defined in src/mime-entity.ts:298

`Protected`checkDisposed

checkDisposed(objectName?: string): void
Parameters
- objectName: string = 'MimeEntity'
Returns void
Inherited from MimePart.checkDisposed
- Defined in src/mime-entity.ts:315

`Protected`tryInit

tryInit(obj: unknown): boolean
Parameters
- obj: unknown
Returns boolean
Inherited from MimePart.tryInit
- Defined in src/mime-entity.ts:320

`Protected`removeHeader

removeHeader(name: string): void
Parameters
- name: string
Returns void
Inherited from MimePart.removeHeader
- Defined in src/mime-entity.ts:333

`Protected`setHeader

setHeader(name: string, value: string): void
Parameters
- name: string
- value: string
Returns void
Inherited from MimePart.setHeader
- Defined in src/mime-entity.ts:343

`Protected`setRawHeader

setRawHeader(name: string, rawValue: Uint8Array): void
Parameters
- name: string
- rawValue: Uint8Array
Returns void
Inherited from MimePart.setRawHeader
- Defined in src/mime-entity.ts:353

`Static`load

load(
    stream: Stream,
    persistent?: boolean,
    options?: ParserOptions,
): Result<MimeEntity>
C#: MimeEntity.Load. Parses a MIME entity from a stream (or byte buffer), or — given an explicit Content-Type — from a bare content stream (the HttpWebResponse use-case, where headers are parsed separately). Parse errors are returned as an Err (C#: FormatException) per the port's Result convention.
Parameters
- stream: Stream
- Optionalpersistent: boolean
- Optionaloptions: ParserOptions
Returns Result<MimeEntity>
Inherited from MimePart.load
- Defined in src/mime-entity.ts:416
load(data: Uint8Array, options?: ParserOptions): Result<MimeEntity>
C#: MimeEntity.Load. Parses a MIME entity from a stream (or byte buffer), or — given an explicit Content-Type — from a bare content stream (the HttpWebResponse use-case, where headers are parsed separately). Parse errors are returned as an Err (C#: FormatException) per the port's Result convention.
Parameters
- data: Uint8Array
- Optionaloptions: ParserOptions
Returns Result<MimeEntity>
Inherited from MimePart.load
- Defined in src/mime-entity.ts:417
load(
    contentType: ContentType,
    content: Stream,
    options?: ParserOptions,
): Result<MimeEntity>
C#: MimeEntity.Load. Parses a MIME entity from a stream (or byte buffer), or — given an explicit Content-Type — from a bare content stream (the HttpWebResponse use-case, where headers are parsed separately). Parse errors are returned as an Err (C#: FormatException) per the port's Result convention.
Parameters
- contentType: ContentType
- content: Stream
- Optionaloptions: ParserOptions
Returns Result<MimeEntity>
Inherited from MimePart.load
- Defined in src/mime-entity.ts:418

getBestEncoding

getBestEncoding(
constraint: EncodingConstraint,
maxLineLength?: number,
): ContentEncoding
Calculates the best content-transfer-encoding for this part.
Parameters
- constraint: EncodingConstraint
  The encoding constraint.
- maxLineLength: number = DEFAULT_MAX_LINE_LENGTH
  The maximum line length.
Returns ContentEncoding
The best content-transfer-encoding.
Inherited from MimePart.getBestEncoding
- Defined in src/mime-part.ts:222

computeContentMd5

computeContentMd5(): string
Computes a base64-encoded MD5 checksum for the decoded content.

Returns string
The computed checksum.

Throws
The part has no content or has been disposed.
Inherited from MimePart.computeContentMd5
- Defined in src/mime-part.ts:244

verifyContentMd5

verifyContentMd5(): boolean
Verifies the Content-MD5 checksum against the decoded content.

Returns boolean
true if the checksum matches; otherwise false.
Inherited from MimePart.verifyContentMd5
- Defined in src/mime-part.ts:263

prepare

prepare(constraint: EncodingConstraint, maxLineLength?: number): void
Prepares this part for transport under the requested encoding constraint.
Parameters
- constraint: EncodingConstraint
  The encoding constraint.
- maxLineLength: number = DEFAULT_MAX_LINE_LENGTH
  The maximum encoded line length.
Returns void

Throws
maxLineLength is outside the supported range.
Inherited from MimePart.prepare
- Defined in src/mime-part.ts:290

writeTo

writeTo(stream: Stream): void
Writes the MIME part to a stream.
Parameters
- stream: Stream
  The destination stream.
Returns void
Inherited from MimePart.writeTo
- Defined in src/mime-part.ts:321
writeTo(options: FormatOptions, stream: Stream): void
Writes the MIME part to a stream.
Parameters
- options: FormatOptions
  Formatting options.
- stream: Stream
  The destination stream.
Returns void
Inherited from MimePart.writeTo
- Defined in src/mime-part.ts:322
writeTo(options: FormatOptions, stream: Stream, contentOnly: boolean): void
Writes the MIME part to a stream.
Parameters
- options: FormatOptions
  Formatting options.
- stream: Stream
  The destination stream.
- contentOnly: boolean
  Whether to omit the part headers.
Returns void
Inherited from MimePart.writeTo
- Defined in src/mime-part.ts:323

`Protected`onHeadersChanged

onHeadersChanged(
action: "changed" | "removed" | "added" | "cleared",
header: Header | null,
): void
Parameters
- action: "changed" | "removed" | "added" | "cleared"
- header: Header | null
Returns void
Inherited from MimePart.onHeadersChanged
- Defined in src/mime-part.ts:369

dispose

dispose(): void
Releases the content and base entity resources.

Returns void
Inherited from MimePart.dispose
- Defined in src/mime-part.ts:402

accept

accept(visitor: MimeVisitor): void
Dispatches to the visitor method for application/pkcs7-mime entities.
Parameters
- visitor: MimeVisitor
  The visitor.
Returns void
Overrides MimePart.accept
- Defined in src/smime/application-pkcs7-mime.ts:110

decompress

decompress(ctx?: SecureMimeContext): Promise<MimeEntity>
Decompress the compressed-data using the specified context.
Parameters
- Optionalctx: SecureMimeContext
Returns Promise<MimeEntity>
- Defined in src/smime/application-pkcs7-mime.ts:123

decrypt

decrypt(ctx?: SecureMimeContext): Promise<MimeEntity>
Decrypt the enveloped-data using the specified context.
Parameters
- Optionalctx: SecureMimeContext
Returns Promise<MimeEntity>
- Defined in src/smime/application-pkcs7-mime.ts:132

import

import(ctx: SecureMimeContext): Promise<void>
Import the certificates contained in the certs-only content.
Parameters
- ctx: SecureMimeContext
Returns Promise<void>
- Defined in src/smime/application-pkcs7-mime.ts:141

verify

verify(
ctx?: SecureMimeContext,
): Promise<{ signatures: DigitalSignatureCollection; entity: MimeEntity }>
Verify the signed-data and return the signatures and the unwrapped entity.
Parameters
- Optionalctx: SecureMimeContext
Returns Promise<{ signatures: DigitalSignatureCollection; entity: MimeEntity }>
- Defined in src/smime/application-pkcs7-mime.ts:148

`Static`compress

compress(
ctx: SecureMimeContext,
entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Compress the entity using the specified context.
Parameters
- ctx: SecureMimeContext
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:157
compress(entity: MimeEntity): Promise<ApplicationPkcs7Mime>
Compress the entity using the specified context.
Parameters
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:158

`Static`encrypt

encrypt(
    ctx: SecureMimeContext,
    recipients: CmsRecipientCollection,
    entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Encrypt the entity to the specified recipients using the specified context.
Parameters
- ctx: SecureMimeContext
- recipients: CmsRecipientCollection
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:170
encrypt(
recipients: CmsRecipientCollection,
entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Encrypt the entity to the specified recipients using the specified context.
Parameters
- recipients: CmsRecipientCollection
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:175

`Static`encryptToMailboxes

encryptToMailboxes(
    ctx: SecureMimeContext,
    recipients: Iterable<MailboxAddress>,
    entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Encrypt the entity to the specified recipient mailboxes (certificates resolved via the store).
Parameters
- ctx: SecureMimeContext
- recipients: Iterable<MailboxAddress>
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:195
encryptToMailboxes(
recipients: Iterable<MailboxAddress>,
entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Encrypt the entity to the specified recipient mailboxes (certificates resolved via the store).
Parameters
- recipients: Iterable<MailboxAddress>
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:200

`Static`sign

sign(
    ctx: SecureMimeContext,
    signer: CmsSigner,
    entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Sign the entity (encapsulated signed-data) using the specified context.
Parameters
- ctx: SecureMimeContext
- signer: CmsSigner
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:221
sign(signer: CmsSigner, entity: MimeEntity): Promise<ApplicationPkcs7Mime>
Sign the entity (encapsulated signed-data) using the specified context.
Parameters
- signer: CmsSigner
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:222

`Static`signWithMailbox

signWithMailbox(
    ctx: SecureMimeContext,
    signer: MailboxAddress,
    digestAlgo: DigestAlgorithm,
    entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Sign the entity using a signer mailbox and digest algorithm (signer resolved via the store).
Parameters
- ctx: SecureMimeContext
- signer: MailboxAddress
- digestAlgo: DigestAlgorithm
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:242
signWithMailbox(
    signer: MailboxAddress,
    digestAlgo: DigestAlgorithm,
    entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Sign the entity using a signer mailbox and digest algorithm, resolved via the default context.
Parameters
- signer: MailboxAddress
- digestAlgo: DigestAlgorithm
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:249

`Static`signAndEncrypt

signAndEncrypt(
    ctx: SecureMimeContext,
    signer: CmsSigner,
    recipients: CmsRecipientCollection,
    entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Sign as multipart/signed and then encrypt the entity using the specified context.
Parameters
- ctx: SecureMimeContext
- signer: CmsSigner
- recipients: CmsRecipientCollection
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:276

`Static`signAndEncryptToMailboxes

signAndEncryptToMailboxes(
    ctx: SecureMimeContext,
    signer: MailboxAddress,
    digestAlgo: DigestAlgorithm,
    recipients: Iterable<MailboxAddress>,
    entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Sign as multipart/signed and then encrypt using a signer mailbox and recipient mailboxes.
Parameters
- ctx: SecureMimeContext
- signer: MailboxAddress
- digestAlgo: DigestAlgorithm
- recipients: Iterable<MailboxAddress>
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:291

`Static`signAndEncryptDefault

signAndEncryptDefault(
    signer: CmsSigner,
    recipients: CmsRecipientCollection,
    entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Sign and encrypt using the default S/MIME context.
Parameters
- signer: CmsSigner
- recipients: CmsRecipientCollection
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:307

`Static`signAndEncryptToMailboxesDefault

signAndEncryptToMailboxesDefault(
    signer: MailboxAddress,
    digestAlgo: DigestAlgorithm,
    recipients: Iterable<MailboxAddress>,
    entity: MimeEntity,
): Promise<ApplicationPkcs7Mime>
Sign and encrypt to mailboxes using the default S/MIME context.
Parameters
- signer: MailboxAddress
- digestAlgo: DigestAlgorithm
- recipients: Iterable<MailboxAddress>
- entity: MimeEntity
Returns Promise<ApplicationPkcs7Mime>
- Defined in src/smime/application-pkcs7-mime.ts:319

Class ApplicationPkcs7Mime

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns ApplicationPkcs7Mime

Parameters

Returns ApplicationPkcs7Mime

Properties

Readonlyheaders

ReadonlycontentType

ensureNewLine

Protected ReadonlylazyLoaded

content

Accessors

isDisposed

Returns boolean

contentDisposition

Returns ContentDisposition | null

Throws

Parameters

Returns void

contentBase

Returns string | null

Throws

Parameters

Returns void

contentLocation

Returns string | null

Throws

Parameters

Returns void

contentId

Returns string | null

Throws

Parameters

Returns void

isAttachment

Returns boolean

Parameters

Returns void

contentDescription

Returns string | null

Throws

Parameters

Returns void

contentDuration

Returns number | null

Throws

Throws

Parameters

Returns void

contentMd5

Returns string | null

Throws

Parameters

Returns void

contentTransferEncoding

Returns ContentEncoding

Throws

Parameters

Returns void

fileName

Returns string | null

Parameters

Returns void

secureMimeType

Returns SecureMimeType

Methods

toString

Returns string

ProtectedcheckDisposed

Parameters

Returns void

ProtectedtryInit

`Readonly`headers

`Readonly`contentType

`Protected` `Readonly`lazyLoaded

`Protected`checkDisposed

`Protected`tryInit

`Protected`removeHeader

`Protected`setHeader

`Protected`setRawHeader

`Static`load

`Protected`onHeadersChanged

`Static`compress

`Static`encrypt

`Static`encryptToMailboxes