text: /**
   * Debugging support for web applications.
   *
   * @author David I. Lehn <dlehn@digitalbazaar.com>
   *
   * Copyright 2008-2013 Digital Bazaar, Inc.
   */
  var forge = require('./forge');
  
  /* DEBUG API */
  module.exports = forge.debug = forge.debug || {};
  
  // Private storage for debugging.
  // Useful to expose data that is otherwise unviewable behind closures.
  // NOTE: remember that this can hold references to data and cause leaks!
  // format is "forge._debug.<modulename>.<dataname> = data"
  // Example:
  // (function() {
  //   var cat = 'forge.test.Test'; // debugging category
  //   var sState = {...}; // local state
  //   forge.debug.set(cat, 'sState', sState);
  // })();
  forge.debug.storage = {};
  
  /**
   * Gets debug data. Omit name for all cat data  Omit name and cat for
   * all data.
   *
   * @param cat name of debugging category.
   * @param name name of data to get (optional).
   * @return object with requested debug data or undefined.
   */
  forge.debug.get = function(cat, name) {
    var rval;
    if(typeof(cat) === 'undefined') {
      rval = forge.debug.storage;
    } else if(cat in forge.debug.storage) {
      if(typeof(name) === 'undefined') {
        rval = forge.debug.storage[cat];
      } else {
        rval = forge.debug.storage[cat][name];
      }
    }
    return rval;
  };
  
  /**
   * Sets debug data.
   *
   * @param cat name of debugging category.
   * @param name name of data to set.
   * @param data data to set.
   */
  forge.debug.set = function(cat, name, data) {
    if(!(cat in forge.debug.storage)) {
      forge.debug.storage[cat] = {};
    }
    forge.debug.storage[cat][name] = data;
  };
  
  /**
   * Clears debug data. Omit name for all cat data. Omit name and cat for
   * all data.
   *
   * @param cat name of debugging category.
   * @param name name of data to clear or omit to clear entire category.
   */
  forge.debug.clear = function(cat, name) {
    if(typeof(cat) === 'undefined') {
      forge.debug.storage = {};
    } else if(cat in forge.debug.storage) {
      if(typeof(name) === 'undefined') {
        delete forge.debug.storage[cat];
      } else {
        delete forge.debug.storage[cat][name];
      }
    }
  };
  