Inconsistency regarding configure signature of AppenderModule with typescript

[ofekisr]

There is some inconsistency between the documentation and typescript types
regarding the configure signature of AppenderModule and there is no findAppender declaration in log4js.d.ts

What do you think?

please review the three states below:

from: appenders Advanced configuration doc - configure defined with four arguments

const myAppenderModule = {
  configure: (config, layouts, findAppender, levels) => {
    /* ...your appender config... */
  },
};
log4js.configure({
  appenders: { custom: { type: myAppenderModule } },
  categories: { default: { appenders: ["custom"], level: "debug" } },
});

from: writing appenders doc - configure defined with only two arguments

// This is the function that generates an appender function
function stdoutAppender(layout, timezoneOffset) {
  // This is the appender function itself
  return (loggingEvent) => {
    process.stdout.write(`${layout(loggingEvent, timezoneOffset)}\n`);
  };
}

// stdout configure doesn't need to use findAppender, or levels
function configure(config, layouts) {
  // the default layout for the appender
  let layout = layouts.colouredLayout;
  // check if there is another layout specified
  if (config.layout) {
    // load the layout
    layout = layouts.layout(config.layout.type, config.layout);
  }
  //create a new appender instance
  return stdoutAppender(layout, config.timezoneOffset);
}

//export the only function needed
exports.configure = configure;

from: https://github.com/log4js-node/log4js-node/blob/master/types/log4js.d.ts - configure defined without findAppender
there is no declaration of findAppender - I can't defined my own Appender as middleware Appender - I can't reach the next appenders

export interface CustomAppender {
  type: string | AppenderModule;
  [key: string]: any;
}

export interface AppenderModule {
  configure: (config: Config, layouts: LayoutsParam) => AppenderFunction;
}

[lamweili]

Thanks, I have corrected the typings in PR #1304.

---

On initialisation, the index.js will always pass the 4 parameters to configure the specific appender.

log4js-node/lib/appenders/index.js

Lines 117 to 122 in 0c37f40

	return appenderModule.configure(
	adapters.modifyConfig(appenderConfig),
	layouts,
	(appender) => getAppender(appender, config),
	levels
	);

But it is up to individual appenders whether to use and take in the parameters.

log4js-node/lib/appenders/recording.js

Line 5 in 0c37f40

function configure() {

log4js-node/lib/appenders/file.js

Line 135 in 0c37f40

function configure(config, layouts) {

log4js-node/lib/appenders/categoryFilter.js

Line 14 in 0c37f40

function configure(config, layouts, findAppender) {

log4js-node/lib/appenders/logLevelFilter.js

Line 15 in 0c37f40

function configure(config, layouts, findAppender, levels) {

[ofekisr]

@lamweili thanks!!
you should fix the documentation as well to be more precise, I understand how to build a custom appnder via the src code and not only from the documentation
You can contact me for more details ofek1israel@gmail.com

[lamweili]

@ofekisr Pull requests are always welcomed!