@sphereon/ssi-sdk.vc-status-list 0.34.1-feature.SSISDK.17.bitstring.sl.2 → 0.34.1-feature.SSISDK.17.bitstring.sl.25

package/dist/index.d.ts

@@ -1,12 +1,61 @@
 import { IIdentifierResolution } from '@sphereon/ssi-sdk-ext.identifier-resolution';
-import { StatusListIndexingDirection, StatusPurpose2021, BitstringStatusPurpose, StatusListType, IIssuer, CredentialProofFormat, StatusListDriverType, StatusListCredential, StatusListCredentialIdMode, ICredentialStatus, OrPromise, ICredential, IVerifiableCredential } from '@sphereon/ssi-types';
-import { IPluginMethodMap, IAgentContext, ICredentialIssuer, ICredentialVerifier, IKeyManager, ICredentialPlugin, CredentialPayload } from '@veramo/core';
+import { IIssuer, StatusListType, CredentialProofFormat, StatusListCredential, StatusListDriverType, StatusListIndexingDirection, StatusPurpose2021, ICredentialStatus, OrPromise, ICredential, IVerifiableCredential } from '@sphereon/ssi-types';
+import { IPluginMethodMap, IAgentContext, ICredentialIssuer, ICredentialVerifier, IKeyManager, CredentialPayload } from '@veramo/core';
 import { DataSource } from 'typeorm';
-import { BitsPerStatus } from '@sd-jwt/jwt-status-list';
+import { StatusList, BitsPerStatus } from '@sd-jwt/jwt-status-list';
 import { SdJwtVcPayload } from '@sd-jwt/sd-jwt-vc';
 import { StatusListOpts } from '@sphereon/oid4vci-common';
+import { BitstringStatusPurpose } from '@4sure-tech/vc-bitstring-status-lists';
+import { IVcdmCredentialPlugin } from '@sphereon/ssi-sdk.credential-vcdm';
+import { BitstringStatusListArgs, IStatusListEntity, StatusListEntity, IStatusListEntryEntity, IBitstringStatusListEntryEntity, BitstringStatusListEntryCredentialStatus } from '@sphereon/ssi-sdk.data-store';
 import { StatusMethod } from 'credential-status';
 
+interface DecodedStatusListPayload {
+    issuer: string;
+    id: string;
+    statusList: StatusList;
+    exp?: number;
+    ttl?: number;
+    iat: number;
+}
+
+interface IExtractedCredentialDetails {
+    id: string;
+    issuer: string | IIssuer;
+    encodedList: string;
+    decodedPayload?: DecodedStatusListPayload;
+}
+interface IStatusListImplementationResult {
+    id: string;
+    encodedList: string;
+    issuer: string | IIssuer;
+    type: StatusListType;
+    proofFormat: CredentialProofFormat;
+    length: number;
+    statusListCredential: StatusListCredential;
+    statuslistContentType: string;
+    correlationId?: string;
+    driverType?: StatusListDriverType;
+}
+interface IStatusList2021ImplementationResult extends IStatusListImplementationResult {
+    type: StatusListType.StatusList2021;
+    indexingDirection: StatusListIndexingDirection;
+    statusPurpose: StatusPurpose2021;
+}
+interface IOAuthStatusListImplementationResult extends IStatusListImplementationResult {
+    type: StatusListType.OAuthStatusList;
+    bitsPerStatus: number;
+    expiresAt?: Date;
+}
+interface IBitstringStatusListImplementationResult extends IStatusListImplementationResult {
+    type: StatusListType.BitstringStatusList;
+    statusPurpose: BitstringStatusPurpose | BitstringStatusPurpose[];
+    bitsPerStatus?: number;
+    validFrom?: Date;
+    validUntil?: Date;
+    ttl?: number;
+}
+
 declare enum StatusOAuth {
     Valid = 0,
     Invalid = 1,
@@ -16,34 +65,14 @@ declare enum Status2021 {
     Valid = 0,
     Invalid = 1
 }
-type BitstringStatus = {
-    status: string;
-    message?: string;
-    [x: string]: any;
-};
-type BitstringStatusResult = BitstringStatus & {
-    index: number;
-    status: string;
-    set: boolean;
-    message?: string;
-    [x: string]: any;
-};
 type StatusList2021Args = {
     indexingDirection: StatusListIndexingDirection;
     statusPurpose?: StatusPurpose2021;
 };
 type OAuthStatusListArgs = {
-    bitsPerStatus?: BitsPerStatus;
+    bitsPerStatus: BitsPerStatus;
     expiresAt?: Date;
 };
-type BitstringStatusListArgs = {
-    statusPurpose: BitstringStatusPurpose;
-    statusSize?: number;
-    statusMessage?: Array<BitstringStatus>;
-    ttl?: number;
-    validFrom?: Date;
-    validUntil?: Date;
-};
 type BaseCreateNewStatusListArgs = {
     type: StatusListType;
     id: string;
@@ -54,6 +83,7 @@ type BaseCreateNewStatusListArgs = {
     keyRef?: string;
     statusList2021?: StatusList2021Args;
     oauthStatusList?: OAuthStatusListArgs;
+    bitstringStatusList?: BitstringStatusListArgs;
     driverType?: StatusListDriverType;
 };
 type UpdateStatusList2021Args = {
@@ -65,8 +95,7 @@ type UpdateOAuthStatusListArgs = {
 };
 type UpdateBitstringStatusListArgs = {
     statusPurpose: BitstringStatusPurpose;
-    statusSize?: number;
-    statusMessage?: Array<BitstringStatus>;
+    bitsPerStatus: number;
     validFrom?: Date;
     validUntil?: Date;
     ttl?: number;
@@ -74,7 +103,7 @@ type UpdateBitstringStatusListArgs = {
 interface UpdateStatusListFromEncodedListArgs {
     type?: StatusListType;
     statusListIndex: number | string;
-    value: boolean;
+    value: number;
     proofFormat?: CredentialProofFormat;
     keyRef?: string;
     correlationId?: string;
@@ -89,37 +118,34 @@ interface UpdateStatusListFromStatusListCredentialArgs {
     statusListCredential: StatusListCredential;
     keyRef?: string;
     statusListIndex: number | string;
-    value: number | Status2021 | StatusOAuth | BitstringStatus;
+    value: number | Status2021 | StatusOAuth;
 }
 interface StatusListResult {
+    id: string;
     encodedList: string;
-    statusListCredential: StatusListCredential;
-    length: number;
+    issuer: string | IIssuer;
     type: StatusListType;
     proofFormat: CredentialProofFormat;
-    id: string;
+    length: number;
+    statusListCredential: StatusListCredential;
     statuslistContentType: string;
-    issuer: string | IIssuer;
-    statusList2021?: StatusList2021Details;
-    oauthStatusList?: OAuthStatusDetails;
-    bitstringStatusList?: BitstringStatusDetails;
     correlationId?: string;
     driverType?: StatusListDriverType;
-    credentialIdMode?: StatusListCredentialIdMode;
-}
-interface StatusList2021Details {
-    indexingDirection: StatusListIndexingDirection;
-    statusPurpose?: StatusPurpose2021;
-}
-interface OAuthStatusDetails {
-    bitsPerStatus?: BitsPerStatus;
-    expiresAt?: Date;
-}
-interface BitstringStatusDetails {
-    statusPurpose: BitstringStatusPurpose;
-    validFrom?: Date;
-    validUntil?: Date;
-    ttl?: number;
+    statusList2021?: {
+        indexingDirection: StatusListIndexingDirection;
+        statusPurpose: StatusPurpose2021;
+    };
+    oauthStatusList?: {
+        bitsPerStatus: number;
+        expiresAt?: Date;
+    };
+    bitstringStatusList?: {
+        statusPurpose: BitstringStatusPurpose | BitstringStatusPurpose[];
+        bitsPerStatus?: number;
+        validFrom?: Date;
+        validUntil?: Date;
+        ttl?: number;
+    };
 }
 interface StatusList2021EntryCredentialStatus extends ICredentialStatus {
     type: 'StatusList2021Entry';
@@ -134,15 +160,6 @@ interface StatusListOAuthEntryCredentialStatus extends ICredentialStatus {
     statusListCredential: string;
     expiresAt?: Date;
 }
-interface BitstringStatusListEntryCredentialStatus extends ICredentialStatus {
-    type: 'BitstringStatusListEntry';
-    statusPurpose: BitstringStatusPurpose | BitstringStatusPurpose[];
-    statusListIndex: string;
-    statusListCredential: string;
-    statusSize?: number;
-    statusMessage?: Array<BitstringStatus>;
-    statusReference?: string | string[];
-}
 interface StatusList2021ToVerifiableCredentialArgs {
     issuer: string | IIssuer;
     id: string;
@@ -166,19 +183,27 @@ interface CreateStatusListArgs {
 interface UpdateStatusListIndexArgs {
     statusListCredential: StatusListCredential;
     statusListIndex: number | string;
-    value: number | Status2021 | StatusOAuth | BitstringStatus;
+    value: number | Status2021 | StatusOAuth;
+    bitsPerStatus?: number;
     keyRef?: string;
     expiresAt?: Date;
 }
 interface CheckStatusIndexArgs {
     statusListCredential: StatusListCredential;
     statusListIndex: string | number;
+    bitsPerStatus?: number;
 }
-interface ToStatusListDetailsArgs {
-    statusListPayload: StatusListCredential;
+interface IToDetailsFromCredentialArgs {
+    statusListCredential: StatusListCredential;
+    statusListType: StatusListType;
+    bitsPerStatus?: number;
     correlationId?: string;
     driverType?: StatusListDriverType;
 }
+interface IMergeDetailsWithEntityArgs {
+    extractedDetails: IExtractedCredentialDetails;
+    statusListEntity: IStatusListEntity;
+}
 /**
  * The interface definition for a plugin that can add statuslist info to a credential
  *
@@ -251,12 +276,22 @@ type SignedStatusListData = {
     statusListCredential: StatusListCredential;
     encodedList: string;
 };
-type IRequiredPlugins = ICredentialPlugin & IIdentifierResolution;
-type IRequiredContext = IAgentContext<ICredentialIssuer & ICredentialVerifier & IIdentifierResolution & IKeyManager & ICredentialPlugin>;
+type IRequiredPlugins = IVcdmCredentialPlugin & IIdentifierResolution;
+type IRequiredContext = IAgentContext<ICredentialIssuer & ICredentialVerifier & IIdentifierResolution & IKeyManager & IVcdmCredentialPlugin>;
 
+/**
+ * Fetches a status list credential from a URL
+ * @param args - Object containing the status list credential URL
+ * @returns Promise resolving to the fetched StatusListCredential
+ */
 declare function fetchStatusListCredential(args: {
     statusListCredential: string;
 }): Promise<StatusListCredential>;
+/**
+ * Creates a status checking function for credential-status plugin
+ * @param args - Configuration options for status verification
+ * @returns StatusMethod function for checking credential status
+ */
 declare function statusPluginStatusFunction(args: {
     documentLoader: any;
     suite: any;
@@ -267,7 +302,8 @@ declare function statusPluginStatusFunction(args: {
 }): StatusMethod;
 /**
  * Function that can be used together with @digitalbazar/vc and @digitialcredentials/vc
- * @param args
+ * @param args - Configuration options for status verification
+ * @returns Function for checking credential status
  */
 declare function vcLibCheckStatusFunction(args: {
     mandatoryCredentialStatus?: boolean;
@@ -282,6 +318,11 @@ declare function vcLibCheckStatusFunction(args: {
     verified: boolean;
     error?: any;
 }>;
+/**
+ * Checks the status of a credential using its credential status information
+ * @param args - Parameters for credential status verification
+ * @returns Promise resolving to verification result with error details if any
+ */
 declare function checkStatusForCredential(args: {
     credential: StatusListCredential;
     documentLoader: any;
@@ -300,22 +341,61 @@ declare function simpleCheckStatusFromStatusListUrl(args: {
     type?: StatusListType | 'StatusList2021Entry';
     id?: string;
     statusListIndex: string;
-}): Promise<number | Status2021 | StatusOAuth | BitstringStatus>;
+}): Promise<number | Status2021 | StatusOAuth>;
+/**
+ * Checks the status at a specific index in a status list credential
+ * @param args - Parameters including credential and index to check
+ * @returns Promise resolving to status value at the specified index
+ */
 declare function checkStatusIndexFromStatusListCredential(args: {
     statusListCredential: StatusListCredential;
-    statusPurpose?: StatusPurpose2021;
+    statusPurpose?: StatusPurpose2021 | string | string[];
     type?: StatusListType | 'StatusList2021Entry' | 'BitstringStatusListEntry';
     id?: string;
     statusListIndex: string | number;
-}): Promise<number | Status2021 | StatusOAuth | BitstringStatus>;
-declare function createNewStatusList(args: CreateNewStatusListFuncArgs, context: IAgentContext<(ICredentialPlugin | any) & IIdentifierResolution>): Promise<StatusListResult>;
-declare function updateStatusIndexFromStatusListCredential(args: UpdateStatusListIndexArgs, context: IAgentContext<ICredentialPlugin & IIdentifierResolution>): Promise<StatusListResult>;
-declare function statusListCredentialToDetails(args: {
-    statusListCredential: StatusListCredential;
-    correlationId?: string;
-    driverType?: StatusListDriverType;
-}): Promise<StatusListResult>;
-declare function updateStatusListIndexFromEncodedList(args: UpdateStatusListFromEncodedListArgs, context: IAgentContext<ICredentialPlugin & IIdentifierResolution>): Promise<StatusListResult>;
-declare function statusList2021ToVerifiableCredential(args: StatusList2021ToVerifiableCredentialArgs, context: IAgentContext<ICredentialPlugin & IIdentifierResolution>): Promise<StatusListCredential>;
+    bitsPerStatus?: number;
+}): Promise<number | Status2021 | StatusOAuth>;
+declare function createNewStatusList(args: CreateNewStatusListFuncArgs, context: IAgentContext<(IVcdmCredentialPlugin | any) & IIdentifierResolution>): Promise<StatusListResult>;
+/**
+ * Updates a status index in a status list credential
+ * @param args - Parameters for status update including credential and new value
+ * @param context - Agent context with required plugins
+ * @returns Promise resolving to updated status list details
+ */
+declare function updateStatusIndexFromStatusListCredential(args: UpdateStatusListIndexArgs, context: IAgentContext<IVcdmCredentialPlugin & IIdentifierResolution>): Promise<StatusListResult>;
+/**
+ * Extracts credential details from a status list credential
+ * @param statusListCredential - The status list credential to extract from
+ * @returns Promise resolving to extracted credential details
+ */
+declare function extractCredentialDetails(statusListCredential: StatusListCredential): Promise<IExtractedCredentialDetails>;
+declare function toStatusListDetails(args: IToDetailsFromCredentialArgs): Promise<StatusListResult & (IStatusList2021ImplementationResult | IOAuthStatusListImplementationResult | IBitstringStatusListImplementationResult)>;
+declare function toStatusListDetails(args: IMergeDetailsWithEntityArgs): Promise<StatusListResult & (IStatusList2021ImplementationResult | IOAuthStatusListImplementationResult | IBitstringStatusListImplementationResult)>;
+/**
+ * Creates a credential status object from status list and entry information
+ * @param args - Parameters including status list, entry, and index
+ * @returns Promise resolving to appropriate credential status type
+ */
+declare function createCredentialStatusFromStatusList(args: {
+    statusList: StatusListEntity;
+    statusListEntry: IStatusListEntryEntity | IBitstringStatusListEntryEntity;
+    statusListIndex: number;
+}): Promise<StatusList2021EntryCredentialStatus | StatusListOAuthEntryCredentialStatus | BitstringStatusListEntryCredentialStatus>;
+/**
+ * Updates a status list using a base64 encoded list of statuses
+ * @param args - Parameters including encoded list and update details
+ * @param context - Agent context with required plugins
+ * @returns Promise resolving to updated status list details
+ */
+declare function updateStatusListIndexFromEncodedList(args: UpdateStatusListFromEncodedListArgs, context: IAgentContext<IVcdmCredentialPlugin & IIdentifierResolution>): Promise<StatusListResult>;
+/**
+ * Converts a StatusList2021 to a verifiable credential
+ * @param args - Parameters for credential creation including issuer and encoded list
+ * @param context - Agent context with required plugins
+ * @returns Promise resolving to signed status list credential
+ */
+declare function statusList2021ToVerifiableCredential(args: StatusList2021ToVerifiableCredentialArgs, context: IAgentContext<IVcdmCredentialPlugin & IIdentifierResolution>): Promise<StatusListCredential>;
+
+declare function determineStatusListType(credential: StatusListCredential): StatusListType;
 
-export { type BaseCreateNewStatusListArgs, type BitstringStatus, type BitstringStatusListArgs, type BitstringStatusListEntryCredentialStatus, type BitstringStatusResult, type CheckStatusIndexArgs, type CreateNewStatusListArgs, type CreateNewStatusListFuncArgs, type CreateStatusListArgs, type CredentialWithStatusSupport, type GetStatusListArgs, type IAddStatusToCredentialArgs, type IAddStatusToSdJwtCredentialArgs, type IIssueCredentialStatusOpts, type IRequiredContext, type IRequiredPlugins, type IStatusListPlugin, type OAuthStatusListArgs, type SignedStatusListData, Status2021, type StatusList2021Args, type StatusList2021EntryCredentialStatus, type StatusList2021ToVerifiableCredentialArgs, type StatusListOAuthEntryCredentialStatus, type StatusListResult, StatusOAuth, type ToStatusListDetailsArgs, type UpdateBitstringStatusListArgs, type UpdateOAuthStatusListArgs, type UpdateStatusList2021Args, type UpdateStatusListFromEncodedListArgs, type UpdateStatusListFromStatusListCredentialArgs, type UpdateStatusListIndexArgs, checkStatusForCredential, checkStatusIndexFromStatusListCredential, createNewStatusList, fetchStatusListCredential, simpleCheckStatusFromStatusListUrl, statusList2021ToVerifiableCredential, statusListCredentialToDetails, statusPluginStatusFunction, updateStatusIndexFromStatusListCredential, updateStatusListIndexFromEncodedList, vcLibCheckStatusFunction };
+export { type BaseCreateNewStatusListArgs, type CheckStatusIndexArgs, type CreateNewStatusListArgs, type CreateNewStatusListFuncArgs, type CreateStatusListArgs, type CredentialWithStatusSupport, type GetStatusListArgs, type IAddStatusToCredentialArgs, type IAddStatusToSdJwtCredentialArgs, type IIssueCredentialStatusOpts, type IMergeDetailsWithEntityArgs, type IRequiredContext, type IRequiredPlugins, type IStatusListPlugin, type IToDetailsFromCredentialArgs, type OAuthStatusListArgs, type SignedStatusListData, Status2021, type StatusList2021Args, type StatusList2021EntryCredentialStatus, type StatusList2021ToVerifiableCredentialArgs, type StatusListOAuthEntryCredentialStatus, type StatusListResult, StatusOAuth, type UpdateBitstringStatusListArgs, type UpdateOAuthStatusListArgs, type UpdateStatusList2021Args, type UpdateStatusListFromEncodedListArgs, type UpdateStatusListFromStatusListCredentialArgs, type UpdateStatusListIndexArgs, checkStatusForCredential, checkStatusIndexFromStatusListCredential, createCredentialStatusFromStatusList, createNewStatusList, determineStatusListType, extractCredentialDetails, fetchStatusListCredential, simpleCheckStatusFromStatusListUrl, statusList2021ToVerifiableCredential, statusPluginStatusFunction, toStatusListDetails, updateStatusIndexFromStatusListCredential, updateStatusListIndexFromEncodedList, vcLibCheckStatusFunction };