Context object, easy DX yet precise

[brillout]

Maybe there is an opportunity to do something like this:

// The context object provided by the Auth.js universal middleware
const contextAuth = {
  user: {
    id: 42,
    name: 'Auth.js'
  },
  sessionExpire: '2025-01-01'
}

// Object containing extra infos about contextAuth, created by unimid/universal-middleware
const source = {
  type: 'universalMiddlewares',
  name: 'Auth.js',
  value: contextAuth,
  // Not sure if easily possible, maybe by parsing a dummy `new Error().stack`
  definedAt: '/server/authjs-handler.ts'
}

// The "big" context object that contains everything, created by unimid/universal-middleware
const context = {
  ...contextAuth,
  // ... (all other context objects set by other universal middlewares)

  source: {
    user: source,
    sessionExpire: source
  },

  from: {
    // or unimid
    universalMiddlewares: {
      ['Auth.js']: source
    }
  }
}

// context.user => easy access to value
// context.source.user => to know where context.user comes from
// context.from.universalMiddlewares['Auth.js'] => to know what the Auth.js universal middlewares sets

Clearly not important for now, but could be worth it to already start with such foundation.

FYI on Vike's side:

• Flat pageContext vikejs/vike#1268
• I'm even thinking of renaming Vike's pageContext to context. The idea here is that most (junior-ish) users won't (want to) understand the differences between pageContext and context. Having a single context object that contains everything is quite a lovely DX.

Having that insight at the beginning of Vike would have been neat.