har-mcp 0.1.0

package/src/tools/read-har/schema.ts

@@ -0,0 +1,82 @@
+/**
+ * Schema Definition for Read HAR Tool
+ */
+
+import { z } from "zod"
+
+export const readHarSchema = z.object({
+  path: z.string().describe("Path to the HAR file"),
+
+  mode: z
+    .enum(["summary", "list", "detail", "content", "stats", "timeline", "size", "cookies"])
+    .default("summary")
+    .describe(
+      "Output mode: summary (overview), list (entries), detail (full metadata), content (with body), stats (aggregate by endpoint), timeline (waterfall visualization), size (payload size analysis), cookies (cookie propagation tracking)",
+    ),
+
+  // Pagination
+  page: z.number().int().min(1).default(1),
+  pageSize: z.number().int().min(1).max(100).default(20),
+
+  // Entry selection (required for content mode)
+  entries: z
+    .array(z.number().int().min(0))
+    .max(10)
+    .optional()
+    .describe("Specific entry indexes to return (required for content mode)"),
+
+  // Filtering
+  filter: z
+    .object({
+      url: z.string().optional().describe("URL pattern (substring, glob with *, or ~regex)"),
+      method: z.union([z.string(), z.array(z.string())]).optional(),
+      status: z
+        .union([
+          z.number(),
+          z.string().regex(/^\d{1}xx$/i),
+          z.object({ min: z.number().optional(), max: z.number().optional() }),
+        ])
+        .optional(),
+      contentType: z.string().optional(),
+      minDuration: z.number().optional(),
+      hasError: z.boolean().optional(),
+      bodyContains: z.string().optional().describe("Filter entries whose response body contains this string"),
+    })
+    .optional(),
+
+  // Include options for detail mode
+  include: z
+    .object({
+      headers: z.boolean().optional().default(false),
+      cookies: z.boolean().optional().default(false),
+      timing: z.boolean().optional().default(true),
+      queryParams: z.boolean().optional().default(true),
+    })
+    .optional(),
+
+  // Content options
+  contentOptions: z
+    .object({
+      includeRequestBody: z.boolean().optional().default(false),
+      includeResponseBody: z.boolean().optional().default(true),
+      maxContentLength: z.number().optional().default(50000),
+    })
+    .optional(),
+
+  // Sorting
+  sort: z
+    .object({
+      by: z.enum(["index", "time", "duration", "size", "status"]).default("index"),
+      order: z.enum(["asc", "desc"]).default("asc"),
+    })
+    .optional(),
+
+  // Output format
+  format: z
+    .enum(["markdown", "json"])
+    .default("markdown")
+    .describe("Output format: markdown (default) or json for programmatic use"),
+})
+
+export type ReadHarInput = z.infer<typeof readHarSchema>
+export type ReadHarInputRaw = z.input<typeof readHarSchema>

package/src/tools/read-har.ts

@@ -0,0 +1,15 @@
+/**
+ * Read HAR Tool - Re-export for backward compatibility
+ *
+ * This file re-exports everything from the read-har module for backward compatibility.
+ * The actual implementation has been split into smaller, more maintainable sub-modules.
+ *
+ * @see ./read-har/index.ts for the main implementation
+ * @see ./read-har/schema.ts for schema definitions
+ * @see ./read-har/helpers.ts for helper functions
+ * @see ./read-har/filters.ts for filter and sort functions
+ * @see ./read-har/formatters/ for output formatters
+ */
+
+// Re-export everything for backward compatibility
+export * from "./read-har/index.ts"

package/src/types/har-to-curl.d.ts

@@ -0,0 +1,11 @@
+declare module "har-to-curl" {
+  /**
+   * Converts a HAR entry to a cURL command string
+   * @param entry - A HAR entry object following HAR 1.2 specification
+   * @returns The cURL command as a string
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  function harToCurl(entry: any): string
+
+  export default harToCurl
+}

package/src/types/har.ts

@@ -0,0 +1,386 @@
+import { z } from "zod"
+
+// ============================================================================
+// HAR 1.2 Type Definitions
+// Based on W3C HAR 1.2 Specification
+// ============================================================================
+
+// --- Name/Value Types ---
+
+export interface HarHeader {
+  name: string
+  value: string
+  comment?: string
+}
+
+export interface HarQueryParam {
+  name: string
+  value: string
+  comment?: string
+}
+
+export interface HarPostParam {
+  name: string
+  value?: string
+  fileName?: string
+  contentType?: string
+  comment?: string
+}
+
+export interface HarCookie {
+  name: string
+  value: string
+  path?: string
+  domain?: string
+  expires?: string
+  httpOnly?: boolean
+  secure?: boolean
+  comment?: string
+}
+
+// --- Creator/Browser ---
+
+export interface HarCreator {
+  name: string
+  version: string
+  comment?: string
+}
+
+export interface HarBrowser {
+  name: string
+  version: string
+  comment?: string
+}
+
+// --- Page Timings ---
+
+export interface HarPageTimings {
+  onContentLoad?: number
+  onLoad?: number
+  comment?: string
+}
+
+export interface HarPage {
+  startedDateTime: string
+  id: string
+  title: string
+  pageTimings: HarPageTimings
+  comment?: string
+}
+
+// --- Timings ---
+
+export interface HarTimings {
+  blocked?: number
+  dns?: number
+  connect?: number
+  send: number
+  wait: number
+  receive: number
+  ssl?: number
+  comment?: string
+}
+
+// --- Cache ---
+
+export interface HarCacheEntry {
+  expires?: string
+  lastAccess: string
+  eTag: string
+  hitCount: number
+  comment?: string
+}
+
+export interface HarCache {
+  beforeRequest?: HarCacheEntry | null
+  afterRequest?: HarCacheEntry | null
+  comment?: string
+}
+
+// --- Content ---
+
+export interface HarContent {
+  size: number
+  compression?: number
+  mimeType: string
+  text?: string
+  encoding?: string
+  comment?: string
+}
+
+export interface HarPostData {
+  mimeType: string
+  params?: HarPostParam[]
+  text?: string
+  comment?: string
+}
+
+// --- Request/Response ---
+
+export interface HarRequest {
+  method: string
+  url: string
+  httpVersion: string
+  cookies: HarCookie[]
+  headers: HarHeader[]
+  queryString: HarQueryParam[]
+  postData?: HarPostData
+  headersSize: number
+  bodySize: number
+  comment?: string
+}
+
+export interface HarResponse {
+  status: number
+  statusText: string
+  httpVersion: string
+  cookies: HarCookie[]
+  headers: HarHeader[]
+  content: HarContent
+  redirectURL: string
+  headersSize: number
+  bodySize: number
+  comment?: string
+}
+
+// --- Entry ---
+
+export interface HarEntry {
+  pageref?: string
+  startedDateTime: string
+  time: number
+  request: HarRequest
+  response: HarResponse
+  cache: HarCache
+  timings: HarTimings
+  serverIPAddress?: string
+  connection?: string
+  comment?: string
+}
+
+// --- Log ---
+
+export interface HarLog {
+  version: string
+  creator: HarCreator
+  browser?: HarBrowser
+  pages?: HarPage[]
+  entries: HarEntry[]
+  comment?: string
+}
+
+// --- Main HAR File ---
+
+export interface HarFile {
+  log: HarLog
+}
+
+// ============================================================================
+// Zod Schemas for Runtime Validation
+// ============================================================================
+
+export const HarHeaderSchema = z.object({
+  name: z.string(),
+  value: z.string(),
+  comment: z.string().optional(),
+})
+
+export const HarQueryParamSchema = z.object({
+  name: z.string(),
+  value: z.string(),
+  comment: z.string().optional(),
+})
+
+export const HarPostParamSchema = z.object({
+  name: z.string(),
+  value: z.string().optional(),
+  fileName: z.string().optional(),
+  contentType: z.string().optional(),
+  comment: z.string().optional(),
+})
+
+export const HarCookieSchema = z.object({
+  name: z.string(),
+  value: z.string(),
+  path: z.string().optional(),
+  domain: z.string().optional(),
+  expires: z.string().optional(),
+  httpOnly: z.boolean().optional(),
+  secure: z.boolean().optional(),
+  comment: z.string().optional(),
+})
+
+export const HarCreatorSchema = z.object({
+  name: z.string(),
+  version: z.string(),
+  comment: z.string().optional(),
+})
+
+export const HarBrowserSchema = z.object({
+  name: z.string(),
+  version: z.string(),
+  comment: z.string().optional(),
+})
+
+export const HarPageTimingsSchema = z.object({
+  onContentLoad: z.number().optional(),
+  onLoad: z.number().optional(),
+  comment: z.string().optional(),
+})
+
+export const HarPageSchema = z.object({
+  startedDateTime: z.string(),
+  id: z.string(),
+  title: z.string(),
+  pageTimings: HarPageTimingsSchema,
+  comment: z.string().optional(),
+})
+
+// Use .passthrough() to allow Chrome DevTools extensions (fields starting with _)
+export const HarTimingsSchema = z
+  .object({
+    blocked: z.number().optional(),
+    dns: z.number().optional(),
+    connect: z.number().optional(),
+    send: z.number(),
+    wait: z.number(),
+    receive: z.number(),
+    ssl: z.number().optional(),
+    comment: z.string().optional(),
+  })
+  .passthrough()
+
+export const HarCacheEntrySchema = z.object({
+  expires: z.string().optional(),
+  lastAccess: z.string(),
+  eTag: z.string(),
+  hitCount: z.number(),
+  comment: z.string().optional(),
+})
+
+// Chrome often exports empty cache objects - make this fully optional and passthrough
+export const HarCacheSchema = z
+  .object({
+    beforeRequest: HarCacheEntrySchema.nullable().optional(),
+    afterRequest: HarCacheEntrySchema.nullable().optional(),
+    comment: z.string().optional(),
+  })
+  .passthrough()
+
+// Chrome DevTools extensions: passthrough allows _transferSize, _error, _fetchedViaServiceWorker, etc.
+export const HarContentSchema = z
+  .object({
+    size: z.number(),
+    compression: z.number().optional(),
+    mimeType: z.string(),
+    text: z.string().optional(),
+    encoding: z.string().optional(),
+    comment: z.string().optional(),
+  })
+  .passthrough()
+
+export const HarPostDataSchema = z
+  .object({
+    mimeType: z.string(),
+    params: z.array(HarPostParamSchema).optional(),
+    text: z.string().optional(),
+    comment: z.string().optional(),
+  })
+  .passthrough()
+
+export const HarRequestSchema = z
+  .object({
+    method: z.string(),
+    url: z.string(),
+    httpVersion: z.string(),
+    cookies: z.array(HarCookieSchema),
+    headers: z.array(HarHeaderSchema),
+    queryString: z.array(HarQueryParamSchema),
+    postData: HarPostDataSchema.optional(),
+    headersSize: z.number(),
+    bodySize: z.number(),
+    comment: z.string().optional(),
+  })
+  .passthrough()
+
+// Chrome DevTools extensions: _transferSize, _error, _fetchedViaServiceWorker, etc.
+export const HarResponseSchema = z
+  .object({
+    status: z.number(),
+    statusText: z.string(),
+    httpVersion: z.string(),
+    cookies: z.array(HarCookieSchema),
+    headers: z.array(HarHeaderSchema),
+    content: HarContentSchema,
+    redirectURL: z.string(),
+    headersSize: z.number(),
+    bodySize: z.number(),
+    comment: z.string().optional(),
+  })
+  .passthrough()
+
+// Chrome DevTools extensions: _connectionId, _initiator, _priority, _resourceType, etc.
+export const HarEntrySchema = z
+  .object({
+    pageref: z.string().optional(),
+    startedDateTime: z.string(),
+    time: z.number(),
+    request: HarRequestSchema,
+    response: HarResponseSchema,
+    cache: HarCacheSchema,
+    timings: HarTimingsSchema,
+    serverIPAddress: z.string().optional(),
+    connection: z.string().optional(),
+    comment: z.string().optional(),
+  })
+  .passthrough()
+
+export const HarLogSchema = z
+  .object({
+    version: z.string(),
+    creator: HarCreatorSchema,
+    browser: HarBrowserSchema.optional(),
+    pages: z.array(HarPageSchema).optional(),
+    entries: z.array(HarEntrySchema),
+    comment: z.string().optional(),
+  })
+  .passthrough()
+
+export const HarFileSchema = z
+  .object({
+    log: HarLogSchema,
+  })
+  .passthrough()
+
+// ============================================================================
+// Type Inference from Zod Schemas (alternative types)
+// ============================================================================
+
+export type HarFileFromSchema = z.infer<typeof HarFileSchema>
+export type HarLogFromSchema = z.infer<typeof HarLogSchema>
+export type HarEntryFromSchema = z.infer<typeof HarEntrySchema>
+export type HarRequestFromSchema = z.infer<typeof HarRequestSchema>
+export type HarResponseFromSchema = z.infer<typeof HarResponseSchema>
+
+// ============================================================================
+// Validation Helper Functions
+// ============================================================================
+
+/**
+ * Validates a HAR file object against the HAR 1.2 specification
+ * @param data - The data to validate
+ * @returns The validated HarFile object
+ * @throws ZodError if validation fails
+ */
+export function validateHarFile(data: unknown): HarFile {
+  return HarFileSchema.parse(data)
+}
+
+/**
+ * Safely validates a HAR file object, returning a result object
+ * @param data - The data to validate
+ * @returns A Zod SafeParseReturnType with success status and data/error
+ */
+export function safeValidateHarFile(data: unknown) {
+  return HarFileSchema.safeParse(data)
+}