extractor

type AnalyzeInput struct {
	SourceURL   string      // 当前内容来源 URL，绝对路径
	ContentType ContentType // "html" | "js" | "json"
	Content     []byte      // 资源内容
	Headers     http.Header // HTTP 响应头（用于 source map 等场景）
}

type CacheDirs struct {
	JS        string `json:"js"`
	SourceMap string `json:"sourceMap,omitempty"`
	Source    string `json:"source,omitempty"`
	HTML      string `json:"html,omitempty"`
}

type CacheDirsMetadata struct {
	// HTML 站点 HTML 缓存文件路径
	HTML string `json:"html,omitempty"`
	// JS JS 文件缓存目录
	JS string `json:"js,omitempty"`
	// SourceMap source map 文件缓存目录
	SourceMap string `json:"source_map,omitempty"`
	// Sources 还原出的原始源码目录
	Sources string `json:"sources,omitempty"`
}

type ContentType string

type DiscoveredJS struct {
	// URL 发现的 JS URL
	URL string
	// FromURL 发现该 JS 的来源 URL（分析的是哪个 HTML/JS 文件）
	FromURL string
	// FromPlugin 发现该 JS 的插件名称
	FromPlugin string
	// IsInline 是否来自内联脚本
	IsInline bool
}

type InlineScript struct {
	SourceURL string // 来源 HTML 的 URL
	Index     int    // 脚本在 HTML 中的顺序索引
	Content   []byte // 脚本内容
}

type Intermediate struct {
	URL  string      // 资源的绝对 URL
	Type ContentType // 期望的资源类型
}

type JSMetadata struct {
	// URL 完整的 JS URL
	URL string `json:"url"`
	// LocalPath 本地文件路径
	LocalPath string `json:"local_path"`
	// SourceURL 发现该 JS 的来源 URL
	SourceURL string `json:"source_url"`
	// IsInline 是否来自内联脚本
	IsInline bool `json:"is_inline"`
	// SourceMapURL 关联的 source map URL（如果有）
	SourceMapURL string `json:"source_map_url,omitempty"`
	// SourceMapPath 本地 source map 文件路径（如果有）
	SourceMapPath string `json:"source_map_path,omitempty"`
	// SourcesRestored 是否已从 source map 还原出原始源码
	SourcesRestored bool `json:"sources_restored,omitempty"`
	// RestoredSourceCount 从该 JS 的 source map 还原出的源码文件数量
	RestoredSourceCount int `json:"restored_source_count,omitempty"`
	// RestoredSources 从该 JS 的 source map 还原出的源码文件相对路径列表
	// 路径相对于 meta.json 所在目录（即缓存根目录）
	RestoredSources []string `json:"restored_sources,omitempty"`
	// FromPlugin 发现该 JS 的插件名称
	FromPlugin string `json:"from_plugin,omitempty"`
	// DiscoveredAt 发现时间（Unix timestamp）
	DiscoveredAt int64 `json:"discovered_at"`
}

type KnowledgeBase struct {

	// PublicPaths 发现的 publicPath 列表
	PublicPaths []string

	// PrependURLs 用于拼接在文件名前面的 URL 列表
	PrependURLs []string

	// SeenURLs 已尝试过的 URL（无论成功/404）
	SeenURLs map[string]bool

	// SeenFragments 已探测过的 JS 路径片段
	SeenFragments map[string]bool

	// KnownPaths 已知存在的 JS 路径（用于优先拼接）
	KnownPaths []string
	// contains filtered or unexported fields
}

type OutputFormat string

type OutputResult struct {
	Summary   Summary    `json:"summary"`
	JSURLs    []string   `json:"jsURLs"`
	CacheBase string     `json:"cacheBase,omitempty"`
	CacheDirs *CacheDirs `json:"cacheDirs,omitempty"`
}

type Pipeline struct {

	// 调试模式
	Debug bool
	// contains filtered or unexported fields
}

type Plugin interface {
	// Name 插件的唯一标识名称
	Name() string

	// Precheck 快速过滤，返回 true 才执行 Analyze
	Precheck(ctx context.Context, input *AnalyzeInput) bool

	// Analyze 正式分析逻辑
	Analyze(ctx context.Context, input *AnalyzeInput) (*Result, error)
}

type PluginRegistry struct {
	// contains filtered or unexported fields
}

type RSCProbe struct {
	URL     string            // 要发送 RSC 请求的 URL
	Headers map[string]string // 请求头（如 RSC: 1）
}

type Result struct {
	// FromPlugin 来源插件名称
	FromPlugin string

	// URLs 明确且完整的 JS URL，直接加入下载队列
	URLs []DiscoveredJS

	// ProbeTargets 提取到的路径片段，待主流程探测
	ProbeTargets []DiscoveredJS

	// PublicPaths 发现的 publicPath 路径
	PublicPaths []string

	// PrependURLs 用于拼接在文件名前面的 URL（通常是 protocol-relative URL）
	PrependURLs []string

	// Intermediates 需要主流程去下载并重新分发的配置文件
	Intermediates []Intermediate

	// InlineScripts 行内脚本内容，需要主流程分析
	InlineScripts []InlineScript

	// RSCProbes 需要发送 RSC 请求的探测目标（Next.js Flight 数据）
	RSCProbes []RSCProbe
}

type SiteMetadata struct {
	// URLs 所有发现的 JS URL 信息
	URLs []JSMetadata `json:"urls"`
	// PrependURLs 探测时使用的 PrependURLs（拼接用的 CDN 前缀）
	PrependURLs []string `json:"prepend_urls"`
	// PublicPaths 探测时使用的 PublicPaths
	PublicPaths []string `json:"public_paths"`
	// CacheDirs 各资源类型的缓存目录路径
	CacheDirs *CacheDirsMetadata `json:"cache_dirs,omitempty"`
	// DiscoveredAt 探测开始时间
	DiscoveredAt int64 `json:"discovered_at"`
}

type Summary struct {
	JSCount        int `json:"jsCount"`
	SourceMapCount int `json:"sourceMapCount,omitempty"`
	SourceCount    int `json:"sourceCount,omitempty"`
}