Add example doc requests to server readme

Author: MasterKale

packages/server/README.md

@@ -7,6 +7,7 @@ verification.
   - [Node LTS 22.x and higher](#node-lts-22x-and-higher)
   - [Deno 2.1 and higher](#deno-21-and-higher)
 - [Usage](#usage)
+- [Example Presentation Requests](#example-presentation-requests)
 
 ## Installation
 
@@ -69,3 +70,92 @@ const verified = await verifyPresentationResponse({
 
 `verified.credential1.claims` will contain any verified claims contained in the presented
 credential.
+
+## Example Presentation Requests
+
+This library offers a respectable amount of flexibility to define desired claims when requesting an
+mdoc or SD-JWT-VC presentation. See below for some ideas of values suitable as `credentialOptions`
+when calling `generatePresentationRequest()`:
+
+```ts
+import type {
+  OID4VPMDLCredentialOptions,
+  OID4VPMdocCredentialOptionsFull,
+  OID4VPMdocCredentialOptionsSimple,
+  OID4VPSDJWTVCCredentialOptions,
+} from '@simpledigicreds/server';
+```
+
+```ts
+// A streamlined mDL request
+const mdlRequest: OID4VPMDLCredentialOptions = {
+  format: 'mdl',
+  desiredClaims: ['family_name', 'given_name'],
+};
+```
+
+```ts
+// A simple European PID mdoc request
+const mdocPIDRequest: OID4VPMdocCredentialOptionsSimple = {
+  format: 'mdoc',
+  doctype: 'eu.europa.ec.eudi.pid.1',
+  claimPathPrefix: 'eu.europa.ec.eudi.pid.1',
+  desiredClaims: ['family_name', 'given_name', 'nationality'],
+};
+```
+
+```ts
+// A simple EMVCo payment card mdoc request
+const mdocEMVCORequest: OID4VPMdocCredentialOptionsSimple = {
+  format: 'mdoc',
+  doctype: 'com.emvco.payment_card',
+  claimPathPrefix: 'com.emvco.payment_card.1',
+  desiredClaims: ['card_number', 'card_network', 'expiry_year', 'expiry_month'],
+};
+```
+
+```ts
+// A simple mVRC mdoc request
+const mdocMVRCRequest: OID4VPMdocCredentialOptionsSimple = {
+  format: 'mdoc',
+  doctype: 'org.iso.7367.1.mVRC',
+  claimPathPrefix: 'org.iso.18013.5.1',
+  desiredClaims: ['registration_number', 'date_of_registration', 'vehicle_holder'],
+};
+```
+
+```ts
+// An mdoc request with claims across multiple namespaces
+const mdocRequestFull: OID4VPMdocCredentialOptionsFull = {
+  format: 'mdoc',
+  doctype: 'org.iso.7367.1.mVRC',
+  desiredClaims: [
+    ['org.iso.23220.1', 'issue_date'],
+    ['org.iso.23220.1', 'issuing_authority_unicode'],
+    ['org.iso.7367.1', 'vehicle_holder'],
+    ['org.iso.7367.1', 'registration_number'],
+  ],
+};
+```
+
+```ts
+// A simple European PID SD-JWT-VC request
+const sdjwtvcRequest: OID4VPSDJWTVCCredentialOptions = {
+  format: 'sd-jwt-vc',
+  desiredClaims: ['family_name', 'given_name'],
+  acceptedVCTValues: ['urn:eu.europa.ec.eudi:pid:1', 'urn:eudi:pid:1'],
+};
+```
+
+```ts
+// A more complex SD-JWT-VC request with a mix of single-path and multi-path claims
+const sdjwtvcRequestComplex: OID4VPSDJWTVCCredentialOptions = {
+  format: 'sd-jwt-vc',
+  desiredClaims: [
+    'given_name',
+    'family_name',
+    ['age_equal_or_over', '18'],
+  ],
+  acceptedVCTValues: ['urn:eudi:pid:1'],
+};
+```