MLE-25617 Two more client-level TS methods

Author: rjrudin

marklogic.d.ts

@@ -521,6 +521,24 @@ declare module 'marklogic' {
      */
     invoke(path: string, variables?: Record<string, any>, txid?: string | object): ResultProvider<EvalResult[]>;
 
+    /**
+     * Configures logging for database interactions.
+     * Can accept either a logger object (e.g., Bunyan or Winston) or a logging level string.
+     * @since 1.0
+     * @param logger - A logger object with debug(), info(), warn(), and error() methods, or a logging level string
+     * @param isErrorFirst - Whether to log errors as the first parameter (true for Bunyan, false for Winston). Defaults to false. Only used when logger is an object.
+     */
+    setLogger(logger: any | 'debug' | 'info' | 'warn' | 'error' | 'silent', isErrorFirst?: boolean): void;
+
+    /**
+     * Updates the SAML authentication token for subsequent requests.
+     * Only supported for clients created with authType: 'saml'.
+     * @since 2.2.0
+     * @param token - The new SAML authentication token
+     * @throws Error if the client is not using SAML authentication
+     */
+    setAuthToken(token: string): void;
+
     /**
      * Releases the client and destroys the agent.
      * Call this method when you're done with the client to free up resources.

test-typescript/dbclient-convenience-runtime.test.ts

@@ -158,4 +158,35 @@ describe('DatabaseClient convenience methods runtime validation', function() {
     results[0].should.have.property('value');
     results[0].value.should.be.a.String();
   });
+
+
+
+  it('should use setLogger with a level string', async function() {
+    // Set logger to 'info' level
+    client.setLogger('info');
+    
+    // Verify client is still functional after setting logger
+    const result = await client.probe(testUri).result();
+    result.should.have.property('exists');
+    result.should.have.property('uri');
+  });
+
+  it('should use setLogger with a logger object', async function() {
+    // Create a simple logger object
+    const testLogger = {
+      debug: (msg: string) => console.log('DEBUG:', msg),
+      info: (msg: string) => console.log('INFO:', msg),
+      warn: (msg: string) => console.log('WARN:', msg),
+      error: (msg: string) => console.log('ERROR:', msg)
+    };
+    
+    // Set logger with object
+    client.setLogger(testLogger, false);
+    
+    // Verify client is still functional after setting logger
+    const result = await client.probe(testUri).result();
+    result.should.have.property('exists');
+    result.should.have.property('uri');
+  });
+
 });

test-typescript/dbclient-setLogger-setAuthToken-compile.test.ts

@@ -0,0 +1,40 @@
+/**
+ * Compile-time type checking tests for setLogger and setAuthToken.
+ * These tests verify TypeScript type definitions but don't execute.
+ */
+
+/// <reference path="../marklogic.d.ts" />
+
+import type { DatabaseClient } from 'marklogic';
+
+const marklogic = require('../lib/marklogic.js');
+
+const db: DatabaseClient = marklogic.createDatabaseClient({
+  host: 'localhost',
+  port: 8000,
+  user: 'admin',
+  password: 'admin'
+});
+
+// Test setLogger with logger object
+const bunyanLogger = {
+  debug: (msg: string) => console.log(msg),
+  info: (msg: string) => console.log(msg),
+  warn: (msg: string) => console.log(msg),
+  error: (msg: string) => console.log(msg)
+};
+db.setLogger(bunyanLogger);
+db.setLogger(bunyanLogger, true); // error-first (Bunyan style)
+db.setLogger(bunyanLogger, false); // error-last (Winston style)
+
+// Test setLogger with level string
+db.setLogger('debug');
+db.setLogger('info');
+db.setLogger('warn');
+db.setLogger('error');
+db.setLogger('silent');
+
+// Test setAuthToken
+db.setAuthToken('new-saml-token-string');
+
+console.log('Compile-time tests pass for setLogger and setAuthToken');