Implement full Query By Example matching.

lib/config.js

@@ -135,5 +135,8 @@ config.wallet = {
       // only derived proof is allowed in presentation
       proofValuePrefix: 'u2V0Dh'
     }]
+  },
+  debug: {
+    queryByExample: false // Default to false, let debug.js handle detection
   }
 };

lib/debug.js

@@ -0,0 +1,28 @@
+import {config} from '@bedrock/web';
+
+const isDebugEnabled = () => {
+  // Check config first
+  if(config.wallet?.debug?.queryByExample) {
+    return true;
+  }
+
+  // Node.js environment
+  if(typeof process !== 'undefined' &&
+      process.env?.DEBUG_QUERY_BY_EXAMPLE === 'true') {
+    return true;
+  }
+
+  // Browser environment
+  if(typeof window !== 'undefined' &&
+      window.DEBUG_QUERY_BY_EXAMPLE === true) {
+    return true;
+  }
+
+  return false;
+};
+
+export function debugLog(...args) {
+  if(isDebugEnabled()) {
+    console.log('[QBE DEBUG]', ...args);
+  }
+}

lib/index.js

@@ -20,12 +20,13 @@ import * as exchanges from './exchanges/index.js';
 import * as helpers from './helpers.js';
 import * as inbox from './inbox.js';
 import * as presentations from './presentations.js';
+import * as queryByExample from './queryByExample.js';
 import * as users from './users.js';
 import * as validator from './validator.js';
 import * as zcap from './zcap.js';
 export {
   ageCredentialHelpers, capabilities, cryptoSuites, exchanges,
-  helpers, inbox, presentations, users, validator, zcap
+  helpers, inbox, presentations, queryByExample, users, validator, zcap
 };
 export {
   getCredentialStore, getProfileEdvClient, initialize, profileManager

lib/presentations.js

@@ -9,9 +9,11 @@ import {createDiscloseCryptosuite as createBbsDiscloseCryptosuite} from
 import {createDiscloseCryptosuite as createEcdsaSdDiscloseCryptosuite} from
   '@digitalbazaar/ecdsa-sd-2023-cryptosuite';
 import {DataIntegrityProof} from '@digitalbazaar/data-integrity';
+import {debugLog} from './debug.js';
 import {documentLoader} from './documentLoader.js';
 import {ensureLocalCredentials} from './ageCredentialHelpers.js';
 import jsonpointer from 'json-pointer';
+import {matchCredentials} from './queryByExample.js';
 import {profileManager} from './state.js';
 import {supportedSuites} from './cryptoSuites.js';
 import {v4 as uuid} from 'uuid';
@@ -389,8 +391,25 @@ async function _getMatches({
     // match any open badge achievement ID
     // FIXME: add more generalized matching
     result.matches = matches
-      .filter(_matchContextFilter({credentialQuery}))
-      .filter(_openBadgeFilter({credentialQuery}));
+      .filter(_matchContextFilter({credentialQuery}));
+
+    // Full query by example matching implemented via queryByExample module
+    // Process all credentials at once for efficiency
+    if(credentialQuery?.example) {
+
+      const allContents = result.matches.map(match => match.record.content);
+      const matchingContents = matchCredentials({
+        credentials: allContents, queryByExample: credentialQuery
+      });
+
+      // Map results back to original records using reference comparison
+      result.matches = result.matches.filter(match =>
+        matchingContents.includes(match.record.content)
+      );
+    }
+
+    result.matches =
+        result.matches.filter(_openBadgeFilter({credentialQuery}));
 
     // create derived VCs for each match based on specific `credentialQuery`
     const updatedQuery = {...vprQuery, credentialQuery};
@@ -399,7 +418,6 @@ async function _getMatches({
       vprQuery: updatedQuery, matches: result.matches
     });
   }
-
   return results;
 }
 
@@ -459,6 +477,9 @@ function _matchContextFilter({credentialQuery}) {
 async function _matchQueryByExample({
   verifiablePresentationRequest, query, credentialStore, matches
 }) {
+  debugLog('_matchQueryByExample called with query type:',
+    query.type); // DEBUG
+
   matches.push(...await _getMatches({
     verifiablePresentationRequest, vprQuery: query, credentialStore
   }));