@sphereon/ssi-types 0.30.1-unstable.4 → 0.30.1

package/src/types/w3c-vc.ts

@@ -1,306 +1,306 @@
-import { IProofPurpose, IProofType } from './did'
-import { PresentationSubmission } from './pex'
-import { OriginalType, WrappedVerifiableCredential, WrappedVerifiablePresentation } from './vc'
-
-export type AdditionalClaims = Record<string, any>
-
-export type IIssuerId = string
-
-export interface ICredential {
-  '@context': ICredentialContextType | ICredentialContextType[]
-  type: string[]
-  credentialSchema?: undefined | ICredentialSchemaType | ICredentialSchemaType[]
-  // If iss is present, the value MUST be used to set the issuer property of the new credential JSON object or the holderDID property of the new presentation JSON object.
-  issuer: IIssuerId | IIssuer
-  // If nbf is present, the UNIX timestamp MUST be converted to an [XMLSCHEMA11-2] date-time, and MUST be used to set the value of the issuanceDate property of the new JSON object.
-  issuanceDate: string
-  // If sub is present, the value MUST be used to set the value of the id property of credentialSubject of the new credential JSON object.
-  credentialSubject: (ICredentialSubject & AdditionalClaims) | (ICredentialSubject & AdditionalClaims)[]
-  // If exp is present, the UNIX timestamp MUST be converted to an [XMLSCHEMA11-2] date-time, and MUST be used to set the value of the expirationDate property of credentialSubject of the new JSON object.
-  expirationDate?: string
-  // If jti is present, the value MUST be used to set the value of the id property of the new JSON object.
-  id?: string
-  credentialStatus?: ICredentialStatus
-  description?: string
-  name?: string
-
-  [x: string]: any
-}
-
-export interface ICredentialSubject {
-  id?: string
-}
-
-export type ICredentialContextType = (ICredentialContext & AdditionalClaims) | string
-
-export interface ICredentialContext {
-  name?: string
-  did?: string
-}
-
-export type ICredentialSchemaType = ICredentialSchema | string
-
-export interface ICredentialSchema {
-  id: string
-  type?: string
-}
-
-export interface IProof {
-  type: IProofType | string // The proof type
-  created: string // The ISO8601 date-time string for creation
-  proofPurpose: IProofPurpose | string // The specific intent for the proof
-  verificationMethod: string // A set of parameters required to independently verify the proof
-  challenge?: string // A challenge to protect against replay attacks
-  domain?: string // A string restricting the (usage of a) proof to the domain and protects against replay attacks
-  proofValue?: string // One of any number of valid representations of proof values
-  jws?: string // JWS based proof
-  jwt?: string //Jwt 2020 proof. Used to map a JWT VC onto a uniform presentation, and retain access to the original JWT
-  mso_mdoc?: string
-  nonce?: string // Similar to challenge. A nonce to protect against replay attacks, used in some ZKP proofs
-  requiredRevealStatements?: string[] // The parts of the proof that must be revealed in a derived proof
-
-  [x: string]: any // Any because we want to be able to access value1.value2.value3, which unknown does not allow for without a cast
-}
-
-export interface ICredentialStatus {
-  id: string
-  type: string
-  [x: string]: any
-}
-
-export interface IIssuer {
-  id: string
-
-  [x: string]: any
-}
-
-export interface IHasProof {
-  proof: IProof | IProof[]
-}
-
-export type IVerifiableCredential = ICredential & IHasProof
-
-/**
- * Represents a Json Web Token in compact form.
- */
-export type CompactJWT = string
-
-/**
- * Represents a signed Verifiable Credential (includes proof), in either JSON, compact JWT or compact SD-JWT VC format.
- * See {@link https://www.w3.org/TR/vc-data-model/#credentials | VC data model}
- * See {@link https://www.w3.org/TR/vc-data-model/#proof-formats | proof formats}
- */
-export type W3CVerifiableCredential = IVerifiableCredential | CompactJWT
-
-export interface IPresentation {
-  id?: string
-  '@context': ICredentialContextType | ICredentialContextType[]
-  type?: string | string[]
-  verifiableCredential?: W3CVerifiableCredential[]
-  presentation_submission?: PresentationSubmission
-  holder?: string
-  verifier?: string
-
-  [x: string]: any
-}
-
-export type IVerifiablePresentation = IPresentation & IHasProof
-
-/**
- * Represents a signed Verifiable Presentation (includes proof), in either JSON or compact JWT format.
- * See {@link https://www.w3.org/TR/vc-data-model/#presentations | VC data model}
- * See {@link https://www.w3.org/TR/vc-data-model/#proof-formats | proof formats}
- */
-export type W3CVerifiablePresentation = IVerifiablePresentation | CompactJWT
-
-export interface WrappedW3CVerifiableCredential {
-  /**
-   * Original VC that we've received
-   */
-  original: W3CVerifiableCredential | JwtDecodedVerifiableCredential
-  /**
-   * In case of JWT credential it will be the decoded version. In other cases it will be the same as original one
-   */
-  decoded: JwtDecodedVerifiableCredential | IVerifiableCredential
-  /**
-   * Type of this credential. Supported types are json-ld, jwt (decoded/encoded)
-   */
-  type: OriginalType.JSONLD | OriginalType.JWT_ENCODED | OriginalType.JWT_DECODED
-  /**
-   * The claim format, typically used during exchange transport protocols
-   */
-  format: 'jwt_vc' | 'ldp_vc' | 'ldp' | 'jwt'
-  /**
-   * Internal stable representation of a Credential
-   */
-  credential: IVerifiableCredential
-}
-
-export interface WrappedW3CVerifiablePresentation {
-  /**
-   * Original VP that we've received
-   */
-  original: W3CVerifiablePresentation | JwtDecodedVerifiablePresentation
-  /**
-   * In case of JWT VP it will be the decoded version. In other cases it will be the same as original one
-   */
-  decoded: JwtDecodedVerifiablePresentation | IVerifiablePresentation
-  /**
-   * Type of this Presentation. Supported types are json-ld and jwt (decoded/encoded) and sd-jwt-vc (decoded/encoded)
-   */
-  type: OriginalType.JSONLD | OriginalType.JWT_ENCODED | OriginalType.JWT_DECODED
-  /**
-   * The claim format, typically used during exchange transport protocols
-   */
-  format: 'jwt_vp' | 'ldp_vp'
-  /**
-   * Internal stable representation of a Presentation without proofs, created based on https://www.w3.org/TR/vc-data-model/#jwt-decoding
-   */
-  presentation: UniformVerifiablePresentation
-  /**
-   * Wrapped Verifiable Credentials belonging to the Presentation
-   */
-  vcs: WrappedW3CVerifiableCredential[]
-}
-
-export interface UniformVerifiablePresentation {
-  '@context': ICredentialContextType | ICredentialContextType[]
-  type: string | string[]
-  verifiableCredential: WrappedW3CVerifiableCredential[]
-  presentation_submission?: PresentationSubmission
-  holder?: string
-}
-
-export interface JwtDecodedVerifiableCredential {
-  vc: IVerifiableCredential
-  exp: string
-  iss: string
-  nbf: string
-  sub: string
-  jti: string
-
-  [x: string]: any
-}
-
-export interface JwtDecodedVerifiablePresentation {
-  vp: IVerifiablePresentation
-  exp: string
-  iss: string
-  nbf: string
-  sub: string
-  jti: string
-  aud: string
-  iat: string
-
-  [x: string]: any
-}
-
-export const JWT_PROOF_TYPE_2020 = 'JwtProof2020'
-
-export interface IVerifyStatusResult {
-  verified: boolean
-  /**
-   * Optional Error object for the
-   * but currently the machine readable errors are not exported from DID-JWT package to be imported here
-   */
-  error?: IError | undefined
-
-  /**
-   * Other options can be specified for verification.
-   * They will be forwarded to the lower level modules. that performt the checks
-   */
-  [x: string]: any
-}
-
-export interface IVerifyResult {
-  /**
-   * This value is used to transmit the global result of verification.
-   */
-  verified: boolean
-
-  results?: [
-    {
-      credential?: ICredential
-      presentation?: IPresentation
-      verified: boolean
-      error?: IError
-      log: [{ id: string; valid: boolean }]
-    }
-  ]
-
-  statusResult?: IVerifyStatusResult
-
-  /**
-   * Optional Error object for the
-   * but currently the machine readable errors are not exported from DID-JWT package to be imported here
-   */
-  error?: IError | undefined
-
-  /**
-   * Other options can be specified for verification.
-   * They will be forwarded to the lower level modules. that performt the checks
-   */
-  [x: string]: any
-}
-
-/**
- * An error object, which can contain a code.
- * @beta
- */
-export interface IError {
-  name?: string
-
-  errors?: IError[]
-
-  /**
-   * The details of the error being thrown or forwarded
-   */
-  message?: string
-
-  /**
-   * The stack of the error
-   */
-  stack?: string | string[]
-
-  details?: IErrorDetails
-
-  /**
-   * The code for the error being throw
-   */
-  errorCode?: string
-}
-
-export interface IErrorDetails {
-  code?: string
-  url?: string
-  cause?: IError
-}
-
-export enum StatusListType {
-  StatusList2021 = 'StatusList2021',
-}
-
-export type StatusPurpose2021 = 'revocation' | 'suspension' | string
-
-export enum StatusListCredentialIdMode {
-  ISSUANCE = 'ISSUANCE',
-  // PERSISTENCE = 'PERSISTENCE',
-  NEVER = 'NEVER',
-}
-
-export type StatusListIndexingDirection = 'rightToLeft'
-
-export enum StatusListDriverType {
-  AGENT_TYPEORM = 'agent_typeorm',
- /* AGENT_KV_STORE = 'agent_kv_store',
-  GITHUB = 'github',
-  AGENT_FILESYSTEM = 'agent_filesystem',*/
-}
-
-export function isWrappedW3CVerifiableCredential(vc: WrappedVerifiableCredential): vc is WrappedW3CVerifiableCredential {
-  return vc.format === 'jwt_vc' || vc.format === 'ldp_vc'
-}
-
-export function isWrappedW3CVerifiablePresentation(vp: WrappedVerifiablePresentation): vp is WrappedW3CVerifiablePresentation {
-  return vp.format === 'jwt_vp' || vp.format === 'ldp_vp'
-}
+import { IProofPurpose, IProofType } from './did'
+import { PresentationSubmission } from './pex'
+import { OriginalType, WrappedVerifiableCredential, WrappedVerifiablePresentation } from './vc'
+
+export type AdditionalClaims = Record<string, any>
+
+export type IIssuerId = string
+
+export interface ICredential {
+  '@context': ICredentialContextType | ICredentialContextType[]
+  type: string[]
+  credentialSchema?: undefined | ICredentialSchemaType | ICredentialSchemaType[]
+  // If iss is present, the value MUST be used to set the issuer property of the new credential JSON object or the holderDID property of the new presentation JSON object.
+  issuer: IIssuerId | IIssuer
+  // If nbf is present, the UNIX timestamp MUST be converted to an [XMLSCHEMA11-2] date-time, and MUST be used to set the value of the issuanceDate property of the new JSON object.
+  issuanceDate: string
+  // If sub is present, the value MUST be used to set the value of the id property of credentialSubject of the new credential JSON object.
+  credentialSubject: (ICredentialSubject & AdditionalClaims) | (ICredentialSubject & AdditionalClaims)[]
+  // If exp is present, the UNIX timestamp MUST be converted to an [XMLSCHEMA11-2] date-time, and MUST be used to set the value of the expirationDate property of credentialSubject of the new JSON object.
+  expirationDate?: string
+  // If jti is present, the value MUST be used to set the value of the id property of the new JSON object.
+  id?: string
+  credentialStatus?: ICredentialStatus
+  description?: string
+  name?: string
+
+  [x: string]: any
+}
+
+export interface ICredentialSubject {
+  id?: string
+}
+
+export type ICredentialContextType = (ICredentialContext & AdditionalClaims) | string
+
+export interface ICredentialContext {
+  name?: string
+  did?: string
+}
+
+export type ICredentialSchemaType = ICredentialSchema | string
+
+export interface ICredentialSchema {
+  id: string
+  type?: string
+}
+
+export interface IProof {
+  type: IProofType | string // The proof type
+  created: string // The ISO8601 date-time string for creation
+  proofPurpose: IProofPurpose | string // The specific intent for the proof
+  verificationMethod: string // A set of parameters required to independently verify the proof
+  challenge?: string // A challenge to protect against replay attacks
+  domain?: string // A string restricting the (usage of a) proof to the domain and protects against replay attacks
+  proofValue?: string // One of any number of valid representations of proof values
+  jws?: string // JWS based proof
+  jwt?: string //Jwt 2020 proof. Used to map a JWT VC onto a uniform presentation, and retain access to the original JWT
+  mso_mdoc?: string
+  nonce?: string // Similar to challenge. A nonce to protect against replay attacks, used in some ZKP proofs
+  requiredRevealStatements?: string[] // The parts of the proof that must be revealed in a derived proof
+
+  [x: string]: any // Any because we want to be able to access value1.value2.value3, which unknown does not allow for without a cast
+}
+
+export interface ICredentialStatus {
+  id: string
+  type: string
+  [x: string]: any
+}
+
+export interface IIssuer {
+  id: string
+
+  [x: string]: any
+}
+
+export interface IHasProof {
+  proof: IProof | IProof[]
+}
+
+export type IVerifiableCredential = ICredential & IHasProof
+
+/**
+ * Represents a Json Web Token in compact form.
+ */
+export type CompactJWT = string
+
+/**
+ * Represents a signed Verifiable Credential (includes proof), in either JSON, compact JWT or compact SD-JWT VC format.
+ * See {@link https://www.w3.org/TR/vc-data-model/#credentials | VC data model}
+ * See {@link https://www.w3.org/TR/vc-data-model/#proof-formats | proof formats}
+ */
+export type W3CVerifiableCredential = IVerifiableCredential | CompactJWT
+
+export interface IPresentation {
+  id?: string
+  '@context': ICredentialContextType | ICredentialContextType[]
+  type?: string | string[]
+  verifiableCredential?: W3CVerifiableCredential[]
+  presentation_submission?: PresentationSubmission
+  holder?: string
+  verifier?: string
+
+  [x: string]: any
+}
+
+export type IVerifiablePresentation = IPresentation & IHasProof
+
+/**
+ * Represents a signed Verifiable Presentation (includes proof), in either JSON or compact JWT format.
+ * See {@link https://www.w3.org/TR/vc-data-model/#presentations | VC data model}
+ * See {@link https://www.w3.org/TR/vc-data-model/#proof-formats | proof formats}
+ */
+export type W3CVerifiablePresentation = IVerifiablePresentation | CompactJWT
+
+export interface WrappedW3CVerifiableCredential {
+  /**
+   * Original VC that we've received
+   */
+  original: W3CVerifiableCredential | JwtDecodedVerifiableCredential
+  /**
+   * In case of JWT credential it will be the decoded version. In other cases it will be the same as original one
+   */
+  decoded: JwtDecodedVerifiableCredential | IVerifiableCredential
+  /**
+   * Type of this credential. Supported types are json-ld, jwt (decoded/encoded)
+   */
+  type: OriginalType.JSONLD | OriginalType.JWT_ENCODED | OriginalType.JWT_DECODED
+  /**
+   * The claim format, typically used during exchange transport protocols
+   */
+  format: 'jwt_vc' | 'ldp_vc' | 'ldp' | 'jwt'
+  /**
+   * Internal stable representation of a Credential
+   */
+  credential: IVerifiableCredential
+}
+
+export interface WrappedW3CVerifiablePresentation {
+  /**
+   * Original VP that we've received
+   */
+  original: W3CVerifiablePresentation | JwtDecodedVerifiablePresentation
+  /**
+   * In case of JWT VP it will be the decoded version. In other cases it will be the same as original one
+   */
+  decoded: JwtDecodedVerifiablePresentation | IVerifiablePresentation
+  /**
+   * Type of this Presentation. Supported types are json-ld and jwt (decoded/encoded) and sd-jwt-vc (decoded/encoded)
+   */
+  type: OriginalType.JSONLD | OriginalType.JWT_ENCODED | OriginalType.JWT_DECODED
+  /**
+   * The claim format, typically used during exchange transport protocols
+   */
+  format: 'jwt_vp' | 'ldp_vp'
+  /**
+   * Internal stable representation of a Presentation without proofs, created based on https://www.w3.org/TR/vc-data-model/#jwt-decoding
+   */
+  presentation: UniformVerifiablePresentation
+  /**
+   * Wrapped Verifiable Credentials belonging to the Presentation
+   */
+  vcs: WrappedW3CVerifiableCredential[]
+}
+
+export interface UniformVerifiablePresentation {
+  '@context': ICredentialContextType | ICredentialContextType[]
+  type: string | string[]
+  verifiableCredential: WrappedW3CVerifiableCredential[]
+  presentation_submission?: PresentationSubmission
+  holder?: string
+}
+
+export interface JwtDecodedVerifiableCredential {
+  vc: IVerifiableCredential
+  exp: string
+  iss: string
+  nbf: string
+  sub: string
+  jti: string
+
+  [x: string]: any
+}
+
+export interface JwtDecodedVerifiablePresentation {
+  vp: IVerifiablePresentation
+  exp: string
+  iss: string
+  nbf: string
+  sub: string
+  jti: string
+  aud: string
+  iat: string
+
+  [x: string]: any
+}
+
+export const JWT_PROOF_TYPE_2020 = 'JwtProof2020'
+
+export interface IVerifyStatusResult {
+  verified: boolean
+  /**
+   * Optional Error object for the
+   * but currently the machine readable errors are not exported from DID-JWT package to be imported here
+   */
+  error?: IError | undefined
+
+  /**
+   * Other options can be specified for verification.
+   * They will be forwarded to the lower level modules. that performt the checks
+   */
+  [x: string]: any
+}
+
+export interface IVerifyResult {
+  /**
+   * This value is used to transmit the global result of verification.
+   */
+  verified: boolean
+
+  results?: [
+    {
+      credential?: ICredential
+      presentation?: IPresentation
+      verified: boolean
+      error?: IError
+      log: [{ id: string; valid: boolean }]
+    }
+  ]
+
+  statusResult?: IVerifyStatusResult
+
+  /**
+   * Optional Error object for the
+   * but currently the machine readable errors are not exported from DID-JWT package to be imported here
+   */
+  error?: IError | undefined
+
+  /**
+   * Other options can be specified for verification.
+   * They will be forwarded to the lower level modules. that performt the checks
+   */
+  [x: string]: any
+}
+
+/**
+ * An error object, which can contain a code.
+ * @beta
+ */
+export interface IError {
+  name?: string
+
+  errors?: IError[]
+
+  /**
+   * The details of the error being thrown or forwarded
+   */
+  message?: string
+
+  /**
+   * The stack of the error
+   */
+  stack?: string | string[]
+
+  details?: IErrorDetails
+
+  /**
+   * The code for the error being throw
+   */
+  errorCode?: string
+}
+
+export interface IErrorDetails {
+  code?: string
+  url?: string
+  cause?: IError
+}
+
+export enum StatusListType {
+  StatusList2021 = 'StatusList2021',
+}
+
+export type StatusPurpose2021 = 'revocation' | 'suspension' | string
+
+export enum StatusListCredentialIdMode {
+  ISSUANCE = 'ISSUANCE',
+  // PERSISTENCE = 'PERSISTENCE',
+  NEVER = 'NEVER',
+}
+
+export type StatusListIndexingDirection = 'rightToLeft'
+
+export enum StatusListDriverType {
+  AGENT_TYPEORM = 'agent_typeorm',
+ /* AGENT_KV_STORE = 'agent_kv_store',
+  GITHUB = 'github',
+  AGENT_FILESYSTEM = 'agent_filesystem',*/
+}
+
+export function isWrappedW3CVerifiableCredential(vc: WrappedVerifiableCredential): vc is WrappedW3CVerifiableCredential {
+  return vc.format === 'jwt_vc' || vc.format === 'ldp_vc'
+}
+
+export function isWrappedW3CVerifiablePresentation(vp: WrappedVerifiablePresentation): vp is WrappedW3CVerifiablePresentation {
+  return vp.format === 'jwt_vp' || vp.format === 'ldp_vp'
+}

package/src/utils/index.ts

@@ -1 +1 @@
-export * from './object'
+export * from './object'

package/src/utils/object.ts

@@ -1,28 +1,28 @@
-const BASE64_REGEX = /^[-A-Za-z0-9+_/]*={0,3}$/g
-
-export class ObjectUtils {
-  public static asArray<T>(value: T): T[] {
-    return Array.isArray(value) ? value : [value]
-  }
-
-  public static isObject(value: unknown): value is object {
-    return typeof value === 'object' || Object.prototype.toString.call(value) === '[object Object]'
-  }
-
-  public static isUrlAbsolute(url: string) {
-    // regex to check for absolute IRI (starting scheme and ':') or blank node IRI
-    const isAbsoluteRegex = /^([A-Za-z][A-Za-z0-9+-.]*|_):[^\s]*$/
-    ObjectUtils.isString(url) && isAbsoluteRegex.test(url)
-  }
-
-  public static isString(value: unknown): value is string {
-    return typeof value === 'string' || Object.prototype.toString.call(value) === '[object String]'
-  }
-
-  public static isBase64(value: unknown): boolean {
-    if (!ObjectUtils.isString(value)) {
-      return false
-    }
-    return value.match(BASE64_REGEX) !== null
-  }
-}
+const BASE64_REGEX = /^[-A-Za-z0-9+_/]*={0,3}$/g
+
+export class ObjectUtils {
+  public static asArray<T>(value: T): T[] {
+    return Array.isArray(value) ? value : [value]
+  }
+
+  public static isObject(value: unknown): value is object {
+    return typeof value === 'object' || Object.prototype.toString.call(value) === '[object Object]'
+  }
+
+  public static isUrlAbsolute(url: string) {
+    // regex to check for absolute IRI (starting scheme and ':') or blank node IRI
+    const isAbsoluteRegex = /^([A-Za-z][A-Za-z0-9+-.]*|_):[^\s]*$/
+    ObjectUtils.isString(url) && isAbsoluteRegex.test(url)
+  }
+
+  public static isString(value: unknown): value is string {
+    return typeof value === 'string' || Object.prototype.toString.call(value) === '[object String]'
+  }
+
+  public static isBase64(value: unknown): boolean {
+    if (!ObjectUtils.isString(value)) {
+      return false
+    }
+    return value.match(BASE64_REGEX) !== null
+  }
+}