feat: flat pipeline syntax — mw(config) returns an Entry directly

[mandarini]

Summary

Adds pipeline() and flat entry syntax to @supabase/web-middleware.

pipeline(entries, handler) composes an ordered list of middleware entries around a handler. Each entry is created by calling a middleware with its config — no handler argument:

import { pipeline } from '@supabase/web-middleware'

export default {
  fetch: pipeline(
    [withCors({}), withFeatureFlag({ name: 'beta' })],
    async (req, ctx) => {
      ctx.cors       // from withCors
      ctx.flag       // from withFeatureFlag
      return Response.json({ ok: true })
    },
  ) satisfies FetchHandler,
}

mw(config) with no handler returns an Entry — the unit that pipeline accepts. The rule: if the last argument is not a function, return an Entry.

What changed

• src/core/types.ts — Entry<Key, In, Contribution> and ConfigArgs<Config> added here so both defineMiddleware and pipeline can import them
• src/core/define-middleware.ts — added config-only overload: mw(config) → Entry
• src/core/pipeline.ts — new file; pipeline(entries, handler) folds entries right-to-left so the first entry is outermost
• src/core/pipeline.test.ts — new test file
• Exports and README updated

Try it

npm i https://pkg.pr.new/supabase/web-middleware/@supabase/web-middleware@9

Merge order

• Depends on: nothing — this is the root of the chain, merge first.
• Blocks: feat: withSupabase on the @supabase/middleware engine server#88 — its middleware option consumes this PR via a pkg.pr.new preview (@supabase/web-middleware@9); after this merges and publishes, #88's dependency must be repointed to the npm version.
• Not related to merge order: feat(supabase): add plugins option to createClient supabase-js#2485 is the same pattern family (flat array; middleware on the server, plugins for client namespaces) but has no code dependency in either direction.
• All three run together in plugin-examples.

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/supabase/web-middleware/@supabase/web-middleware@9

commit: 9c2db60

[johnstonmatt]

awesome!