@adhd/apigen-plugin-logger 0.1.0

package/index.d.ts

@@ -0,0 +1,3 @@
+export type { LoggerOptions } from './lib/plugin';
+export { Logger, loggerPlugin, makeLoggerPlugin } from './lib/plugin';
+export { default } from './lib/plugin';

package/index.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});function G(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var C={exports:{}};function K(e){try{return JSON.stringify(e)}catch{return'"[Circular]"'}}var Y=J;function J(e,t,r){var s=r&&r.stringify||K,i=1;if(typeof e=="object"&&e!==null){var l=t.length+i;if(l===1)return e;var f=new Array(l);f[0]=s(e);for(var c=1;c<l;c++)f[c]=s(t[c]);return f.join(" ")}if(typeof e!="string")return e;var d=t.length;if(d===0)return e;for(var n="",a=1-i,o=-1,b=e&&e.length||0,u=0;u<b;){if(e.charCodeAt(u)===37&&u+1<b){switch(o=o>-1?o:0,e.charCodeAt(u+1)){case 100:case 102:if(a>=d||t[a]==null)break;o<u&&(n+=e.slice(o,u)),n+=Number(t[a]),o=u+2,u++;break;case 105:if(a>=d||t[a]==null)break;o<u&&(n+=e.slice(o,u)),n+=Math.floor(Number(t[a])),o=u+2,u++;break;case 79:case 111:case 106:if(a>=d||t[a]===void 0)break;o<u&&(n+=e.slice(o,u));var j=typeof t[a];if(j==="string"){n+="'"+t[a]+"'",o=u+2,u++;break}if(j==="function"){n+=t[a].name||"<anonymous>",o=u+2,u++;break}n+=s(t[a]),o=u+2,u++;break;case 115:if(a>=d)break;o<u&&(n+=e.slice(o,u)),n+=String(t[a]),o=u+2,u++;break;case 37:o<u&&(n+=e.slice(o,u)),n+="%",o=u+2,u++,a--;break}++a}++u}return o===-1?e:(o<b&&(n+=e.slice(o)),n)}const B=Y;C.exports=g;const L=ue().console||{},U={mapHttpRequest:S,mapHttpResponse:S,wrapRequestSerializer:F,wrapResponseSerializer:F,wrapErrorSerializer:F,req:S,res:S,err:R,errWithCause:R};function v(e,t){return e==="silent"?1/0:t.levels.values[e]}const A=Symbol("pino.logFuncs"),P=Symbol("pino.hierarchy"),Q={error:"log",fatal:"error",warn:"error",info:"log",debug:"log",trace:"log"};function I(e,t){const r={logger:t,parent:e[P]};t[P]=r}function X(e,t,r){const s={};t.forEach(i=>{s[i]=r[i]?r[i]:L[i]||L[Q[i]||"log"]||w}),e[A]=s}function Z(e,t){return Array.isArray(e)?e.filter(function(s){return s!=="!stdSerializers.err"}):e===!0?Object.keys(t):!1}function g(e){e=e||{},e.browser=e.browser||{};const t=e.browser.transmit;if(t&&typeof t.send!="function")throw Error("pino: transmit option must have a send function");const r=e.browser.write||L;e.browser.write&&(e.browser.asObject=!0);const s=e.serializers||{},i=Z(e.browser.serialize,s);let l=e.browser.serialize;Array.isArray(e.browser.serialize)&&e.browser.serialize.indexOf("!stdSerializers.err")>-1&&(l=!1);const f=Object.keys(e.customLevels||{}),c=["error","fatal","warn","info","debug","trace"].concat(f);typeof r=="function"&&c.forEach(function(h){r[h]=r}),(e.enabled===!1||e.browser.disabled)&&(e.level="silent");const d=e.level||"info",n=Object.create(r);n.log||(n.log=w),X(n,c,r),I({},n),Object.defineProperty(n,"levelVal",{get:o}),Object.defineProperty(n,"level",{get:b,set:u});const a={transmit:t,serialize:i,asObject:e.browser.asObject,asObjectBindingsOnly:e.browser.asObjectBindingsOnly,formatters:e.browser.formatters,reportCaller:e.browser.reportCaller,levels:c,timestamp:ae(e),messageKey:e.messageKey||"msg",onChild:e.onChild||w};n.levels=ee(e),n.level=d,n.isLevelEnabled=function(h){return this.levels.values[h]?this.levels.values[h]>=this.levels.values[this.level]:!1},n.setMaxListeners=n.getMaxListeners=n.emit=n.addListener=n.on=n.prependListener=n.once=n.prependOnceListener=n.removeListener=n.removeAllListeners=n.listeners=n.listenerCount=n.eventNames=n.write=n.flush=w,n.serializers=s,n._serialize=i,n._stdErrSerialize=l,n.child=function(...h){return j.call(this,a,...h)},t&&(n._logEvent=x());function o(){return v(this.level,this)}function b(){return this._level}function u(h){if(h!=="silent"&&!this.levels.values[h])throw Error("unknown level "+h);this._level=h,y(this,a,n,"error"),y(this,a,n,"fatal"),y(this,a,n,"warn"),y(this,a,n,"info"),y(this,a,n,"debug"),y(this,a,n,"trace"),f.forEach(m=>{y(this,a,n,m)})}function j(h,m,_){if(!m)throw new Error("missing bindings for child Pino");_=_||{},i&&m.serializers&&(_.serializers=m.serializers);const V=_.serializers;if(i&&V){var z=Object.assign({},s,V),M=e.browser.serialize===!0?Object.keys(z):i;delete m.serializers,D([m],M,z,this._stdErrSerialize)}function $(E){this._childLevel=(E._childLevel|0)+1,this.bindings=m,z&&(this.serializers=z,this._serialize=M),t&&(this._logEvent=x([].concat(E._logEvent.bindings,m)))}$.prototype=this;const k=new $(this);return I(this,k),k.child=function(...E){return j.call(this,h,...E)},k.level=_.level||this.level,h.onChild(k),k}return n}function ee(e){const t=e.customLevels||{},r=Object.assign({},g.levels.values,t),s=Object.assign({},g.levels.labels,te(t));return{values:r,labels:s}}function te(e){const t={};return Object.keys(e).forEach(function(r){t[e[r]]=r}),t}g.levels={values:{fatal:60,error:50,warn:40,info:30,debug:20,trace:10},labels:{10:"trace",20:"debug",30:"info",40:"warn",50:"error",60:"fatal"}};g.stdSerializers=U;g.stdTimeFunctions=Object.assign({},{nullTime:q,epochTime:H,unixTime:le,isoTime:ce});function ne(e){const t=[];e.bindings&&t.push(e.bindings);let r=e[P];for(;r.parent;)r=r.parent,r.logger.bindings&&t.push(r.logger.bindings);return t.reverse()}function y(e,t,r,s){if(Object.defineProperty(e,s,{value:v(e.level,r)>v(s,r)?w:r[A][s],writable:!0,enumerable:!0,configurable:!0}),e[s]===w){if(!t.transmit)return;const l=t.transmit.level||e.level,f=v(l,r);if(v(s,r)<f)return}e[s]=ie(e,t,r,s);const i=ne(e);i.length!==0&&(e[s]=re(i,e[s]))}function re(e,t){return function(){return t.apply(this,[...e,...arguments])}}function ie(e,t,r,s){return function(i){return function(){const f=t.timestamp(),c=new Array(arguments.length),d=Object.getPrototypeOf&&Object.getPrototypeOf(this)===L?L:this;for(var n=0;n<c.length;n++)c[n]=arguments[n];var a=!1;if(t.serialize&&(D(c,this._serialize,this.serializers,this._stdErrSerialize),a=!0),t.asObject||t.formatters){const o=se(this,s,c,f,t);if(t.reportCaller&&o&&o.length>0&&o[0]&&typeof o[0]=="object")try{const b=N();b&&(o[0].caller=b)}catch{}i.call(d,...o)}else{if(t.reportCaller)try{const o=N();o&&c.push(o)}catch{}i.apply(d,c)}if(t.transmit){const o=t.transmit.level||e._level,b=v(o,r),u=v(s,r);if(u<b)return;oe(this,{ts:f,methodLevel:s,methodValue:u,transmitLevel:o,transmitValue:r.levels.values[t.transmit.level||e._level],send:t.transmit.send,val:v(e._level,r)},c,a)}}}(e[A][s])}function se(e,t,r,s,i){const{level:l,log:f=o=>o}=i.formatters||{},c=r.slice();let d=c[0];const n={};let a=(e._childLevel|0)+1;if(a<1&&(a=1),s&&(n.time=s),l){const o=l(t,e.levels.values[t]);Object.assign(n,o)}else n.level=e.levels.values[t];if(i.asObjectBindingsOnly){if(d!==null&&typeof d=="object")for(;a--&&typeof c[0]=="object";)Object.assign(n,c.shift());return[f(n),...c]}else{if(d!==null&&typeof d=="object"){for(;a--&&typeof c[0]=="object";)Object.assign(n,c.shift());d=c.length?B(c.shift(),c):void 0}else typeof d=="string"&&(d=B(c.shift(),c));return d!==void 0&&(n[i.messageKey]=d),[f(n)]}}function D(e,t,r,s){for(const i in e)if(s&&e[i]instanceof Error)e[i]=g.stdSerializers.err(e[i]);else if(typeof e[i]=="object"&&!Array.isArray(e[i])&&t)for(const l in e[i])t.indexOf(l)>-1&&l in r&&(e[i][l]=r[l](e[i][l]))}function oe(e,t,r,s=!1){const i=t.send,l=t.ts,f=t.methodLevel,c=t.methodValue,d=t.val,n=e._logEvent.bindings;s||D(r,e._serialize||Object.keys(e.serializers),e.serializers,e._stdErrSerialize===void 0?!0:e._stdErrSerialize),e._logEvent.ts=l,e._logEvent.messages=r.filter(function(a){return n.indexOf(a)===-1}),e._logEvent.level.label=f,e._logEvent.level.value=c,i(f,e._logEvent,d),e._logEvent=x(n)}function x(e){return{ts:0,messages:[],bindings:e||[],level:{label:"",value:0}}}function R(e){const t={type:e.constructor.name,msg:e.message,stack:e.stack};for(const r in e)t[r]===void 0&&(t[r]=e[r]);return t}function ae(e){return typeof e.timestamp=="function"?e.timestamp:e.timestamp===!1?q:H}function S(){return{}}function F(e){return e}function w(){}function q(){return!1}function H(){return Date.now()}function le(){return Math.round(Date.now()/1e3)}function ce(){return new Date(Date.now()).toISOString()}function ue(){function e(t){return typeof t<"u"&&t}try{return typeof globalThis<"u"||Object.defineProperty(Object.prototype,"globalThis",{get:function(){return delete Object.prototype.globalThis,this.globalThis=this},configurable:!0}),globalThis}catch{return e(self)||e(window)||e(this)||{}}}C.exports.default=g;C.exports.pino=g;function N(){const e=new Error().stack;if(!e)return null;const t=e.split(`
+`);for(let r=1;r<t.length;r++){const s=t[r].trim();if(/(^at\s+)?(createWrap|LOG|set\s*\(|asObject|Object\.apply|Function\.apply)/.test(s)||s.indexOf("browser.js")!==-1||s.indexOf("node:internal")!==-1||s.indexOf("node_modules")!==-1)continue;let i=s.match(/\((.*?):(\d+):(\d+)\)/);if(i||(i=s.match(/at\s+(.*?):(\d+):(\d+)/)),i){const l=i[1],f=i[2],c=i[3];return l+":"+f+":"+c}}return null}var fe=C.exports;const p=G(fe);class O{constructor(t){this._inner=t}info(t,r){this._inner.info(t,r)}error(t,r){this._inner.error(t,r)}debug(t,r){this._inner.debug(t,r)}warn(t,r){this._inner.warn(t,r)}get pino(){return this._inner}}function de(e,t){const r=e.ctx.get(O);if(r!==void 0)return r;const s=new O(t.pino.child({op:e.operation.id}));return e.ctx.set(O,s),s}function he(e){const t=e.level??"info",r=typeof e.destination=="string"&&e.destination.length>0,s=!r&&!!process.stderr.isTTY,i=e.format??(s?"pretty":"json");let l;if(i==="pretty")l=p({level:t,transport:{target:"pino-pretty",options:{colorize:!r,translateTime:"SYS:HH:MM:ss.l",ignore:"pid,hostname",...r?{destination:e.destination,mkdir:!0}:{destination:2}}}});else{const f=r?p.destination({dest:e.destination,mkdir:!0,sync:!0}):p.destination(2);l=p({level:t},f)}return new O(l)}const be=new O(p({level:"info"},p.destination(2)));function W(e){return function(r,s){const i=de(r,e),l=r.operation.id,f=Date.now();i.info({op:l},`→ ${l}`);const c=s();function d(n){return n!==null&&typeof n=="object"&&Symbol.asyncIterator in n}return d(c)?async function*(){let a=0;try{for await(const o of c)a++,i.debug({op:l,chunk:a},`chunk ${a}`),yield o;i.info({op:l,ms:Date.now()-f,chunks:a},`← ${l} ok`)}catch(o){throw i.error({op:l,ms:Date.now()-f,err:o},`✗ ${l} stream error`),o}}():c.then(n=>(i.info({op:l,ms:Date.now()-f},`← ${l} ok`),n),n=>{throw i.error({op:l,ms:Date.now()-f,err:n},`✗ ${l} error`),n})}}const T={id:"logger",description:"Layer plugin: wraps every operation with entry/exit/error logging (SPEC §7.2a / §8.1). Seeds Logger into call.ctx for downstream consumers.",optionsSchema:{type:"object",properties:{level:{type:"string",description:"pino log level (trace|debug|info|warn|error|fatal). Default: info.",default:"info"},format:{type:"string",enum:["json","pretty"],description:"Log output format. Default: pretty on a TTY stderr, json otherwise."},destination:{type:"string",description:"File path to write logs to. Default: stderr (fd 2). Never stdout."}}},capabilities:{target:{name:"logger",generate(e,t){return[]}},layer:{layer:W(be)}}};function me(e={}){const t=he(e);return{...T,capabilities:{...T.capabilities,layer:{layer:W(t)}}}}exports.Logger=O;exports.default=T;exports.loggerPlugin=T;exports.makeLoggerPlugin=me;

package/index.mjs

@@ -0,0 +1,566 @@
+function G(e) {
+  return e && e.__esModule && Object.prototype.hasOwnProperty.call(e, "default") ? e.default : e;
+}
+var T = { exports: {} };
+function K(e) {
+  try {
+    return JSON.stringify(e);
+  } catch {
+    return '"[Circular]"';
+  }
+}
+var Y = J;
+function J(e, t, r) {
+  var s = r && r.stringify || K, i = 1;
+  if (typeof e == "object" && e !== null) {
+    var l = t.length + i;
+    if (l === 1)
+      return e;
+    var f = new Array(l);
+    f[0] = s(e);
+    for (var c = 1; c < l; c++)
+      f[c] = s(t[c]);
+    return f.join(" ");
+  }
+  if (typeof e != "string")
+    return e;
+  var d = t.length;
+  if (d === 0)
+    return e;
+  for (var n = "", a = 1 - i, o = -1, b = e && e.length || 0, u = 0; u < b; ) {
+    if (e.charCodeAt(u) === 37 && u + 1 < b) {
+      switch (o = o > -1 ? o : 0, e.charCodeAt(u + 1)) {
+        case 100:
+        case 102:
+          if (a >= d || t[a] == null)
+            break;
+          o < u && (n += e.slice(o, u)), n += Number(t[a]), o = u + 2, u++;
+          break;
+        case 105:
+          if (a >= d || t[a] == null)
+            break;
+          o < u && (n += e.slice(o, u)), n += Math.floor(Number(t[a])), o = u + 2, u++;
+          break;
+        case 79:
+        case 111:
+        case 106:
+          if (a >= d || t[a] === void 0)
+            break;
+          o < u && (n += e.slice(o, u));
+          var O = typeof t[a];
+          if (O === "string") {
+            n += "'" + t[a] + "'", o = u + 2, u++;
+            break;
+          }
+          if (O === "function") {
+            n += t[a].name || "<anonymous>", o = u + 2, u++;
+            break;
+          }
+          n += s(t[a]), o = u + 2, u++;
+          break;
+        case 115:
+          if (a >= d)
+            break;
+          o < u && (n += e.slice(o, u)), n += String(t[a]), o = u + 2, u++;
+          break;
+        case 37:
+          o < u && (n += e.slice(o, u)), n += "%", o = u + 2, u++, a--;
+          break;
+      }
+      ++a;
+    }
+    ++u;
+  }
+  return o === -1 ? e : (o < b && (n += e.slice(o)), n);
+}
+const $ = Y;
+T.exports = v;
+const L = ue().console || {}, U = {
+  mapHttpRequest: S,
+  mapHttpResponse: S,
+  wrapRequestSerializer: C,
+  wrapResponseSerializer: C,
+  wrapErrorSerializer: C,
+  req: S,
+  res: S,
+  err: I,
+  errWithCause: I
+};
+function g(e, t) {
+  return e === "silent" ? 1 / 0 : t.levels.values[e];
+}
+const A = Symbol("pino.logFuncs"), F = Symbol("pino.hierarchy"), Q = {
+  error: "log",
+  fatal: "error",
+  warn: "error",
+  info: "log",
+  debug: "log",
+  trace: "log"
+};
+function B(e, t) {
+  const r = {
+    logger: t,
+    parent: e[F]
+  };
+  t[F] = r;
+}
+function X(e, t, r) {
+  const s = {};
+  t.forEach((i) => {
+    s[i] = r[i] ? r[i] : L[i] || L[Q[i] || "log"] || w;
+  }), e[A] = s;
+}
+function Z(e, t) {
+  return Array.isArray(e) ? e.filter(function(s) {
+    return s !== "!stdSerializers.err";
+  }) : e === !0 ? Object.keys(t) : !1;
+}
+function v(e) {
+  e = e || {}, e.browser = e.browser || {};
+  const t = e.browser.transmit;
+  if (t && typeof t.send != "function")
+    throw Error("pino: transmit option must have a send function");
+  const r = e.browser.write || L;
+  e.browser.write && (e.browser.asObject = !0);
+  const s = e.serializers || {}, i = Z(e.browser.serialize, s);
+  let l = e.browser.serialize;
+  Array.isArray(e.browser.serialize) && e.browser.serialize.indexOf("!stdSerializers.err") > -1 && (l = !1);
+  const f = Object.keys(e.customLevels || {}), c = ["error", "fatal", "warn", "info", "debug", "trace"].concat(f);
+  typeof r == "function" && c.forEach(function(h) {
+    r[h] = r;
+  }), (e.enabled === !1 || e.browser.disabled) && (e.level = "silent");
+  const d = e.level || "info", n = Object.create(r);
+  n.log || (n.log = w), X(n, c, r), B({}, n), Object.defineProperty(n, "levelVal", {
+    get: o
+  }), Object.defineProperty(n, "level", {
+    get: b,
+    set: u
+  });
+  const a = {
+    transmit: t,
+    serialize: i,
+    asObject: e.browser.asObject,
+    asObjectBindingsOnly: e.browser.asObjectBindingsOnly,
+    formatters: e.browser.formatters,
+    reportCaller: e.browser.reportCaller,
+    levels: c,
+    timestamp: ae(e),
+    messageKey: e.messageKey || "msg",
+    onChild: e.onChild || w
+  };
+  n.levels = ee(e), n.level = d, n.isLevelEnabled = function(h) {
+    return this.levels.values[h] ? this.levels.values[h] >= this.levels.values[this.level] : !1;
+  }, n.setMaxListeners = n.getMaxListeners = n.emit = n.addListener = n.on = n.prependListener = n.once = n.prependOnceListener = n.removeListener = n.removeAllListeners = n.listeners = n.listenerCount = n.eventNames = n.write = n.flush = w, n.serializers = s, n._serialize = i, n._stdErrSerialize = l, n.child = function(...h) {
+    return O.call(this, a, ...h);
+  }, t && (n._logEvent = x());
+  function o() {
+    return g(this.level, this);
+  }
+  function b() {
+    return this._level;
+  }
+  function u(h) {
+    if (h !== "silent" && !this.levels.values[h])
+      throw Error("unknown level " + h);
+    this._level = h, y(this, a, n, "error"), y(this, a, n, "fatal"), y(this, a, n, "warn"), y(this, a, n, "info"), y(this, a, n, "debug"), y(this, a, n, "trace"), f.forEach((m) => {
+      y(this, a, n, m);
+    });
+  }
+  function O(h, m, j) {
+    if (!m)
+      throw new Error("missing bindings for child Pino");
+    j = j || {}, i && m.serializers && (j.serializers = m.serializers);
+    const P = j.serializers;
+    if (i && P) {
+      var z = Object.assign({}, s, P), V = e.browser.serialize === !0 ? Object.keys(z) : i;
+      delete m.serializers, D([m], V, z, this._stdErrSerialize);
+    }
+    function M(E) {
+      this._childLevel = (E._childLevel | 0) + 1, this.bindings = m, z && (this.serializers = z, this._serialize = V), t && (this._logEvent = x(
+        [].concat(E._logEvent.bindings, m)
+      ));
+    }
+    M.prototype = this;
+    const _ = new M(this);
+    return B(this, _), _.child = function(...E) {
+      return O.call(this, h, ...E);
+    }, _.level = j.level || this.level, h.onChild(_), _;
+  }
+  return n;
+}
+function ee(e) {
+  const t = e.customLevels || {}, r = Object.assign({}, v.levels.values, t), s = Object.assign({}, v.levels.labels, te(t));
+  return {
+    values: r,
+    labels: s
+  };
+}
+function te(e) {
+  const t = {};
+  return Object.keys(e).forEach(function(r) {
+    t[e[r]] = r;
+  }), t;
+}
+v.levels = {
+  values: {
+    fatal: 60,
+    error: 50,
+    warn: 40,
+    info: 30,
+    debug: 20,
+    trace: 10
+  },
+  labels: {
+    10: "trace",
+    20: "debug",
+    30: "info",
+    40: "warn",
+    50: "error",
+    60: "fatal"
+  }
+};
+v.stdSerializers = U;
+v.stdTimeFunctions = Object.assign({}, { nullTime: q, epochTime: H, unixTime: le, isoTime: ce });
+function ne(e) {
+  const t = [];
+  e.bindings && t.push(e.bindings);
+  let r = e[F];
+  for (; r.parent; )
+    r = r.parent, r.logger.bindings && t.push(r.logger.bindings);
+  return t.reverse();
+}
+function y(e, t, r, s) {
+  if (Object.defineProperty(e, s, {
+    value: g(e.level, r) > g(s, r) ? w : r[A][s],
+    writable: !0,
+    enumerable: !0,
+    configurable: !0
+  }), e[s] === w) {
+    if (!t.transmit)
+      return;
+    const l = t.transmit.level || e.level, f = g(l, r);
+    if (g(s, r) < f)
+      return;
+  }
+  e[s] = ie(e, t, r, s);
+  const i = ne(e);
+  i.length !== 0 && (e[s] = re(i, e[s]));
+}
+function re(e, t) {
+  return function() {
+    return t.apply(this, [...e, ...arguments]);
+  };
+}
+function ie(e, t, r, s) {
+  return /* @__PURE__ */ function(i) {
+    return function() {
+      const f = t.timestamp(), c = new Array(arguments.length), d = Object.getPrototypeOf && Object.getPrototypeOf(this) === L ? L : this;
+      for (var n = 0; n < c.length; n++)
+        c[n] = arguments[n];
+      var a = !1;
+      if (t.serialize && (D(c, this._serialize, this.serializers, this._stdErrSerialize), a = !0), t.asObject || t.formatters) {
+        const o = se(this, s, c, f, t);
+        if (t.reportCaller && o && o.length > 0 && o[0] && typeof o[0] == "object")
+          try {
+            const b = R();
+            b && (o[0].caller = b);
+          } catch {
+          }
+        i.call(d, ...o);
+      } else {
+        if (t.reportCaller)
+          try {
+            const o = R();
+            o && c.push(o);
+          } catch {
+          }
+        i.apply(d, c);
+      }
+      if (t.transmit) {
+        const o = t.transmit.level || e._level, b = g(o, r), u = g(s, r);
+        if (u < b)
+          return;
+        oe(this, {
+          ts: f,
+          methodLevel: s,
+          methodValue: u,
+          transmitLevel: o,
+          transmitValue: r.levels.values[t.transmit.level || e._level],
+          send: t.transmit.send,
+          val: g(e._level, r)
+        }, c, a);
+      }
+    };
+  }(e[A][s]);
+}
+function se(e, t, r, s, i) {
+  const {
+    level: l,
+    log: f = (o) => o
+  } = i.formatters || {}, c = r.slice();
+  let d = c[0];
+  const n = {};
+  let a = (e._childLevel | 0) + 1;
+  if (a < 1 && (a = 1), s && (n.time = s), l) {
+    const o = l(t, e.levels.values[t]);
+    Object.assign(n, o);
+  } else
+    n.level = e.levels.values[t];
+  if (i.asObjectBindingsOnly) {
+    if (d !== null && typeof d == "object")
+      for (; a-- && typeof c[0] == "object"; )
+        Object.assign(n, c.shift());
+    return [f(n), ...c];
+  } else {
+    if (d !== null && typeof d == "object") {
+      for (; a-- && typeof c[0] == "object"; )
+        Object.assign(n, c.shift());
+      d = c.length ? $(c.shift(), c) : void 0;
+    } else
+      typeof d == "string" && (d = $(c.shift(), c));
+    return d !== void 0 && (n[i.messageKey] = d), [f(n)];
+  }
+}
+function D(e, t, r, s) {
+  for (const i in e)
+    if (s && e[i] instanceof Error)
+      e[i] = v.stdSerializers.err(e[i]);
+    else if (typeof e[i] == "object" && !Array.isArray(e[i]) && t)
+      for (const l in e[i])
+        t.indexOf(l) > -1 && l in r && (e[i][l] = r[l](e[i][l]));
+}
+function oe(e, t, r, s = !1) {
+  const i = t.send, l = t.ts, f = t.methodLevel, c = t.methodValue, d = t.val, n = e._logEvent.bindings;
+  s || D(
+    r,
+    e._serialize || Object.keys(e.serializers),
+    e.serializers,
+    e._stdErrSerialize === void 0 ? !0 : e._stdErrSerialize
+  ), e._logEvent.ts = l, e._logEvent.messages = r.filter(function(a) {
+    return n.indexOf(a) === -1;
+  }), e._logEvent.level.label = f, e._logEvent.level.value = c, i(f, e._logEvent, d), e._logEvent = x(n);
+}
+function x(e) {
+  return {
+    ts: 0,
+    messages: [],
+    bindings: e || [],
+    level: { label: "", value: 0 }
+  };
+}
+function I(e) {
+  const t = {
+    type: e.constructor.name,
+    msg: e.message,
+    stack: e.stack
+  };
+  for (const r in e)
+    t[r] === void 0 && (t[r] = e[r]);
+  return t;
+}
+function ae(e) {
+  return typeof e.timestamp == "function" ? e.timestamp : e.timestamp === !1 ? q : H;
+}
+function S() {
+  return {};
+}
+function C(e) {
+  return e;
+}
+function w() {
+}
+function q() {
+  return !1;
+}
+function H() {
+  return Date.now();
+}
+function le() {
+  return Math.round(Date.now() / 1e3);
+}
+function ce() {
+  return new Date(Date.now()).toISOString();
+}
+function ue() {
+  function e(t) {
+    return typeof t < "u" && t;
+  }
+  try {
+    return typeof globalThis < "u" || Object.defineProperty(Object.prototype, "globalThis", {
+      get: function() {
+        return delete Object.prototype.globalThis, this.globalThis = this;
+      },
+      configurable: !0
+    }), globalThis;
+  } catch {
+    return e(self) || e(window) || e(this) || {};
+  }
+}
+T.exports.default = v;
+T.exports.pino = v;
+function R() {
+  const e = new Error().stack;
+  if (!e)
+    return null;
+  const t = e.split(`
+`);
+  for (let r = 1; r < t.length; r++) {
+    const s = t[r].trim();
+    if (/(^at\s+)?(createWrap|LOG|set\s*\(|asObject|Object\.apply|Function\.apply)/.test(s) || s.indexOf("browser.js") !== -1 || s.indexOf("node:internal") !== -1 || s.indexOf("node_modules") !== -1)
+      continue;
+    let i = s.match(/\((.*?):(\d+):(\d+)\)/);
+    if (i || (i = s.match(/at\s+(.*?):(\d+):(\d+)/)), i) {
+      const l = i[1], f = i[2], c = i[3];
+      return l + ":" + f + ":" + c;
+    }
+  }
+  return null;
+}
+var fe = T.exports;
+const p = /* @__PURE__ */ G(fe);
+class k {
+  constructor(t) {
+    this._inner = t;
+  }
+  info(t, r) {
+    this._inner.info(t, r);
+  }
+  error(t, r) {
+    this._inner.error(t, r);
+  }
+  debug(t, r) {
+    this._inner.debug(t, r);
+  }
+  warn(t, r) {
+    this._inner.warn(t, r);
+  }
+  /** Access the underlying pino logger for advanced usage. */
+  get pino() {
+    return this._inner;
+  }
+}
+function de(e, t) {
+  const r = e.ctx.get(k);
+  if (r !== void 0)
+    return r;
+  const s = new k(t.pino.child({ op: e.operation.id }));
+  return e.ctx.set(k, s), s;
+}
+function he(e) {
+  const t = e.level ?? "info", r = typeof e.destination == "string" && e.destination.length > 0, s = !r && !!process.stderr.isTTY, i = e.format ?? (s ? "pretty" : "json");
+  let l;
+  if (i === "pretty")
+    l = p({
+      level: t,
+      transport: {
+        target: "pino-pretty",
+        options: {
+          colorize: !r,
+          translateTime: "SYS:HH:MM:ss.l",
+          ignore: "pid,hostname",
+          ...r ? { destination: e.destination, mkdir: !0 } : { destination: 2 }
+        }
+      }
+    });
+  else {
+    const f = r ? p.destination({
+      dest: e.destination,
+      mkdir: !0,
+      sync: !0
+    }) : p.destination(2);
+    l = p({ level: t }, f);
+  }
+  return new k(l);
+}
+const be = new k(p({ level: "info" }, p.destination(2)));
+function W(e) {
+  return function(r, s) {
+    const i = de(r, e), l = r.operation.id, f = Date.now();
+    i.info({ op: l }, `→ ${l}`);
+    const c = s();
+    function d(n) {
+      return n !== null && typeof n == "object" && Symbol.asyncIterator in n;
+    }
+    return d(c) ? async function* () {
+      let a = 0;
+      try {
+        for await (const o of c)
+          a++, i.debug({ op: l, chunk: a }, `chunk ${a}`), yield o;
+        i.info({ op: l, ms: Date.now() - f, chunks: a }, `← ${l} ok`);
+      } catch (o) {
+        throw i.error({ op: l, ms: Date.now() - f, err: o }, `✗ ${l} stream error`), o;
+      }
+    }() : c.then(
+      (n) => (i.info({ op: l, ms: Date.now() - f }, `← ${l} ok`), n),
+      (n) => {
+        throw i.error({ op: l, ms: Date.now() - f, err: n }, `✗ ${l} error`), n;
+      }
+    );
+  };
+}
+const N = {
+  id: "logger",
+  description: "Layer plugin: wraps every operation with entry/exit/error logging (SPEC §7.2a / §8.1). Seeds Logger into call.ctx for downstream consumers.",
+  optionsSchema: {
+    type: "object",
+    properties: {
+      level: {
+        type: "string",
+        description: "pino log level (trace|debug|info|warn|error|fatal). Default: info.",
+        default: "info"
+      },
+      format: {
+        type: "string",
+        enum: ["json", "pretty"],
+        description: "Log output format. Default: pretty on a TTY stderr, json otherwise."
+      },
+      destination: {
+        type: "string",
+        description: "File path to write logs to. Default: stderr (fd 2). Never stdout."
+      }
+    }
+  },
+  capabilities: {
+    // ------------------------------------------------------------------
+    // target — retained as a no-op scaffold (generate-only, no serve).
+    //          The logger plugin does not project descriptor operations to
+    //          files; this block ensures `--type logger` does not throw.
+    // ------------------------------------------------------------------
+    target: {
+      name: "logger",
+      generate(e, t) {
+        return [];
+      }
+    },
+    // ------------------------------------------------------------------
+    // layer — the operative capability (SPEC §7.1 / §8 / §8.1 / §11).
+    //
+    // The layer function is built lazily on first call so opts (log level,
+    // format, destination) resolved at compose time are baked into the
+    // root logger instance.  For simplicity the default export uses the
+    // module-level `_defaultRoot` logger.  Consumers that need per-request
+    // option control should construct a plugin instance via `makeLoggerPlugin`.
+    // ------------------------------------------------------------------
+    layer: {
+      layer: W(be)
+    }
+  }
+};
+function me(e = {}) {
+  const t = he(e);
+  return {
+    ...N,
+    capabilities: {
+      ...N.capabilities,
+      layer: {
+        layer: W(t)
+      }
+    }
+  };
+}
+export {
+  k as Logger,
+  N as default,
+  N as loggerPlugin,
+  me as makeLoggerPlugin
+};

package/lib/plugin.d.ts

@@ -0,0 +1,70 @@
+import { Plugin } from '@adhd/apigen-core';
+import { Logger as PinoLogger } from 'pino';
+
+export interface LoggerOptions {
+    /** pino log level. Default: `info`. */
+    level?: string;
+    /**
+     * Output format. `pretty` is colorized human-readable; `json` is raw jsonl.
+     * Default: `pretty` when stderr is a TTY, else `json`.
+     */
+    format?: 'json' | 'pretty';
+    /**
+     * Where logs are written. Default: stderr (fd 2) — NEVER stdout, which is the
+     * MCP stdio JSON-RPC channel.
+     */
+    destination?: string;
+}
+/**
+ * Typed ctx extension key for the per-request pino Logger (SPEC §8.1 rule 3).
+ *
+ * Layers insert a Logger bound to this key; downstream layers and domain
+ * functions retrieve it via `call.ctx.get(Logger)`.
+ *
+ * @example
+ * ```ts
+ * // In the logger layer (already done by loggerPlugin):
+ * call.ctx.set(Logger, pinoInstance.child({ op: call.operation.id }))
+ * // In a downstream layer or domain function:
+ * const log = call.ctx.get(Logger)
+ * log?.info('hello from domain fn')
+ * ```
+ */
+export declare class Logger {
+    private readonly _inner;
+    constructor(_inner: PinoLogger);
+    info(obj: Record<string, unknown>, msg: string): void;
+    error(obj: Record<string, unknown>, msg: string): void;
+    debug(obj: Record<string, unknown>, msg: string): void;
+    warn(obj: Record<string, unknown>, msg: string): void;
+    /** Access the underlying pino logger for advanced usage. */
+    get pino(): PinoLogger;
+}
+/**
+ * v2 logger plugin (SPEC §7.2a / SPEC §8.1).
+ *
+ * Implements the `layer` capability only — it wraps every operation, logs
+ * entry/exit/error, and is stream-lifecycle aware (SPEC §11).
+ *
+ * Also seeds the per-request {@link Logger} into `call.ctx` so downstream
+ * layers and domain functions can read it via `call.ctx.get(Logger)`.
+ *
+ * The `target` capability is retained as a pass-through scaffold so the plugin
+ * can still be selected via `--type logger` without errors; it emits no files.
+ */
+export declare const loggerPlugin: Plugin<LoggerOptions>;
+/**
+ * Factory that returns a fully-configured logger plugin instance.
+ *
+ * Use this when you need per-deployment log level, format, or destination
+ * control at compose time rather than relying on the default export's
+ * built-in json/stderr defaults.
+ *
+ * @example
+ * ```ts
+ * import { makeLoggerPlugin } from '@adhd/apigen-plugin-logger'
+ * const invoke = createInvoker([makeLoggerPlugin({ level: 'debug', format: 'pretty' })])
+ * ```
+ */
+export declare function makeLoggerPlugin(opts?: LoggerOptions): Plugin<LoggerOptions>;
+export default loggerPlugin;

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@adhd/apigen-plugin-logger",
+  "version": "0.1.0",
+  "main": "./index.js",
+  "dependencies": {
+    "@adhd/apigen-core": "^0.1.0",
+    "pino": "10.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "./index.mjs",
+  "types": "./index.d.ts"
+}