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

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\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","_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 { StatusListCredentialIdMode, StatusListDriverType } from '@sphereon/ssi-types'\nimport { DataSource } from 'typeorm'\nimport {\n  ICreateStatusListArgs,\n  IGetRandomNewStatusListIndexArgs,\n  IGetStatusListArgs,\n  IGetStatusListLengthArgs,\n  IStatusListDriver,\n  IUpdateStatusListArgs,\n} 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: ICreateStatusListArgs): 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: IUpdateStatusListArgs): 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?: IGetRandomNewStatusListIndexArgs): 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?: IGetStatusListLengthArgs): 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?: IGetStatusListArgs): 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","_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

@@ -123,22 +123,13 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
      * @param args - Status list creation parameters
      * @returns Promise resolving to StatusListResult
      */
-    createStatusList(args: {
-        statusListType: StatusListType;
-        statusListCredential: StatusListCredential;
-        correlationId?: string;
-        credentialIdMode?: StatusListCredentialIdMode;
-        bitsPerStatus?: number;
-    }): Promise<StatusListResult>;
+    createStatusList(args: ICreateStatusListArgs): 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>;
+    updateStatusList(args: IUpdateStatusListArgs): Promise<StatusListResult>;
     /**
      * Deletes the status list from the database
      * @returns Promise resolving to boolean indicating success
@@ -170,9 +161,7 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
      * @param args - Optional correlation ID parameter
      * @returns Promise resolving to available index number
      */
-    getRandomNewStatusListIndex(args?: {
-        correlationId?: string;
-    }): Promise<number>;
+    getRandomNewStatusListIndex(args?: IGetRandomNewStatusListIndexArgs): Promise<number>;
     /**
      * Implementation for generating random status list indices with retry logic
      * @param tries - Number of attempts made
@@ -185,17 +174,13 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
      * @param args - Optional correlation ID parameter
      * @returns Promise resolving to status list length
      */
-    getStatusListLength(args?: {
-        correlationId?: string;
-    }): Promise<number>;
+    getStatusListLength(args?: IGetStatusListLengthArgs): Promise<number>;
     /**
      * Retrieves the status list details
      * @param args - Optional correlation ID parameter
      * @returns Promise resolving to StatusListResult
      */
-    getStatusList(args?: {
-        correlationId?: string;
-    }): Promise<StatusListResult>;
+    getStatusList(args?: IGetStatusListArgs): Promise<StatusListResult>;
     /**
      * Retrieves all status lists
      * @returns Promise resolving to array of StatusListResult
@@ -210,22 +195,33 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
 
 type IRequiredPlugins = IDataStoreORM & IDIDManager & IKeyManager & IIdentifierResolution & ICredentialIssuer & ICredentialVerifier & IVcdmCredentialPlugin & IStatusListPlugin & IResolver;
 type IRequiredContext = IAgentContext<IRequiredPlugins>;
+interface ICreateStatusListArgs {
+    statusListType: StatusListType;
+    statusListCredential: StatusListCredential;
+    credentialIdMode?: StatusListCredentialIdMode;
+    correlationId?: string;
+    bitsPerStatus?: number;
+}
+interface IGetStatusListArgs {
+    correlationId?: string;
+}
+interface IGetStatusListLengthArgs {
+    correlationId?: string;
+}
+interface IUpdateStatusListArgs {
+    statusListCredential: StatusListCredential;
+    correlationId: string;
+}
+interface IGetRandomNewStatusListIndexArgs {
+    correlationId?: string;
+}
 interface IStatusListDriver {
     statusListStore: StatusListStore;
     getType(): StatusListDriverType;
     getOptions(): DriverOptions;
-    getStatusListLength(args?: {
-        correlationId?: string;
-    }): Promise<number>;
-    createStatusList(args: {
-        statusListType: StatusListType;
-        statusListCredential: StatusListCredential;
-        correlationId?: string;
-        bitsPerStatus?: number;
-    }): Promise<StatusListResult>;
-    getStatusList(args?: {
-        correlationId?: string;
-    }): Promise<StatusListResult>;
+    getStatusListLength(args?: IGetStatusListLengthArgs): Promise<number>;
+    createStatusList(args: ICreateStatusListArgs): Promise<StatusListResult>;
+    getStatusList(args?: IGetStatusListArgs): Promise<StatusListResult>;
     getStatusLists(): Promise<Array<StatusListResult>>;
     updateStatusListEntry(args: IAddStatusListEntryArgs): Promise<{
         credentialStatus: StatusList2021EntryCredentialStatus | StatusListOAuthEntryCredentialStatus | BitstringStatusListEntryCredentialStatus;
@@ -233,15 +229,10 @@ interface IStatusListDriver {
     }>;
     getStatusListEntryByCredentialId(args: IGetStatusListEntryByCredentialIdArgs): Promise<IStatusListEntryEntity | undefined>;
     getStatusListEntryByIndex(args: IGetStatusListEntryByIndexArgs): Promise<IStatusListEntryEntity | undefined>;
-    updateStatusList(args: {
-        statusListCredential: StatusListCredential;
-        correlationId: string;
-    }): Promise<StatusListResult>;
+    updateStatusList(args: IUpdateStatusListArgs): Promise<StatusListResult>;
     deleteStatusList(): Promise<boolean>;
-    getRandomNewStatusListIndex(args?: {
-        correlationId?: string;
-    }): Promise<number>;
+    getRandomNewStatusListIndex(args?: IGetRandomNewStatusListIndexArgs): Promise<number>;
     isStatusListIndexInUse(): Promise<boolean>;
 }
 
-export { AgentDataSourceStatusListDriver, type DriverOptions, type FilesystemOptions, type IRequiredContext, type IRequiredPlugins, type IStatusListDriver, type StatusListManagementOptions, type TypeORMOptions, getDriver, getOptions };
+export { AgentDataSourceStatusListDriver, type DriverOptions, type FilesystemOptions, type ICreateStatusListArgs, type IGetRandomNewStatusListIndexArgs, type IGetStatusListArgs, type IGetStatusListLengthArgs, type IRequiredContext, type IRequiredPlugins, type IStatusListDriver, type IUpdateStatusListArgs, type StatusListManagementOptions, type TypeORMOptions, getDriver, getOptions };

package/dist/index.d.ts

@@ -123,22 +123,13 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
      * @param args - Status list creation parameters
      * @returns Promise resolving to StatusListResult
      */
-    createStatusList(args: {
-        statusListType: StatusListType;
-        statusListCredential: StatusListCredential;
-        correlationId?: string;
-        credentialIdMode?: StatusListCredentialIdMode;
-        bitsPerStatus?: number;
-    }): Promise<StatusListResult>;
+    createStatusList(args: ICreateStatusListArgs): 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>;
+    updateStatusList(args: IUpdateStatusListArgs): Promise<StatusListResult>;
     /**
      * Deletes the status list from the database
      * @returns Promise resolving to boolean indicating success
@@ -170,9 +161,7 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
      * @param args - Optional correlation ID parameter
      * @returns Promise resolving to available index number
      */
-    getRandomNewStatusListIndex(args?: {
-        correlationId?: string;
-    }): Promise<number>;
+    getRandomNewStatusListIndex(args?: IGetRandomNewStatusListIndexArgs): Promise<number>;
     /**
      * Implementation for generating random status list indices with retry logic
      * @param tries - Number of attempts made
@@ -185,17 +174,13 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
      * @param args - Optional correlation ID parameter
      * @returns Promise resolving to status list length
      */
-    getStatusListLength(args?: {
-        correlationId?: string;
-    }): Promise<number>;
+    getStatusListLength(args?: IGetStatusListLengthArgs): Promise<number>;
     /**
      * Retrieves the status list details
      * @param args - Optional correlation ID parameter
      * @returns Promise resolving to StatusListResult
      */
-    getStatusList(args?: {
-        correlationId?: string;
-    }): Promise<StatusListResult>;
+    getStatusList(args?: IGetStatusListArgs): Promise<StatusListResult>;
     /**
      * Retrieves all status lists
      * @returns Promise resolving to array of StatusListResult
@@ -210,22 +195,33 @@ declare class AgentDataSourceStatusListDriver implements IStatusListDriver {
 
 type IRequiredPlugins = IDataStoreORM & IDIDManager & IKeyManager & IIdentifierResolution & ICredentialIssuer & ICredentialVerifier & IVcdmCredentialPlugin & IStatusListPlugin & IResolver;
 type IRequiredContext = IAgentContext<IRequiredPlugins>;
+interface ICreateStatusListArgs {
+    statusListType: StatusListType;
+    statusListCredential: StatusListCredential;
+    credentialIdMode?: StatusListCredentialIdMode;
+    correlationId?: string;
+    bitsPerStatus?: number;
+}
+interface IGetStatusListArgs {
+    correlationId?: string;
+}
+interface IGetStatusListLengthArgs {
+    correlationId?: string;
+}
+interface IUpdateStatusListArgs {
+    statusListCredential: StatusListCredential;
+    correlationId: string;
+}
+interface IGetRandomNewStatusListIndexArgs {
+    correlationId?: string;
+}
 interface IStatusListDriver {
     statusListStore: StatusListStore;
     getType(): StatusListDriverType;
     getOptions(): DriverOptions;
-    getStatusListLength(args?: {
-        correlationId?: string;
-    }): Promise<number>;
-    createStatusList(args: {
-        statusListType: StatusListType;
-        statusListCredential: StatusListCredential;
-        correlationId?: string;
-        bitsPerStatus?: number;
-    }): Promise<StatusListResult>;
-    getStatusList(args?: {
-        correlationId?: string;
-    }): Promise<StatusListResult>;
+    getStatusListLength(args?: IGetStatusListLengthArgs): Promise<number>;
+    createStatusList(args: ICreateStatusListArgs): Promise<StatusListResult>;
+    getStatusList(args?: IGetStatusListArgs): Promise<StatusListResult>;
     getStatusLists(): Promise<Array<StatusListResult>>;
     updateStatusListEntry(args: IAddStatusListEntryArgs): Promise<{
         credentialStatus: StatusList2021EntryCredentialStatus | StatusListOAuthEntryCredentialStatus | BitstringStatusListEntryCredentialStatus;
@@ -233,15 +229,10 @@ interface IStatusListDriver {
     }>;
     getStatusListEntryByCredentialId(args: IGetStatusListEntryByCredentialIdArgs): Promise<IStatusListEntryEntity | undefined>;
     getStatusListEntryByIndex(args: IGetStatusListEntryByIndexArgs): Promise<IStatusListEntryEntity | undefined>;
-    updateStatusList(args: {
-        statusListCredential: StatusListCredential;
-        correlationId: string;
-    }): Promise<StatusListResult>;
+    updateStatusList(args: IUpdateStatusListArgs): Promise<StatusListResult>;
     deleteStatusList(): Promise<boolean>;
-    getRandomNewStatusListIndex(args?: {
-        correlationId?: string;
-    }): Promise<number>;
+    getRandomNewStatusListIndex(args?: IGetRandomNewStatusListIndexArgs): Promise<number>;
     isStatusListIndexInUse(): Promise<boolean>;
 }
 
-export { AgentDataSourceStatusListDriver, type DriverOptions, type FilesystemOptions, type IRequiredContext, type IRequiredPlugins, type IStatusListDriver, type StatusListManagementOptions, type TypeORMOptions, getDriver, getOptions };
+export { AgentDataSourceStatusListDriver, type DriverOptions, type FilesystemOptions, type ICreateStatusListArgs, type IGetRandomNewStatusListIndexArgs, type IGetStatusListArgs, type IGetStatusListLengthArgs, type IRequiredContext, type IRequiredPlugins, type IStatusListDriver, type IUpdateStatusListArgs, type StatusListManagementOptions, type TypeORMOptions, getDriver, getOptions };

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\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","_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 { StatusListCredentialIdMode, StatusListDriverType } from '@sphereon/ssi-types'\nimport { DataSource } from 'typeorm'\nimport {\n  ICreateStatusListArgs,\n  IGetRandomNewStatusListIndexArgs,\n  IGetStatusListArgs,\n  IGetStatusListLengthArgs,\n  IStatusListDriver,\n  IUpdateStatusListArgs,\n} 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: ICreateStatusListArgs): 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: IUpdateStatusListArgs): 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?: IGetRandomNewStatusListIndexArgs): 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?: IGetStatusListLengthArgs): 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?: IGetStatusListArgs): 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","_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.24+d486d9b6",
+  "version": "0.34.1-feature.SSISDK.17.bitstring.sl.26+45018dde",
   "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.24+d486d9b6",
+    "@sphereon/ssi-express-support": "0.34.1-feature.SSISDK.17.bitstring.sl.26+45018dde",
     "@sphereon/ssi-sdk-ext.did-utils": "0.29.1-next.3",
     "@sphereon/ssi-sdk-ext.identifier-resolution": "0.29.1-next.3",
-    "@sphereon/ssi-sdk.agent-config": "0.34.1-feature.SSISDK.17.bitstring.sl.24+d486d9b6",
-    "@sphereon/ssi-sdk.core": "0.34.1-feature.SSISDK.17.bitstring.sl.24+d486d9b6",
-    "@sphereon/ssi-sdk.credential-vcdm": "0.34.1-feature.SSISDK.17.bitstring.sl.24+d486d9b6",
-    "@sphereon/ssi-sdk.data-store": "0.34.1-feature.SSISDK.17.bitstring.sl.24+d486d9b6",
-    "@sphereon/ssi-sdk.vc-status-list": "0.34.1-feature.SSISDK.17.bitstring.sl.24+d486d9b6",
-    "@sphereon/ssi-types": "0.34.1-feature.SSISDK.17.bitstring.sl.24+d486d9b6",
+    "@sphereon/ssi-sdk.agent-config": "0.34.1-feature.SSISDK.17.bitstring.sl.26+45018dde",
+    "@sphereon/ssi-sdk.core": "0.34.1-feature.SSISDK.17.bitstring.sl.26+45018dde",
+    "@sphereon/ssi-sdk.credential-vcdm": "0.34.1-feature.SSISDK.17.bitstring.sl.26+45018dde",
+    "@sphereon/ssi-sdk.data-store": "0.34.1-feature.SSISDK.17.bitstring.sl.26+45018dde",
+    "@sphereon/ssi-sdk.vc-status-list": "0.34.1-feature.SSISDK.17.bitstring.sl.26+45018dde",
+    "@sphereon/ssi-types": "0.34.1-feature.SSISDK.17.bitstring.sl.26+45018dde",
     "@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": "d486d9b69ca1a5c0df614642a2d1e158a60edee8"
+  "gitHead": "45018dde1cd6ea44529ec6fa68ba6877466f13bb"
 }

package/src/drivers.ts

@@ -37,9 +37,16 @@ import {
   StatusListResult,
   toStatusListDetails,
 } from '@sphereon/ssi-sdk.vc-status-list'
-import { StatusListCredential, StatusListCredentialIdMode, StatusListDriverType, StatusListType } from '@sphereon/ssi-types'
+import { StatusListCredentialIdMode, StatusListDriverType } from '@sphereon/ssi-types'
 import { DataSource } from 'typeorm'
-import { IStatusListDriver } from './types'
+import {
+  ICreateStatusListArgs,
+  IGetRandomNewStatusListIndexArgs,
+  IGetStatusListArgs,
+  IGetStatusListLengthArgs,
+  IStatusListDriver,
+  IUpdateStatusListArgs,
+} from './types'
 import { statusListResultToEntity } from './status-list-adapters'
 
 /**
@@ -208,13 +215,7 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
    * @param args - Status list creation parameters
    * @returns Promise resolving to StatusListResult
    */
-  async createStatusList(args: {
-    statusListType: StatusListType
-    statusListCredential: StatusListCredential
-    correlationId?: string
-    credentialIdMode?: StatusListCredentialIdMode
-    bitsPerStatus?: number
-  }): Promise<StatusListResult> {
+  async createStatusList(args: ICreateStatusListArgs): Promise<StatusListResult> {
     const correlationId = args.correlationId ?? this.options.correlationId
     if (!correlationId) {
       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')
@@ -248,7 +249,7 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
    * @param args - Status list update parameters
    * @returns Promise resolving to StatusListResult
    */
-  async updateStatusList(args: { statusListCredential: StatusListCredential; correlationId: string }): Promise<StatusListResult> {
+  async updateStatusList(args: IUpdateStatusListArgs): Promise<StatusListResult> {
     const correlationId = args.correlationId ?? this.options.correlationId
 
     const extractedDetails = await extractCredentialDetails(args.statusListCredential)
@@ -344,7 +345,7 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
    * @param args - Optional correlation ID parameter
    * @returns Promise resolving to available index number
    */
-  async getRandomNewStatusListIndex(args?: { correlationId?: string }): Promise<number> {
+  async getRandomNewStatusListIndex(args?: IGetRandomNewStatusListIndexArgs): Promise<number> {
     let result = -1
     let tries = 0
     while (result < 0) {
@@ -385,7 +386,7 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
    * @param args - Optional correlation ID parameter
    * @returns Promise resolving to status list length
    */
-  async getStatusListLength(args?: { correlationId?: string }): Promise<number> {
+  async getStatusListLength(args?: IGetStatusListLengthArgs): Promise<number> {
     if (!this._statusListLength) {
       this._statusListLength = await this.getStatusList(args).then((details) => details.length)
     }
@@ -397,7 +398,7 @@ export class AgentDataSourceStatusListDriver implements IStatusListDriver {
    * @param args - Optional correlation ID parameter
    * @returns Promise resolving to StatusListResult
    */
-  async getStatusList(args?: { correlationId?: string }): Promise<StatusListResult> {
+  async getStatusList(args?: IGetStatusListArgs): Promise<StatusListResult> {
     const id = this.options.id
     const correlationId = args?.correlationId ?? this.options.correlationId
 

package/src/types.ts

@@ -13,7 +13,7 @@ import {
   StatusListOAuthEntryCredentialStatus,
   StatusListResult,
 } from '@sphereon/ssi-sdk.vc-status-list'
-import { StatusListCredential, StatusListDriverType, StatusListType } from '@sphereon/ssi-types'
+import { StatusListCredential, StatusListCredentialIdMode, StatusListDriverType, StatusListType } from '@sphereon/ssi-types'
 import { IAgentContext, ICredentialIssuer, ICredentialVerifier, IDataStoreORM, IDIDManager, IKeyManager, IResolver } from '@veramo/core'
 import { DriverOptions } from './drivers'
 import { IVcdmCredentialPlugin } from '@sphereon/ssi-sdk.credential-vcdm'
@@ -29,6 +29,31 @@ export type IRequiredPlugins = IDataStoreORM &
   IResolver
 export type IRequiredContext = IAgentContext<IRequiredPlugins>
 
+export interface ICreateStatusListArgs {
+  statusListType: StatusListType
+  statusListCredential: StatusListCredential
+  credentialIdMode?: StatusListCredentialIdMode
+  correlationId?: string
+  bitsPerStatus?: number
+}
+
+export interface IGetStatusListArgs {
+  correlationId?: string
+}
+
+export interface IGetStatusListLengthArgs {
+  correlationId?: string
+}
+
+export interface IUpdateStatusListArgs {
+  statusListCredential: StatusListCredential
+  correlationId: string
+}
+
+export interface IGetRandomNewStatusListIndexArgs {
+  correlationId?: string
+}
+
 export interface IStatusListDriver {
   statusListStore: StatusListStore
 
@@ -36,16 +61,11 @@ export interface IStatusListDriver {
 
   getOptions(): DriverOptions
 
-  getStatusListLength(args?: { correlationId?: string }): Promise<number>
+  getStatusListLength(args?: IGetStatusListLengthArgs): Promise<number>
 
-  createStatusList(args: {
-    statusListType: StatusListType
-    statusListCredential: StatusListCredential
-    correlationId?: string
-    bitsPerStatus?: number
-  }): Promise<StatusListResult>
+  createStatusList(args: ICreateStatusListArgs): Promise<StatusListResult>
 
-  getStatusList(args?: { correlationId?: string }): Promise<StatusListResult>
+  getStatusList(args?: IGetStatusListArgs): Promise<StatusListResult>
 
   getStatusLists(): Promise<Array<StatusListResult>>
 
@@ -58,11 +78,11 @@ export interface IStatusListDriver {
 
   getStatusListEntryByIndex(args: IGetStatusListEntryByIndexArgs): Promise<IStatusListEntryEntity | undefined>
 
-  updateStatusList(args: { statusListCredential: StatusListCredential; correlationId: string }): Promise<StatusListResult>
+  updateStatusList(args: IUpdateStatusListArgs): Promise<StatusListResult>
 
   deleteStatusList(): Promise<boolean>
 
-  getRandomNewStatusListIndex(args?: { correlationId?: string }): Promise<number>
+  getRandomNewStatusListIndex(args?: IGetRandomNewStatusListIndexArgs): Promise<number>
 
   isStatusListIndexInUse(): Promise<boolean>
 }