@parsrun/service 0.1.28 → 0.1.30

package/dist/serialization/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/serialization/index.ts"],"sourcesContent":["/**\n * @parsrun/service - Serialization\n * JSON and MessagePack serializers\n */\n\n// ============================================================================\n// SERIALIZER INTERFACE\n// ============================================================================\n\n/**\n * Serializer interface for encoding/decoding data\n */\nexport interface Serializer {\n  /** Encode data to string or buffer */\n  encode(data: unknown): string | ArrayBuffer;\n  /** Decode string or buffer to data */\n  decode(raw: string | ArrayBuffer): unknown;\n  /** Content type for HTTP headers */\n  contentType: string;\n}\n\n// ============================================================================\n// JSON SERIALIZER\n// ============================================================================\n\n/**\n * JSON serializer (default)\n */\nexport const jsonSerializer: Serializer = {\n  encode(data: unknown): string {\n    return JSON.stringify(data);\n  },\n\n  decode(raw: string | ArrayBuffer): unknown {\n    if (raw instanceof ArrayBuffer) {\n      const decoder = new TextDecoder();\n      return JSON.parse(decoder.decode(raw));\n    }\n    return JSON.parse(raw);\n  },\n\n  contentType: \"application/json\",\n};\n\n// ============================================================================\n// MESSAGEPACK SERIALIZER (Lightweight implementation)\n// ============================================================================\n\n/**\n * Lightweight MessagePack encoder\n * Supports: null, boolean, number, string, array, object\n */\nfunction msgpackEncode(value: unknown): Uint8Array {\n  const parts: Uint8Array[] = [];\n\n  function encode(val: unknown): void {\n    if (val === null || val === undefined) {\n      parts.push(new Uint8Array([0xc0])); // nil\n      return;\n    }\n\n    if (typeof val === \"boolean\") {\n      parts.push(new Uint8Array([val ? 0xc3 : 0xc2]));\n      return;\n    }\n\n    if (typeof val === \"number\") {\n      if (Number.isInteger(val)) {\n        if (val >= 0 && val <= 127) {\n          // positive fixint\n          parts.push(new Uint8Array([val]));\n        } else if (val < 0 && val >= -32) {\n          // negative fixint\n          parts.push(new Uint8Array([val & 0xff]));\n        } else if (val >= 0 && val <= 0xff) {\n          // uint8\n          parts.push(new Uint8Array([0xcc, val]));\n        } else if (val >= 0 && val <= 0xffff) {\n          // uint16\n          parts.push(new Uint8Array([0xcd, (val >> 8) & 0xff, val & 0xff]));\n        } else if (val >= 0 && val <= 0xffffffff) {\n          // uint32\n          parts.push(\n            new Uint8Array([\n              0xce,\n              (val >> 24) & 0xff,\n              (val >> 16) & 0xff,\n              (val >> 8) & 0xff,\n              val & 0xff,\n            ])\n          );\n        } else if (val >= -128 && val <= 127) {\n          // int8\n          parts.push(new Uint8Array([0xd0, val & 0xff]));\n        } else if (val >= -32768 && val <= 32767) {\n          // int16\n          parts.push(new Uint8Array([0xd1, (val >> 8) & 0xff, val & 0xff]));\n        } else if (val >= -2147483648 && val <= 2147483647) {\n          // int32\n          parts.push(\n            new Uint8Array([\n              0xd2,\n              (val >> 24) & 0xff,\n              (val >> 16) & 0xff,\n              (val >> 8) & 0xff,\n              val & 0xff,\n            ])\n          );\n        } else {\n          // Fall back to float64 for large integers\n          const buffer = new ArrayBuffer(9);\n          const view = new DataView(buffer);\n          view.setUint8(0, 0xcb);\n          view.setFloat64(1, val, false);\n          parts.push(new Uint8Array(buffer));\n        }\n      } else {\n        // float64\n        const buffer = new ArrayBuffer(9);\n        const view = new DataView(buffer);\n        view.setUint8(0, 0xcb);\n        view.setFloat64(1, val, false);\n        parts.push(new Uint8Array(buffer));\n      }\n      return;\n    }\n\n    if (typeof val === \"string\") {\n      const encoded = new TextEncoder().encode(val);\n      const len = encoded.length;\n\n      if (len <= 31) {\n        // fixstr\n        parts.push(new Uint8Array([0xa0 | len]));\n      } else if (len <= 0xff) {\n        // str8\n        parts.push(new Uint8Array([0xd9, len]));\n      } else if (len <= 0xffff) {\n        // str16\n        parts.push(new Uint8Array([0xda, (len >> 8) & 0xff, len & 0xff]));\n      } else {\n        // str32\n        parts.push(\n          new Uint8Array([\n            0xdb,\n            (len >> 24) & 0xff,\n            (len >> 16) & 0xff,\n            (len >> 8) & 0xff,\n            len & 0xff,\n          ])\n        );\n      }\n      parts.push(encoded);\n      return;\n    }\n\n    if (Array.isArray(val)) {\n      const len = val.length;\n\n      if (len <= 15) {\n        // fixarray\n        parts.push(new Uint8Array([0x90 | len]));\n      } else if (len <= 0xffff) {\n        // array16\n        parts.push(new Uint8Array([0xdc, (len >> 8) & 0xff, len & 0xff]));\n      } else {\n        // array32\n        parts.push(\n          new Uint8Array([\n            0xdd,\n            (len >> 24) & 0xff,\n            (len >> 16) & 0xff,\n            (len >> 8) & 0xff,\n            len & 0xff,\n          ])\n        );\n      }\n\n      for (const item of val) {\n        encode(item);\n      }\n      return;\n    }\n\n    if (typeof val === \"object\") {\n      const keys = Object.keys(val as object);\n      const len = keys.length;\n\n      if (len <= 15) {\n        // fixmap\n        parts.push(new Uint8Array([0x80 | len]));\n      } else if (len <= 0xffff) {\n        // map16\n        parts.push(new Uint8Array([0xde, (len >> 8) & 0xff, len & 0xff]));\n      } else {\n        // map32\n        parts.push(\n          new Uint8Array([\n            0xdf,\n            (len >> 24) & 0xff,\n            (len >> 16) & 0xff,\n            (len >> 8) & 0xff,\n            len & 0xff,\n          ])\n        );\n      }\n\n      for (const key of keys) {\n        encode(key);\n        encode((val as Record<string, unknown>)[key]);\n      }\n      return;\n    }\n\n    // Unsupported type - encode as null\n    parts.push(new Uint8Array([0xc0]));\n  }\n\n  encode(value);\n\n  // Merge all parts\n  const totalLength = parts.reduce((sum, p) => sum + p.length, 0);\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const part of parts) {\n    result.set(part, offset);\n    offset += part.length;\n  }\n\n  return result;\n}\n\n/**\n * Lightweight MessagePack decoder\n */\nfunction msgpackDecode(buffer: Uint8Array): unknown {\n  let offset = 0;\n\n  function decode(): unknown {\n    if (offset >= buffer.length) {\n      throw new Error(\"Unexpected end of buffer\");\n    }\n\n    const byte = buffer[offset++]!;\n\n    // Positive fixint (0x00 - 0x7f)\n    if (byte <= 0x7f) {\n      return byte;\n    }\n\n    // Negative fixint (0xe0 - 0xff)\n    if (byte >= 0xe0) {\n      return byte - 256;\n    }\n\n    // Fixmap (0x80 - 0x8f)\n    if (byte >= 0x80 && byte <= 0x8f) {\n      const len = byte - 0x80;\n      const result: Record<string, unknown> = {};\n      for (let i = 0; i < len; i++) {\n        const key = decode() as string;\n        result[key] = decode();\n      }\n      return result;\n    }\n\n    // Fixarray (0x90 - 0x9f)\n    if (byte >= 0x90 && byte <= 0x9f) {\n      const len = byte - 0x90;\n      const result: unknown[] = [];\n      for (let i = 0; i < len; i++) {\n        result.push(decode());\n      }\n      return result;\n    }\n\n    // Fixstr (0xa0 - 0xbf)\n    if (byte >= 0xa0 && byte <= 0xbf) {\n      const len = byte - 0xa0;\n      const str = new TextDecoder().decode(buffer.subarray(offset, offset + len));\n      offset += len;\n      return str;\n    }\n\n    switch (byte) {\n      case 0xc0: // nil\n        return null;\n      case 0xc2: // false\n        return false;\n      case 0xc3: // true\n        return true;\n\n      case 0xcc: // uint8\n        return buffer[offset++];\n      case 0xcd: // uint16\n        return (buffer[offset++]! << 8) | buffer[offset++]!;\n      case 0xce: // uint32\n        return (\n          ((buffer[offset++]! << 24) >>> 0) +\n          (buffer[offset++]! << 16) +\n          (buffer[offset++]! << 8) +\n          buffer[offset++]!\n        );\n\n      case 0xd0: // int8\n        {\n          const val = buffer[offset++]!;\n          return val > 127 ? val - 256 : val;\n        }\n      case 0xd1: // int16\n        {\n          const val = (buffer[offset++]! << 8) | buffer[offset++]!;\n          return val > 32767 ? val - 65536 : val;\n        }\n      case 0xd2: // int32\n        {\n          const val =\n            (buffer[offset++]! << 24) |\n            (buffer[offset++]! << 16) |\n            (buffer[offset++]! << 8) |\n            buffer[offset++]!;\n          return val;\n        }\n\n      case 0xcb: // float64\n        {\n          const view = new DataView(buffer.buffer, buffer.byteOffset + offset, 8);\n          offset += 8;\n          return view.getFloat64(0, false);\n        }\n\n      case 0xd9: // str8\n        {\n          const len = buffer[offset++]!;\n          const str = new TextDecoder().decode(buffer.subarray(offset, offset + len));\n          offset += len;\n          return str;\n        }\n      case 0xda: // str16\n        {\n          const len = (buffer[offset++]! << 8) | buffer[offset++]!;\n          const str = new TextDecoder().decode(buffer.subarray(offset, offset + len));\n          offset += len;\n          return str;\n        }\n      case 0xdb: // str32\n        {\n          const len =\n            (buffer[offset++]! << 24) |\n            (buffer[offset++]! << 16) |\n            (buffer[offset++]! << 8) |\n            buffer[offset++]!;\n          const str = new TextDecoder().decode(buffer.subarray(offset, offset + len));\n          offset += len;\n          return str;\n        }\n\n      case 0xdc: // array16\n        {\n          const len = (buffer[offset++]! << 8) | buffer[offset++]!;\n          const result: unknown[] = [];\n          for (let i = 0; i < len; i++) {\n            result.push(decode());\n          }\n          return result;\n        }\n      case 0xdd: // array32\n        {\n          const len =\n            (buffer[offset++]! << 24) |\n            (buffer[offset++]! << 16) |\n            (buffer[offset++]! << 8) |\n            buffer[offset++]!;\n          const result: unknown[] = [];\n          for (let i = 0; i < len; i++) {\n            result.push(decode());\n          }\n          return result;\n        }\n\n      case 0xde: // map16\n        {\n          const len = (buffer[offset++]! << 8) | buffer[offset++]!;\n          const result: Record<string, unknown> = {};\n          for (let i = 0; i < len; i++) {\n            const key = decode() as string;\n            result[key] = decode();\n          }\n          return result;\n        }\n      case 0xdf: // map32\n        {\n          const len =\n            (buffer[offset++]! << 24) |\n            (buffer[offset++]! << 16) |\n            (buffer[offset++]! << 8) |\n            buffer[offset++]!;\n          const result: Record<string, unknown> = {};\n          for (let i = 0; i < len; i++) {\n            const key = decode() as string;\n            result[key] = decode();\n          }\n          return result;\n        }\n\n      default:\n        throw new Error(`Unknown MessagePack type: 0x${byte.toString(16)}`);\n    }\n  }\n\n  return decode();\n}\n\n/**\n * MessagePack serializer\n */\nexport const msgpackSerializer: Serializer = {\n  encode(data: unknown): ArrayBuffer {\n    const encoded = msgpackEncode(data);\n    // Create a new ArrayBuffer with the exact bytes from the Uint8Array\n    const buffer = new ArrayBuffer(encoded.byteLength);\n    new Uint8Array(buffer).set(encoded);\n    return buffer;\n  },\n\n  decode(raw: string | ArrayBuffer): unknown {\n    if (typeof raw === \"string\") {\n      // If string is passed, assume it's base64 encoded\n      const binary = atob(raw);\n      const bytes = new Uint8Array(binary.length);\n      for (let i = 0; i < binary.length; i++) {\n        bytes[i] = binary.charCodeAt(i);\n      }\n      return msgpackDecode(bytes);\n    }\n    return msgpackDecode(new Uint8Array(raw));\n  },\n\n  contentType: \"application/msgpack\",\n};\n\n// ============================================================================\n// SERIALIZER FACTORY\n// ============================================================================\n\n/**\n * Get serializer by format name\n */\nexport function getSerializer(format: \"json\" | \"msgpack\"): Serializer {\n  switch (format) {\n    case \"json\":\n      return jsonSerializer;\n    case \"msgpack\":\n      return msgpackSerializer;\n    default:\n      return jsonSerializer;\n  }\n}\n\n/**\n * Create a custom serializer\n */\nexport function createSerializer(options: {\n  encode: (data: unknown) => string | ArrayBuffer;\n  decode: (raw: string | ArrayBuffer) => unknown;\n  contentType: string;\n}): Serializer {\n  return options;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/serialization/index.ts"],"sourcesContent":["/**\n * @parsrun/service - Serialization\n * JSON and MessagePack serializers\n */\n\n// ============================================================================\n// SERIALIZER INTERFACE\n// ============================================================================\n\n/**\n * Serializer interface for encoding/decoding data\n */\nexport interface Serializer {\n  /** Encode data to string or buffer */\n  encode(data: unknown): string | ArrayBuffer;\n  /** Decode string or buffer to data */\n  decode(raw: string | ArrayBuffer): unknown;\n  /** Content type for HTTP headers */\n  contentType: string;\n}\n\n// ============================================================================\n// JSON SERIALIZER\n// ============================================================================\n\n/**\n * JSON serializer (default)\n */\nexport const jsonSerializer: Serializer = {\n  encode(data: unknown): string {\n    return JSON.stringify(data);\n  },\n\n  decode(raw: string | ArrayBuffer): unknown {\n    if (raw instanceof ArrayBuffer) {\n      const decoder = new TextDecoder();\n      return JSON.parse(decoder.decode(raw));\n    }\n    return JSON.parse(raw);\n  },\n\n  contentType: \"application/json\",\n};\n\n// ============================================================================\n// MESSAGEPACK SERIALIZER (Lightweight implementation)\n// ============================================================================\n\n/**\n * Lightweight MessagePack encoder\n * Supports: null, boolean, number, string, array, object\n */\nfunction msgpackEncode(value: unknown): Uint8Array {\n  const parts: Uint8Array[] = [];\n\n  function encode(val: unknown): void {\n    if (val === null || val === undefined) {\n      parts.push(new Uint8Array([0xc0])); // nil\n      return;\n    }\n\n    if (typeof val === \"boolean\") {\n      parts.push(new Uint8Array([val ? 0xc3 : 0xc2]));\n      return;\n    }\n\n    if (typeof val === \"number\") {\n      if (Number.isInteger(val)) {\n        if (val >= 0 && val <= 127) {\n          // positive fixint\n          parts.push(new Uint8Array([val]));\n        } else if (val < 0 && val >= -32) {\n          // negative fixint\n          parts.push(new Uint8Array([val & 0xff]));\n        } else if (val >= 0 && val <= 0xff) {\n          // uint8\n          parts.push(new Uint8Array([0xcc, val]));\n        } else if (val >= 0 && val <= 0xffff) {\n          // uint16\n          parts.push(new Uint8Array([0xcd, (val >> 8) & 0xff, val & 0xff]));\n        } else if (val >= 0 && val <= 0xffffffff) {\n          // uint32\n          parts.push(\n            new Uint8Array([\n              0xce,\n              (val >> 24) & 0xff,\n              (val >> 16) & 0xff,\n              (val >> 8) & 0xff,\n              val & 0xff,\n            ])\n          );\n        } else if (val >= -128 && val <= 127) {\n          // int8\n          parts.push(new Uint8Array([0xd0, val & 0xff]));\n        } else if (val >= -32768 && val <= 32767) {\n          // int16\n          parts.push(new Uint8Array([0xd1, (val >> 8) & 0xff, val & 0xff]));\n        } else if (val >= -2147483648 && val <= 2147483647) {\n          // int32\n          parts.push(\n            new Uint8Array([\n              0xd2,\n              (val >> 24) & 0xff,\n              (val >> 16) & 0xff,\n              (val >> 8) & 0xff,\n              val & 0xff,\n            ])\n          );\n        } else {\n          // Fall back to float64 for large integers\n          const buffer = new ArrayBuffer(9);\n          const view = new DataView(buffer);\n          view.setUint8(0, 0xcb);\n          view.setFloat64(1, val, false);\n          parts.push(new Uint8Array(buffer));\n        }\n      } else {\n        // float64\n        const buffer = new ArrayBuffer(9);\n        const view = new DataView(buffer);\n        view.setUint8(0, 0xcb);\n        view.setFloat64(1, val, false);\n        parts.push(new Uint8Array(buffer));\n      }\n      return;\n    }\n\n    if (typeof val === \"string\") {\n      const encoded = new TextEncoder().encode(val);\n      const len = encoded.length;\n\n      if (len <= 31) {\n        // fixstr\n        parts.push(new Uint8Array([0xa0 | len]));\n      } else if (len <= 0xff) {\n        // str8\n        parts.push(new Uint8Array([0xd9, len]));\n      } else if (len <= 0xffff) {\n        // str16\n        parts.push(new Uint8Array([0xda, (len >> 8) & 0xff, len & 0xff]));\n      } else {\n        // str32\n        parts.push(\n          new Uint8Array([\n            0xdb,\n            (len >> 24) & 0xff,\n            (len >> 16) & 0xff,\n            (len >> 8) & 0xff,\n            len & 0xff,\n          ])\n        );\n      }\n      parts.push(encoded);\n      return;\n    }\n\n    if (Array.isArray(val)) {\n      const len = val.length;\n\n      if (len <= 15) {\n        // fixarray\n        parts.push(new Uint8Array([0x90 | len]));\n      } else if (len <= 0xffff) {\n        // array16\n        parts.push(new Uint8Array([0xdc, (len >> 8) & 0xff, len & 0xff]));\n      } else {\n        // array32\n        parts.push(\n          new Uint8Array([\n            0xdd,\n            (len >> 24) & 0xff,\n            (len >> 16) & 0xff,\n            (len >> 8) & 0xff,\n            len & 0xff,\n          ])\n        );\n      }\n\n      for (const item of val) {\n        encode(item);\n      }\n      return;\n    }\n\n    if (typeof val === \"object\") {\n      const keys = Object.keys(val as object);\n      const len = keys.length;\n\n      if (len <= 15) {\n        // fixmap\n        parts.push(new Uint8Array([0x80 | len]));\n      } else if (len <= 0xffff) {\n        // map16\n        parts.push(new Uint8Array([0xde, (len >> 8) & 0xff, len & 0xff]));\n      } else {\n        // map32\n        parts.push(\n          new Uint8Array([\n            0xdf,\n            (len >> 24) & 0xff,\n            (len >> 16) & 0xff,\n            (len >> 8) & 0xff,\n            len & 0xff,\n          ])\n        );\n      }\n\n      for (const key of keys) {\n        encode(key);\n        encode((val as Record<string, unknown>)[key]);\n      }\n      return;\n    }\n\n    // Unsupported type - encode as null\n    parts.push(new Uint8Array([0xc0]));\n  }\n\n  encode(value);\n\n  // Merge all parts\n  const totalLength = parts.reduce((sum, p) => sum + p.length, 0);\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const part of parts) {\n    result.set(part, offset);\n    offset += part.length;\n  }\n\n  return result;\n}\n\n/**\n * Lightweight MessagePack decoder\n */\nfunction msgpackDecode(buffer: Uint8Array): unknown {\n  let offset = 0;\n\n  function decode(): unknown {\n    if (offset >= buffer.length) {\n      throw new Error(\"Unexpected end of buffer\");\n    }\n\n    const byte = buffer[offset++]!;\n\n    // Positive fixint (0x00 - 0x7f)\n    if (byte <= 0x7f) {\n      return byte;\n    }\n\n    // Negative fixint (0xe0 - 0xff)\n    if (byte >= 0xe0) {\n      return byte - 256;\n    }\n\n    // Fixmap (0x80 - 0x8f)\n    if (byte >= 0x80 && byte <= 0x8f) {\n      const len = byte - 0x80;\n      const result: Record<string, unknown> = {};\n      for (let i = 0; i < len; i++) {\n        const key = decode() as string;\n        result[key] = decode();\n      }\n      return result;\n    }\n\n    // Fixarray (0x90 - 0x9f)\n    if (byte >= 0x90 && byte <= 0x9f) {\n      const len = byte - 0x90;\n      const result: unknown[] = [];\n      for (let i = 0; i < len; i++) {\n        result.push(decode());\n      }\n      return result;\n    }\n\n    // Fixstr (0xa0 - 0xbf)\n    if (byte >= 0xa0 && byte <= 0xbf) {\n      const len = byte - 0xa0;\n      const str = new TextDecoder().decode(buffer.subarray(offset, offset + len));\n      offset += len;\n      return str;\n    }\n\n    switch (byte) {\n      case 0xc0: // nil\n        return null;\n      case 0xc2: // false\n        return false;\n      case 0xc3: // true\n        return true;\n\n      case 0xcc: // uint8\n        return buffer[offset++];\n      case 0xcd: // uint16\n        return (buffer[offset++]! << 8) | buffer[offset++]!;\n      case 0xce: // uint32\n        return (\n          ((buffer[offset++]! << 24) >>> 0) +\n          (buffer[offset++]! << 16) +\n          (buffer[offset++]! << 8) +\n          buffer[offset++]!\n        );\n\n      case 0xd0: // int8\n        {\n          const val = buffer[offset++]!;\n          return val > 127 ? val - 256 : val;\n        }\n      case 0xd1: // int16\n        {\n          const val = (buffer[offset++]! << 8) | buffer[offset++]!;\n          return val > 32767 ? val - 65536 : val;\n        }\n      case 0xd2: // int32\n        {\n          const val =\n            (buffer[offset++]! << 24) |\n            (buffer[offset++]! << 16) |\n            (buffer[offset++]! << 8) |\n            buffer[offset++]!;\n          return val;\n        }\n\n      case 0xcb: // float64\n        {\n          const view = new DataView(buffer.buffer, buffer.byteOffset + offset, 8);\n          offset += 8;\n          return view.getFloat64(0, false);\n        }\n\n      case 0xd9: // str8\n        {\n          const len = buffer[offset++]!;\n          const str = new TextDecoder().decode(buffer.subarray(offset, offset + len));\n          offset += len;\n          return str;\n        }\n      case 0xda: // str16\n        {\n          const len = (buffer[offset++]! << 8) | buffer[offset++]!;\n          const str = new TextDecoder().decode(buffer.subarray(offset, offset + len));\n          offset += len;\n          return str;\n        }\n      case 0xdb: // str32\n        {\n          const len =\n            (buffer[offset++]! << 24) |\n            (buffer[offset++]! << 16) |\n            (buffer[offset++]! << 8) |\n            buffer[offset++]!;\n          const str = new TextDecoder().decode(buffer.subarray(offset, offset + len));\n          offset += len;\n          return str;\n        }\n\n      case 0xdc: // array16\n        {\n          const len = (buffer[offset++]! << 8) | buffer[offset++]!;\n          const result: unknown[] = [];\n          for (let i = 0; i < len; i++) {\n            result.push(decode());\n          }\n          return result;\n        }\n      case 0xdd: // array32\n        {\n          const len =\n            (buffer[offset++]! << 24) |\n            (buffer[offset++]! << 16) |\n            (buffer[offset++]! << 8) |\n            buffer[offset++]!;\n          const result: unknown[] = [];\n          for (let i = 0; i < len; i++) {\n            result.push(decode());\n          }\n          return result;\n        }\n\n      case 0xde: // map16\n        {\n          const len = (buffer[offset++]! << 8) | buffer[offset++]!;\n          const result: Record<string, unknown> = {};\n          for (let i = 0; i < len; i++) {\n            const key = decode() as string;\n            result[key] = decode();\n          }\n          return result;\n        }\n      case 0xdf: // map32\n        {\n          const len =\n            (buffer[offset++]! << 24) |\n            (buffer[offset++]! << 16) |\n            (buffer[offset++]! << 8) |\n            buffer[offset++]!;\n          const result: Record<string, unknown> = {};\n          for (let i = 0; i < len; i++) {\n            const key = decode() as string;\n            result[key] = decode();\n          }\n          return result;\n        }\n\n      default:\n        throw new Error(`Unknown MessagePack type: 0x${byte.toString(16)}`);\n    }\n  }\n\n  return decode();\n}\n\n/**\n * MessagePack serializer\n */\nexport const msgpackSerializer: Serializer = {\n  encode(data: unknown): ArrayBuffer {\n    const encoded = msgpackEncode(data);\n    // Create a new ArrayBuffer with the exact bytes from the Uint8Array\n    const buffer = new ArrayBuffer(encoded.byteLength);\n    new Uint8Array(buffer).set(encoded);\n    return buffer;\n  },\n\n  decode(raw: string | ArrayBuffer): unknown {\n    if (typeof raw === \"string\") {\n      // If string is passed, assume it's base64 encoded\n      const binary = atob(raw);\n      const bytes = new Uint8Array(binary.length);\n      for (let i = 0; i < binary.length; i++) {\n        bytes[i] = binary.charCodeAt(i);\n      }\n      return msgpackDecode(bytes);\n    }\n    return msgpackDecode(new Uint8Array(raw));\n  },\n\n  contentType: \"application/msgpack\",\n};\n\n// ============================================================================\n// SERIALIZER FACTORY\n// ============================================================================\n\n/**\n * Get a serializer by format name.\n *\n * @param format - The serialization format (\"json\" or \"msgpack\")\n * @returns The corresponding serializer instance\n *\n * @example\n * ```typescript\n * const serializer = getSerializer('json');\n * const encoded = serializer.encode({ foo: 'bar' });\n * const decoded = serializer.decode(encoded);\n * ```\n */\nexport function getSerializer(format: \"json\" | \"msgpack\"): Serializer {\n  switch (format) {\n    case \"json\":\n      return jsonSerializer;\n    case \"msgpack\":\n      return msgpackSerializer;\n    default:\n      return jsonSerializer;\n  }\n}\n\n/**\n * Create a custom serializer with provided encode/decode functions.\n *\n * @param options - Serializer configuration\n * @param options.encode - Function to encode data to string or ArrayBuffer\n * @param options.decode - Function to decode string or ArrayBuffer to data\n * @param options.contentType - HTTP content type for the serialization format\n * @returns A custom serializer instance\n *\n * @example\n * ```typescript\n * const customSerializer = createSerializer({\n *   encode: (data) => btoa(JSON.stringify(data)),\n *   decode: (raw) => JSON.parse(atob(raw as string)),\n *   contentType: 'application/x-custom',\n * });\n * ```\n */\nexport function createSerializer(options: {\n  encode: (data: unknown) => string | ArrayBuffer;\n  decode: (raw: string | ArrayBuffer) => unknown;\n  contentType: string;\n}): Serializer {\n  return options;\n}\n"],"mappings":";AA4BO,IAAM,iBAA6B;AAAA,EACxC,OAAO,MAAuB;AAC5B,WAAO,KAAK,UAAU,IAAI;AAAA,EAC5B;AAAA,EAEA,OAAO,KAAoC;AACzC,QAAI,eAAe,aAAa;AAC9B,YAAM,UAAU,IAAI,YAAY;AAChC,aAAO,KAAK,MAAM,QAAQ,OAAO,GAAG,CAAC;AAAA,IACvC;AACA,WAAO,KAAK,MAAM,GAAG;AAAA,EACvB;AAAA,EAEA,aAAa;AACf;AAUA,SAAS,cAAc,OAA4B;AACjD,QAAM,QAAsB,CAAC;AAE7B,WAAS,OAAO,KAAoB;AAClC,QAAI,QAAQ,QAAQ,QAAQ,QAAW;AACrC,YAAM,KAAK,IAAI,WAAW,CAAC,GAAI,CAAC,CAAC;AACjC;AAAA,IACF;AAEA,QAAI,OAAO,QAAQ,WAAW;AAC5B,YAAM,KAAK,IAAI,WAAW,CAAC,MAAM,MAAO,GAAI,CAAC,CAAC;AAC9C;AAAA,IACF;AAEA,QAAI,OAAO,QAAQ,UAAU;AAC3B,UAAI,OAAO,UAAU,GAAG,GAAG;AACzB,YAAI,OAAO,KAAK,OAAO,KAAK;AAE1B,gBAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;AAAA,QAClC,WAAW,MAAM,KAAK,OAAO,KAAK;AAEhC,gBAAM,KAAK,IAAI,WAAW,CAAC,MAAM,GAAI,CAAC,CAAC;AAAA,QACzC,WAAW,OAAO,KAAK,OAAO,KAAM;AAElC,gBAAM,KAAK,IAAI,WAAW,CAAC,KAAM,GAAG,CAAC,CAAC;AAAA,QACxC,WAAW,OAAO,KAAK,OAAO,OAAQ;AAEpC,gBAAM,KAAK,IAAI,WAAW,CAAC,KAAO,OAAO,IAAK,KAAM,MAAM,GAAI,CAAC,CAAC;AAAA,QAClE,WAAW,OAAO,KAAK,OAAO,YAAY;AAExC,gBAAM;AAAA,YACJ,IAAI,WAAW;AAAA,cACb;AAAA,cACC,OAAO,KAAM;AAAA,cACb,OAAO,KAAM;AAAA,cACb,OAAO,IAAK;AAAA,cACb,MAAM;AAAA,YACR,CAAC;AAAA,UACH;AAAA,QACF,WAAW,OAAO,QAAQ,OAAO,KAAK;AAEpC,gBAAM,KAAK,IAAI,WAAW,CAAC,KAAM,MAAM,GAAI,CAAC,CAAC;AAAA,QAC/C,WAAW,OAAO,UAAU,OAAO,OAAO;AAExC,gBAAM,KAAK,IAAI,WAAW,CAAC,KAAO,OAAO,IAAK,KAAM,MAAM,GAAI,CAAC,CAAC;AAAA,QAClE,WAAW,OAAO,eAAe,OAAO,YAAY;AAElD,gBAAM;AAAA,YACJ,IAAI,WAAW;AAAA,cACb;AAAA,cACC,OAAO,KAAM;AAAA,cACb,OAAO,KAAM;AAAA,cACb,OAAO,IAAK;AAAA,cACb,MAAM;AAAA,YACR,CAAC;AAAA,UACH;AAAA,QACF,OAAO;AAEL,gBAAM,SAAS,IAAI,YAAY,CAAC;AAChC,gBAAM,OAAO,IAAI,SAAS,MAAM;AAChC,eAAK,SAAS,GAAG,GAAI;AACrB,eAAK,WAAW,GAAG,KAAK,KAAK;AAC7B,gBAAM,KAAK,IAAI,WAAW,MAAM,CAAC;AAAA,QACnC;AAAA,MACF,OAAO;AAEL,cAAM,SAAS,IAAI,YAAY,CAAC;AAChC,cAAM,OAAO,IAAI,SAAS,MAAM;AAChC,aAAK,SAAS,GAAG,GAAI;AACrB,aAAK,WAAW,GAAG,KAAK,KAAK;AAC7B,cAAM,KAAK,IAAI,WAAW,MAAM,CAAC;AAAA,MACnC;AACA;AAAA,IACF;AAEA,QAAI,OAAO,QAAQ,UAAU;AAC3B,YAAM,UAAU,IAAI,YAAY,EAAE,OAAO,GAAG;AAC5C,YAAM,MAAM,QAAQ;AAEpB,UAAI,OAAO,IAAI;AAEb,cAAM,KAAK,IAAI,WAAW,CAAC,MAAO,GAAG,CAAC,CAAC;AAAA,MACzC,WAAW,OAAO,KAAM;AAEtB,cAAM,KAAK,IAAI,WAAW,CAAC,KAAM,GAAG,CAAC,CAAC;AAAA,MACxC,WAAW,OAAO,OAAQ;AAExB,cAAM,KAAK,IAAI,WAAW,CAAC,KAAO,OAAO,IAAK,KAAM,MAAM,GAAI,CAAC,CAAC;AAAA,MAClE,OAAO;AAEL,cAAM;AAAA,UACJ,IAAI,WAAW;AAAA,YACb;AAAA,YACC,OAAO,KAAM;AAAA,YACb,OAAO,KAAM;AAAA,YACb,OAAO,IAAK;AAAA,YACb,MAAM;AAAA,UACR,CAAC;AAAA,QACH;AAAA,MACF;AACA,YAAM,KAAK,OAAO;AAClB;AAAA,IACF;AAEA,QAAI,MAAM,QAAQ,GAAG,GAAG;AACtB,YAAM,MAAM,IAAI;AAEhB,UAAI,OAAO,IAAI;AAEb,cAAM,KAAK,IAAI,WAAW,CAAC,MAAO,GAAG,CAAC,CAAC;AAAA,MACzC,WAAW,OAAO,OAAQ;AAExB,cAAM,KAAK,IAAI,WAAW,CAAC,KAAO,OAAO,IAAK,KAAM,MAAM,GAAI,CAAC,CAAC;AAAA,MAClE,OAAO;AAEL,cAAM;AAAA,UACJ,IAAI,WAAW;AAAA,YACb;AAAA,YACC,OAAO,KAAM;AAAA,YACb,OAAO,KAAM;AAAA,YACb,OAAO,IAAK;AAAA,YACb,MAAM;AAAA,UACR,CAAC;AAAA,QACH;AAAA,MACF;AAEA,iBAAW,QAAQ,KAAK;AACtB,eAAO,IAAI;AAAA,MACb;AACA;AAAA,IACF;AAEA,QAAI,OAAO,QAAQ,UAAU;AAC3B,YAAM,OAAO,OAAO,KAAK,GAAa;AACtC,YAAM,MAAM,KAAK;AAEjB,UAAI,OAAO,IAAI;AAEb,cAAM,KAAK,IAAI,WAAW,CAAC,MAAO,GAAG,CAAC,CAAC;AAAA,MACzC,WAAW,OAAO,OAAQ;AAExB,cAAM,KAAK,IAAI,WAAW,CAAC,KAAO,OAAO,IAAK,KAAM,MAAM,GAAI,CAAC,CAAC;AAAA,MAClE,OAAO;AAEL,cAAM;AAAA,UACJ,IAAI,WAAW;AAAA,YACb;AAAA,YACC,OAAO,KAAM;AAAA,YACb,OAAO,KAAM;AAAA,YACb,OAAO,IAAK;AAAA,YACb,MAAM;AAAA,UACR,CAAC;AAAA,QACH;AAAA,MACF;AAEA,iBAAW,OAAO,MAAM;AACtB,eAAO,GAAG;AACV,eAAQ,IAAgC,GAAG,CAAC;AAAA,MAC9C;AACA;AAAA,IACF;AAGA,UAAM,KAAK,IAAI,WAAW,CAAC,GAAI,CAAC,CAAC;AAAA,EACnC;AAEA,SAAO,KAAK;AAGZ,QAAM,cAAc,MAAM,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,QAAQ,CAAC;AAC9D,QAAM,SAAS,IAAI,WAAW,WAAW;AACzC,MAAI,SAAS;AACb,aAAW,QAAQ,OAAO;AACxB,WAAO,IAAI,MAAM,MAAM;AACvB,cAAU,KAAK;AAAA,EACjB;AAEA,SAAO;AACT;AAKA,SAAS,cAAc,QAA6B;AAClD,MAAI,SAAS;AAEb,WAAS,SAAkB;AACzB,QAAI,UAAU,OAAO,QAAQ;AAC3B,YAAM,IAAI,MAAM,0BAA0B;AAAA,IAC5C;AAEA,UAAM,OAAO,OAAO,QAAQ;AAG5B,QAAI,QAAQ,KAAM;AAChB,aAAO;AAAA,IACT;AAGA,QAAI,QAAQ,KAAM;AAChB,aAAO,OAAO;AAAA,IAChB;AAGA,QAAI,QAAQ,OAAQ,QAAQ,KAAM;AAChC,YAAM,MAAM,OAAO;AACnB,YAAM,SAAkC,CAAC;AACzC,eAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,cAAM,MAAM,OAAO;AACnB,eAAO,GAAG,IAAI,OAAO;AAAA,MACvB;AACA,aAAO;AAAA,IACT;AAGA,QAAI,QAAQ,OAAQ,QAAQ,KAAM;AAChC,YAAM,MAAM,OAAO;AACnB,YAAM,SAAoB,CAAC;AAC3B,eAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,eAAO,KAAK,OAAO,CAAC;AAAA,MACtB;AACA,aAAO;AAAA,IACT;AAGA,QAAI,QAAQ,OAAQ,QAAQ,KAAM;AAChC,YAAM,MAAM,OAAO;AACnB,YAAM,MAAM,IAAI,YAAY,EAAE,OAAO,OAAO,SAAS,QAAQ,SAAS,GAAG,CAAC;AAC1E,gBAAU;AACV,aAAO;AAAA,IACT;AAEA,YAAQ,MAAM;AAAA,MACZ,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MAET,KAAK;AACH,eAAO,OAAO,QAAQ;AAAA,MACxB,KAAK;AACH,eAAQ,OAAO,QAAQ,KAAM,IAAK,OAAO,QAAQ;AAAA,MACnD,KAAK;AACH,gBACI,OAAO,QAAQ,KAAM,OAAQ,MAC9B,OAAO,QAAQ,KAAM,OACrB,OAAO,QAAQ,KAAM,KACtB,OAAO,QAAQ;AAAA,MAGnB,KAAK,KACH;AACE,cAAM,MAAM,OAAO,QAAQ;AAC3B,eAAO,MAAM,MAAM,MAAM,MAAM;AAAA,MACjC;AAAA,MACF,KAAK,KACH;AACE,cAAM,MAAO,OAAO,QAAQ,KAAM,IAAK,OAAO,QAAQ;AACtD,eAAO,MAAM,QAAQ,MAAM,QAAQ;AAAA,MACrC;AAAA,MACF,KAAK,KACH;AACE,cAAM,MACH,OAAO,QAAQ,KAAM,KACrB,OAAO,QAAQ,KAAM,KACrB,OAAO,QAAQ,KAAM,IACtB,OAAO,QAAQ;AACjB,eAAO;AAAA,MACT;AAAA,MAEF,KAAK,KACH;AACE,cAAM,OAAO,IAAI,SAAS,OAAO,QAAQ,OAAO,aAAa,QAAQ,CAAC;AACtE,kBAAU;AACV,eAAO,KAAK,WAAW,GAAG,KAAK;AAAA,MACjC;AAAA,MAEF,KAAK,KACH;AACE,cAAM,MAAM,OAAO,QAAQ;AAC3B,cAAM,MAAM,IAAI,YAAY,EAAE,OAAO,OAAO,SAAS,QAAQ,SAAS,GAAG,CAAC;AAC1E,kBAAU;AACV,eAAO;AAAA,MACT;AAAA,MACF,KAAK,KACH;AACE,cAAM,MAAO,OAAO,QAAQ,KAAM,IAAK,OAAO,QAAQ;AACtD,cAAM,MAAM,IAAI,YAAY,EAAE,OAAO,OAAO,SAAS,QAAQ,SAAS,GAAG,CAAC;AAC1E,kBAAU;AACV,eAAO;AAAA,MACT;AAAA,MACF,KAAK,KACH;AACE,cAAM,MACH,OAAO,QAAQ,KAAM,KACrB,OAAO,QAAQ,KAAM,KACrB,OAAO,QAAQ,KAAM,IACtB,OAAO,QAAQ;AACjB,cAAM,MAAM,IAAI,YAAY,EAAE,OAAO,OAAO,SAAS,QAAQ,SAAS,GAAG,CAAC;AAC1E,kBAAU;AACV,eAAO;AAAA,MACT;AAAA,MAEF,KAAK,KACH;AACE,cAAM,MAAO,OAAO,QAAQ,KAAM,IAAK,OAAO,QAAQ;AACtD,cAAM,SAAoB,CAAC;AAC3B,iBAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,iBAAO,KAAK,OAAO,CAAC;AAAA,QACtB;AACA,eAAO;AAAA,MACT;AAAA,MACF,KAAK,KACH;AACE,cAAM,MACH,OAAO,QAAQ,KAAM,KACrB,OAAO,QAAQ,KAAM,KACrB,OAAO,QAAQ,KAAM,IACtB,OAAO,QAAQ;AACjB,cAAM,SAAoB,CAAC;AAC3B,iBAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,iBAAO,KAAK,OAAO,CAAC;AAAA,QACtB;AACA,eAAO;AAAA,MACT;AAAA,MAEF,KAAK,KACH;AACE,cAAM,MAAO,OAAO,QAAQ,KAAM,IAAK,OAAO,QAAQ;AACtD,cAAM,SAAkC,CAAC;AACzC,iBAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,gBAAM,MAAM,OAAO;AACnB,iBAAO,GAAG,IAAI,OAAO;AAAA,QACvB;AACA,eAAO;AAAA,MACT;AAAA,MACF,KAAK,KACH;AACE,cAAM,MACH,OAAO,QAAQ,KAAM,KACrB,OAAO,QAAQ,KAAM,KACrB,OAAO,QAAQ,KAAM,IACtB,OAAO,QAAQ;AACjB,cAAM,SAAkC,CAAC;AACzC,iBAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,gBAAM,MAAM,OAAO;AACnB,iBAAO,GAAG,IAAI,OAAO;AAAA,QACvB;AACA,eAAO;AAAA,MACT;AAAA,MAEF;AACE,cAAM,IAAI,MAAM,+BAA+B,KAAK,SAAS,EAAE,CAAC,EAAE;AAAA,IACtE;AAAA,EACF;AAEA,SAAO,OAAO;AAChB;AAKO,IAAM,oBAAgC;AAAA,EAC3C,OAAO,MAA4B;AACjC,UAAM,UAAU,cAAc,IAAI;AAElC,UAAM,SAAS,IAAI,YAAY,QAAQ,UAAU;AACjD,QAAI,WAAW,MAAM,EAAE,IAAI,OAAO;AAClC,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,KAAoC;AACzC,QAAI,OAAO,QAAQ,UAAU;AAE3B,YAAM,SAAS,KAAK,GAAG;AACvB,YAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;AAC1C,eAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,cAAM,CAAC,IAAI,OAAO,WAAW,CAAC;AAAA,MAChC;AACA,aAAO,cAAc,KAAK;AAAA,IAC5B;AACA,WAAO,cAAc,IAAI,WAAW,GAAG,CAAC;AAAA,EAC1C;AAAA,EAEA,aAAa;AACf;AAmBO,SAAS,cAAc,QAAwC;AACpE,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAoBO,SAAS,iBAAiB,SAIlB;AACb,SAAO;AACT;","names":[]}

package/dist/{server-DFE8n2Sx.d.ts → server-BB9AbnkP.d.ts}

@@ -1,5 +1,5 @@
 import { Logger } from '@parsrun/core';
-import { b as ServiceDefinition, m as TraceContext, f as RpcRequest, g as RpcResponse } from './types-n4LLSPQU.js';
+import { b as ServiceDefinition, m as TraceContext, f as RpcRequest, g as RpcResponse } from './types-DHZaZwAt.js';
 
 /**
  * @parsrun/service - RPC Server
@@ -36,6 +36,9 @@ type RpcHandlers = {
     queries?: Record<string, RpcHandler>;
     mutations?: Record<string, RpcHandler>;
 };
+/**
+ * Options for creating an RPC server.
+ */
 interface RpcServerOptions {
     /** Service definition */
     definition: ServiceDefinition;
@@ -49,7 +52,13 @@ interface RpcServerOptions {
     middleware?: RpcMiddleware[];
 }
 /**
- * RPC middleware function
+ * RPC middleware function for request processing.
+ * Middleware can intercept, modify, or handle requests before/after handlers.
+ *
+ * @param request - The incoming RPC request
+ * @param context - Handler context with logger and metadata
+ * @param next - Function to call the next middleware or handler
+ * @returns Promise resolving to the handler result
  */
 type RpcMiddleware = (request: RpcRequest, context: RpcHandlerContext, next: () => Promise<unknown>) => Promise<unknown>;
 /**
@@ -87,19 +96,54 @@ declare class RpcServer {
     };
 }
 /**
- * Create an RPC server
+ * Create an RPC server for handling incoming requests.
+ *
+ * @param options - Server configuration options
+ * @returns A new RPC server instance
+ *
+ * @example
+ * ```typescript
+ * const server = createRpcServer({
+ *   definition: paymentsService,
+ *   handlers: {
+ *     queries: {
+ *       getSubscription: async (input, ctx) => {
+ *         return { status: 'active', plan: 'pro' };
+ *       },
+ *     },
+ *   },
+ *   middleware: [loggingMiddleware()],
+ * });
+ * ```
  */
 declare function createRpcServer(options: RpcServerOptions): RpcServer;
 /**
- * Logging middleware
+ * Create logging middleware for RPC requests.
+ * Logs request start and completion with input keys.
+ *
+ * @returns RPC middleware that logs requests
  */
 declare function loggingMiddleware(): RpcMiddleware;
 /**
- * Validation middleware (placeholder - integrate with ArkType)
+ * Create validation middleware for RPC request inputs.
+ * Applies validators to request inputs by method name.
+ *
+ * @param validators - Map of method names to validation functions
+ * @returns RPC middleware that validates inputs
+ *
+ * @example
+ * ```typescript
+ * const middleware = validationMiddleware({
+ *   createUser: (input) => validateUserInput(input),
+ * });
+ * ```
  */
 declare function validationMiddleware(validators: Record<string, (input: unknown) => unknown>): RpcMiddleware;
 /**
- * Tenant context middleware
+ * Create tenant context middleware.
+ * Extracts tenant ID from request metadata and adds it to the logger context.
+ *
+ * @returns RPC middleware that enriches logger with tenant context
  */
 declare function tenantMiddleware(): RpcMiddleware;
 

package/dist/tracing/index.d.ts

@@ -1,4 +1,4 @@
-import { m as TraceContext, o as SpanKind, q as SpanAttributeValue, n as Span, p as SpanStatus, T as TracingConfig } from '../types-n4LLSPQU.js';
+import { m as TraceContext, o as SpanKind, q as SpanAttributeValue, n as Span, p as SpanStatus, T as TracingConfig } from '../types-DHZaZwAt.js';
 import { Logger } from '@parsrun/core';
 
 /**
@@ -83,11 +83,21 @@ declare class TraceContextManager {
      */
     clear(): void;
 }
+/**
+ * Sampling configuration for tracing.
+ * - "always": Sample all traces
+ * - "never": Never sample traces
+ * - { ratio: number }: Sample a percentage of traces (0-1)
+ */
 type Sampler = "always" | "never" | {
     ratio: number;
 };
 /**
- * Determine if a trace should be sampled
+ * Determine if a trace should be sampled based on the sampler configuration.
+ *
+ * @param sampler - Sampling configuration
+ * @param traceId - Optional trace ID for deterministic sampling
+ * @returns Whether the trace should be sampled
  */
 declare function shouldSample(sampler: Sampler, traceId?: string): boolean;
 
@@ -96,6 +106,9 @@ declare function shouldSample(sampler: Sampler, traceId?: string): boolean;
  * Span creation and management
  */
 
+/**
+ * Options for creating a span.
+ */
 interface SpanOptions {
     /** Span name */
     name: string;
@@ -109,7 +122,10 @@ interface SpanOptions {
     startTime?: number;
 }
 /**
- * Create a new span
+ * Create a new span for tracing an operation.
+ *
+ * @param options - Span configuration options
+ * @returns A new span instance
  */
 declare function createSpan(options: SpanOptions): Span;
 /**
@@ -159,15 +175,24 @@ declare class SpanManager {
     clear(): void;
 }
 /**
- * Calculate span duration in milliseconds
+ * Calculate span duration in milliseconds.
+ *
+ * @param span - The span to measure
+ * @returns Duration in milliseconds, or undefined if not ended
  */
 declare function getSpanDuration(span: Span): number | undefined;
 /**
- * Check if span is completed
+ * Check if a span is completed (has an end time).
+ *
+ * @param span - The span to check
+ * @returns True if the span has been ended
  */
 declare function isSpanCompleted(span: Span): boolean;
 /**
- * Get span as simplified object (for logging)
+ * Convert a span to a simplified object for logging.
+ *
+ * @param span - The span to convert
+ * @returns A plain object representation of the span
  */
 declare function spanToLogObject(span: Span): Record<string, unknown>;
 /**
@@ -204,18 +229,28 @@ declare const SpanAttributes: {
  * Console and OTLP exporters for spans
  */
 
+/**
+ * Interface for span exporters.
+ * Exporters receive completed spans and send them to a backend.
+ */
 interface SpanExporter {
     /** Exporter name */
     readonly name: string;
-    /** Export spans */
+    /** Export spans to the backend */
     export(spans: Span[]): Promise<void>;
-    /** Shutdown exporter */
+    /** Shutdown exporter and flush pending spans */
     shutdown(): Promise<void>;
 }
+/**
+ * Base options for span exporters.
+ */
 interface ExporterOptions {
     /** Logger */
     logger?: Logger;
 }
+/**
+ * Options for the console exporter.
+ */
 interface ConsoleExporterOptions extends ExporterOptions {
     /** Pretty print (default: true in dev) */
     pretty?: boolean;
@@ -225,7 +260,8 @@ interface ConsoleExporterOptions extends ExporterOptions {
     includeEvents?: boolean;
 }
 /**
- * Console exporter for development/debugging
+ * Console exporter for development and debugging.
+ * Outputs spans to the console with optional pretty formatting.
  */
 declare class ConsoleExporter implements SpanExporter {
     readonly name = "console";
@@ -238,9 +274,15 @@ declare class ConsoleExporter implements SpanExporter {
     shutdown(): Promise<void>;
 }
 /**
- * Create a console exporter
+ * Create a console exporter for local development.
+ *
+ * @param options - Exporter configuration options
+ * @returns A new console exporter instance
  */
 declare function createConsoleExporter(options?: ConsoleExporterOptions): ConsoleExporter;
+/**
+ * Options for the OTLP exporter.
+ */
 interface OtlpExporterOptions extends ExporterOptions {
     /** OTLP endpoint URL */
     endpoint: string;
@@ -258,7 +300,8 @@ interface OtlpExporterOptions extends ExporterOptions {
     flushInterval?: number;
 }
 /**
- * OTLP exporter for production tracing
+ * OTLP exporter for production tracing.
+ * Sends spans to an OpenTelemetry-compatible backend via HTTP.
  */
 declare class OtlpExporter implements SpanExporter {
     readonly name = "otlp";
@@ -282,7 +325,18 @@ declare class OtlpExporter implements SpanExporter {
     shutdown(): Promise<void>;
 }
 /**
- * Create an OTLP exporter
+ * Create an OTLP exporter for production tracing.
+ *
+ * @param options - Exporter configuration options
+ * @returns A new OTLP exporter instance
+ *
+ * @example
+ * ```typescript
+ * const exporter = createOtlpExporter({
+ *   endpoint: 'https://otel-collector.example.com:4318',
+ *   serviceName: 'payments',
+ * });
+ * ```
  */
 declare function createOtlpExporter(options: OtlpExporterOptions): OtlpExporter;
 
@@ -291,6 +345,9 @@ declare function createOtlpExporter(options: OtlpExporterOptions): OtlpExporter;
  * High-level tracing API
  */
 
+/**
+ * Options for creating a tracer.
+ */
 interface TracerOptions {
     /** Service name */
     serviceName: string;
@@ -370,7 +427,21 @@ declare class Tracer {
     shutdown(): Promise<void>;
 }
 /**
- * Create a tracer
+ * Create a tracer for distributed tracing.
+ *
+ * @param options - Tracer configuration options
+ * @returns A new tracer instance
+ *
+ * @example
+ * ```typescript
+ * const tracer = createTracer({
+ *   serviceName: 'payments',
+ *   config: { sampler: { ratio: 0.1 } },
+ * });
+ * await tracer.trace('processPayment', async (span) => {
+ *   // Processing logic
+ * });
+ * ```
  */
 declare function createTracer(options: TracerOptions): Tracer;
 /**
@@ -386,11 +457,19 @@ declare function setGlobalTracer(tracer: Tracer): void;
  */
 declare function resetGlobalTracer(): void;
 /**
- * Create HTTP server tracing middleware
+ * Create HTTP server tracing middleware.
+ * Automatically creates spans for incoming HTTP requests.
+ *
+ * @param tracer - The tracer instance to use
+ * @returns Middleware function for HTTP frameworks
  */
 declare function createTracingMiddleware(tracer: Tracer): (request: Request, next: () => Promise<Response>) => Promise<Response>;
 /**
- * Create RPC tracing helpers
+ * Create RPC tracing helpers for instrumenting RPC calls.
+ * Provides methods to trace outgoing calls and incoming handlers.
+ *
+ * @param tracer - The tracer instance to use
+ * @returns Object with traceCall and traceHandler methods
  */
 declare function createRpcTracing(tracer: Tracer): {
     /**