@linkprobe/core 0.1.0 → 0.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Hossein Hosseini
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Hossein Hosseini
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,155 +1,185 @@
-# @linkprobe/core
-
-The framework-agnostic metadata extraction engine for LinkProbe.
-
-`@linkprobe/core` provides utilities for extracting and resolving webpage metadata from URLs. It supports Open Graph, Twitter Cards, and standard HTML metadata, making it ideal for building link previews, content cards, social embeds, and metadata-driven experiences.
-
-## Installation
-
-```bash
-pnpm add @linkprobe/core
-```
-
-## Quick Start
-
-```ts
-import {probe} from "@linkprobe/core";
-
-const result = await probe("https://github.com");
-
-if (result.status === "success") {
-  console.log(result.metadata);
-}
-```
-
-## Example Response
-
-```ts
-{
-  status: "success",
-  metadata: {
-    url: "https://github.com",
-    openGraph: {
-      title: "GitHub",
-      description: "...",
-      image: "..."
-    },
-    twitter: {
-      title: "GitHub"
-    },
-    html: {
-      title: "GitHub"
-    }
-  },
-  page: {
-    requestedUrl: "https://github.com",
-    finalUrl: "https://github.com",
-    contentType: "text/html"
-  }
-}
-```
-
-## Metadata Resolution
-
-Metadata may be available from multiple sources.
-
-Use `resolveMetadata()` to create a unified representation using customizable priority rules.
-
-```ts
-import {probe, resolveMetadata} from "@linkprobe/core";
-
-const result = await probe("https://github.com");
-
-if (result.status === "success") {
-  const metadata = resolveMetadata(result.metadata);
-
-  console.log(metadata);
-}
-```
-
-Example output:
-
-```ts
-{
-  title: "GitHub",
-  description: "...",
-  image: "...",
-  favicon: "...",
-  siteName: "GitHub"
-}
-```
-
-## Custom Priorities
-
-```ts
-const metadata = resolveMetadata(result.metadata, {
-  titlePriority: ["twitter", "openGraph", "html"],
-});
-```
-
-## Options
-
-### probe(url, options)
-
-```ts
-await probe("https://github.com", {
-  timeout: 5000,
-});
-```
-
-| Option  | Type   | Description                     |
-| ------- | ------ | ------------------------------- |
-| timeout | number | Request timeout in milliseconds |
-
-## Supported Sources
-
-### Open Graph
-
-```html
-<meta property="og:title" />
-<meta property="og:description" />
-<meta property="og:image" />
-```
-
-### Twitter Cards
-
-```html
-<meta name="twitter:title" />
-<meta name="twitter:description" />
-<meta name="twitter:image" />
-```
-
-### HTML Metadata
-
-```html
-<title>...</title>
-<meta name="description" />
-<link rel="icon" />
-<link rel="canonical" />
-```
-
-## Error Handling
-
-```ts
-const result = await probe(url);
-
-if (result.status === "failed") {
-  console.error(result.error.code, result.error.message);
-}
-```
-
-Possible error codes:
-
-```txt
-FETCH_FAILED
-TIMEOUT
-UNKNOWN_ERROR
-```
-
-## TypeScript
-
-All public APIs are fully typed and exported by the package.
-
-```ts
-import type {Metadata, ProbeResult, ProbeOptions, ResolvedMetadata} from "@linkprobe/core";
-```
+# @linkprobe/core
+
+The framework-agnostic metadata extraction engine for LinkProbe.
+
+`@linkprobe/core` extracts, analyzes, and resolves webpage metadata from URLs including Open Graph, Twitter Cards, and HTML metadata.
+
+It is designed for building link previews, content cards, and metadata-driven applications.
+
+## Features
+
+* Open Graph metadata extraction
+* Twitter Card metadata extraction
+* HTML metadata extraction
+* Metadata resolution across multiple sources
+* Metadata coverage analysis
+* Metadata diagnostics
+* Fully typed API
+* Framework-agnostic core
+
+## Installation
+
+```bash
+npm i @linkprobe/core
+```
+
+or
+
+```bash
+pnpm add @linkprobe/core
+```
+
+## Quick Start
+
+```ts
+import { probe } from "@linkprobe/core";
+
+const result = await probe("https://github.com");
+
+if (result.status === "success") {
+  console.log(result.metadata);
+}
+```
+
+## API
+
+### probe(url, options)
+
+Extract metadata from a single URL.
+
+```ts
+await probe("https://github.com", {
+  timeout: 5000,
+});
+```
+
+### probeMany(urls, options)
+
+Extract metadata from multiple URLs.
+
+```ts
+import { probeMany } from "@linkprobe/core";
+
+const results = await probeMany([
+  "https://github.com",
+  "https://vercel.com",
+]);
+```
+
+### resolveMetadata(metadata, options?)
+
+Resolve metadata using priority rules across sources.
+
+```ts
+import { resolveMetadata } from "@linkprobe/core";
+
+const resolved = resolveMetadata(result.metadata, {
+  titlePriority: ["openGraph", "twitter", "html"],
+});
+```
+
+## Coverage
+
+Indicates how complete the extracted metadata is.
+
+```ts
+result.coverage;
+```
+
+```ts
+{
+  available: ["title", "description", "image", "favicon"],
+  missing: [],
+  score: 100
+}
+```
+
+## Diagnostics
+
+Provides insight into detected metadata sources.
+
+```ts
+result.diagnostics;
+```
+
+```ts
+{
+  openGraph: {
+    detected: true,
+    fields: ["title", "description", "image"]
+  },
+  twitter: {
+    detected: true,
+    fields: ["title", "description"]
+  },
+  html: {
+    detected: true,
+    fields: ["title", "description", "favicon"]
+  }
+}
+```
+
+## Error Handling
+
+```ts
+const result = await probe(url);
+
+if (result.status === "failed") {
+  console.error(result.error.code, result.error.message);
+}
+```
+
+### Error Codes
+
+* FETCH_FAILED
+* TIMEOUT
+* UNKNOWN_ERROR
+
+## Custom Priorities
+
+```ts
+const resolved = resolveMetadata(result.metadata, {
+  titlePriority: ["twitter", "openGraph", "html"],
+  descriptionPriority: ["openGraph", "html", "twitter"],
+});
+```
+
+## Supported Sources
+
+### Open Graph
+
+```html
+<meta property="og:title" />
+<meta property="og:description" />
+<meta property="og:image" />
+```
+
+### Twitter Cards
+
+```html
+<meta name="twitter:title" />
+<meta name="twitter:description" />
+<meta name="twitter:image" />
+```
+
+### HTML Metadata
+
+```html
+<title>...</title>
+<meta name="description" />
+<link rel="icon" />
+<link rel="canonical" />
+```
+
+## TypeScript
+
+All APIs are fully typed.
+
+```ts
+import type {
+  ProbeResult,
+  Metadata,
+  ResolvedMetadata,
+  ProbeOptions,
+} from "@linkprobe/core";
+```

package/dist/index.d.mts

@@ -1,92 +1,95 @@
+interface SourceDiagnostics {
+    detected: boolean;
+    fields: string[];
+}
+interface ProbeDiagnostics {
+    html?: SourceDiagnostics;
+    openGraph?: SourceDiagnostics;
+    twitter?: SourceDiagnostics;
+}
+
 interface OpenGraphMetadata {
-    title?: string;
     description?: string;
     image?: string;
+    locale?: string;
     siteName?: string;
+    title?: string;
     type?: string;
-    locale?: string;
 }
 interface TwitterMetadata {
-    title?: string;
+    creator?: string;
     description?: string;
     image?: string;
     site?: string;
-    creator?: string;
+    title?: string;
 }
 interface HtmlMetadata {
-    title?: string;
+    canonicalUrl?: string;
     description?: string;
     favicon?: string;
-    canonicalUrl?: string;
+    title?: string;
 }
 interface Metadata {
-    url: string;
+    html?: HtmlMetadata;
     openGraph?: OpenGraphMetadata;
     twitter?: TwitterMetadata;
-    html?: HtmlMetadata;
+    url: string;
+}
+
+interface MetadataCoverage {
+    available: string[];
+    missing: string[];
+    score: number;
 }
 
 interface ProbeOptions {
     timeout?: number;
 }
 interface PageInfo {
-    requestedUrl: string;
-    finalUrl: string;
     contentType?: string;
-}
-interface SourceDiagnostics {
-    detected: boolean;
-    fields: string[];
-}
-interface ProbeDiagnostics {
-    openGraph?: SourceDiagnostics;
-    twitter?: SourceDiagnostics;
-    html?: SourceDiagnostics;
+    finalUrl: string;
+    requestedUrl: string;
 }
 interface ProbeSuccess {
-    status: "success";
+    coverage: MetadataCoverage;
+    diagnostics: ProbeDiagnostics;
     metadata: Metadata;
     page: PageInfo;
-    diagnostics?: ProbeDiagnostics;
+    status: "success";
 }
 interface ProbeError {
     code: string;
     message: string;
 }
 interface ProbeFailed {
-    status: "failed";
     error: ProbeError;
+    status: "failed";
 }
 type ProbeResult = ProbeSuccess | ProbeFailed;
 
-type MetadataSource = "openGraph" | "twitter" | "html";
+interface ProbeManyOptions extends ProbeOptions {
+    concurrency?: number;
+}
+
+type MetadataSource = "html" | "openGraph" | "twitter";
 interface ResolveMetadataOptions {
-    titlePriority?: MetadataSource[];
     descriptionPriority?: MetadataSource[];
     imagePriority?: MetadataSource[];
+    titlePriority?: MetadataSource[];
 }
 interface ResolvedMetadata {
-    title?: string;
+    canonicalUrl?: string;
     description?: string;
-    image?: string;
     favicon?: string;
+    image?: string;
     siteName?: string;
-    canonicalUrl?: string;
-}
-interface MetadataCoverage {
-    score: number;
-    available: string[];
-    missing: string[];
+    title?: string;
 }
 
-declare function buildDiagnostics(metadata: Metadata): ProbeDiagnostics;
-
-declare function getMetadataCoverage(metadata: Metadata): MetadataCoverage;
-
 declare function probe(url: string, options?: ProbeOptions): Promise<ProbeResult>;
 
-declare function probeMany(urls: string[], options?: ProbeOptions): Promise<ProbeResult[]>;
+declare function probeMany(urls: string[], options?: ProbeManyOptions): Promise<ProbeResult[]>;
 
 declare function resolveMetadata(metadata: Metadata, options?: ResolveMetadataOptions): ResolvedMetadata;
 
-export { buildDiagnostics, getMetadataCoverage, probe, probeMany, resolveMetadata };
+export { type HtmlMetadata, type Metadata, type MetadataCoverage, type MetadataSource, type OpenGraphMetadata, type PageInfo, type ProbeDiagnostics, type ProbeError, type ProbeFailed, type ProbeManyOptions, type ProbeOptions, type ProbeResult, type ProbeSuccess, type ResolveMetadataOptions, type ResolvedMetadata, type SourceDiagnostics, type TwitterMetadata, probe, probeMany, resolveMetadata };

package/dist/index.d.ts

@@ -1,92 +1,95 @@
+interface SourceDiagnostics {
+    detected: boolean;
+    fields: string[];
+}
+interface ProbeDiagnostics {
+    html?: SourceDiagnostics;
+    openGraph?: SourceDiagnostics;
+    twitter?: SourceDiagnostics;
+}
+
 interface OpenGraphMetadata {
-    title?: string;
     description?: string;
     image?: string;
+    locale?: string;
     siteName?: string;
+    title?: string;
     type?: string;
-    locale?: string;
 }
 interface TwitterMetadata {
-    title?: string;
+    creator?: string;
     description?: string;
     image?: string;
     site?: string;
-    creator?: string;
+    title?: string;
 }
 interface HtmlMetadata {
-    title?: string;
+    canonicalUrl?: string;
     description?: string;
     favicon?: string;
-    canonicalUrl?: string;
+    title?: string;
 }
 interface Metadata {
-    url: string;
+    html?: HtmlMetadata;
     openGraph?: OpenGraphMetadata;
     twitter?: TwitterMetadata;
-    html?: HtmlMetadata;
+    url: string;
+}
+
+interface MetadataCoverage {
+    available: string[];
+    missing: string[];
+    score: number;
 }
 
 interface ProbeOptions {
     timeout?: number;
 }
 interface PageInfo {
-    requestedUrl: string;
-    finalUrl: string;
     contentType?: string;
-}
-interface SourceDiagnostics {
-    detected: boolean;
-    fields: string[];
-}
-interface ProbeDiagnostics {
-    openGraph?: SourceDiagnostics;
-    twitter?: SourceDiagnostics;
-    html?: SourceDiagnostics;
+    finalUrl: string;
+    requestedUrl: string;
 }
 interface ProbeSuccess {
-    status: "success";
+    coverage: MetadataCoverage;
+    diagnostics: ProbeDiagnostics;
     metadata: Metadata;
     page: PageInfo;
-    diagnostics?: ProbeDiagnostics;
+    status: "success";
 }
 interface ProbeError {
     code: string;
     message: string;
 }
 interface ProbeFailed {
-    status: "failed";
     error: ProbeError;
+    status: "failed";
 }
 type ProbeResult = ProbeSuccess | ProbeFailed;
 
-type MetadataSource = "openGraph" | "twitter" | "html";
+interface ProbeManyOptions extends ProbeOptions {
+    concurrency?: number;
+}
+
+type MetadataSource = "html" | "openGraph" | "twitter";
 interface ResolveMetadataOptions {
-    titlePriority?: MetadataSource[];
     descriptionPriority?: MetadataSource[];
     imagePriority?: MetadataSource[];
+    titlePriority?: MetadataSource[];
 }
 interface ResolvedMetadata {
-    title?: string;
+    canonicalUrl?: string;
     description?: string;
-    image?: string;
     favicon?: string;
+    image?: string;
     siteName?: string;
-    canonicalUrl?: string;
-}
-interface MetadataCoverage {
-    score: number;
-    available: string[];
-    missing: string[];
+    title?: string;
 }
 
-declare function buildDiagnostics(metadata: Metadata): ProbeDiagnostics;
-
-declare function getMetadataCoverage(metadata: Metadata): MetadataCoverage;
-
 declare function probe(url: string, options?: ProbeOptions): Promise<ProbeResult>;
 
-declare function probeMany(urls: string[], options?: ProbeOptions): Promise<ProbeResult[]>;
+declare function probeMany(urls: string[], options?: ProbeManyOptions): Promise<ProbeResult[]>;
 
 declare function resolveMetadata(metadata: Metadata, options?: ResolveMetadataOptions): ResolvedMetadata;
 
-export { buildDiagnostics, getMetadataCoverage, probe, probeMany, resolveMetadata };
+export { type HtmlMetadata, type Metadata, type MetadataCoverage, type MetadataSource, type OpenGraphMetadata, type PageInfo, type ProbeDiagnostics, type ProbeError, type ProbeFailed, type ProbeManyOptions, type ProbeOptions, type ProbeResult, type ProbeSuccess, type ResolveMetadataOptions, type ResolvedMetadata, type SourceDiagnostics, type TwitterMetadata, probe, probeMany, resolveMetadata };

package/dist/index.js

@@ -1,32 +1,8 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  buildDiagnostics: () => buildDiagnostics,
-  getMetadataCoverage: () => getMetadataCoverage,
-  probe: () => probe,
-  probeMany: () => probeMany,
-  resolveMetadata: () => resolveMetadata
-});
-module.exports = __toCommonJS(index_exports);
+'use strict';
+
+var cheerio = require('cheerio');
+
+// src/probe.ts
 
 // src/utils/extract-fields.ts
 function extractFields(source) {
@@ -36,69 +12,6 @@ function extractFields(source) {
   return Object.entries(source).filter(([, value]) => value !== void 0 && value !== null && value !== "").map(([key]) => key);
 }
 
-// src/build-diagnostics.ts
-function buildDiagnostics(metadata) {
-  const openGraphFields = extractFields(metadata.openGraph);
-  const twitterFields = extractFields(metadata.twitter);
-  const htmlFields = extractFields(metadata.html);
-  return {
-    html: {
-      detected: htmlFields.length > 0,
-      fields: htmlFields
-    },
-    openGraph: {
-      detected: openGraphFields.length > 0,
-      fields: openGraphFields
-    },
-    twitter: {
-      detected: twitterFields.length > 0,
-      fields: twitterFields
-    }
-  };
-}
-
-// src/resolve-metadata.ts
-var DEFAULT_PRIORITY = ["openGraph", "twitter", "html"];
-function resolveField(metadata, field, priority) {
-  for (const source of priority) {
-    const value = metadata[source]?.[field];
-    if (value !== void 0 && value !== null && value !== "") {
-      return value;
-    }
-  }
-  return void 0;
-}
-function resolveMetadata(metadata, options) {
-  return {
-    canonicalUrl: metadata.html?.canonicalUrl,
-    description: resolveField(
-      metadata,
-      "description",
-      options?.descriptionPriority ?? DEFAULT_PRIORITY
-    ),
-    favicon: metadata.html?.favicon,
-    image: resolveField(metadata, "image", options?.imagePriority ?? DEFAULT_PRIORITY),
-    siteName: metadata.openGraph?.siteName,
-    title: resolveField(metadata, "title", options?.titlePriority ?? DEFAULT_PRIORITY)
-  };
-}
-
-// src/get-metadata-coverage.ts
-var REQUIRED_FIELDS = ["title", "description", "image", "favicon"];
-function getMetadataCoverage(metadata) {
-  const resolved = resolveMetadata(metadata);
-  const available = REQUIRED_FIELDS.filter((field) => resolved[field]);
-  const missing = REQUIRED_FIELDS.filter((field) => !resolved[field]);
-  return {
-    available: [...available],
-    missing: [...missing],
-    score: Math.round(available.length / REQUIRED_FIELDS.length * 100)
-  };
-}
-
-// src/probe.ts
-var import_cheerio = require("cheerio");
-
 // src/utils/resolve-url.ts
 function resolveUrl(url, baseUrl) {
   try {
@@ -153,7 +66,7 @@ var TwitterCardParser = class {
   }
 };
 
-// src/parsers/index.ts
+// src/parsers/parsers.ts
 var parsers = {
   html: new HtmlMetaParser(),
   openGraph: new OpenGraphParser(),
@@ -183,16 +96,80 @@ async function fetchHtml(url, options) {
   };
 }
 
+// src/lib/build-diagnostics.ts
+function buildDiagnostics(metadata) {
+  const openGraphFields = extractFields(metadata.openGraph);
+  const twitterFields = extractFields(metadata.twitter);
+  const htmlFields = extractFields(metadata.html);
+  return {
+    html: {
+      detected: htmlFields.length > 0,
+      fields: htmlFields
+    },
+    openGraph: {
+      detected: openGraphFields.length > 0,
+      fields: openGraphFields
+    },
+    twitter: {
+      detected: twitterFields.length > 0,
+      fields: twitterFields
+    }
+  };
+}
+
+// src/resolve-metadata.ts
+var DEFAULT_PRIORITY = ["openGraph", "twitter", "html"];
+function resolveMetadata(metadata, options) {
+  return {
+    canonicalUrl: metadata.html?.canonicalUrl,
+    description: resolveField(
+      metadata,
+      "description",
+      options?.descriptionPriority ?? DEFAULT_PRIORITY
+    ),
+    favicon: metadata.html?.favicon,
+    image: resolveField(metadata, "image", options?.imagePriority ?? DEFAULT_PRIORITY),
+    siteName: metadata.openGraph?.siteName,
+    title: resolveField(metadata, "title", options?.titlePriority ?? DEFAULT_PRIORITY)
+  };
+}
+
+// src/lib/get-metadata-coverage.ts
+var REQUIRED_FIELDS = ["title", "description", "image", "favicon"];
+function getMetadataCoverage(metadata) {
+  const resolved = resolveMetadata(metadata);
+  const available = REQUIRED_FIELDS.filter((field) => resolved[field]);
+  const missing = REQUIRED_FIELDS.filter((field) => !resolved[field]);
+  return {
+    available: [...available],
+    missing: [...missing],
+    score: Math.round(available.length / REQUIRED_FIELDS.length * 100)
+  };
+}
+
+// src/lib/resolve-field.ts
+function resolveField(metadata, field, priority) {
+  for (const source of priority) {
+    const value = metadata[source]?.[field];
+    if (value !== void 0 && value !== null && value !== "") {
+      return value;
+    }
+  }
+  return void 0;
+}
+
 // src/probe.ts
 async function probe(url, options) {
   try {
     const page = await fetchHtml(url, { timeout: options?.timeout });
-    const $ = (0, import_cheerio.load)(page.html);
+    const $ = cheerio.load(page.html);
     const pageUrl = page.url;
     const context = { $, pageUrl };
     const metadata = extractMetadata(context);
     const diagnostics = buildDiagnostics(metadata);
+    const coverage = getMetadataCoverage(metadata);
     return {
+      coverage,
       diagnostics,
       metadata,
       page: {
@@ -233,11 +210,9 @@ async function probe(url, options) {
 async function probeMany(urls, options) {
   return Promise.all(urls.map((url) => probe(url, options)));
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  buildDiagnostics,
-  getMetadataCoverage,
-  probe,
-  probeMany,
-  resolveMetadata
-});
+
+exports.probe = probe;
+exports.probeMany = probeMany;
+exports.resolveMetadata = resolveMetadata;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/extract-fields.ts","../src/utils/resolve-url.ts","../src/parsers/html-meta-parser.ts","../src/parsers/open-graph-parser.ts","../src/parsers/twitter-card-parser.ts","../src/parsers/parsers.ts","../src/extractors/extract-metadata.ts","../src/fetchers/fetch-html.ts","../src/lib/build-diagnostics.ts","../src/resolve-metadata.ts","../src/lib/get-metadata-coverage.ts","../src/lib/resolve-field.ts","../src/probe.ts","../src/probe-many.ts"],"names":["load"],"mappings":"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","file":"index.js","sourcesContent":["export function extractFields(source?: Record<string, unknown>): string[] {\n  if (!source) {\n    return [];\n  }\n\n  return Object.entries(source)\n    .filter(([, value]) => value !== undefined && value !== null && value !== \"\")\n    .map(([key]) => key);\n}\n","export function resolveUrl(url: string, baseUrl: string): string {\n  try {\n    return new URL(url, baseUrl).toString();\n  } catch {\n    return url;\n  }\n}\n","import type {HtmlMetadata, MetadataParser, ParserContext} from \"../types\";\n\nimport {resolveUrl} from \"../utils\";\n\nexport class HtmlMetaParser implements MetadataParser<HtmlMetadata> {\n  parse(context: ParserContext): Partial<HtmlMetadata> {\n    const {$, pageUrl} = context;\n\n    return {\n      canonicalUrl: $('link[rel=\"canonical\"]').attr(\"href\"),\n      description: $('meta[name=\"description\"]').attr(\"content\"),\n      favicon: resolveUrl(\n        $('link[rel=\"icon\"]').attr(\"href\") ??\n          $('link[rel=\"shortcut icon\"]').attr(\"href\") ??\n          $('link[rel=\"apple-touch-icon\"]').attr(\"href\") ??\n          \"/favicon.ico\",\n        pageUrl,\n      ),\n      title: $(\"title\").text(),\n    };\n  }\n}\n","import type {MetadataParser, OpenGraphMetadata, ParserContext} from \"../types\";\n\nimport {resolveUrl} from \"../utils\";\n\nexport class OpenGraphParser implements MetadataParser<OpenGraphMetadata> {\n  parse(context: ParserContext): Partial<OpenGraphMetadata> {\n    const {$, pageUrl} = context;\n\n    return {\n      description: $('meta[property=\"og:description\"]').attr(\"content\"),\n      image: resolveUrl($('meta[property=\"og:image\"]').attr(\"content\") ?? \"\", pageUrl),\n      locale: $('meta[property=\"og:locale\"]').attr(\"content\"),\n      siteName: $('meta[property=\"og:site_name\"]').attr(\"content\"),\n      title: $('meta[property=\"og:title\"]').attr(\"content\"),\n      type: $('meta[property=\"og:type\"]').attr(\"content\"),\n    };\n  }\n}\n","import type {MetadataParser, ParserContext, TwitterMetadata} from \"../types\";\n\nimport {resolveUrl} from \"../utils\";\n\nexport class TwitterCardParser implements MetadataParser<TwitterMetadata> {\n  parse(context: ParserContext): Partial<TwitterMetadata> {\n    const {$, pageUrl} = context;\n\n    return {\n      creator: $('meta[name=\"twitter:creator\"]').attr(\"content\"),\n      description: $('meta[name=\"twitter:description\"]').attr(\"content\"),\n      image: resolveUrl($('meta[name=\"twitter:image\"]').attr(\"content\") ?? \"\", pageUrl),\n      site: $('meta[name=\"twitter:site\"]').attr(\"content\"),\n      title: $('meta[name=\"twitter:title\"]').attr(\"content\"),\n    };\n  }\n}\n","import {HtmlMetaParser} from \"./html-meta-parser\";\nimport {OpenGraphParser} from \"./open-graph-parser\";\nimport {TwitterCardParser} from \"./twitter-card-parser\";\n\nexport const parsers = {\n  html: new HtmlMetaParser(),\n  openGraph: new OpenGraphParser(),\n  twitter: new TwitterCardParser(),\n};\n","import type {Metadata, ParserContext} from \"../types\";\n\nimport {parsers} from \"../parsers\";\n\nexport function extractMetadata(context: ParserContext): Metadata {\n  return {\n    html: parsers.html.parse(context),\n    openGraph: parsers.openGraph.parse(context),\n    twitter: parsers.twitter.parse(context),\n    url: context.pageUrl,\n  };\n}\n","import type {FetchHtmlOptions, FetchHtmlResult} from \"../types\";\n\nexport async function fetchHtml(url: string, options: FetchHtmlOptions): Promise<FetchHtmlResult> {\n  const controller = new AbortController();\n\n  const timeout = setTimeout(() => controller.abort(), options.timeout ?? 5000);\n\n  const response = await fetch(url, {signal: controller.signal});\n\n  clearTimeout(timeout);\n\n  return {\n    contentType: response.headers.get(\"content-type\") ?? undefined,\n    html: await response.text(),\n    url: response.url,\n  };\n}\n","import type {Metadata, ProbeDiagnostics} from \"../types\";\n\nimport {extractFields} from \"../utils\";\n\nexport function buildDiagnostics(metadata: Metadata): ProbeDiagnostics {\n  const openGraphFields = extractFields(metadata.openGraph as Record<string, unknown>);\n  const twitterFields = extractFields(metadata.twitter as Record<string, unknown>);\n  const htmlFields = extractFields(metadata.html as Record<string, unknown>);\n\n  return {\n    html: {\n      detected: htmlFields.length > 0,\n      fields: htmlFields,\n    },\n    openGraph: {\n      detected: openGraphFields.length > 0,\n      fields: openGraphFields,\n    },\n    twitter: {\n      detected: twitterFields.length > 0,\n      fields: twitterFields,\n    },\n  };\n}\n","import type {Metadata, MetadataSource, ResolveMetadataOptions, ResolvedMetadata} from \"./types\";\n\nimport {resolveField} from \"./lib\";\n\nconst DEFAULT_PRIORITY: MetadataSource[] = [\"openGraph\", \"twitter\", \"html\"];\n\nexport function resolveMetadata(\n  metadata: Metadata,\n  options?: ResolveMetadataOptions,\n): ResolvedMetadata {\n  return {\n    canonicalUrl: metadata.html?.canonicalUrl,\n    description: resolveField(\n      metadata,\n      \"description\",\n      options?.descriptionPriority ?? DEFAULT_PRIORITY,\n    ),\n    favicon: metadata.html?.favicon,\n    image: resolveField(metadata, \"image\", options?.imagePriority ?? DEFAULT_PRIORITY),\n    siteName: metadata.openGraph?.siteName,\n    title: resolveField(metadata, \"title\", options?.titlePriority ?? DEFAULT_PRIORITY),\n  };\n}\n","import type {Metadata, MetadataCoverage} from \"../types\";\n\nimport {resolveMetadata} from \"../resolve-metadata\";\n\nconst REQUIRED_FIELDS = [\"title\", \"description\", \"image\", \"favicon\"] as const;\n\nexport function getMetadataCoverage(metadata: Metadata): MetadataCoverage {\n  const resolved = resolveMetadata(metadata);\n  const available = REQUIRED_FIELDS.filter((field) => resolved[field]);\n  const missing = REQUIRED_FIELDS.filter((field) => !resolved[field]);\n\n  return {\n    available: [...available],\n    missing: [...missing],\n    score: Math.round((available.length / REQUIRED_FIELDS.length) * 100),\n  };\n}\n","import type {Metadata, MetadataSource, ResolvedMetadata} from \"../types\";\n\nexport function resolveField<T extends keyof ResolvedMetadata>(\n  metadata: Metadata,\n  field: T,\n  priority: MetadataSource[],\n): ResolvedMetadata[T] {\n  for (const source of priority) {\n    const value = metadata[source]?.[field as keyof (typeof metadata)[typeof source]];\n\n    if (value !== undefined && value !== null && value !== \"\") {\n      return value as ResolvedMetadata[T];\n    }\n  }\n\n  return undefined;\n}\n","import type {ParserContext, ProbeOptions, ProbeResult} from \"./types\";\n\nimport {load} from \"cheerio\";\n\nimport {extractMetadata} from \"./extractors\";\nimport {fetchHtml} from \"./fetchers\";\nimport {buildDiagnostics, getMetadataCoverage} from \"./lib\";\n\nexport async function probe(url: string, options?: ProbeOptions): Promise<ProbeResult> {\n  try {\n    const page = await fetchHtml(url, {timeout: options?.timeout});\n\n    const $ = load(page.html);\n    const pageUrl = page.url;\n\n    const context: ParserContext = {$, pageUrl};\n\n    const metadata = extractMetadata(context);\n    const diagnostics = buildDiagnostics(metadata);\n    const coverage = getMetadataCoverage(metadata);\n\n    return {\n      coverage,\n      diagnostics,\n      metadata,\n      page: {\n        contentType: page.contentType,\n        finalUrl: page.url,\n        requestedUrl: url,\n      },\n      status: \"success\",\n    };\n  } catch (error) {\n    if (error instanceof Error && error.name === \"AbortError\")\n      return {\n        error: {\n          code: \"TIMEOUT\",\n          message: \"Request timed out\",\n        },\n        status: \"failed\",\n      };\n\n    if (error instanceof TypeError)\n      return {\n        error: {\n          code: \"FETCH_FAILED\",\n          message: error.message,\n        },\n        status: \"failed\",\n      };\n\n    return {\n      error: {\n        code: \"UNKNOWN_ERROR\",\n        message: \"Unknown error\",\n      },\n      status: \"failed\",\n    };\n  }\n}\n","import type {ProbeManyOptions, ProbeResult} from \"./types\";\n\nimport {probe} from \"./probe\";\n\nexport async function probeMany(\n  urls: string[],\n  options?: ProbeManyOptions,\n): Promise<ProbeResult[]> {\n  return Promise.all(urls.map((url) => probe(url, options)));\n}\n"]}

package/dist/index.mjs

@@ -1,3 +1,7 @@
+import { load } from 'cheerio';
+
+// src/probe.ts
+
 // src/utils/extract-fields.ts
 function extractFields(source) {
   if (!source) {
@@ -6,69 +10,6 @@ function extractFields(source) {
   return Object.entries(source).filter(([, value]) => value !== void 0 && value !== null && value !== "").map(([key]) => key);
 }
 
-// src/build-diagnostics.ts
-function buildDiagnostics(metadata) {
-  const openGraphFields = extractFields(metadata.openGraph);
-  const twitterFields = extractFields(metadata.twitter);
-  const htmlFields = extractFields(metadata.html);
-  return {
-    html: {
-      detected: htmlFields.length > 0,
-      fields: htmlFields
-    },
-    openGraph: {
-      detected: openGraphFields.length > 0,
-      fields: openGraphFields
-    },
-    twitter: {
-      detected: twitterFields.length > 0,
-      fields: twitterFields
-    }
-  };
-}
-
-// src/resolve-metadata.ts
-var DEFAULT_PRIORITY = ["openGraph", "twitter", "html"];
-function resolveField(metadata, field, priority) {
-  for (const source of priority) {
-    const value = metadata[source]?.[field];
-    if (value !== void 0 && value !== null && value !== "") {
-      return value;
-    }
-  }
-  return void 0;
-}
-function resolveMetadata(metadata, options) {
-  return {
-    canonicalUrl: metadata.html?.canonicalUrl,
-    description: resolveField(
-      metadata,
-      "description",
-      options?.descriptionPriority ?? DEFAULT_PRIORITY
-    ),
-    favicon: metadata.html?.favicon,
-    image: resolveField(metadata, "image", options?.imagePriority ?? DEFAULT_PRIORITY),
-    siteName: metadata.openGraph?.siteName,
-    title: resolveField(metadata, "title", options?.titlePriority ?? DEFAULT_PRIORITY)
-  };
-}
-
-// src/get-metadata-coverage.ts
-var REQUIRED_FIELDS = ["title", "description", "image", "favicon"];
-function getMetadataCoverage(metadata) {
-  const resolved = resolveMetadata(metadata);
-  const available = REQUIRED_FIELDS.filter((field) => resolved[field]);
-  const missing = REQUIRED_FIELDS.filter((field) => !resolved[field]);
-  return {
-    available: [...available],
-    missing: [...missing],
-    score: Math.round(available.length / REQUIRED_FIELDS.length * 100)
-  };
-}
-
-// src/probe.ts
-import { load } from "cheerio";
-
 // src/utils/resolve-url.ts
 function resolveUrl(url, baseUrl) {
   try {
@@ -123,7 +64,7 @@ var TwitterCardParser = class {
   }
 };
 
-// src/parsers/index.ts
+// src/parsers/parsers.ts
 var parsers = {
   html: new HtmlMetaParser(),
   openGraph: new OpenGraphParser(),
@@ -153,6 +94,68 @@ async function fetchHtml(url, options) {
   };
 }
 
+// src/lib/build-diagnostics.ts
+function buildDiagnostics(metadata) {
+  const openGraphFields = extractFields(metadata.openGraph);
+  const twitterFields = extractFields(metadata.twitter);
+  const htmlFields = extractFields(metadata.html);
+  return {
+    html: {
+      detected: htmlFields.length > 0,
+      fields: htmlFields
+    },
+    openGraph: {
+      detected: openGraphFields.length > 0,
+      fields: openGraphFields
+    },
+    twitter: {
+      detected: twitterFields.length > 0,
+      fields: twitterFields
+    }
+  };
+}
+
+// src/resolve-metadata.ts
+var DEFAULT_PRIORITY = ["openGraph", "twitter", "html"];
+function resolveMetadata(metadata, options) {
+  return {
+    canonicalUrl: metadata.html?.canonicalUrl,
+    description: resolveField(
+      metadata,
+      "description",
+      options?.descriptionPriority ?? DEFAULT_PRIORITY
+    ),
+    favicon: metadata.html?.favicon,
+    image: resolveField(metadata, "image", options?.imagePriority ?? DEFAULT_PRIORITY),
+    siteName: metadata.openGraph?.siteName,
+    title: resolveField(metadata, "title", options?.titlePriority ?? DEFAULT_PRIORITY)
+  };
+}
+
+// src/lib/get-metadata-coverage.ts
+var REQUIRED_FIELDS = ["title", "description", "image", "favicon"];
+function getMetadataCoverage(metadata) {
+  const resolved = resolveMetadata(metadata);
+  const available = REQUIRED_FIELDS.filter((field) => resolved[field]);
+  const missing = REQUIRED_FIELDS.filter((field) => !resolved[field]);
+  return {
+    available: [...available],
+    missing: [...missing],
+    score: Math.round(available.length / REQUIRED_FIELDS.length * 100)
+  };
+}
+
+// src/lib/resolve-field.ts
+function resolveField(metadata, field, priority) {
+  for (const source of priority) {
+    const value = metadata[source]?.[field];
+    if (value !== void 0 && value !== null && value !== "") {
+      return value;
+    }
+  }
+  return void 0;
+}
+
 // src/probe.ts
 async function probe(url, options) {
   try {
@@ -162,7 +165,9 @@ async function probe(url, options) {
     const context = { $, pageUrl };
     const metadata = extractMetadata(context);
     const diagnostics = buildDiagnostics(metadata);
+    const coverage = getMetadataCoverage(metadata);
     return {
+      coverage,
       diagnostics,
       metadata,
       page: {
@@ -203,10 +208,7 @@ async function probe(url, options) {
 async function probeMany(urls, options) {
   return Promise.all(urls.map((url) => probe(url, options)));
 }
-export {
-  buildDiagnostics,
-  getMetadataCoverage,
-  probe,
-  probeMany,
-  resolveMetadata
-};
+
+export { probe, probeMany, resolveMetadata };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/extract-fields.ts","../src/utils/resolve-url.ts","../src/parsers/html-meta-parser.ts","../src/parsers/open-graph-parser.ts","../src/parsers/twitter-card-parser.ts","../src/parsers/parsers.ts","../src/extractors/extract-metadata.ts","../src/fetchers/fetch-html.ts","../src/lib/build-diagnostics.ts","../src/resolve-metadata.ts","../src/lib/get-metadata-coverage.ts","../src/lib/resolve-field.ts","../src/probe.ts","../src/probe-many.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["export function extractFields(source?: Record<string, unknown>): string[] {\n  if (!source) {\n    return [];\n  }\n\n  return Object.entries(source)\n    .filter(([, value]) => value !== undefined && value !== null && value !== \"\")\n    .map(([key]) => key);\n}\n","export function resolveUrl(url: string, baseUrl: string): string {\n  try {\n    return new URL(url, baseUrl).toString();\n  } catch {\n    return url;\n  }\n}\n","import type {HtmlMetadata, MetadataParser, ParserContext} from \"../types\";\n\nimport {resolveUrl} from \"../utils\";\n\nexport class HtmlMetaParser implements MetadataParser<HtmlMetadata> {\n  parse(context: ParserContext): Partial<HtmlMetadata> {\n    const {$, pageUrl} = context;\n\n    return {\n      canonicalUrl: $('link[rel=\"canonical\"]').attr(\"href\"),\n      description: $('meta[name=\"description\"]').attr(\"content\"),\n      favicon: resolveUrl(\n        $('link[rel=\"icon\"]').attr(\"href\") ??\n          $('link[rel=\"shortcut icon\"]').attr(\"href\") ??\n          $('link[rel=\"apple-touch-icon\"]').attr(\"href\") ??\n          \"/favicon.ico\",\n        pageUrl,\n      ),\n      title: $(\"title\").text(),\n    };\n  }\n}\n","import type {MetadataParser, OpenGraphMetadata, ParserContext} from \"../types\";\n\nimport {resolveUrl} from \"../utils\";\n\nexport class OpenGraphParser implements MetadataParser<OpenGraphMetadata> {\n  parse(context: ParserContext): Partial<OpenGraphMetadata> {\n    const {$, pageUrl} = context;\n\n    return {\n      description: $('meta[property=\"og:description\"]').attr(\"content\"),\n      image: resolveUrl($('meta[property=\"og:image\"]').attr(\"content\") ?? \"\", pageUrl),\n      locale: $('meta[property=\"og:locale\"]').attr(\"content\"),\n      siteName: $('meta[property=\"og:site_name\"]').attr(\"content\"),\n      title: $('meta[property=\"og:title\"]').attr(\"content\"),\n      type: $('meta[property=\"og:type\"]').attr(\"content\"),\n    };\n  }\n}\n","import type {MetadataParser, ParserContext, TwitterMetadata} from \"../types\";\n\nimport {resolveUrl} from \"../utils\";\n\nexport class TwitterCardParser implements MetadataParser<TwitterMetadata> {\n  parse(context: ParserContext): Partial<TwitterMetadata> {\n    const {$, pageUrl} = context;\n\n    return {\n      creator: $('meta[name=\"twitter:creator\"]').attr(\"content\"),\n      description: $('meta[name=\"twitter:description\"]').attr(\"content\"),\n      image: resolveUrl($('meta[name=\"twitter:image\"]').attr(\"content\") ?? \"\", pageUrl),\n      site: $('meta[name=\"twitter:site\"]').attr(\"content\"),\n      title: $('meta[name=\"twitter:title\"]').attr(\"content\"),\n    };\n  }\n}\n","import {HtmlMetaParser} from \"./html-meta-parser\";\nimport {OpenGraphParser} from \"./open-graph-parser\";\nimport {TwitterCardParser} from \"./twitter-card-parser\";\n\nexport const parsers = {\n  html: new HtmlMetaParser(),\n  openGraph: new OpenGraphParser(),\n  twitter: new TwitterCardParser(),\n};\n","import type {Metadata, ParserContext} from \"../types\";\n\nimport {parsers} from \"../parsers\";\n\nexport function extractMetadata(context: ParserContext): Metadata {\n  return {\n    html: parsers.html.parse(context),\n    openGraph: parsers.openGraph.parse(context),\n    twitter: parsers.twitter.parse(context),\n    url: context.pageUrl,\n  };\n}\n","import type {FetchHtmlOptions, FetchHtmlResult} from \"../types\";\n\nexport async function fetchHtml(url: string, options: FetchHtmlOptions): Promise<FetchHtmlResult> {\n  const controller = new AbortController();\n\n  const timeout = setTimeout(() => controller.abort(), options.timeout ?? 5000);\n\n  const response = await fetch(url, {signal: controller.signal});\n\n  clearTimeout(timeout);\n\n  return {\n    contentType: response.headers.get(\"content-type\") ?? undefined,\n    html: await response.text(),\n    url: response.url,\n  };\n}\n","import type {Metadata, ProbeDiagnostics} from \"../types\";\n\nimport {extractFields} from \"../utils\";\n\nexport function buildDiagnostics(metadata: Metadata): ProbeDiagnostics {\n  const openGraphFields = extractFields(metadata.openGraph as Record<string, unknown>);\n  const twitterFields = extractFields(metadata.twitter as Record<string, unknown>);\n  const htmlFields = extractFields(metadata.html as Record<string, unknown>);\n\n  return {\n    html: {\n      detected: htmlFields.length > 0,\n      fields: htmlFields,\n    },\n    openGraph: {\n      detected: openGraphFields.length > 0,\n      fields: openGraphFields,\n    },\n    twitter: {\n      detected: twitterFields.length > 0,\n      fields: twitterFields,\n    },\n  };\n}\n","import type {Metadata, MetadataSource, ResolveMetadataOptions, ResolvedMetadata} from \"./types\";\n\nimport {resolveField} from \"./lib\";\n\nconst DEFAULT_PRIORITY: MetadataSource[] = [\"openGraph\", \"twitter\", \"html\"];\n\nexport function resolveMetadata(\n  metadata: Metadata,\n  options?: ResolveMetadataOptions,\n): ResolvedMetadata {\n  return {\n    canonicalUrl: metadata.html?.canonicalUrl,\n    description: resolveField(\n      metadata,\n      \"description\",\n      options?.descriptionPriority ?? DEFAULT_PRIORITY,\n    ),\n    favicon: metadata.html?.favicon,\n    image: resolveField(metadata, \"image\", options?.imagePriority ?? DEFAULT_PRIORITY),\n    siteName: metadata.openGraph?.siteName,\n    title: resolveField(metadata, \"title\", options?.titlePriority ?? DEFAULT_PRIORITY),\n  };\n}\n","import type {Metadata, MetadataCoverage} from \"../types\";\n\nimport {resolveMetadata} from \"../resolve-metadata\";\n\nconst REQUIRED_FIELDS = [\"title\", \"description\", \"image\", \"favicon\"] as const;\n\nexport function getMetadataCoverage(metadata: Metadata): MetadataCoverage {\n  const resolved = resolveMetadata(metadata);\n  const available = REQUIRED_FIELDS.filter((field) => resolved[field]);\n  const missing = REQUIRED_FIELDS.filter((field) => !resolved[field]);\n\n  return {\n    available: [...available],\n    missing: [...missing],\n    score: Math.round((available.length / REQUIRED_FIELDS.length) * 100),\n  };\n}\n","import type {Metadata, MetadataSource, ResolvedMetadata} from \"../types\";\n\nexport function resolveField<T extends keyof ResolvedMetadata>(\n  metadata: Metadata,\n  field: T,\n  priority: MetadataSource[],\n): ResolvedMetadata[T] {\n  for (const source of priority) {\n    const value = metadata[source]?.[field as keyof (typeof metadata)[typeof source]];\n\n    if (value !== undefined && value !== null && value !== \"\") {\n      return value as ResolvedMetadata[T];\n    }\n  }\n\n  return undefined;\n}\n","import type {ParserContext, ProbeOptions, ProbeResult} from \"./types\";\n\nimport {load} from \"cheerio\";\n\nimport {extractMetadata} from \"./extractors\";\nimport {fetchHtml} from \"./fetchers\";\nimport {buildDiagnostics, getMetadataCoverage} from \"./lib\";\n\nexport async function probe(url: string, options?: ProbeOptions): Promise<ProbeResult> {\n  try {\n    const page = await fetchHtml(url, {timeout: options?.timeout});\n\n    const $ = load(page.html);\n    const pageUrl = page.url;\n\n    const context: ParserContext = {$, pageUrl};\n\n    const metadata = extractMetadata(context);\n    const diagnostics = buildDiagnostics(metadata);\n    const coverage = getMetadataCoverage(metadata);\n\n    return {\n      coverage,\n      diagnostics,\n      metadata,\n      page: {\n        contentType: page.contentType,\n        finalUrl: page.url,\n        requestedUrl: url,\n      },\n      status: \"success\",\n    };\n  } catch (error) {\n    if (error instanceof Error && error.name === \"AbortError\")\n      return {\n        error: {\n          code: \"TIMEOUT\",\n          message: \"Request timed out\",\n        },\n        status: \"failed\",\n      };\n\n    if (error instanceof TypeError)\n      return {\n        error: {\n          code: \"FETCH_FAILED\",\n          message: error.message,\n        },\n        status: \"failed\",\n      };\n\n    return {\n      error: {\n        code: \"UNKNOWN_ERROR\",\n        message: \"Unknown error\",\n      },\n      status: \"failed\",\n    };\n  }\n}\n","import type {ProbeManyOptions, ProbeResult} from \"./types\";\n\nimport {probe} from \"./probe\";\n\nexport async function probeMany(\n  urls: string[],\n  options?: ProbeManyOptions,\n): Promise<ProbeResult[]> {\n  return Promise.all(urls.map((url) => probe(url, options)));\n}\n"]}

package/package.json

@@ -1,40 +1,53 @@
 {
   "name": "@linkprobe/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Core metadata extraction engine for LinkProbe",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
   "files": [
     "dist"
   ],
   "license": "MIT",
-  "author": "Hossein-i",
+  "author": {
+    "name": "Hossein-i",
+    "email": "sayhi@hossein-i.ir",
+    "url": "https://www.hossein-i.ir"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Hossein-i/linkprobe.git",
+    "url": "git+https://github.com/linkprobe/linkprobe.git",
     "directory": "packages/core"
   },
   "bugs": {
-    "url": "https://github.com/Hossein-i/linkprobe/issues"
+    "url": "https://github.com/linkprobe/linkprobe/issues",
+    "email": "sayhi@hossein-i.ir"
   },
-  "homepage": "https://github.com/Hossein-i/linkprobe",
+  "homepage": "https://github.com/linkprobe/linkprobe",
   "dependencies": {
     "cheerio": "^1.2.0"
   },
   "devDependencies": {
+    "@linkprobe/standard": "^0.1.1",
     "tsup": "^8.5.1",
     "typescript": "6.0.3",
-    "vitest": "^4.1.7",
-    "@linkprobe/standard": "0.1.0"
+    "vitest": "^4.1.7"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
+    "dev": "tsup --watch",
     "lint": "eslint --max-warnings 0",
     "check-types": "tsc --noEmit",
-    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "build": "tsup",
     "test": "vitest"
   }
 }