@sphereon/ssi-sdk.vc-status-list-issuer-drivers 0.34.1-feature.SSISDK.17.bitstring.sl.14 → 0.34.1-feature.SSISDK.17.bitstring.sl.16

package/dist/index.cjs

@@ -118,11 +118,23 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
   _statusListStore;
   options;
   _statusListLength;
+  /**
+  * Creates a new AgentDataSourceStatusListDriver instance
+  * @param _dataSource - TypeORM DataSource for database operations
+  * @param _statusListStore - StatusListStore for data persistence
+  * @param options - Driver configuration options
+  */
   constructor(_dataSource, _statusListStore, options) {
     this._dataSource = _dataSource;
     this._statusListStore = _statusListStore;
     this.options = options;
   }
+  /**
+  * Initializes and creates a new AgentDataSourceStatusListDriver instance
+  * @param options - Status list management configuration
+  * @param dbArgs - Database connection arguments
+  * @returns Promise resolving to initialized driver instance
+  */
   static async init(options, dbArgs) {
     if (options.driverType !== import_ssi_types2.StatusListDriverType.AGENT_TYPEORM) {
       throw Error(`TypeORM driver can only be used when the TypeORM driver type is selected in the configuration. Got: ${options.driverType}`);
@@ -145,24 +157,45 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
     statusListStore = new import_ssi_sdk3.StatusListStore(dataSource);
     return new _AgentDataSourceStatusListDriver(dataSource, statusListStore, options);
   }
+  /**
+  * Gets the TypeORM DataSource instance
+  * @returns DataSource instance for database operations
+  */
   get dataSource() {
     if (!this._dataSource) {
       throw Error(`Datasource not available yet for ${this.options.driverOptions?.dbName}`);
     }
     return this._dataSource;
   }
+  /**
+  * Gets the StatusListStore instance
+  * @returns StatusListStore for data persistence operations
+  */
   get statusListStore() {
     if (!this._statusListStore) {
       this._statusListStore = new import_ssi_sdk3.StatusListStore(this.dataSource);
     }
     return this._statusListStore;
   }
+  /**
+  * Gets the driver configuration options
+  * @returns DriverOptions configuration
+  */
   getOptions() {
     return this.options.driverOptions ?? {};
   }
+  /**
+  * Gets the driver type
+  * @returns StatusListDriverType enum value
+  */
   getType() {
     return this.options.driverType;
   }
+  /**
+  * Creates a new status list credential and stores it in the database
+  * @param args - Status list creation parameters
+  * @returns Promise resolving to StatusListResult
+  */
   async createStatusList(args) {
     const correlationId = args.correlationId ?? this.options.correlationId;
     if (!correlationId) {
@@ -186,6 +219,11 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
     this._statusListLength = implementationResult.length;
     return implementationResult;
   }
+  /**
+  * Updates an existing status list credential in the database
+  * @param args - Status list update parameters
+  * @returns Promise resolving to StatusListResult
+  */
   async updateStatusList(args) {
     const correlationId = args.correlationId ?? this.options.correlationId;
     const extractedDetails = await (0, import_ssi_sdk4.extractCredentialDetails)(args.statusListCredential);
@@ -214,6 +252,10 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
       ...details
     };
   }
+  /**
+  * Deletes the status list from the database
+  * @returns Promise resolving to boolean indicating success
+  */
   async deleteStatusList() {
     await this.statusListStore.removeStatusList({
       id: this.options.id,
@@ -221,6 +263,11 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
     });
     return Promise.resolve(true);
   }
+  /**
+  * Updates a status list entry and returns the credential status
+  * @param args - Status list entry update parameters
+  * @returns Promise resolving to credential status and entry
+  */
   async updateStatusListEntry(args) {
     const statusListEntity = statusListResultToEntity(await this.getStatusList());
     const statusListEntry = await this.statusListStore.updateStatusListEntry({
@@ -237,12 +284,27 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
       statusListEntry
     };
   }
+  /**
+  * Retrieves a status list entry by credential ID
+  * @param args - Query parameters including credential ID
+  * @returns Promise resolving to status list entry or undefined
+  */
   async getStatusListEntryByCredentialId(args) {
     return await this.statusListStore.getStatusListEntryByCredentialId(args);
   }
+  /**
+  * Retrieves a status list entry by index
+  * @param args - Query parameters including status list index
+  * @returns Promise resolving to status list entry or undefined
+  */
   async getStatusListEntryByIndex(args) {
     return await this.statusListStore.getStatusListEntryByIndex(args);
   }
+  /**
+  * Generates a random available index for new status list entries
+  * @param args - Optional correlation ID parameter
+  * @returns Promise resolving to available index number
+  */
   async getRandomNewStatusListIndex(args) {
     let result = -1;
     let tries = 0;
@@ -251,6 +313,12 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
     }
     return result;
   }
+  /**
+  * Implementation for generating random status list indices with retry logic
+  * @param tries - Number of attempts made
+  * @param args - Optional correlation ID parameter
+  * @returns Promise resolving to available index or -1 if none found
+  */
   async getRandomNewStatusListIndexImpl(tries, args) {
     const statusListId = this.options.id;
     const correlationId = args?.correlationId ?? this.options.correlationId;
@@ -273,12 +341,22 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
     }
     return -1;
   }
+  /**
+  * Gets the length of the status list
+  * @param args - Optional correlation ID parameter
+  * @returns Promise resolving to status list length
+  */
   async getStatusListLength(args) {
     if (!this._statusListLength) {
       this._statusListLength = await this.getStatusList(args).then((details) => details.length);
     }
     return this._statusListLength;
   }
+  /**
+  * Retrieves the status list details
+  * @param args - Optional correlation ID parameter
+  * @returns Promise resolving to StatusListResult
+  */
   async getStatusList(args) {
     const id = this.options.id;
     const correlationId = args?.correlationId ?? this.options.correlationId;
@@ -294,6 +372,10 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
       driverType: statusListEntity.driverType
     });
   }
+  /**
+  * Retrieves all status lists
+  * @returns Promise resolving to array of StatusListResult
+  */
   async getStatusLists() {
     const statusLists = await this.statusListStore.getStatusLists({});
     return Promise.all(statusLists.map(async (statusListEntity) => {
@@ -306,6 +388,10 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
       });
     }));
   }
+  /**
+  * Checks if a status list index is currently in use
+  * @returns Promise resolving to boolean indicating usage status
+  */
   isStatusListIndexInUse() {
     return Promise.resolve(false);
   }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/drivers.ts","../src/status-list-adapters.ts"],"sourcesContent":["/**\n * @public\n */\nexport * from './types'\nexport * from './drivers'\n","/**\n * StatusList Driver Implementation for TypeORM/Agent Data Sources\n *\n * This module provides the database-backed implementation of the IStatusListDriver interface,\n * handling persistence and retrieval of status list credentials and entries using TypeORM.\n * It delegates status list format-specific operations to the functions layer while managing\n * database interactions, driver configuration, and entity lifecycle.\n *\n * Key responsibilities:\n * - Database connection and store management\n * - Status list CRUD operations\n * - Status list entry management\n * - Random index generation for new entries\n * - Integration with multiple data sources\n *\n * @author Sphereon International B.V.\n * @since 2024\n */\n\nimport { DataSources } from '@sphereon/ssi-sdk.agent-config'\nimport {\n  BitstringStatusListEntryCredentialStatus,\n  IAddStatusListArgs,\n  IAddStatusListEntryArgs,\n  IBitstringStatusListEntryEntity,\n  IGetStatusListEntryByCredentialIdArgs,\n  IGetStatusListEntryByIndexArgs,\n  IStatusListEntryEntity,\n  StatusListEntity,\n  StatusListStore,\n} from '@sphereon/ssi-sdk.data-store'\nimport {\n  createCredentialStatusFromStatusList,\n  extractCredentialDetails,\n  StatusList2021EntryCredentialStatus,\n  StatusListOAuthEntryCredentialStatus,\n  StatusListResult,\n  toStatusListDetails,\n} from '@sphereon/ssi-sdk.vc-status-list'\nimport { StatusListCredential, StatusListCredentialIdMode, StatusListDriverType, StatusListType } from '@sphereon/ssi-types'\nimport { DataSource } from 'typeorm'\nimport { IStatusListDriver } from './types'\nimport { statusListResultToEntity } from './status-list-adapters'\n\nexport interface StatusListManagementOptions {\n  id?: string\n  correlationId?: string\n  driverType: StatusListDriverType\n  driverOptions?: DriverOptions\n}\n\nexport type DriverOptions = TypeORMOptions\n\nexport interface TypeORMOptions {\n  dbName?: string\n}\n\nexport interface FilesystemOptions {\n  path: string // The base path where statusList Credentials will be persisted. Should be a folder and thus not include the VC/StatusList itself\n}\n\nexport function getOptions(args: { id?: string; correlationId?: string; dbName: string }): StatusListManagementOptions {\n  return {\n    id: args.id,\n    correlationId: args.correlationId,\n    driverType: StatusListDriverType.AGENT_TYPEORM,\n    driverOptions: { dbName: args.dbName },\n  }\n}\n\nexport async function getDriver(args: {\n  id?: string\n  correlationId?: string\n  dbName?: string\n  dataSource?: DataSource\n  dataSources?: DataSources\n}): Promise<IStatusListDriver> {\n  const dbName = args.dbName ?? args.dataSource?.name\n  if (!dbName) {\n    throw Error(`Please provide either a DB name or data source`)\n  }\n  const dataSources = args.dataSources ?? DataSources.singleInstance()\n  return await AgentDataSourceStatusListDriver.init(\n    getOptions({\n      ...args,\n      dbName,\n    }),\n    { dataSource: args.dataSource ?? (await dataSources.getDbConnection(dbName)), dataSources },\n  )\n}\n\n/**\n * TypeORM-based implementation of the IStatusListDriver interface\n *\n * Manages status list credentials and entries using a TypeORM data source.\n * Handles database operations while delegating format-specific logic to the functions layer.\n */\nexport class AgentDataSourceStatusListDriver implements IStatusListDriver {\n  private _statusListLength: number | undefined\n\n  constructor(\n    private _dataSource: DataSource,\n    private _statusListStore: StatusListStore,\n    private options: StatusListManagementOptions,\n  ) {}\n\n  public static async init(\n    options: StatusListManagementOptions,\n    dbArgs?: {\n      dataSources?: DataSources\n      dataSource?: DataSource\n    },\n  ): Promise<AgentDataSourceStatusListDriver> {\n    if (options.driverType !== StatusListDriverType.AGENT_TYPEORM) {\n      throw Error(`TypeORM driver can only be used when the TypeORM driver type is selected in the configuration. Got: ${options.driverType}`)\n    } else if (!options.driverOptions) {\n      throw Error(`TypeORM driver can only be used when the TypeORM options are provided.`)\n    }\n    let dataSource: DataSource\n    let statusListStore: StatusListStore\n    if (dbArgs?.dataSource) {\n      dataSource = dbArgs.dataSource\n    } else if (options.driverOptions.dbName) {\n      if (dbArgs?.dataSources) {\n        dataSource = await dbArgs.dataSources.getDbConnection(options.driverOptions.dbName)\n      } else {\n        dataSource = await DataSources.singleInstance().getDbConnection(options.driverOptions.dbName)\n      }\n    } else {\n      return Promise.reject(Error(`Either a datasource or dbName needs to be provided`))\n    }\n\n    statusListStore = new StatusListStore(dataSource)\n    return new AgentDataSourceStatusListDriver(dataSource, statusListStore, options)\n  }\n\n  get dataSource(): DataSource {\n    if (!this._dataSource) {\n      throw Error(`Datasource not available yet for ${this.options.driverOptions?.dbName}`)\n    }\n    return this._dataSource\n  }\n\n  get statusListStore(): StatusListStore {\n    if (!this._statusListStore) {\n      this._statusListStore = new StatusListStore(this.dataSource)\n    }\n    return this._statusListStore\n  }\n\n  getOptions(): DriverOptions {\n    return this.options.driverOptions ?? {}\n  }\n\n  getType(): StatusListDriverType {\n    return this.options.driverType\n  }\n\n  async createStatusList(args: {\n    statusListType: StatusListType\n    statusListCredential: StatusListCredential\n    correlationId?: string\n    credentialIdMode?: StatusListCredentialIdMode\n    bitsPerStatus?: number\n  }): Promise<StatusListResult> {\n    const correlationId = args.correlationId ?? this.options.correlationId\n    if (!correlationId) {\n      throw Error('Either a correlationId needs to be set as an option, or it needs to be provided when creating a status list. None found')\n    }\n    const credentialIdMode = args.credentialIdMode ?? StatusListCredentialIdMode.ISSUANCE\n\n    // Convert credential to implementation details using CREATE/READ context\n    const implementationResult = await toStatusListDetails({\n      statusListCredential: args.statusListCredential,\n      statusListType: args.statusListType,\n      bitsPerStatus: args.bitsPerStatus,\n      correlationId,\n      driverType: this.getType(),\n    })\n\n    // Add driver-specific fields to create complete entity\n    const statusListArgs = {\n      ...implementationResult,\n      credentialIdMode,\n      correlationId,\n      driverType: this.getType(),\n    } as IAddStatusListArgs\n\n    await this.statusListStore.addStatusList(statusListArgs)\n    this._statusListLength = implementationResult.length\n    return implementationResult\n  }\n\n  async updateStatusList(args: { statusListCredential: StatusListCredential; correlationId: string }): Promise<StatusListResult> {\n    const correlationId = args.correlationId ?? this.options.correlationId\n\n    const extractedDetails = await extractCredentialDetails(args.statusListCredential)\n    const entity = await this.statusListStore.getStatusList({\n      id: extractedDetails.id,\n      correlationId,\n    })\n    if (!entity) {\n      throw Error(`Status list ${extractedDetails.id}, correlationId ${correlationId} could not be found`)\n    }\n\n    entity.statusListCredential = args.statusListCredential\n\n    const details = await toStatusListDetails({\n      extractedDetails,\n      statusListEntity: entity,\n    })\n\n    // Merge details with existing entity and driver properties\n    const updateArgs = {\n      ...entity,\n      ...details,\n      correlationId,\n      driverType: this.getType(),\n    } as IAddStatusListArgs\n\n    await this.statusListStore.updateStatusList(updateArgs)\n    this._statusListLength = details.length\n    return { ...entity, ...details }\n  }\n\n  async deleteStatusList(): Promise<boolean> {\n    await this.statusListStore.removeStatusList({ id: this.options.id, correlationId: this.options.correlationId })\n    return Promise.resolve(true)\n  }\n\n  async updateStatusListEntry(args: IAddStatusListEntryArgs): Promise<{\n    credentialStatus: StatusList2021EntryCredentialStatus | StatusListOAuthEntryCredentialStatus | BitstringStatusListEntryCredentialStatus\n    statusListEntry: IStatusListEntryEntity | IBitstringStatusListEntryEntity\n  }> {\n    // Get status list entity\n    const statusListEntity: StatusListEntity = statusListResultToEntity(await this.getStatusList())\n\n    // Update the entry in the store\n    const statusListEntry = await this.statusListStore.updateStatusListEntry({ ...args, statusListId: statusListEntity.id })\n\n    // Use implementation to create the credential status - this moves type-specific logic to implementations\n    const credentialStatus = await createCredentialStatusFromStatusList({\n      statusList: statusListEntity,\n      statusListEntry,\n      statusListIndex: statusListEntry.statusListIndex,\n    })\n\n    return {\n      credentialStatus,\n      statusListEntry,\n    }\n  }\n\n  async getStatusListEntryByCredentialId(\n    args: IGetStatusListEntryByCredentialIdArgs,\n  ): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined> {\n    return await this.statusListStore.getStatusListEntryByCredentialId(args)\n  }\n\n  async getStatusListEntryByIndex(\n    args: IGetStatusListEntryByIndexArgs,\n  ): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined> {\n    return await this.statusListStore.getStatusListEntryByIndex(args)\n  }\n\n  async getRandomNewStatusListIndex(args?: { correlationId?: string }): Promise<number> {\n    let result = -1\n    let tries = 0\n    while (result < 0) {\n      // no tries guard, because we will throw an error when they are exhausted anyway\n      result = await this.getRandomNewStatusListIndexImpl(tries++, args)\n    }\n    return result\n  }\n\n  private async getRandomNewStatusListIndexImpl(tries: number, args?: { correlationId?: string }): Promise<number> {\n    const statusListId = this.options.id\n    const correlationId = args?.correlationId ?? this.options.correlationId\n    if (tries >= 10) {\n      throw Error(`We could not find any random status list index that is available in the statuslist ${statusListId}`)\n    }\n    // TODO: Check against DB\n    const length = await this.getStatusListLength(args)\n    const statusListIndex = Array.from({ length: 20 }, () => Math.floor(Math.random() * length))\n    const available = await this.statusListStore.availableStatusListEntries({\n      statusListId,\n      ...(correlationId && { correlationId }),\n      statusListIndex,\n    })\n    if (available.length > 0) {\n      return available[0] // doesn't matter we pick the first element, as they are all random anyway\n    }\n    return -1\n  }\n\n  async getStatusListLength(args?: { correlationId?: string }): Promise<number> {\n    if (!this._statusListLength) {\n      this._statusListLength = await this.getStatusList(args).then((details) => details.length)\n    }\n    return this._statusListLength!\n  }\n\n  async getStatusList(args?: { correlationId?: string }): Promise<StatusListResult> {\n    const id = this.options.id\n    const correlationId = args?.correlationId ?? this.options.correlationId\n\n    const statusListEntity = await this.statusListStore.getStatusList({ id, correlationId })\n\n    // Convert entity to result using CREATE/READ context\n    return await toStatusListDetails({\n      statusListCredential: statusListEntity.statusListCredential!,\n      statusListType: statusListEntity.type,\n      bitsPerStatus: statusListEntity.bitsPerStatus,\n      correlationId: statusListEntity.correlationId,\n      driverType: statusListEntity.driverType,\n    })\n  }\n\n  async getStatusLists(): Promise<Array<StatusListResult>> {\n    const statusLists = await this.statusListStore.getStatusLists({})\n    return Promise.all(\n      statusLists.map(async (statusListEntity) => {\n        return toStatusListDetails({\n          statusListCredential: statusListEntity.statusListCredential!,\n          statusListType: statusListEntity.type,\n          bitsPerStatus: statusListEntity.bitsPerStatus,\n          correlationId: statusListEntity.correlationId,\n          driverType: statusListEntity.driverType,\n        })\n      }),\n    )\n  }\n\n  isStatusListIndexInUse(): Promise<boolean> {\n    return Promise.resolve(false)\n  }\n}\n","import { StatusListType } from '@sphereon/ssi-types'\nimport { BitstringStatusListEntity, OAuthStatusListEntity, StatusList2021Entity } from '@sphereon/ssi-sdk.data-store'\nimport { StatusListResult } from '@sphereon/ssi-sdk.vc-status-list'\n\nexport function statusListResultToEntity(result: StatusListResult): StatusList2021Entity | OAuthStatusListEntity | BitstringStatusListEntity {\n  const baseFields = {\n    id: result.id,\n    correlationId: result.correlationId,\n    driverType: result.driverType,\n    credentialIdMode: result.credentialIdMode,\n    length: result.length,\n    issuer: result.issuer,\n    type: result.type,\n    proofFormat: result.proofFormat,\n    statusListCredential: result.statusListCredential,\n  }\n\n  if (result.type === StatusListType.StatusList2021) {\n    if (!result.statusList2021) {\n      throw new Error('Missing statusList2021 details')\n    }\n    return Object.assign(new StatusList2021Entity(), {\n      ...baseFields,\n      indexingDirection: result.statusList2021.indexingDirection,\n      statusPurpose: result.statusList2021.statusPurpose,\n    })\n  } else if (result.type === StatusListType.OAuthStatusList) {\n    if (!result.oauthStatusList) {\n      throw new Error('Missing oauthStatusList details')\n    }\n    return Object.assign(new OAuthStatusListEntity(), {\n      ...baseFields,\n      bitsPerStatus: result.oauthStatusList.bitsPerStatus,\n      expiresAt: result.oauthStatusList.expiresAt,\n    })\n  } else if (result.type === StatusListType.BitstringStatusList) {\n    if (!result.bitstringStatusList) {\n      throw new Error('Missing bitstringStatusList details')\n    }\n    return Object.assign(new BitstringStatusListEntity(), {\n      ...baseFields,\n      statusPurpose: result.bitstringStatusList.statusPurpose,\n      ttl: result.bitstringStatusList.ttl,\n      bitsPerStatus: result.bitstringStatusList.bitsPerStatus,\n      validFrom: result.bitstringStatusList.validFrom,\n      validUntil: result.bitstringStatusList.validUntil,\n    })\n  }\n  throw new Error(`Unsupported status list type: ${result.type}`)\n}\n"],"mappings":"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","names":["import_ssi_sdk","import_ssi_types","statusListResultToEntity","result","baseFields","id","correlationId","driverType","credentialIdMode","length","issuer","type","proofFormat","statusListCredential","StatusListType","StatusList2021","statusList2021","Error","Object","assign","StatusList2021Entity","indexingDirection","statusPurpose","OAuthStatusList","oauthStatusList","OAuthStatusListEntity","bitsPerStatus","expiresAt","BitstringStatusList","bitstringStatusList","BitstringStatusListEntity","ttl","validFrom","validUntil","getOptions","args","id","correlationId","driverType","StatusListDriverType","AGENT_TYPEORM","driverOptions","dbName","getDriver","dataSource","name","Error","dataSources","DataSources","singleInstance","AgentDataSourceStatusListDriver","init","getDbConnection","_statusListLength","constructor","_dataSource","_statusListStore","options","dbArgs","statusListStore","Promise","reject","StatusListStore","getType","createStatusList","credentialIdMode","StatusListCredentialIdMode","ISSUANCE","implementationResult","toStatusListDetails","statusListCredential","statusListType","bitsPerStatus","statusListArgs","addStatusList","length","updateStatusList","extractedDetails","extractCredentialDetails","entity","getStatusList","details","statusListEntity","updateArgs","deleteStatusList","removeStatusList","resolve","updateStatusListEntry","statusListResultToEntity","statusListEntry","statusListId","credentialStatus","createCredentialStatusFromStatusList","statusList","statusListIndex","getStatusListEntryByCredentialId","getStatusListEntryByIndex","getRandomNewStatusListIndex","result","tries","getRandomNewStatusListIndexImpl","getStatusListLength","Array","from","Math","floor","random","available","availableStatusListEntries","then","type","getStatusLists","statusLists","all","map","isStatusListIndexInUse"]}
+{"version":3,"sources":["../src/index.ts","../src/drivers.ts","../src/status-list-adapters.ts"],"sourcesContent":["/**\n * @public\n */\nexport * from './types'\nexport * from './drivers'\n","/**\n * StatusList Driver Implementation for TypeORM/Agent Data Sources\n *\n * This module provides the database-backed implementation of the IStatusListDriver interface,\n * handling persistence and retrieval of status list credentials and entries using TypeORM.\n * It delegates status list format-specific operations to the functions layer while managing\n * database interactions, driver configuration, and entity lifecycle.\n *\n * Key responsibilities:\n * - Database connection and store management\n * - Status list CRUD operations\n * - Status list entry management\n * - Random index generation for new entries\n * - Integration with multiple data sources\n *\n * @author Sphereon International B.V.\n * @since 2024\n */\n\nimport { DataSources } from '@sphereon/ssi-sdk.agent-config'\nimport {\n  BitstringStatusListEntryCredentialStatus,\n  IAddStatusListArgs,\n  IAddStatusListEntryArgs,\n  IBitstringStatusListEntryEntity,\n  IGetStatusListEntryByCredentialIdArgs,\n  IGetStatusListEntryByIndexArgs,\n  IStatusListEntryEntity,\n  StatusListEntity,\n  StatusListStore,\n} from '@sphereon/ssi-sdk.data-store'\nimport {\n  createCredentialStatusFromStatusList,\n  extractCredentialDetails,\n  StatusList2021EntryCredentialStatus,\n  StatusListOAuthEntryCredentialStatus,\n  StatusListResult,\n  toStatusListDetails,\n} from '@sphereon/ssi-sdk.vc-status-list'\nimport { StatusListCredential, StatusListCredentialIdMode, StatusListDriverType, StatusListType } from '@sphereon/ssi-types'\nimport { DataSource } from 'typeorm'\nimport { IStatusListDriver } from './types'\nimport { statusListResultToEntity } from './status-list-adapters'\n\n/**\n * Configuration options for status list management\n */\nexport interface StatusListManagementOptions {\n  id?: string\n  correlationId?: string\n  driverType: StatusListDriverType\n  driverOptions?: DriverOptions\n}\n\nexport type DriverOptions = TypeORMOptions\n\n/**\n * TypeORM-specific configuration options\n */\nexport interface TypeORMOptions {\n  dbName?: string\n}\n\n/**\n * Filesystem-specific configuration options\n */\nexport interface FilesystemOptions {\n  path: string // The base path where statusList Credentials will be persisted. Should be a folder and thus not include the VC/StatusList itself\n}\n\n/**\n * Creates status list management options for TypeORM driver\n * @param args - Configuration parameters including id, correlationId, and database name\n * @returns StatusListManagementOptions configured for TypeORM\n */\nexport function getOptions(args: { id?: string; correlationId?: string; dbName: string }): StatusListManagementOptions {\n  return {\n    id: args.id,\n    correlationId: args.correlationId,\n    driverType: StatusListDriverType.AGENT_TYPEORM,\n    driverOptions: { dbName: args.dbName },\n  }\n}\n\n/**\n * Creates and initializes a status list driver instance\n * @param args - Configuration parameters including database connection details\n * @returns Promise resolving to initialized IStatusListDriver instance\n */\nexport async function getDriver(args: {\n  id?: string\n  correlationId?: string\n  dbName?: string\n  dataSource?: DataSource\n  dataSources?: DataSources\n}): Promise<IStatusListDriver> {\n  const dbName = args.dbName ?? args.dataSource?.name\n  if (!dbName) {\n    throw Error(`Please provide either a DB name or data source`)\n  }\n  const dataSources = args.dataSources ?? DataSources.singleInstance()\n  return await AgentDataSourceStatusListDriver.init(\n    getOptions({\n      ...args,\n      dbName,\n    }),\n    { dataSource: args.dataSource ?? (await dataSources.getDbConnection(dbName)), dataSources },\n  )\n}\n\n/**\n * TypeORM-based implementation of the IStatusListDriver interface\n *\n * Manages status list credentials and entries using a TypeORM data source.\n * Handles database operations while delegating format-specific logic to the functions layer.\n */\nexport class AgentDataSourceStatusListDriver implements IStatusListDriver {\n  private _statusListLength: number | undefined\n\n  /**\n   * Creates a new AgentDataSourceStatusListDriver instance\n   * @param _dataSource - TypeORM DataSource for database operations\n   * @param _statusListStore - StatusListStore for data persistence\n   * @param options - Driver configuration options\n   */\n  constructor(\n    private _dataSource: DataSource,\n    private _statusListStore: StatusListStore,\n    private options: StatusListManagementOptions,\n  ) {}\n\n  /**\n   * Initializes and creates a new AgentDataSourceStatusListDriver instance\n   * @param options - Status list management configuration\n   * @param dbArgs - Database connection arguments\n   * @returns Promise resolving to initialized driver instance\n   */\n  public static async init(\n    options: StatusListManagementOptions,\n    dbArgs?: {\n      dataSources?: DataSources\n      dataSource?: DataSource\n    },\n  ): Promise<AgentDataSourceStatusListDriver> {\n    if (options.driverType !== StatusListDriverType.AGENT_TYPEORM) {\n      throw Error(`TypeORM driver can only be used when the TypeORM driver type is selected in the configuration. Got: ${options.driverType}`)\n    } else if (!options.driverOptions) {\n      throw Error(`TypeORM driver can only be used when the TypeORM options are provided.`)\n    }\n    let dataSource: DataSource\n    let statusListStore: StatusListStore\n    if (dbArgs?.dataSource) {\n      dataSource = dbArgs.dataSource\n    } else if (options.driverOptions.dbName) {\n      if (dbArgs?.dataSources) {\n        dataSource = await dbArgs.dataSources.getDbConnection(options.driverOptions.dbName)\n      } else {\n        dataSource = await DataSources.singleInstance().getDbConnection(options.driverOptions.dbName)\n      }\n    } else {\n      return Promise.reject(Error(`Either a datasource or dbName needs to be provided`))\n    }\n\n    statusListStore = new StatusListStore(dataSource)\n    return new AgentDataSourceStatusListDriver(dataSource, statusListStore, options)\n  }\n\n  /**\n   * Gets the TypeORM DataSource instance\n   * @returns DataSource instance for database operations\n   */\n  get dataSource(): DataSource {\n    if (!this._dataSource) {\n      throw Error(`Datasource not available yet for ${this.options.driverOptions?.dbName}`)\n    }\n    return this._dataSource\n  }\n\n  /**\n   * Gets the StatusListStore instance\n   * @returns StatusListStore for data persistence operations\n   */\n  get statusListStore(): StatusListStore {\n    if (!this._statusListStore) {\n      this._statusListStore = new StatusListStore(this.dataSource)\n    }\n    return this._statusListStore\n  }\n\n  /**\n   * Gets the driver configuration options\n   * @returns DriverOptions configuration\n   */\n  getOptions(): DriverOptions {\n    return this.options.driverOptions ?? {}\n  }\n\n  /**\n   * Gets the driver type\n   * @returns StatusListDriverType enum value\n   */\n  getType(): StatusListDriverType {\n    return this.options.driverType\n  }\n\n  /**\n   * Creates a new status list credential and stores it in the database\n   * @param args - Status list creation parameters\n   * @returns Promise resolving to StatusListResult\n   */\n  async createStatusList(args: {\n    statusListType: StatusListType\n    statusListCredential: StatusListCredential\n    correlationId?: string\n    credentialIdMode?: StatusListCredentialIdMode\n    bitsPerStatus?: number\n  }): Promise<StatusListResult> {\n    const correlationId = args.correlationId ?? this.options.correlationId\n    if (!correlationId) {\n      throw Error('Either a correlationId needs to be set as an option, or it needs to be provided when creating a status list. None found')\n    }\n    const credentialIdMode = args.credentialIdMode ?? StatusListCredentialIdMode.ISSUANCE\n\n    // Convert credential to implementation details using CREATE/READ context\n    const implementationResult = await toStatusListDetails({\n      statusListCredential: args.statusListCredential,\n      statusListType: args.statusListType,\n      bitsPerStatus: args.bitsPerStatus,\n      correlationId,\n      driverType: this.getType(),\n    })\n\n    // Add driver-specific fields to create complete entity\n    const statusListArgs = {\n      ...implementationResult,\n      credentialIdMode,\n      correlationId,\n      driverType: this.getType(),\n    } as IAddStatusListArgs\n\n    await this.statusListStore.addStatusList(statusListArgs)\n    this._statusListLength = implementationResult.length\n    return implementationResult\n  }\n\n  /**\n   * Updates an existing status list credential in the database\n   * @param args - Status list update parameters\n   * @returns Promise resolving to StatusListResult\n   */\n  async updateStatusList(args: { statusListCredential: StatusListCredential; correlationId: string }): Promise<StatusListResult> {\n    const correlationId = args.correlationId ?? this.options.correlationId\n\n    const extractedDetails = await extractCredentialDetails(args.statusListCredential)\n    const entity = await this.statusListStore.getStatusList({\n      id: extractedDetails.id,\n      correlationId,\n    })\n    if (!entity) {\n      throw Error(`Status list ${extractedDetails.id}, correlationId ${correlationId} could not be found`)\n    }\n\n    entity.statusListCredential = args.statusListCredential\n\n    const details = await toStatusListDetails({\n      extractedDetails,\n      statusListEntity: entity,\n    })\n\n    // Merge details with existing entity and driver properties\n    const updateArgs = {\n      ...entity,\n      ...details,\n      correlationId,\n      driverType: this.getType(),\n    } as IAddStatusListArgs\n\n    await this.statusListStore.updateStatusList(updateArgs)\n    this._statusListLength = details.length\n    return { ...entity, ...details }\n  }\n\n  /**\n   * Deletes the status list from the database\n   * @returns Promise resolving to boolean indicating success\n   */\n  async deleteStatusList(): Promise<boolean> {\n    await this.statusListStore.removeStatusList({ id: this.options.id, correlationId: this.options.correlationId })\n    return Promise.resolve(true)\n  }\n\n  /**\n   * Updates a status list entry and returns the credential status\n   * @param args - Status list entry update parameters\n   * @returns Promise resolving to credential status and entry\n   */\n  async updateStatusListEntry(args: IAddStatusListEntryArgs): Promise<{\n    credentialStatus: StatusList2021EntryCredentialStatus | StatusListOAuthEntryCredentialStatus | BitstringStatusListEntryCredentialStatus\n    statusListEntry: IStatusListEntryEntity | IBitstringStatusListEntryEntity\n  }> {\n    // Get status list entity\n    const statusListEntity: StatusListEntity = statusListResultToEntity(await this.getStatusList())\n\n    // Update the entry in the store\n    const statusListEntry = await this.statusListStore.updateStatusListEntry({ ...args, statusListId: statusListEntity.id })\n\n    // Use implementation to create the credential status - this moves type-specific logic to implementations\n    const credentialStatus = await createCredentialStatusFromStatusList({\n      statusList: statusListEntity,\n      statusListEntry,\n      statusListIndex: statusListEntry.statusListIndex,\n    })\n\n    return {\n      credentialStatus,\n      statusListEntry,\n    }\n  }\n\n  /**\n   * Retrieves a status list entry by credential ID\n   * @param args - Query parameters including credential ID\n   * @returns Promise resolving to status list entry or undefined\n   */\n  async getStatusListEntryByCredentialId(\n    args: IGetStatusListEntryByCredentialIdArgs,\n  ): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined> {\n    return await this.statusListStore.getStatusListEntryByCredentialId(args)\n  }\n\n  /**\n   * Retrieves a status list entry by index\n   * @param args - Query parameters including status list index\n   * @returns Promise resolving to status list entry or undefined\n   */\n  async getStatusListEntryByIndex(\n    args: IGetStatusListEntryByIndexArgs,\n  ): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined> {\n    return await this.statusListStore.getStatusListEntryByIndex(args)\n  }\n\n  /**\n   * Generates a random available index for new status list entries\n   * @param args - Optional correlation ID parameter\n   * @returns Promise resolving to available index number\n   */\n  async getRandomNewStatusListIndex(args?: { correlationId?: string }): Promise<number> {\n    let result = -1\n    let tries = 0\n    while (result < 0) {\n      // no tries guard, because we will throw an error when they are exhausted anyway\n      result = await this.getRandomNewStatusListIndexImpl(tries++, args)\n    }\n    return result\n  }\n\n  /**\n   * Implementation for generating random status list indices with retry logic\n   * @param tries - Number of attempts made\n   * @param args - Optional correlation ID parameter\n   * @returns Promise resolving to available index or -1 if none found\n   */\n  private async getRandomNewStatusListIndexImpl(tries: number, args?: { correlationId?: string }): Promise<number> {\n    const statusListId = this.options.id\n    const correlationId = args?.correlationId ?? this.options.correlationId\n    if (tries >= 10) {\n      throw Error(`We could not find any random status list index that is available in the statuslist ${statusListId}`)\n    }\n    // TODO: Check against DB\n    const length = await this.getStatusListLength(args)\n    const statusListIndex = Array.from({ length: 20 }, () => Math.floor(Math.random() * length))\n    const available = await this.statusListStore.availableStatusListEntries({\n      statusListId,\n      ...(correlationId && { correlationId }),\n      statusListIndex,\n    })\n    if (available.length > 0) {\n      return available[0] // doesn't matter we pick the first element, as they are all random anyway\n    }\n    return -1\n  }\n\n  /**\n   * Gets the length of the status list\n   * @param args - Optional correlation ID parameter\n   * @returns Promise resolving to status list length\n   */\n  async getStatusListLength(args?: { correlationId?: string }): Promise<number> {\n    if (!this._statusListLength) {\n      this._statusListLength = await this.getStatusList(args).then((details) => details.length)\n    }\n    return this._statusListLength!\n  }\n\n  /**\n   * Retrieves the status list details\n   * @param args - Optional correlation ID parameter\n   * @returns Promise resolving to StatusListResult\n   */\n  async getStatusList(args?: { correlationId?: string }): Promise<StatusListResult> {\n    const id = this.options.id\n    const correlationId = args?.correlationId ?? this.options.correlationId\n\n    const statusListEntity = await this.statusListStore.getStatusList({ id, correlationId })\n\n    // Convert entity to result using CREATE/READ context\n    return await toStatusListDetails({\n      statusListCredential: statusListEntity.statusListCredential!,\n      statusListType: statusListEntity.type,\n      bitsPerStatus: statusListEntity.bitsPerStatus,\n      correlationId: statusListEntity.correlationId,\n      driverType: statusListEntity.driverType,\n    })\n  }\n\n  /**\n   * Retrieves all status lists\n   * @returns Promise resolving to array of StatusListResult\n   */\n  async getStatusLists(): Promise<Array<StatusListResult>> {\n    const statusLists = await this.statusListStore.getStatusLists({})\n    return Promise.all(\n      statusLists.map(async (statusListEntity) => {\n        return toStatusListDetails({\n          statusListCredential: statusListEntity.statusListCredential!,\n          statusListType: statusListEntity.type,\n          bitsPerStatus: statusListEntity.bitsPerStatus,\n          correlationId: statusListEntity.correlationId,\n          driverType: statusListEntity.driverType,\n        })\n      }),\n    )\n  }\n\n  /**\n   * Checks if a status list index is currently in use\n   * @returns Promise resolving to boolean indicating usage status\n   */\n  isStatusListIndexInUse(): Promise<boolean> {\n    return Promise.resolve(false)\n  }\n}\n","import { StatusListType } from '@sphereon/ssi-types'\nimport { BitstringStatusListEntity, OAuthStatusListEntity, StatusList2021Entity } from '@sphereon/ssi-sdk.data-store'\nimport { StatusListResult } from '@sphereon/ssi-sdk.vc-status-list'\n\nexport function statusListResultToEntity(result: StatusListResult): StatusList2021Entity | OAuthStatusListEntity | BitstringStatusListEntity {\n  const baseFields = {\n    id: result.id,\n    correlationId: result.correlationId,\n    driverType: result.driverType,\n    credentialIdMode: result.credentialIdMode,\n    length: result.length,\n    issuer: result.issuer,\n    type: result.type,\n    proofFormat: result.proofFormat,\n    statusListCredential: result.statusListCredential,\n  }\n\n  if (result.type === StatusListType.StatusList2021) {\n    if (!result.statusList2021) {\n      throw new Error('Missing statusList2021 details')\n    }\n    return Object.assign(new StatusList2021Entity(), {\n      ...baseFields,\n      indexingDirection: result.statusList2021.indexingDirection,\n      statusPurpose: result.statusList2021.statusPurpose,\n    })\n  } else if (result.type === StatusListType.OAuthStatusList) {\n    if (!result.oauthStatusList) {\n      throw new Error('Missing oauthStatusList details')\n    }\n    return Object.assign(new OAuthStatusListEntity(), {\n      ...baseFields,\n      bitsPerStatus: result.oauthStatusList.bitsPerStatus,\n      expiresAt: result.oauthStatusList.expiresAt,\n    })\n  } else if (result.type === StatusListType.BitstringStatusList) {\n    if (!result.bitstringStatusList) {\n      throw new Error('Missing bitstringStatusList details')\n    }\n    return Object.assign(new BitstringStatusListEntity(), {\n      ...baseFields,\n      statusPurpose: result.bitstringStatusList.statusPurpose,\n      ttl: result.bitstringStatusList.ttl,\n      bitsPerStatus: result.bitstringStatusList.bitsPerStatus,\n      validFrom: result.bitstringStatusList.validFrom,\n      validUntil: result.bitstringStatusList.validUntil,\n    })\n  }\n  throw new Error(`Unsupported status list type: ${result.type}`)\n}\n"],"mappings":"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","names":["import_ssi_sdk","import_ssi_types","statusListResultToEntity","result","baseFields","id","correlationId","driverType","credentialIdMode","length","issuer","type","proofFormat","statusListCredential","StatusListType","StatusList2021","statusList2021","Error","Object","assign","StatusList2021Entity","indexingDirection","statusPurpose","OAuthStatusList","oauthStatusList","OAuthStatusListEntity","bitsPerStatus","expiresAt","BitstringStatusList","bitstringStatusList","BitstringStatusListEntity","ttl","validFrom","validUntil","getOptions","args","id","correlationId","driverType","StatusListDriverType","AGENT_TYPEORM","driverOptions","dbName","getDriver","dataSource","name","Error","dataSources","DataSources","singleInstance","AgentDataSourceStatusListDriver","init","getDbConnection","_statusListLength","constructor","_dataSource","_statusListStore","options","dbArgs","statusListStore","Promise","reject","StatusListStore","getType","createStatusList","credentialIdMode","StatusListCredentialIdMode","ISSUANCE","implementationResult","toStatusListDetails","statusListCredential","statusListType","bitsPerStatus","statusListArgs","addStatusList","length","updateStatusList","extractedDetails","extractCredentialDetails","entity","getStatusList","details","statusListEntity","updateArgs","deleteStatusList","removeStatusList","resolve","updateStatusListEntry","statusListResultToEntity","statusListEntry","statusListId","credentialStatus","createCredentialStatusFromStatusList","statusList","statusListIndex","getStatusListEntryByCredentialId","getStatusListEntryByIndex","getRandomNewStatusListIndex","result","tries","getRandomNewStatusListIndexImpl","getStatusListLength","Array","from","Math","floor","random","available","availableStatusListEntries","then","type","getStatusLists","statusLists","all","map","isStatusListIndexInUse"]}

package/dist/index.d.cts

@@ -26,6 +26,9 @@ import { IVcdmCredentialPlugin } from '@sphereon/ssi-sdk.credential-vcdm';
  * @since 2024
  */
 
+/**
+ * Configuration options for status list management
+ */
 interface StatusListManagementOptions {
     id?: string;
     correlationId?: string;
@@ -33,17 +36,33 @@ interface StatusListManagementOptions {
     driverOptions?: DriverOptions;
 }
 type DriverOptions = TypeORMOptions;
+/**
+ * TypeORM-specific configuration options
+ */
 interface TypeORMOptions {
     dbName?: string;
 }
+/**
+ * Filesystem-specific configuration options
+ */
 interface FilesystemOptions {
     path: string;
 }
+/**
+ * Creates status list management options for TypeORM driver
+ * @param args - Configuration parameters including id, correlationId, and database name
+ * @returns StatusListManagementOptions configured for TypeORM
+ */
 declare function getOptions(args: {
     id?: string;
     correlationId?: string;
     dbName: string;
 }): StatusListManagementOptions;
+/**
+ * Creates and initializes a status list driver instance
+ * @param args - Configuration parameters including database connection details
+ * @returns Promise resolving to initialized IStatusListDriver instance
+ */
 declare function getDriver(args: {
     id?: string;
     correlationId?: string;
@@ -62,15 +81,48 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
     private _statusListStore;
     private options;
     private _statusListLength;
+    /**
+     * Creates a new AgentDataSourceStatusListDriver instance
+     * @param _dataSource - TypeORM DataSource for database operations
+     * @param _statusListStore - StatusListStore for data persistence
+     * @param options - Driver configuration options
+     */
     constructor(_dataSource: DataSource, _statusListStore: StatusListStore, options: StatusListManagementOptions);
+    /**
+     * Initializes and creates a new AgentDataSourceStatusListDriver instance
+     * @param options - Status list management configuration
+     * @param dbArgs - Database connection arguments
+     * @returns Promise resolving to initialized driver instance
+     */
     static init(options: StatusListManagementOptions, dbArgs?: {
         dataSources?: DataSources;
         dataSource?: DataSource;
     }): Promise<AgentDataSourceStatusListDriver>;
+    /**
+     * Gets the TypeORM DataSource instance
+     * @returns DataSource instance for database operations
+     */
     get dataSource(): DataSource;
+    /**
+     * Gets the StatusListStore instance
+     * @returns StatusListStore for data persistence operations
+     */
     get statusListStore(): StatusListStore;
+    /**
+     * Gets the driver configuration options
+     * @returns DriverOptions configuration
+     */
     getOptions(): DriverOptions;
+    /**
+     * Gets the driver type
+     * @returns StatusListDriverType enum value
+     */
     getType(): StatusListDriverType;
+    /**
+     * Creates a new status list credential and stores it in the database
+     * @param args - Status list creation parameters
+     * @returns Promise resolving to StatusListResult
+     */
     createStatusList(args: {
         statusListType: StatusListType;
         statusListCredential: StatusListCredential;
@@ -78,28 +130,81 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
         credentialIdMode?: StatusListCredentialIdMode;
         bitsPerStatus?: number;
     }): Promise<StatusListResult>;
+    /**
+     * Updates an existing status list credential in the database
+     * @param args - Status list update parameters
+     * @returns Promise resolving to StatusListResult
+     */
     updateStatusList(args: {
         statusListCredential: StatusListCredential;
         correlationId: string;
     }): Promise<StatusListResult>;
+    /**
+     * Deletes the status list from the database
+     * @returns Promise resolving to boolean indicating success
+     */
     deleteStatusList(): Promise<boolean>;
+    /**
+     * Updates a status list entry and returns the credential status
+     * @param args - Status list entry update parameters
+     * @returns Promise resolving to credential status and entry
+     */
     updateStatusListEntry(args: IAddStatusListEntryArgs): Promise<{
         credentialStatus: StatusList2021EntryCredentialStatus | StatusListOAuthEntryCredentialStatus | BitstringStatusListEntryCredentialStatus;
         statusListEntry: IStatusListEntryEntity | IBitstringStatusListEntryEntity;
     }>;
+    /**
+     * Retrieves a status list entry by credential ID
+     * @param args - Query parameters including credential ID
+     * @returns Promise resolving to status list entry or undefined
+     */
     getStatusListEntryByCredentialId(args: IGetStatusListEntryByCredentialIdArgs): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined>;
+    /**
+     * Retrieves a status list entry by index
+     * @param args - Query parameters including status list index
+     * @returns Promise resolving to status list entry or undefined
+     */
     getStatusListEntryByIndex(args: IGetStatusListEntryByIndexArgs): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined>;
+    /**
+     * Generates a random available index for new status list entries
+     * @param args - Optional correlation ID parameter
+     * @returns Promise resolving to available index number
+     */
     getRandomNewStatusListIndex(args?: {
         correlationId?: string;
     }): Promise<number>;
+    /**
+     * Implementation for generating random status list indices with retry logic
+     * @param tries - Number of attempts made
+     * @param args - Optional correlation ID parameter
+     * @returns Promise resolving to available index or -1 if none found
+     */
     private getRandomNewStatusListIndexImpl;
+    /**
+     * Gets the length of the status list
+     * @param args - Optional correlation ID parameter
+     * @returns Promise resolving to status list length
+     */
     getStatusListLength(args?: {
         correlationId?: string;
     }): Promise<number>;
+    /**
+     * Retrieves the status list details
+     * @param args - Optional correlation ID parameter
+     * @returns Promise resolving to StatusListResult
+     */
     getStatusList(args?: {
         correlationId?: string;
     }): Promise<StatusListResult>;
+    /**
+     * Retrieves all status lists
+     * @returns Promise resolving to array of StatusListResult
+     */
     getStatusLists(): Promise<Array<StatusListResult>>;
+    /**
+     * Checks if a status list index is currently in use
+     * @returns Promise resolving to boolean indicating usage status
+     */
     isStatusListIndexInUse(): Promise<boolean>;
 }
 

package/dist/index.d.ts

@@ -26,6 +26,9 @@ import { IVcdmCredentialPlugin } from '@sphereon/ssi-sdk.credential-vcdm';
  * @since 2024
  */
 
+/**
+ * Configuration options for status list management
+ */
 interface StatusListManagementOptions {
     id?: string;
     correlationId?: string;
@@ -33,17 +36,33 @@ interface StatusListManagementOptions {
     driverOptions?: DriverOptions;
 }
 type DriverOptions = TypeORMOptions;
+/**
+ * TypeORM-specific configuration options
+ */
 interface TypeORMOptions {
     dbName?: string;
 }
+/**
+ * Filesystem-specific configuration options
+ */
 interface FilesystemOptions {
     path: string;
 }
+/**
+ * Creates status list management options for TypeORM driver
+ * @param args - Configuration parameters including id, correlationId, and database name
+ * @returns StatusListManagementOptions configured for TypeORM
+ */
 declare function getOptions(args: {
     id?: string;
     correlationId?: string;
     dbName: string;
 }): StatusListManagementOptions;
+/**
+ * Creates and initializes a status list driver instance
+ * @param args - Configuration parameters including database connection details
+ * @returns Promise resolving to initialized IStatusListDriver instance
+ */
 declare function getDriver(args: {
     id?: string;
     correlationId?: string;
@@ -62,15 +81,48 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
     private _statusListStore;
     private options;
     private _statusListLength;
+    /**
+     * Creates a new AgentDataSourceStatusListDriver instance
+     * @param _dataSource - TypeORM DataSource for database operations
+     * @param _statusListStore - StatusListStore for data persistence
+     * @param options - Driver configuration options
+     */
     constructor(_dataSource: DataSource, _statusListStore: StatusListStore, options: StatusListManagementOptions);
+    /**
+     * Initializes and creates a new AgentDataSourceStatusListDriver instance
+     * @param options - Status list management configuration
+     * @param dbArgs - Database connection arguments
+     * @returns Promise resolving to initialized driver instance
+     */
     static init(options: StatusListManagementOptions, dbArgs?: {
         dataSources?: DataSources;
         dataSource?: DataSource;
     }): Promise<AgentDataSourceStatusListDriver>;
+    /**
+     * Gets the TypeORM DataSource instance
+     * @returns DataSource instance for database operations
+     */
     get dataSource(): DataSource;
+    /**
+     * Gets the StatusListStore instance
+     * @returns StatusListStore for data persistence operations
+     */
     get statusListStore(): StatusListStore;
+    /**
+     * Gets the driver configuration options
+     * @returns DriverOptions configuration
+     */
     getOptions(): DriverOptions;
+    /**
+     * Gets the driver type
+     * @returns StatusListDriverType enum value
+     */
     getType(): StatusListDriverType;
+    /**
+     * Creates a new status list credential and stores it in the database
+     * @param args - Status list creation parameters
+     * @returns Promise resolving to StatusListResult
+     */
     createStatusList(args: {
         statusListType: StatusListType;
         statusListCredential: StatusListCredential;
@@ -78,28 +130,81 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
         credentialIdMode?: StatusListCredentialIdMode;
         bitsPerStatus?: number;
     }): Promise<StatusListResult>;
+    /**
+     * Updates an existing status list credential in the database
+     * @param args - Status list update parameters
+     * @returns Promise resolving to StatusListResult
+     */
     updateStatusList(args: {
         statusListCredential: StatusListCredential;
         correlationId: string;
     }): Promise<StatusListResult>;
+    /**
+     * Deletes the status list from the database
+     * @returns Promise resolving to boolean indicating success
+     */
     deleteStatusList(): Promise<boolean>;
+    /**
+     * Updates a status list entry and returns the credential status
+     * @param args - Status list entry update parameters
+     * @returns Promise resolving to credential status and entry
+     */
     updateStatusListEntry(args: IAddStatusListEntryArgs): Promise<{
         credentialStatus: StatusList2021EntryCredentialStatus | StatusListOAuthEntryCredentialStatus | BitstringStatusListEntryCredentialStatus;
         statusListEntry: IStatusListEntryEntity | IBitstringStatusListEntryEntity;
     }>;
+    /**
+     * Retrieves a status list entry by credential ID
+     * @param args - Query parameters including credential ID
+     * @returns Promise resolving to status list entry or undefined
+     */
     getStatusListEntryByCredentialId(args: IGetStatusListEntryByCredentialIdArgs): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined>;
+    /**
+     * Retrieves a status list entry by index
+     * @param args - Query parameters including status list index
+     * @returns Promise resolving to status list entry or undefined
+     */
     getStatusListEntryByIndex(args: IGetStatusListEntryByIndexArgs): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined>;
+    /**
+     * Generates a random available index for new status list entries
+     * @param args - Optional correlation ID parameter
+     * @returns Promise resolving to available index number
+     */
     getRandomNewStatusListIndex(args?: {
         correlationId?: string;
     }): Promise<number>;
+    /**
+     * Implementation for generating random status list indices with retry logic
+     * @param tries - Number of attempts made
+     * @param args - Optional correlation ID parameter
+     * @returns Promise resolving to available index or -1 if none found
+     */
     private getRandomNewStatusListIndexImpl;
+    /**
+     * Gets the length of the status list
+     * @param args - Optional correlation ID parameter
+     * @returns Promise resolving to status list length
+     */
     getStatusListLength(args?: {
         correlationId?: string;
     }): Promise<number>;
+    /**
+     * Retrieves the status list details
+     * @param args - Optional correlation ID parameter
+     * @returns Promise resolving to StatusListResult
+     */
     getStatusList(args?: {
         correlationId?: string;
     }): Promise<StatusListResult>;
+    /**
+     * Retrieves all status lists
+     * @returns Promise resolving to array of StatusListResult
+     */
     getStatusLists(): Promise<Array<StatusListResult>>;
+    /**
+     * Checks if a status list index is currently in use
+     * @returns Promise resolving to boolean indicating usage status
+     */
     isStatusListIndexInUse(): Promise<boolean>;
 }
 

package/dist/index.js

@@ -92,11 +92,23 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
   _statusListStore;
   options;
   _statusListLength;
+  /**
+  * Creates a new AgentDataSourceStatusListDriver instance
+  * @param _dataSource - TypeORM DataSource for database operations
+  * @param _statusListStore - StatusListStore for data persistence
+  * @param options - Driver configuration options
+  */
   constructor(_dataSource, _statusListStore, options) {
     this._dataSource = _dataSource;
     this._statusListStore = _statusListStore;
     this.options = options;
   }
+  /**
+  * Initializes and creates a new AgentDataSourceStatusListDriver instance
+  * @param options - Status list management configuration
+  * @param dbArgs - Database connection arguments
+  * @returns Promise resolving to initialized driver instance
+  */
   static async init(options, dbArgs) {
     if (options.driverType !== StatusListDriverType.AGENT_TYPEORM) {
       throw Error(`TypeORM driver can only be used when the TypeORM driver type is selected in the configuration. Got: ${options.driverType}`);
@@ -119,24 +131,45 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
     statusListStore = new StatusListStore(dataSource);
     return new _AgentDataSourceStatusListDriver(dataSource, statusListStore, options);
   }
+  /**
+  * Gets the TypeORM DataSource instance
+  * @returns DataSource instance for database operations
+  */
   get dataSource() {
     if (!this._dataSource) {
       throw Error(`Datasource not available yet for ${this.options.driverOptions?.dbName}`);
     }
     return this._dataSource;
   }
+  /**
+  * Gets the StatusListStore instance
+  * @returns StatusListStore for data persistence operations
+  */
   get statusListStore() {
     if (!this._statusListStore) {
       this._statusListStore = new StatusListStore(this.dataSource);
     }
     return this._statusListStore;
   }
+  /**
+  * Gets the driver configuration options
+  * @returns DriverOptions configuration
+  */
   getOptions() {
     return this.options.driverOptions ?? {};
   }
+  /**
+  * Gets the driver type
+  * @returns StatusListDriverType enum value
+  */
   getType() {
     return this.options.driverType;
   }
+  /**
+  * Creates a new status list credential and stores it in the database
+  * @param args - Status list creation parameters
+  * @returns Promise resolving to StatusListResult
+  */
   async createStatusList(args) {
     const correlationId = args.correlationId ?? this.options.correlationId;
     if (!correlationId) {
@@ -160,6 +193,11 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
     this._statusListLength = implementationResult.length;
     return implementationResult;
   }
+  /**
+  * Updates an existing status list credential in the database
+  * @param args - Status list update parameters
+  * @returns Promise resolving to StatusListResult
+  */
   async updateStatusList(args) {
     const correlationId = args.correlationId ?? this.options.correlationId;
     const extractedDetails = await extractCredentialDetails(args.statusListCredential);
@@ -188,6 +226,10 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
       ...details
     };
   }
+  /**
+  * Deletes the status list from the database
+  * @returns Promise resolving to boolean indicating success
+  */
   async deleteStatusList() {
     await this.statusListStore.removeStatusList({
       id: this.options.id,
@@ -195,6 +237,11 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
     });
     return Promise.resolve(true);
   }
+  /**
+  * Updates a status list entry and returns the credential status
+  * @param args - Status list entry update parameters
+  * @returns Promise resolving to credential status and entry
+  */
   async updateStatusListEntry(args) {
     const statusListEntity = statusListResultToEntity(await this.getStatusList());
     const statusListEntry = await this.statusListStore.updateStatusListEntry({
@@ -211,12 +258,27 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
       statusListEntry
     };
   }
+  /**
+  * Retrieves a status list entry by credential ID
+  * @param args - Query parameters including credential ID
+  * @returns Promise resolving to status list entry or undefined
+  */
   async getStatusListEntryByCredentialId(args) {
     return await this.statusListStore.getStatusListEntryByCredentialId(args);
   }
+  /**
+  * Retrieves a status list entry by index
+  * @param args - Query parameters including status list index
+  * @returns Promise resolving to status list entry or undefined
+  */
   async getStatusListEntryByIndex(args) {
     return await this.statusListStore.getStatusListEntryByIndex(args);
   }
+  /**
+  * Generates a random available index for new status list entries
+  * @param args - Optional correlation ID parameter
+  * @returns Promise resolving to available index number
+  */
   async getRandomNewStatusListIndex(args) {
     let result = -1;
     let tries = 0;
@@ -225,6 +287,12 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
     }
     return result;
   }
+  /**
+  * Implementation for generating random status list indices with retry logic
+  * @param tries - Number of attempts made
+  * @param args - Optional correlation ID parameter
+  * @returns Promise resolving to available index or -1 if none found
+  */
   async getRandomNewStatusListIndexImpl(tries, args) {
     const statusListId = this.options.id;
     const correlationId = args?.correlationId ?? this.options.correlationId;
@@ -247,12 +315,22 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
     }
     return -1;
   }
+  /**
+  * Gets the length of the status list
+  * @param args - Optional correlation ID parameter
+  * @returns Promise resolving to status list length
+  */
   async getStatusListLength(args) {
     if (!this._statusListLength) {
       this._statusListLength = await this.getStatusList(args).then((details) => details.length);
     }
     return this._statusListLength;
   }
+  /**
+  * Retrieves the status list details
+  * @param args - Optional correlation ID parameter
+  * @returns Promise resolving to StatusListResult
+  */
   async getStatusList(args) {
     const id = this.options.id;
     const correlationId = args?.correlationId ?? this.options.correlationId;
@@ -268,6 +346,10 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
       driverType: statusListEntity.driverType
     });
   }
+  /**
+  * Retrieves all status lists
+  * @returns Promise resolving to array of StatusListResult
+  */
   async getStatusLists() {
     const statusLists = await this.statusListStore.getStatusLists({});
     return Promise.all(statusLists.map(async (statusListEntity) => {
@@ -280,6 +362,10 @@ var AgentDataSourceStatusListDriver = class _AgentDataSourceStatusListDriver {
       });
     }));
   }
+  /**
+  * Checks if a status list index is currently in use
+  * @returns Promise resolving to boolean indicating usage status
+  */
   isStatusListIndexInUse() {
     return Promise.resolve(false);
   }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/drivers.ts","../src/status-list-adapters.ts"],"sourcesContent":["/**\n * StatusList Driver Implementation for TypeORM/Agent Data Sources\n *\n * This module provides the database-backed implementation of the IStatusListDriver interface,\n * handling persistence and retrieval of status list credentials and entries using TypeORM.\n * It delegates status list format-specific operations to the functions layer while managing\n * database interactions, driver configuration, and entity lifecycle.\n *\n * Key responsibilities:\n * - Database connection and store management\n * - Status list CRUD operations\n * - Status list entry management\n * - Random index generation for new entries\n * - Integration with multiple data sources\n *\n * @author Sphereon International B.V.\n * @since 2024\n */\n\nimport { DataSources } from '@sphereon/ssi-sdk.agent-config'\nimport {\n  BitstringStatusListEntryCredentialStatus,\n  IAddStatusListArgs,\n  IAddStatusListEntryArgs,\n  IBitstringStatusListEntryEntity,\n  IGetStatusListEntryByCredentialIdArgs,\n  IGetStatusListEntryByIndexArgs,\n  IStatusListEntryEntity,\n  StatusListEntity,\n  StatusListStore,\n} from '@sphereon/ssi-sdk.data-store'\nimport {\n  createCredentialStatusFromStatusList,\n  extractCredentialDetails,\n  StatusList2021EntryCredentialStatus,\n  StatusListOAuthEntryCredentialStatus,\n  StatusListResult,\n  toStatusListDetails,\n} from '@sphereon/ssi-sdk.vc-status-list'\nimport { StatusListCredential, StatusListCredentialIdMode, StatusListDriverType, StatusListType } from '@sphereon/ssi-types'\nimport { DataSource } from 'typeorm'\nimport { IStatusListDriver } from './types'\nimport { statusListResultToEntity } from './status-list-adapters'\n\nexport interface StatusListManagementOptions {\n  id?: string\n  correlationId?: string\n  driverType: StatusListDriverType\n  driverOptions?: DriverOptions\n}\n\nexport type DriverOptions = TypeORMOptions\n\nexport interface TypeORMOptions {\n  dbName?: string\n}\n\nexport interface FilesystemOptions {\n  path: string // The base path where statusList Credentials will be persisted. Should be a folder and thus not include the VC/StatusList itself\n}\n\nexport function getOptions(args: { id?: string; correlationId?: string; dbName: string }): StatusListManagementOptions {\n  return {\n    id: args.id,\n    correlationId: args.correlationId,\n    driverType: StatusListDriverType.AGENT_TYPEORM,\n    driverOptions: { dbName: args.dbName },\n  }\n}\n\nexport async function getDriver(args: {\n  id?: string\n  correlationId?: string\n  dbName?: string\n  dataSource?: DataSource\n  dataSources?: DataSources\n}): Promise<IStatusListDriver> {\n  const dbName = args.dbName ?? args.dataSource?.name\n  if (!dbName) {\n    throw Error(`Please provide either a DB name or data source`)\n  }\n  const dataSources = args.dataSources ?? DataSources.singleInstance()\n  return await AgentDataSourceStatusListDriver.init(\n    getOptions({\n      ...args,\n      dbName,\n    }),\n    { dataSource: args.dataSource ?? (await dataSources.getDbConnection(dbName)), dataSources },\n  )\n}\n\n/**\n * TypeORM-based implementation of the IStatusListDriver interface\n *\n * Manages status list credentials and entries using a TypeORM data source.\n * Handles database operations while delegating format-specific logic to the functions layer.\n */\nexport class AgentDataSourceStatusListDriver implements IStatusListDriver {\n  private _statusListLength: number | undefined\n\n  constructor(\n    private _dataSource: DataSource,\n    private _statusListStore: StatusListStore,\n    private options: StatusListManagementOptions,\n  ) {}\n\n  public static async init(\n    options: StatusListManagementOptions,\n    dbArgs?: {\n      dataSources?: DataSources\n      dataSource?: DataSource\n    },\n  ): Promise<AgentDataSourceStatusListDriver> {\n    if (options.driverType !== StatusListDriverType.AGENT_TYPEORM) {\n      throw Error(`TypeORM driver can only be used when the TypeORM driver type is selected in the configuration. Got: ${options.driverType}`)\n    } else if (!options.driverOptions) {\n      throw Error(`TypeORM driver can only be used when the TypeORM options are provided.`)\n    }\n    let dataSource: DataSource\n    let statusListStore: StatusListStore\n    if (dbArgs?.dataSource) {\n      dataSource = dbArgs.dataSource\n    } else if (options.driverOptions.dbName) {\n      if (dbArgs?.dataSources) {\n        dataSource = await dbArgs.dataSources.getDbConnection(options.driverOptions.dbName)\n      } else {\n        dataSource = await DataSources.singleInstance().getDbConnection(options.driverOptions.dbName)\n      }\n    } else {\n      return Promise.reject(Error(`Either a datasource or dbName needs to be provided`))\n    }\n\n    statusListStore = new StatusListStore(dataSource)\n    return new AgentDataSourceStatusListDriver(dataSource, statusListStore, options)\n  }\n\n  get dataSource(): DataSource {\n    if (!this._dataSource) {\n      throw Error(`Datasource not available yet for ${this.options.driverOptions?.dbName}`)\n    }\n    return this._dataSource\n  }\n\n  get statusListStore(): StatusListStore {\n    if (!this._statusListStore) {\n      this._statusListStore = new StatusListStore(this.dataSource)\n    }\n    return this._statusListStore\n  }\n\n  getOptions(): DriverOptions {\n    return this.options.driverOptions ?? {}\n  }\n\n  getType(): StatusListDriverType {\n    return this.options.driverType\n  }\n\n  async createStatusList(args: {\n    statusListType: StatusListType\n    statusListCredential: StatusListCredential\n    correlationId?: string\n    credentialIdMode?: StatusListCredentialIdMode\n    bitsPerStatus?: number\n  }): Promise<StatusListResult> {\n    const correlationId = args.correlationId ?? this.options.correlationId\n    if (!correlationId) {\n      throw Error('Either a correlationId needs to be set as an option, or it needs to be provided when creating a status list. None found')\n    }\n    const credentialIdMode = args.credentialIdMode ?? StatusListCredentialIdMode.ISSUANCE\n\n    // Convert credential to implementation details using CREATE/READ context\n    const implementationResult = await toStatusListDetails({\n      statusListCredential: args.statusListCredential,\n      statusListType: args.statusListType,\n      bitsPerStatus: args.bitsPerStatus,\n      correlationId,\n      driverType: this.getType(),\n    })\n\n    // Add driver-specific fields to create complete entity\n    const statusListArgs = {\n      ...implementationResult,\n      credentialIdMode,\n      correlationId,\n      driverType: this.getType(),\n    } as IAddStatusListArgs\n\n    await this.statusListStore.addStatusList(statusListArgs)\n    this._statusListLength = implementationResult.length\n    return implementationResult\n  }\n\n  async updateStatusList(args: { statusListCredential: StatusListCredential; correlationId: string }): Promise<StatusListResult> {\n    const correlationId = args.correlationId ?? this.options.correlationId\n\n    const extractedDetails = await extractCredentialDetails(args.statusListCredential)\n    const entity = await this.statusListStore.getStatusList({\n      id: extractedDetails.id,\n      correlationId,\n    })\n    if (!entity) {\n      throw Error(`Status list ${extractedDetails.id}, correlationId ${correlationId} could not be found`)\n    }\n\n    entity.statusListCredential = args.statusListCredential\n\n    const details = await toStatusListDetails({\n      extractedDetails,\n      statusListEntity: entity,\n    })\n\n    // Merge details with existing entity and driver properties\n    const updateArgs = {\n      ...entity,\n      ...details,\n      correlationId,\n      driverType: this.getType(),\n    } as IAddStatusListArgs\n\n    await this.statusListStore.updateStatusList(updateArgs)\n    this._statusListLength = details.length\n    return { ...entity, ...details }\n  }\n\n  async deleteStatusList(): Promise<boolean> {\n    await this.statusListStore.removeStatusList({ id: this.options.id, correlationId: this.options.correlationId })\n    return Promise.resolve(true)\n  }\n\n  async updateStatusListEntry(args: IAddStatusListEntryArgs): Promise<{\n    credentialStatus: StatusList2021EntryCredentialStatus | StatusListOAuthEntryCredentialStatus | BitstringStatusListEntryCredentialStatus\n    statusListEntry: IStatusListEntryEntity | IBitstringStatusListEntryEntity\n  }> {\n    // Get status list entity\n    const statusListEntity: StatusListEntity = statusListResultToEntity(await this.getStatusList())\n\n    // Update the entry in the store\n    const statusListEntry = await this.statusListStore.updateStatusListEntry({ ...args, statusListId: statusListEntity.id })\n\n    // Use implementation to create the credential status - this moves type-specific logic to implementations\n    const credentialStatus = await createCredentialStatusFromStatusList({\n      statusList: statusListEntity,\n      statusListEntry,\n      statusListIndex: statusListEntry.statusListIndex,\n    })\n\n    return {\n      credentialStatus,\n      statusListEntry,\n    }\n  }\n\n  async getStatusListEntryByCredentialId(\n    args: IGetStatusListEntryByCredentialIdArgs,\n  ): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined> {\n    return await this.statusListStore.getStatusListEntryByCredentialId(args)\n  }\n\n  async getStatusListEntryByIndex(\n    args: IGetStatusListEntryByIndexArgs,\n  ): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined> {\n    return await this.statusListStore.getStatusListEntryByIndex(args)\n  }\n\n  async getRandomNewStatusListIndex(args?: { correlationId?: string }): Promise<number> {\n    let result = -1\n    let tries = 0\n    while (result < 0) {\n      // no tries guard, because we will throw an error when they are exhausted anyway\n      result = await this.getRandomNewStatusListIndexImpl(tries++, args)\n    }\n    return result\n  }\n\n  private async getRandomNewStatusListIndexImpl(tries: number, args?: { correlationId?: string }): Promise<number> {\n    const statusListId = this.options.id\n    const correlationId = args?.correlationId ?? this.options.correlationId\n    if (tries >= 10) {\n      throw Error(`We could not find any random status list index that is available in the statuslist ${statusListId}`)\n    }\n    // TODO: Check against DB\n    const length = await this.getStatusListLength(args)\n    const statusListIndex = Array.from({ length: 20 }, () => Math.floor(Math.random() * length))\n    const available = await this.statusListStore.availableStatusListEntries({\n      statusListId,\n      ...(correlationId && { correlationId }),\n      statusListIndex,\n    })\n    if (available.length > 0) {\n      return available[0] // doesn't matter we pick the first element, as they are all random anyway\n    }\n    return -1\n  }\n\n  async getStatusListLength(args?: { correlationId?: string }): Promise<number> {\n    if (!this._statusListLength) {\n      this._statusListLength = await this.getStatusList(args).then((details) => details.length)\n    }\n    return this._statusListLength!\n  }\n\n  async getStatusList(args?: { correlationId?: string }): Promise<StatusListResult> {\n    const id = this.options.id\n    const correlationId = args?.correlationId ?? this.options.correlationId\n\n    const statusListEntity = await this.statusListStore.getStatusList({ id, correlationId })\n\n    // Convert entity to result using CREATE/READ context\n    return await toStatusListDetails({\n      statusListCredential: statusListEntity.statusListCredential!,\n      statusListType: statusListEntity.type,\n      bitsPerStatus: statusListEntity.bitsPerStatus,\n      correlationId: statusListEntity.correlationId,\n      driverType: statusListEntity.driverType,\n    })\n  }\n\n  async getStatusLists(): Promise<Array<StatusListResult>> {\n    const statusLists = await this.statusListStore.getStatusLists({})\n    return Promise.all(\n      statusLists.map(async (statusListEntity) => {\n        return toStatusListDetails({\n          statusListCredential: statusListEntity.statusListCredential!,\n          statusListType: statusListEntity.type,\n          bitsPerStatus: statusListEntity.bitsPerStatus,\n          correlationId: statusListEntity.correlationId,\n          driverType: statusListEntity.driverType,\n        })\n      }),\n    )\n  }\n\n  isStatusListIndexInUse(): Promise<boolean> {\n    return Promise.resolve(false)\n  }\n}\n","import { StatusListType } from '@sphereon/ssi-types'\nimport { BitstringStatusListEntity, OAuthStatusListEntity, StatusList2021Entity } from '@sphereon/ssi-sdk.data-store'\nimport { StatusListResult } from '@sphereon/ssi-sdk.vc-status-list'\n\nexport function statusListResultToEntity(result: StatusListResult): StatusList2021Entity | OAuthStatusListEntity | BitstringStatusListEntity {\n  const baseFields = {\n    id: result.id,\n    correlationId: result.correlationId,\n    driverType: result.driverType,\n    credentialIdMode: result.credentialIdMode,\n    length: result.length,\n    issuer: result.issuer,\n    type: result.type,\n    proofFormat: result.proofFormat,\n    statusListCredential: result.statusListCredential,\n  }\n\n  if (result.type === StatusListType.StatusList2021) {\n    if (!result.statusList2021) {\n      throw new Error('Missing statusList2021 details')\n    }\n    return Object.assign(new StatusList2021Entity(), {\n      ...baseFields,\n      indexingDirection: result.statusList2021.indexingDirection,\n      statusPurpose: result.statusList2021.statusPurpose,\n    })\n  } else if (result.type === StatusListType.OAuthStatusList) {\n    if (!result.oauthStatusList) {\n      throw new Error('Missing oauthStatusList details')\n    }\n    return Object.assign(new OAuthStatusListEntity(), {\n      ...baseFields,\n      bitsPerStatus: result.oauthStatusList.bitsPerStatus,\n      expiresAt: result.oauthStatusList.expiresAt,\n    })\n  } else if (result.type === StatusListType.BitstringStatusList) {\n    if (!result.bitstringStatusList) {\n      throw new Error('Missing bitstringStatusList details')\n    }\n    return Object.assign(new BitstringStatusListEntity(), {\n      ...baseFields,\n      statusPurpose: result.bitstringStatusList.statusPurpose,\n      ttl: result.bitstringStatusList.ttl,\n      bitsPerStatus: result.bitstringStatusList.bitsPerStatus,\n      validFrom: result.bitstringStatusList.validFrom,\n      validUntil: result.bitstringStatusList.validUntil,\n    })\n  }\n  throw new Error(`Unsupported status list type: ${result.type}`)\n}\n"],"mappings":"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","names":["DataSources","StatusListStore","createCredentialStatusFromStatusList","extractCredentialDetails","toStatusListDetails","StatusListCredentialIdMode","StatusListDriverType","StatusListType","BitstringStatusListEntity","OAuthStatusListEntity","StatusList2021Entity","statusListResultToEntity","result","baseFields","id","correlationId","driverType","credentialIdMode","length","issuer","type","proofFormat","statusListCredential","StatusListType","StatusList2021","statusList2021","Error","Object","assign","StatusList2021Entity","indexingDirection","statusPurpose","OAuthStatusList","oauthStatusList","OAuthStatusListEntity","bitsPerStatus","expiresAt","BitstringStatusList","bitstringStatusList","BitstringStatusListEntity","ttl","validFrom","validUntil","getOptions","args","id","correlationId","driverType","StatusListDriverType","AGENT_TYPEORM","driverOptions","dbName","getDriver","dataSource","name","Error","dataSources","DataSources","singleInstance","AgentDataSourceStatusListDriver","init","getDbConnection","_statusListLength","constructor","_dataSource","_statusListStore","options","dbArgs","statusListStore","Promise","reject","StatusListStore","getType","createStatusList","credentialIdMode","StatusListCredentialIdMode","ISSUANCE","implementationResult","toStatusListDetails","statusListCredential","statusListType","bitsPerStatus","statusListArgs","addStatusList","length","updateStatusList","extractedDetails","extractCredentialDetails","entity","getStatusList","details","statusListEntity","updateArgs","deleteStatusList","removeStatusList","resolve","updateStatusListEntry","statusListResultToEntity","statusListEntry","statusListId","credentialStatus","createCredentialStatusFromStatusList","statusList","statusListIndex","getStatusListEntryByCredentialId","getStatusListEntryByIndex","getRandomNewStatusListIndex","result","tries","getRandomNewStatusListIndexImpl","getStatusListLength","Array","from","Math","floor","random","available","availableStatusListEntries","then","type","getStatusLists","statusLists","all","map","isStatusListIndexInUse"]}
+{"version":3,"sources":["../src/drivers.ts","../src/status-list-adapters.ts"],"sourcesContent":["/**\n * StatusList Driver Implementation for TypeORM/Agent Data Sources\n *\n * This module provides the database-backed implementation of the IStatusListDriver interface,\n * handling persistence and retrieval of status list credentials and entries using TypeORM.\n * It delegates status list format-specific operations to the functions layer while managing\n * database interactions, driver configuration, and entity lifecycle.\n *\n * Key responsibilities:\n * - Database connection and store management\n * - Status list CRUD operations\n * - Status list entry management\n * - Random index generation for new entries\n * - Integration with multiple data sources\n *\n * @author Sphereon International B.V.\n * @since 2024\n */\n\nimport { DataSources } from '@sphereon/ssi-sdk.agent-config'\nimport {\n  BitstringStatusListEntryCredentialStatus,\n  IAddStatusListArgs,\n  IAddStatusListEntryArgs,\n  IBitstringStatusListEntryEntity,\n  IGetStatusListEntryByCredentialIdArgs,\n  IGetStatusListEntryByIndexArgs,\n  IStatusListEntryEntity,\n  StatusListEntity,\n  StatusListStore,\n} from '@sphereon/ssi-sdk.data-store'\nimport {\n  createCredentialStatusFromStatusList,\n  extractCredentialDetails,\n  StatusList2021EntryCredentialStatus,\n  StatusListOAuthEntryCredentialStatus,\n  StatusListResult,\n  toStatusListDetails,\n} from '@sphereon/ssi-sdk.vc-status-list'\nimport { StatusListCredential, StatusListCredentialIdMode, StatusListDriverType, StatusListType } from '@sphereon/ssi-types'\nimport { DataSource } from 'typeorm'\nimport { IStatusListDriver } from './types'\nimport { statusListResultToEntity } from './status-list-adapters'\n\n/**\n * Configuration options for status list management\n */\nexport interface StatusListManagementOptions {\n  id?: string\n  correlationId?: string\n  driverType: StatusListDriverType\n  driverOptions?: DriverOptions\n}\n\nexport type DriverOptions = TypeORMOptions\n\n/**\n * TypeORM-specific configuration options\n */\nexport interface TypeORMOptions {\n  dbName?: string\n}\n\n/**\n * Filesystem-specific configuration options\n */\nexport interface FilesystemOptions {\n  path: string // The base path where statusList Credentials will be persisted. Should be a folder and thus not include the VC/StatusList itself\n}\n\n/**\n * Creates status list management options for TypeORM driver\n * @param args - Configuration parameters including id, correlationId, and database name\n * @returns StatusListManagementOptions configured for TypeORM\n */\nexport function getOptions(args: { id?: string; correlationId?: string; dbName: string }): StatusListManagementOptions {\n  return {\n    id: args.id,\n    correlationId: args.correlationId,\n    driverType: StatusListDriverType.AGENT_TYPEORM,\n    driverOptions: { dbName: args.dbName },\n  }\n}\n\n/**\n * Creates and initializes a status list driver instance\n * @param args - Configuration parameters including database connection details\n * @returns Promise resolving to initialized IStatusListDriver instance\n */\nexport async function getDriver(args: {\n  id?: string\n  correlationId?: string\n  dbName?: string\n  dataSource?: DataSource\n  dataSources?: DataSources\n}): Promise<IStatusListDriver> {\n  const dbName = args.dbName ?? args.dataSource?.name\n  if (!dbName) {\n    throw Error(`Please provide either a DB name or data source`)\n  }\n  const dataSources = args.dataSources ?? DataSources.singleInstance()\n  return await AgentDataSourceStatusListDriver.init(\n    getOptions({\n      ...args,\n      dbName,\n    }),\n    { dataSource: args.dataSource ?? (await dataSources.getDbConnection(dbName)), dataSources },\n  )\n}\n\n/**\n * TypeORM-based implementation of the IStatusListDriver interface\n *\n * Manages status list credentials and entries using a TypeORM data source.\n * Handles database operations while delegating format-specific logic to the functions layer.\n */\nexport class AgentDataSourceStatusListDriver implements IStatusListDriver {\n  private _statusListLength: number | undefined\n\n  /**\n   * Creates a new AgentDataSourceStatusListDriver instance\n   * @param _dataSource - TypeORM DataSource for database operations\n   * @param _statusListStore - StatusListStore for data persistence\n   * @param options - Driver configuration options\n   */\n  constructor(\n    private _dataSource: DataSource,\n    private _statusListStore: StatusListStore,\n    private options: StatusListManagementOptions,\n  ) {}\n\n  /**\n   * Initializes and creates a new AgentDataSourceStatusListDriver instance\n   * @param options - Status list management configuration\n   * @param dbArgs - Database connection arguments\n   * @returns Promise resolving to initialized driver instance\n   */\n  public static async init(\n    options: StatusListManagementOptions,\n    dbArgs?: {\n      dataSources?: DataSources\n      dataSource?: DataSource\n    },\n  ): Promise<AgentDataSourceStatusListDriver> {\n    if (options.driverType !== StatusListDriverType.AGENT_TYPEORM) {\n      throw Error(`TypeORM driver can only be used when the TypeORM driver type is selected in the configuration. Got: ${options.driverType}`)\n    } else if (!options.driverOptions) {\n      throw Error(`TypeORM driver can only be used when the TypeORM options are provided.`)\n    }\n    let dataSource: DataSource\n    let statusListStore: StatusListStore\n    if (dbArgs?.dataSource) {\n      dataSource = dbArgs.dataSource\n    } else if (options.driverOptions.dbName) {\n      if (dbArgs?.dataSources) {\n        dataSource = await dbArgs.dataSources.getDbConnection(options.driverOptions.dbName)\n      } else {\n        dataSource = await DataSources.singleInstance().getDbConnection(options.driverOptions.dbName)\n      }\n    } else {\n      return Promise.reject(Error(`Either a datasource or dbName needs to be provided`))\n    }\n\n    statusListStore = new StatusListStore(dataSource)\n    return new AgentDataSourceStatusListDriver(dataSource, statusListStore, options)\n  }\n\n  /**\n   * Gets the TypeORM DataSource instance\n   * @returns DataSource instance for database operations\n   */\n  get dataSource(): DataSource {\n    if (!this._dataSource) {\n      throw Error(`Datasource not available yet for ${this.options.driverOptions?.dbName}`)\n    }\n    return this._dataSource\n  }\n\n  /**\n   * Gets the StatusListStore instance\n   * @returns StatusListStore for data persistence operations\n   */\n  get statusListStore(): StatusListStore {\n    if (!this._statusListStore) {\n      this._statusListStore = new StatusListStore(this.dataSource)\n    }\n    return this._statusListStore\n  }\n\n  /**\n   * Gets the driver configuration options\n   * @returns DriverOptions configuration\n   */\n  getOptions(): DriverOptions {\n    return this.options.driverOptions ?? {}\n  }\n\n  /**\n   * Gets the driver type\n   * @returns StatusListDriverType enum value\n   */\n  getType(): StatusListDriverType {\n    return this.options.driverType\n  }\n\n  /**\n   * Creates a new status list credential and stores it in the database\n   * @param args - Status list creation parameters\n   * @returns Promise resolving to StatusListResult\n   */\n  async createStatusList(args: {\n    statusListType: StatusListType\n    statusListCredential: StatusListCredential\n    correlationId?: string\n    credentialIdMode?: StatusListCredentialIdMode\n    bitsPerStatus?: number\n  }): Promise<StatusListResult> {\n    const correlationId = args.correlationId ?? this.options.correlationId\n    if (!correlationId) {\n      throw Error('Either a correlationId needs to be set as an option, or it needs to be provided when creating a status list. None found')\n    }\n    const credentialIdMode = args.credentialIdMode ?? StatusListCredentialIdMode.ISSUANCE\n\n    // Convert credential to implementation details using CREATE/READ context\n    const implementationResult = await toStatusListDetails({\n      statusListCredential: args.statusListCredential,\n      statusListType: args.statusListType,\n      bitsPerStatus: args.bitsPerStatus,\n      correlationId,\n      driverType: this.getType(),\n    })\n\n    // Add driver-specific fields to create complete entity\n    const statusListArgs = {\n      ...implementationResult,\n      credentialIdMode,\n      correlationId,\n      driverType: this.getType(),\n    } as IAddStatusListArgs\n\n    await this.statusListStore.addStatusList(statusListArgs)\n    this._statusListLength = implementationResult.length\n    return implementationResult\n  }\n\n  /**\n   * Updates an existing status list credential in the database\n   * @param args - Status list update parameters\n   * @returns Promise resolving to StatusListResult\n   */\n  async updateStatusList(args: { statusListCredential: StatusListCredential; correlationId: string }): Promise<StatusListResult> {\n    const correlationId = args.correlationId ?? this.options.correlationId\n\n    const extractedDetails = await extractCredentialDetails(args.statusListCredential)\n    const entity = await this.statusListStore.getStatusList({\n      id: extractedDetails.id,\n      correlationId,\n    })\n    if (!entity) {\n      throw Error(`Status list ${extractedDetails.id}, correlationId ${correlationId} could not be found`)\n    }\n\n    entity.statusListCredential = args.statusListCredential\n\n    const details = await toStatusListDetails({\n      extractedDetails,\n      statusListEntity: entity,\n    })\n\n    // Merge details with existing entity and driver properties\n    const updateArgs = {\n      ...entity,\n      ...details,\n      correlationId,\n      driverType: this.getType(),\n    } as IAddStatusListArgs\n\n    await this.statusListStore.updateStatusList(updateArgs)\n    this._statusListLength = details.length\n    return { ...entity, ...details }\n  }\n\n  /**\n   * Deletes the status list from the database\n   * @returns Promise resolving to boolean indicating success\n   */\n  async deleteStatusList(): Promise<boolean> {\n    await this.statusListStore.removeStatusList({ id: this.options.id, correlationId: this.options.correlationId })\n    return Promise.resolve(true)\n  }\n\n  /**\n   * Updates a status list entry and returns the credential status\n   * @param args - Status list entry update parameters\n   * @returns Promise resolving to credential status and entry\n   */\n  async updateStatusListEntry(args: IAddStatusListEntryArgs): Promise<{\n    credentialStatus: StatusList2021EntryCredentialStatus | StatusListOAuthEntryCredentialStatus | BitstringStatusListEntryCredentialStatus\n    statusListEntry: IStatusListEntryEntity | IBitstringStatusListEntryEntity\n  }> {\n    // Get status list entity\n    const statusListEntity: StatusListEntity = statusListResultToEntity(await this.getStatusList())\n\n    // Update the entry in the store\n    const statusListEntry = await this.statusListStore.updateStatusListEntry({ ...args, statusListId: statusListEntity.id })\n\n    // Use implementation to create the credential status - this moves type-specific logic to implementations\n    const credentialStatus = await createCredentialStatusFromStatusList({\n      statusList: statusListEntity,\n      statusListEntry,\n      statusListIndex: statusListEntry.statusListIndex,\n    })\n\n    return {\n      credentialStatus,\n      statusListEntry,\n    }\n  }\n\n  /**\n   * Retrieves a status list entry by credential ID\n   * @param args - Query parameters including credential ID\n   * @returns Promise resolving to status list entry or undefined\n   */\n  async getStatusListEntryByCredentialId(\n    args: IGetStatusListEntryByCredentialIdArgs,\n  ): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined> {\n    return await this.statusListStore.getStatusListEntryByCredentialId(args)\n  }\n\n  /**\n   * Retrieves a status list entry by index\n   * @param args - Query parameters including status list index\n   * @returns Promise resolving to status list entry or undefined\n   */\n  async getStatusListEntryByIndex(\n    args: IGetStatusListEntryByIndexArgs,\n  ): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined> {\n    return await this.statusListStore.getStatusListEntryByIndex(args)\n  }\n\n  /**\n   * Generates a random available index for new status list entries\n   * @param args - Optional correlation ID parameter\n   * @returns Promise resolving to available index number\n   */\n  async getRandomNewStatusListIndex(args?: { correlationId?: string }): Promise<number> {\n    let result = -1\n    let tries = 0\n    while (result < 0) {\n      // no tries guard, because we will throw an error when they are exhausted anyway\n      result = await this.getRandomNewStatusListIndexImpl(tries++, args)\n    }\n    return result\n  }\n\n  /**\n   * Implementation for generating random status list indices with retry logic\n   * @param tries - Number of attempts made\n   * @param args - Optional correlation ID parameter\n   * @returns Promise resolving to available index or -1 if none found\n   */\n  private async getRandomNewStatusListIndexImpl(tries: number, args?: { correlationId?: string }): Promise<number> {\n    const statusListId = this.options.id\n    const correlationId = args?.correlationId ?? this.options.correlationId\n    if (tries >= 10) {\n      throw Error(`We could not find any random status list index that is available in the statuslist ${statusListId}`)\n    }\n    // TODO: Check against DB\n    const length = await this.getStatusListLength(args)\n    const statusListIndex = Array.from({ length: 20 }, () => Math.floor(Math.random() * length))\n    const available = await this.statusListStore.availableStatusListEntries({\n      statusListId,\n      ...(correlationId && { correlationId }),\n      statusListIndex,\n    })\n    if (available.length > 0) {\n      return available[0] // doesn't matter we pick the first element, as they are all random anyway\n    }\n    return -1\n  }\n\n  /**\n   * Gets the length of the status list\n   * @param args - Optional correlation ID parameter\n   * @returns Promise resolving to status list length\n   */\n  async getStatusListLength(args?: { correlationId?: string }): Promise<number> {\n    if (!this._statusListLength) {\n      this._statusListLength = await this.getStatusList(args).then((details) => details.length)\n    }\n    return this._statusListLength!\n  }\n\n  /**\n   * Retrieves the status list details\n   * @param args - Optional correlation ID parameter\n   * @returns Promise resolving to StatusListResult\n   */\n  async getStatusList(args?: { correlationId?: string }): Promise<StatusListResult> {\n    const id = this.options.id\n    const correlationId = args?.correlationId ?? this.options.correlationId\n\n    const statusListEntity = await this.statusListStore.getStatusList({ id, correlationId })\n\n    // Convert entity to result using CREATE/READ context\n    return await toStatusListDetails({\n      statusListCredential: statusListEntity.statusListCredential!,\n      statusListType: statusListEntity.type,\n      bitsPerStatus: statusListEntity.bitsPerStatus,\n      correlationId: statusListEntity.correlationId,\n      driverType: statusListEntity.driverType,\n    })\n  }\n\n  /**\n   * Retrieves all status lists\n   * @returns Promise resolving to array of StatusListResult\n   */\n  async getStatusLists(): Promise<Array<StatusListResult>> {\n    const statusLists = await this.statusListStore.getStatusLists({})\n    return Promise.all(\n      statusLists.map(async (statusListEntity) => {\n        return toStatusListDetails({\n          statusListCredential: statusListEntity.statusListCredential!,\n          statusListType: statusListEntity.type,\n          bitsPerStatus: statusListEntity.bitsPerStatus,\n          correlationId: statusListEntity.correlationId,\n          driverType: statusListEntity.driverType,\n        })\n      }),\n    )\n  }\n\n  /**\n   * Checks if a status list index is currently in use\n   * @returns Promise resolving to boolean indicating usage status\n   */\n  isStatusListIndexInUse(): Promise<boolean> {\n    return Promise.resolve(false)\n  }\n}\n","import { StatusListType } from '@sphereon/ssi-types'\nimport { BitstringStatusListEntity, OAuthStatusListEntity, StatusList2021Entity } from '@sphereon/ssi-sdk.data-store'\nimport { StatusListResult } from '@sphereon/ssi-sdk.vc-status-list'\n\nexport function statusListResultToEntity(result: StatusListResult): StatusList2021Entity | OAuthStatusListEntity | BitstringStatusListEntity {\n  const baseFields = {\n    id: result.id,\n    correlationId: result.correlationId,\n    driverType: result.driverType,\n    credentialIdMode: result.credentialIdMode,\n    length: result.length,\n    issuer: result.issuer,\n    type: result.type,\n    proofFormat: result.proofFormat,\n    statusListCredential: result.statusListCredential,\n  }\n\n  if (result.type === StatusListType.StatusList2021) {\n    if (!result.statusList2021) {\n      throw new Error('Missing statusList2021 details')\n    }\n    return Object.assign(new StatusList2021Entity(), {\n      ...baseFields,\n      indexingDirection: result.statusList2021.indexingDirection,\n      statusPurpose: result.statusList2021.statusPurpose,\n    })\n  } else if (result.type === StatusListType.OAuthStatusList) {\n    if (!result.oauthStatusList) {\n      throw new Error('Missing oauthStatusList details')\n    }\n    return Object.assign(new OAuthStatusListEntity(), {\n      ...baseFields,\n      bitsPerStatus: result.oauthStatusList.bitsPerStatus,\n      expiresAt: result.oauthStatusList.expiresAt,\n    })\n  } else if (result.type === StatusListType.BitstringStatusList) {\n    if (!result.bitstringStatusList) {\n      throw new Error('Missing bitstringStatusList details')\n    }\n    return Object.assign(new BitstringStatusListEntity(), {\n      ...baseFields,\n      statusPurpose: result.bitstringStatusList.statusPurpose,\n      ttl: result.bitstringStatusList.ttl,\n      bitsPerStatus: result.bitstringStatusList.bitsPerStatus,\n      validFrom: result.bitstringStatusList.validFrom,\n      validUntil: result.bitstringStatusList.validUntil,\n    })\n  }\n  throw new Error(`Unsupported status list type: ${result.type}`)\n}\n"],"mappings":"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","names":["DataSources","StatusListStore","createCredentialStatusFromStatusList","extractCredentialDetails","toStatusListDetails","StatusListCredentialIdMode","StatusListDriverType","StatusListType","BitstringStatusListEntity","OAuthStatusListEntity","StatusList2021Entity","statusListResultToEntity","result","baseFields","id","correlationId","driverType","credentialIdMode","length","issuer","type","proofFormat","statusListCredential","StatusListType","StatusList2021","statusList2021","Error","Object","assign","StatusList2021Entity","indexingDirection","statusPurpose","OAuthStatusList","oauthStatusList","OAuthStatusListEntity","bitsPerStatus","expiresAt","BitstringStatusList","bitstringStatusList","BitstringStatusListEntity","ttl","validFrom","validUntil","getOptions","args","id","correlationId","driverType","StatusListDriverType","AGENT_TYPEORM","driverOptions","dbName","getDriver","dataSource","name","Error","dataSources","DataSources","singleInstance","AgentDataSourceStatusListDriver","init","getDbConnection","_statusListLength","constructor","_dataSource","_statusListStore","options","dbArgs","statusListStore","Promise","reject","StatusListStore","getType","createStatusList","credentialIdMode","StatusListCredentialIdMode","ISSUANCE","implementationResult","toStatusListDetails","statusListCredential","statusListType","bitsPerStatus","statusListArgs","addStatusList","length","updateStatusList","extractedDetails","extractCredentialDetails","entity","getStatusList","details","statusListEntity","updateArgs","deleteStatusList","removeStatusList","resolve","updateStatusListEntry","statusListResultToEntity","statusListEntry","statusListId","credentialStatus","createCredentialStatusFromStatusList","statusList","statusListIndex","getStatusListEntryByCredentialId","getStatusListEntryByIndex","getRandomNewStatusListIndex","result","tries","getRandomNewStatusListIndexImpl","getStatusListLength","Array","from","Math","floor","random","available","availableStatusListEntries","then","type","getStatusLists","statusLists","all","map","isStatusListIndexInUse"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sphereon/ssi-sdk.vc-status-list-issuer-drivers",
   "description": "Sphereon SSI-SDK plugin for Status List management, like StatusList2021. Issuer drivers module",
-  "version": "0.34.1-feature.SSISDK.17.bitstring.sl.14+35c8ca99",
+  "version": "0.34.1-feature.SSISDK.17.bitstring.sl.16+6964608d",
   "source": "src/index.ts",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -22,15 +22,15 @@
     "build": "tsup --config ../../tsup.config.ts --tsconfig ../../tsconfig.tsup.json"
   },
   "dependencies": {
-    "@sphereon/ssi-express-support": "0.34.1-feature.SSISDK.17.bitstring.sl.14+35c8ca99",
+    "@sphereon/ssi-express-support": "0.34.1-feature.SSISDK.17.bitstring.sl.16+6964608d",
     "@sphereon/ssi-sdk-ext.did-utils": "0.29.0",
     "@sphereon/ssi-sdk-ext.identifier-resolution": "0.29.0",
-    "@sphereon/ssi-sdk.agent-config": "0.34.1-feature.SSISDK.17.bitstring.sl.14+35c8ca99",
-    "@sphereon/ssi-sdk.core": "0.34.1-feature.SSISDK.17.bitstring.sl.14+35c8ca99",
-    "@sphereon/ssi-sdk.credential-vcdm": "0.34.1-feature.SSISDK.17.bitstring.sl.14+35c8ca99",
-    "@sphereon/ssi-sdk.data-store": "0.34.1-feature.SSISDK.17.bitstring.sl.14+35c8ca99",
-    "@sphereon/ssi-sdk.vc-status-list": "0.34.1-feature.SSISDK.17.bitstring.sl.14+35c8ca99",
-    "@sphereon/ssi-types": "0.34.1-feature.SSISDK.17.bitstring.sl.14+35c8ca99",
+    "@sphereon/ssi-sdk.agent-config": "0.34.1-feature.SSISDK.17.bitstring.sl.16+6964608d",
+    "@sphereon/ssi-sdk.core": "0.34.1-feature.SSISDK.17.bitstring.sl.16+6964608d",
+    "@sphereon/ssi-sdk.credential-vcdm": "0.34.1-feature.SSISDK.17.bitstring.sl.16+6964608d",
+    "@sphereon/ssi-sdk.data-store": "0.34.1-feature.SSISDK.17.bitstring.sl.16+6964608d",
+    "@sphereon/ssi-sdk.vc-status-list": "0.34.1-feature.SSISDK.17.bitstring.sl.16+6964608d",
+    "@sphereon/ssi-types": "0.34.1-feature.SSISDK.17.bitstring.sl.16+6964608d",
     "@sphereon/vc-status-list": "7.0.0-next.0",
     "@veramo/core": "4.2.0",
     "debug": "^4.3.5",
@@ -61,5 +61,5 @@
     "SSI",
     "StatusList2021"
   ],
-  "gitHead": "35c8ca99b499927dfffd929ae709750a7337b017"
+  "gitHead": "6964608dcd10f9cc0935ef31e7dec85fb4fe55fd"
 }

package/src/drivers.ts

@@ -42,6 +42,9 @@ import { DataSource } from 'typeorm'
 import { IStatusListDriver } from './types'
 import { statusListResultToEntity } from './status-list-adapters'
 
+/**
+ * Configuration options for status list management
+ */
 export interface StatusListManagementOptions {
   id?: string
   correlationId?: string
@@ -51,14 +54,25 @@ export interface StatusListManagementOptions {
 
 export type DriverOptions = TypeORMOptions
 
+/**
+ * TypeORM-specific configuration options
+ */
 export interface TypeORMOptions {
   dbName?: string
 }
 
+/**
+ * Filesystem-specific configuration options
+ */
 export interface FilesystemOptions {
   path: string // The base path where statusList Credentials will be persisted. Should be a folder and thus not include the VC/StatusList itself
 }
 
+/**
+ * Creates status list management options for TypeORM driver
+ * @param args - Configuration parameters including id, correlationId, and database name
+ * @returns StatusListManagementOptions configured for TypeORM
+ */
 export function getOptions(args: { id?: string; correlationId?: string; dbName: string }): StatusListManagementOptions {
   return {
     id: args.id,
@@ -68,6 +82,11 @@ export function getOptions(args: { id?: string; correlationId?: string; dbName:
   }
 }
 
+/**
+ * Creates and initializes a status list driver instance
+ * @param args - Configuration parameters including database connection details
+ * @returns Promise resolving to initialized IStatusListDriver instance
+ */
 export async function getDriver(args: {
   id?: string
   correlationId?: string
@@ -98,12 +117,24 @@ export async function getDriver(args: {
 export class AgentDataSourceStatusListDriver implements IStatusListDriver {
   private _statusListLength: number | undefined
 
+  /**
+   * Creates a new AgentDataSourceStatusListDriver instance
+   * @param _dataSource - TypeORM DataSource for database operations
+   * @param _statusListStore - StatusListStore for data persistence
+   * @param options - Driver configuration options
+   */
   constructor(
     private _dataSource: DataSource,
     private _statusListStore: StatusListStore,
     private options: StatusListManagementOptions,
   ) {}
 
+  /**
+   * Initializes and creates a new AgentDataSourceStatusListDriver instance
+   * @param options - Status list management configuration
+   * @param dbArgs - Database connection arguments
+   * @returns Promise resolving to initialized driver instance
+   */
   public static async init(
     options: StatusListManagementOptions,
     dbArgs?: {
@@ -134,6 +165,10 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     return new AgentDataSourceStatusListDriver(dataSource, statusListStore, options)
   }
 
+  /**
+   * Gets the TypeORM DataSource instance
+   * @returns DataSource instance for database operations
+   */
   get dataSource(): DataSource {
     if (!this._dataSource) {
       throw Error(`Datasource not available yet for ${this.options.driverOptions?.dbName}`)
@@ -141,6 +176,10 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     return this._dataSource
   }
 
+  /**
+   * Gets the StatusListStore instance
+   * @returns StatusListStore for data persistence operations
+   */
   get statusListStore(): StatusListStore {
     if (!this._statusListStore) {
       this._statusListStore = new StatusListStore(this.dataSource)
@@ -148,14 +187,27 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     return this._statusListStore
   }
 
+  /**
+   * Gets the driver configuration options
+   * @returns DriverOptions configuration
+   */
   getOptions(): DriverOptions {
     return this.options.driverOptions ?? {}
   }
 
+  /**
+   * Gets the driver type
+   * @returns StatusListDriverType enum value
+   */
   getType(): StatusListDriverType {
     return this.options.driverType
   }
 
+  /**
+   * Creates a new status list credential and stores it in the database
+   * @param args - Status list creation parameters
+   * @returns Promise resolving to StatusListResult
+   */
   async createStatusList(args: {
     statusListType: StatusListType
     statusListCredential: StatusListCredential
@@ -191,6 +243,11 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     return implementationResult
   }
 
+  /**
+   * Updates an existing status list credential in the database
+   * @param args - Status list update parameters
+   * @returns Promise resolving to StatusListResult
+   */
   async updateStatusList(args: { statusListCredential: StatusListCredential; correlationId: string }): Promise<StatusListResult> {
     const correlationId = args.correlationId ?? this.options.correlationId
 
@@ -223,11 +280,20 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     return { ...entity, ...details }
   }
 
+  /**
+   * Deletes the status list from the database
+   * @returns Promise resolving to boolean indicating success
+   */
   async deleteStatusList(): Promise<boolean> {
     await this.statusListStore.removeStatusList({ id: this.options.id, correlationId: this.options.correlationId })
     return Promise.resolve(true)
   }
 
+  /**
+   * Updates a status list entry and returns the credential status
+   * @param args - Status list entry update parameters
+   * @returns Promise resolving to credential status and entry
+   */
   async updateStatusListEntry(args: IAddStatusListEntryArgs): Promise<{
     credentialStatus: StatusList2021EntryCredentialStatus | StatusListOAuthEntryCredentialStatus | BitstringStatusListEntryCredentialStatus
     statusListEntry: IStatusListEntryEntity | IBitstringStatusListEntryEntity
@@ -251,18 +317,33 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     }
   }
 
+  /**
+   * Retrieves a status list entry by credential ID
+   * @param args - Query parameters including credential ID
+   * @returns Promise resolving to status list entry or undefined
+   */
   async getStatusListEntryByCredentialId(
     args: IGetStatusListEntryByCredentialIdArgs,
   ): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined> {
     return await this.statusListStore.getStatusListEntryByCredentialId(args)
   }
 
+  /**
+   * Retrieves a status list entry by index
+   * @param args - Query parameters including status list index
+   * @returns Promise resolving to status list entry or undefined
+   */
   async getStatusListEntryByIndex(
     args: IGetStatusListEntryByIndexArgs,
   ): Promise<IStatusListEntryEntity | IBitstringStatusListEntryEntity | undefined> {
     return await this.statusListStore.getStatusListEntryByIndex(args)
   }
 
+  /**
+   * Generates a random available index for new status list entries
+   * @param args - Optional correlation ID parameter
+   * @returns Promise resolving to available index number
+   */
   async getRandomNewStatusListIndex(args?: { correlationId?: string }): Promise<number> {
     let result = -1
     let tries = 0
@@ -273,6 +354,12 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     return result
   }
 
+  /**
+   * Implementation for generating random status list indices with retry logic
+   * @param tries - Number of attempts made
+   * @param args - Optional correlation ID parameter
+   * @returns Promise resolving to available index or -1 if none found
+   */
   private async getRandomNewStatusListIndexImpl(tries: number, args?: { correlationId?: string }): Promise<number> {
     const statusListId = this.options.id
     const correlationId = args?.correlationId ?? this.options.correlationId
@@ -293,6 +380,11 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     return -1
   }
 
+  /**
+   * Gets the length of the status list
+   * @param args - Optional correlation ID parameter
+   * @returns Promise resolving to status list length
+   */
   async getStatusListLength(args?: { correlationId?: string }): Promise<number> {
     if (!this._statusListLength) {
       this._statusListLength = await this.getStatusList(args).then((details) => details.length)
@@ -300,6 +392,11 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     return this._statusListLength!
   }
 
+  /**
+   * Retrieves the status list details
+   * @param args - Optional correlation ID parameter
+   * @returns Promise resolving to StatusListResult
+   */
   async getStatusList(args?: { correlationId?: string }): Promise<StatusListResult> {
     const id = this.options.id
     const correlationId = args?.correlationId ?? this.options.correlationId
@@ -316,6 +413,10 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     })
   }
 
+  /**
+   * Retrieves all status lists
+   * @returns Promise resolving to array of StatusListResult
+   */
   async getStatusLists(): Promise<Array<StatusListResult>> {
     const statusLists = await this.statusListStore.getStatusLists({})
     return Promise.all(
@@ -331,6 +432,10 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
     )
   }
 
+  /**
+   * Checks if a status list index is currently in use
+   * @returns Promise resolving to boolean indicating usage status
+   */
   isStatusListIndexInUse(): Promise<boolean> {
     return Promise.resolve(false)
   }