@xylabs/sdk-meta 7.0.7 → 8.0.0

package/README.md

@@ -1,711 +1,3 @@
-[![logo][]](https://xylabs.com)
-
 # @xylabs/sdk-meta
 
-[![npm][npm-badge]][npm-link]
-[![license][license-badge]][license-link]
-
-> Base functionality used throughout XYO TypeScript/JavaScript libraries
-
-## Install
-
-Using npm:
-
-```sh
-npm install {{name}}
-```
-
-Using yarn:
-
-```sh
-yarn add {{name}}
-```
-
-Using pnpm:
-
-```sh
-pnpm add {{name}}
-```
-
-Using bun:
-
-```sh
-bun add {{name}}
-```
-
-
-## License
-
-See the [LICENSE](LICENSE) file for license rights and limitations (LGPL-3.0-only).
-
-## Reference
-
-### packages
-
-  ### meta
-
-    ### .temp-typedoc
-
-      ### functions
-
-        ### <a id="addMetaToHead"></a>addMetaToHead
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-```ts
-function addMetaToHead(
-   $, 
-   name, 
-   value): void;
-```
-
-Adds or replaces a meta tag in the document head.
-
-## Parameters
-
-### $
-
-`CheerioAPI`
-
-The Cheerio API instance for the document.
-
-### name
-
-`string`
-
-The meta property name.
-
-### value
-
-`string` \| `object`
-
-The meta content value (string, array, or nested object).
-
-## Returns
-
-`void`
-
-        ### <a id="getMetaAsDict"></a>getMetaAsDict
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-```ts
-function getMetaAsDict(obj, parentKey?): Record<string, string>;
-```
-
-Recursively flattens a nested meta object into a flat dictionary with colon-delimited keys.
-
-## Parameters
-
-### obj
-
-[`StringIndexable`](#../type-aliases/StringIndexable)
-
-The nested object to flatten.
-
-### parentKey?
-
-`string`
-
-The accumulated key prefix from parent levels.
-
-## Returns
-
-`Record`\<`string`, `string`\>
-
-A flat record mapping colon-delimited property names to string values.
-
-        ### <a id="mergeDocumentHead"></a>mergeDocumentHead
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-```ts
-function mergeDocumentHead(destination, source): string;
-```
-
-Merges meta tags from the source HTML head into the destination HTML head.
-Existing meta tags with matching property attributes are replaced; others are appended.
-
-## Parameters
-
-### destination
-
-`string`
-
-The base HTML string to merge into.
-
-### source
-
-`string`
-
-The HTML string whose head meta tags will be merged.
-
-## Returns
-
-`string`
-
-The merged HTML string.
-
-        ### <a id="metaBuilder"></a>metaBuilder
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-```ts
-function metaBuilder(
-   html, 
-   meta, 
-   handler?): string;
-```
-
-Injects meta properties, title, and description into an HTML string.
-
-## Parameters
-
-### html
-
-`string`
-
-The base HTML string to modify.
-
-### meta
-
-[`Meta`](#../interfaces/Meta)
-
-The metadata to inject.
-
-### handler?
-
-`string`
-
-Optional meta-handler property value to include.
-
-## Returns
-
-`string`
-
-The modified HTML string with injected metadata.
-
-      ### interfaces
-
-        ### <a id="Meta"></a>Meta
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-Represents page metadata including Open Graph and Twitter card properties.
-
-## Properties
-
-### description?
-
-```ts
-optional description?: string;
-```
-
-***
-
-### og?
-
-```ts
-optional og?: OpenGraphMeta;
-```
-
-***
-
-### title?
-
-```ts
-optional title?: string;
-```
-
-***
-
-### twitter?
-
-```ts
-optional twitter?: TwitterMeta;
-```
-
-        ### <a id="OpenGraphMeta"></a>OpenGraphMeta
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-Open Graph protocol metadata for rich link previews.
-
-## Properties
-
-### audio?
-
-```ts
-optional audio?: OpenGraphStructuredProperty;
-```
-
-***
-
-### description?
-
-```ts
-optional description?: string;
-```
-
-***
-
-### determiner?
-
-```ts
-optional determiner?: string;
-```
-
-***
-
-### image?
-
-```ts
-optional image?: OpenGraphStructuredProperty;
-```
-
-***
-
-### locale?
-
-```ts
-optional locale?: string | string[];
-```
-
-***
-
-### site\_name?
-
-```ts
-optional site_name?: string;
-```
-
-***
-
-### title?
-
-```ts
-optional title?: string;
-```
-
-***
-
-### type?
-
-```ts
-optional type?: string;
-```
-
-***
-
-### url?
-
-```ts
-optional url?: string;
-```
-
-***
-
-### video?
-
-```ts
-optional video?: OpenGraphStructuredProperty;
-```
-
-        ### <a id="OpenGraphStructured"></a>OpenGraphStructured
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-Structured properties for an Open Graph media object (image, video, or audio).
-
-## Properties
-
-### ?
-
-```ts
-optional ?: string;
-```
-
-***
-
-### alt?
-
-```ts
-optional alt?: string;
-```
-
-***
-
-### height?
-
-```ts
-optional height?: number;
-```
-
-***
-
-### secure\_url?
-
-```ts
-optional secure_url?: string;
-```
-
-***
-
-### type?
-
-```ts
-optional type?: string;
-```
-
-***
-
-### url?
-
-```ts
-optional url?: string;
-```
-
-***
-
-### width?
-
-```ts
-optional width?: number;
-```
-
-        ### <a id="TwitterApp"></a>TwitterApp
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-Twitter App Card metadata containing app store identifiers, names, and URLs per platform.
-
-## Properties
-
-### id?
-
-```ts
-optional id?: object;
-```
-
-### googleplay?
-
-```ts
-optional googleplay?: string;
-```
-
-### ipad?
-
-```ts
-optional ipad?: string;
-```
-
-### iphone?
-
-```ts
-optional iphone?: string;
-```
-
-***
-
-### name?
-
-```ts
-optional name?: object;
-```
-
-### googleplay?
-
-```ts
-optional googleplay?: string;
-```
-
-### ipad?
-
-```ts
-optional ipad?: string;
-```
-
-### iphone?
-
-```ts
-optional iphone?: string;
-```
-
-***
-
-### url?
-
-```ts
-optional url?: object;
-```
-
-### googleplay?
-
-```ts
-optional googleplay?: string;
-```
-
-### ipad?
-
-```ts
-optional ipad?: string;
-```
-
-### iphone?
-
-```ts
-optional iphone?: string;
-```
-
-        ### <a id="TwitterMeta"></a>TwitterMeta
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/markup
-
-## Properties
-
-### app?
-
-```ts
-optional app?: TwitterApp;
-```
-
-***
-
-### card?
-
-```ts
-optional card?: "summary" | "summary_large_image" | "app" | "player";
-```
-
-The card type. Used with all cards. Fallback: og:type.
-If an og:type, og:title and og:description exist in the markup but
-twitter:card is absent, then a summary card may be rendered.
-
-***
-
-### creator?
-
-```ts
-optional creator?: object;
-```
-
-### ?
-
-```ts
-optional ?: string;
-```
-
-The
-
-#### Username
-
-of content creator. Used with summary_large_image cards
-
-### id?
-
-```ts
-optional id?: string;
-```
-
-Twitter user ID of content creator. Used with summary,
-summary_large_image cards
-
-***
-
-### description?
-
-```ts
-optional description?: string;
-```
-
-Description of content (maximum 200 characters). Used with summary,
-summary_large_image, player cards. Fallback: og:description.
-
-***
-
-### image?
-
-```ts
-optional image?: object;
-```
-
-### ?
-
-```ts
-optional ?: string;
-```
-
-URL of image to use in the card. Images must be less than 5MB in size.
-JPG, PNG, WEBP and GIF formats are supported. Only the first frame of
-an animated GIF will be used. SVG is not supported. Used with summary,
-summary_large_image, player cards. Fallback: og:image
-
-### alt?
-
-```ts
-optional alt?: string;
-```
-
-A text description of the image conveying the essential nature of
-an image to users who are visually impaired. Maximum 420
-characters. Used with summary, summary_large_image, player cards
-
-***
-
-### player?
-
-```ts
-optional player?: TwitterPlayer;
-```
-
-***
-
-### site?
-
-```ts
-optional site?: object;
-```
-
-The
-
-### ?
-
-```ts
-optional ?: string;
-```
-
-### id?
-
-```ts
-optional id?: string;
-```
-
-Same as twitter:site, but the user’s Twitter ID. Either
-twitter:site or twitter:site:id is required. Used with
-summary, summary_large_image, player cards
-
-### Username
-
-of website. Either twitter:site or twitter:site:id is
-required. Used with summary, summary_large_image, app, player
-cards
-
-***
-
-### title?
-
-```ts
-optional title?: string;
-```
-
-Title of content (max 70 characters). Used with summary,
-summary_large_image, player cards. Fallback: og:title.
-
-        ### <a id="TwitterPlayer"></a>TwitterPlayer
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/player-card
-
-## Properties
-
-### 
-
-```ts
-: string;
-```
-
-HTTPS URL to iFrame player. This must be a HTTPS URL which does not
-generate active mixed content warnings in a web browser. The audio or
-video player must not require plugins such as Adobe Flash.
-
-***
-
-### height?
-
-```ts
-optional height?: number;
-```
-
-Height of iframe in pixels. Used with player card
-
-***
-
-### stream?
-
-```ts
-optional stream?: string;
-```
-
-URL to raw video or audio stream. Used with player card
-
-***
-
-### width?
-
-```ts
-optional width?: number;
-```
-
-Width of iframe in pixels. Used with player card
-
-      ### type-aliases
-
-        ### <a id="OpenGraphStructuredProperty"></a>OpenGraphStructuredProperty
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-```ts
-type OpenGraphStructuredProperty = 
-  | string
-  | OpenGraphStructured
-  | (string | OpenGraphStructured)[];
-```
-
-A structured Open Graph property value: a URL string, a structured object, or an array of either.
-
-        ### <a id="StringIndexable"></a>StringIndexable
-
-[**@xylabs/sdk-meta**](#../README)
-
-***
-
-```ts
-type StringIndexable = Record<string, any>;
-```
-
-An object with string keys and arbitrary values, used for recursive meta flattening.
-
-## Credits
-
-[Made with 🔥 and ❄️ by XY Labs](https://xylabs.com)
-
-[npm-badge]: https://img.shields.io/npm/v/@xylabs/sdk-meta.svg
-[npm-link]: https://www.npmjs.com/package/@xylabs/sdk-meta
-[license-badge]: https://img.shields.io/npm/l/@xylabs/sdk-meta.svg
-[license-link]: https://github.com/xylabs/sdk-js/blob/main/LICENSE
-[logo]: https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg
+DEPRECATED — use `@ariestools/sdk-meta` instead.

package/dist/neutral/index.d.ts

@@ -1,5 +1,2 @@
-export * from './html/index.ts';
-export * from './lib/index.ts';
-export * from './meta/index.ts';
-export * from './models/index.ts';
+export * from '@ariestools/sdk-meta';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}

package/dist/neutral/index.mjs

@@ -1,92 +1,3 @@
-// src/html/mergeDocumentHead.ts
-import { isString } from "@xylabs/sdk/typeof";
-import { load } from "cheerio";
-var opts = {};
-var mergeDocumentHead = (destination, source) => {
-  const $destination = load(destination, opts);
-  const $source = load(source, opts);
-  $source("head").children().each((_, element) => {
-    const el = $destination(element);
-    if (el[0].tagName === "meta") {
-      const property = el.attr("property");
-      if (isString(property)) {
-        const match = $destination(`head meta[property="${property}"]`);
-        if (match.length > 0) {
-          match.replaceWith(el);
-          return;
-        }
-        $destination("head").append(el);
-      }
-    }
-  });
-  return $destination.html(opts);
-};
-
-// src/lib/getMetaAsDict.ts
-import { isString as isString2 } from "@xylabs/sdk/typeof";
-var propertyDelimiter = ":";
-var getMetaAsDict = (obj, parentKey) => {
-  let flatRecord = {};
-  for (const key in obj) {
-    if (typeof obj[key] === "object" && obj[key] !== null) {
-      const childRecord = getMetaAsDict(obj[key], `${isString2(parentKey) ? parentKey : ""}${key}${propertyDelimiter}`);
-      flatRecord = { ...flatRecord, ...childRecord };
-    } else {
-      const newKey = isString2(parentKey) ? `${parentKey}${key}` : key;
-      const trimmed = newKey.endsWith(propertyDelimiter) ? newKey.slice(0, -1) : newKey;
-      flatRecord[trimmed] = String(obj[key]);
-    }
-  }
-  return flatRecord;
-};
-
-// src/meta/builder.ts
-import { isString as isString3 } from "@xylabs/sdk/typeof";
-import { load as load2 } from "cheerio";
-var addMetaToHead = ($, name, value) => {
-  if (typeof value === "string") {
-    const newMeta = `<meta property="${name}" content="${value}" />`;
-    const existingMeta = $(`head meta[property="${name}"]`);
-    if ((existingMeta?.length ?? 0) > 0) {
-      existingMeta.replaceWith(newMeta);
-    } else {
-      $("head").append(newMeta);
-    }
-  } else if (Array.isArray(value)) {
-    for (const item of value) addMetaToHead($, name, item);
-  } else if (typeof value === "object" && value !== null) {
-    for (const [key, v] of Object.entries(value)) {
-      if (key === "url") {
-        addMetaToHead($, name, v);
-      } else {
-        addMetaToHead($, `${name}:${key}`, v);
-      }
-    }
-  } else {
-    throw new TypeError(`Invalid item type [${name}, ${typeof value}]`);
-  }
-};
-var metaBuilder = (html, meta, handler) => {
-  const $ = load2(html);
-  const metaProperties = getMetaAsDict(meta);
-  for (const [key, value] of Object.entries(metaProperties)) {
-    addMetaToHead($, key, value);
-  }
-  if (isString3(meta.description)) {
-    addMetaToHead($, "description", meta.description);
-  }
-  if (isString3(meta.title)) {
-    $("title").text(meta.title);
-  }
-  if (isString3(handler)) {
-    addMetaToHead($, "meta-handler", handler);
-  }
-  return $.html();
-};
-export {
-  addMetaToHead,
-  getMetaAsDict,
-  mergeDocumentHead,
-  metaBuilder
-};
+// src/index.ts
+export * from "@ariestools/sdk-meta";
 //# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/html/mergeDocumentHead.ts", "../../src/lib/getMetaAsDict.ts", "../../src/meta/builder.ts"],
-  "sourcesContent": ["import { isString } from '@xylabs/sdk/typeof'\nimport { load } from 'cheerio'\n\nconst opts = {}\n// const opts = { decodeEntities: false }\n\n/**\n * Merges meta tags from the source HTML head into the destination HTML head.\n * Existing meta tags with matching property attributes are replaced; others are appended.\n * @param destination - The base HTML string to merge into.\n * @param source - The HTML string whose head meta tags will be merged.\n * @returns The merged HTML string.\n */\nexport const mergeDocumentHead = (destination: string, source: string) => {\n  const $destination = load(destination, opts)\n  const $source = load(source, opts)\n\n  // For each child node of the source head\n  $source('head')\n    .children()\n    .each((_, element) => {\n      const el = $destination(element)\n\n      // Special case for meta tags: We want to match them by the name attribute\n      if (el[0].tagName === 'meta') {\n        const property = el.attr('property')\n        if (isString(property)) {\n          const match = $destination(`head meta[property=\"${property}\"]`)\n\n          // If it exists, replace it, otherwise append it\n          if (match.length > 0) {\n            match.replaceWith(el)\n            return\n          }\n          $destination('head').append(el)\n        }\n        // else {\n        //   // For all other elements, just check if the same element exists in the first HTML string\n        //   const match = $destination(el[0].tagName)\n\n        //   // If it exists, replace it, otherwise append it\n        //   if (match.length > 0) {\n        //     match.replaceWith(el)\n        //   } else {\n        //     $destination('head').append(el)\n        //   }\n        // }\n      }\n    })\n\n  // Return the merged HTML\n  return $destination.html(opts)\n}\n", "import { isString } from '@xylabs/sdk/typeof'\n\n/** An object with string keys and arbitrary values, used for recursive meta flattening. */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type StringIndexable = Record<string, any>\n\nconst propertyDelimiter = ':'\n\n/**\n * Recursively flattens a nested meta object into a flat dictionary with colon-delimited keys.\n * @param obj - The nested object to flatten.\n * @param parentKey - The accumulated key prefix from parent levels.\n * @returns A flat record mapping colon-delimited property names to string values.\n */\nexport const getMetaAsDict = (obj: StringIndexable, parentKey?: string): Record<string, string> => {\n  let flatRecord: StringIndexable = {}\n  for (const key in obj) {\n    if (typeof obj[key] === 'object' && obj[key] !== null) {\n      // If the value is another object, we want to iterate through its keys as well.\n      const childRecord = getMetaAsDict(obj[key] as StringIndexable, `${isString(parentKey) ? parentKey : ''}${key}${propertyDelimiter}`)\n      flatRecord = { ...flatRecord, ...childRecord }\n    } else {\n      // Concatenate the key with its parent key.\n      const newKey = isString(parentKey) ? `${parentKey}${key}` : key\n      const trimmed = newKey.endsWith(propertyDelimiter) ? newKey.slice(0, -1) : newKey\n      flatRecord[trimmed] = String(obj[key])\n    }\n  }\n  return flatRecord\n}\n", "import { isString } from '@xylabs/sdk/typeof'\nimport type { CheerioAPI } from 'cheerio'\nimport { load } from 'cheerio'\n\nimport { getMetaAsDict } from '../lib/index.ts'\nimport type { Meta } from '../models/index.ts'\n\n/* test change */\n\n/**\n * Adds or replaces a meta tag in the document head.\n * @param $ - The Cheerio API instance for the document.\n * @param name - The meta property name.\n * @param value - The meta content value (string, array, or nested object).\n */\nexport const addMetaToHead = ($: CheerioAPI, name: string, value: unknown) => {\n  if (typeof value === 'string') {\n    const newMeta = `<meta property=\"${name}\" content=\"${value}\" />`\n    const existingMeta = $(`head meta[property=\"${name}\"]`)\n    if ((existingMeta?.length ?? 0) > 0) {\n      existingMeta.replaceWith(newMeta)\n    } else {\n      $('head').append(newMeta)\n    }\n  } else if (Array.isArray(value)) {\n    for (const item of value) addMetaToHead($, name, item)\n  } else if (typeof value === 'object' && value !== null) {\n    for (const [key, v] of Object.entries(value)) {\n      if (key === 'url') {\n        addMetaToHead($, name, v)\n      } else {\n        addMetaToHead($, `${name}:${key}`, v)\n      }\n    }\n  } else {\n    throw new TypeError(`Invalid item type [${name}, ${typeof value}]`)\n  }\n}\n\n/**\n * Injects meta properties, title, and description into an HTML string.\n * @param HTML - The base HTML string to modify.\n * @param meta - The metadata to inject.\n * @param handler - Optional meta-handler property value to include.\n * @returns The modified HTML string with injected metadata.\n */\nexport const metaBuilder = (html: string, meta: Meta, handler?: string) => {\n  const $ = load(html)\n  // NOTE: This assumes unique meta properties (no duplicates)\n  // which is generally the case, but not always (you can have\n  // multiple og:video:tag tags, for example)\n  const metaProperties = getMetaAsDict(meta)\n  for (const [key, value] of Object.entries(metaProperties)) {\n    addMetaToHead($, key, value)\n  }\n  if (isString(meta.description)) {\n    addMetaToHead($, 'description', meta.description)\n  }\n  if (isString(meta.title)) {\n    $('title').text(meta.title)\n  }\n  if (isString(handler)) {\n    addMetaToHead($, 'meta-handler', handler)\n  }\n  return $.html()\n}\n"],
-  "mappings": "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",
-  "names": ["isString", "isString", "load", "load", "isString"]
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["export * from '@ariestools/sdk-meta'\n"],
+  "mappings": ";AAAA,cAAc;",
+  "names": []
 }

package/package.json

@@ -1,13 +1,11 @@
 {
   "name": "@xylabs/sdk-meta",
-  "version": "7.0.7",
-  "description": "Base functionality used throughout XYO TypeScript/JavaScript libraries",
+  "version": "8.0.0",
+  "description": "DEPRECATED — use @ariestools/sdk-meta. Backward-compatibility re-export shim.",
   "keywords": [
-    "meta",
     "xylabs",
-    "utility",
-    "typescript",
-    "esm"
+    "deprecated",
+    "shim"
   ],
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -36,7 +34,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@xylabs/sdk": "~7.0.7"
+    "@ariestools/sdk-meta": "~8.0.0"
   },
   "devDependencies": {
     "@opentelemetry/api": "~1.9.1",
@@ -49,8 +47,6 @@
     "eslint": "~10.6.0",
     "eslint-import-resolver-typescript": "~4.4.5",
     "typescript": "~6.0.3",
-    "vite": "~8.1.3",
-    "vitest": "~4.1.9",
     "zod": "~4.4.3"
   },
   "peerDependencies": {
@@ -66,5 +62,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "docs": "dist/docs.json"
+  "deprecated": "Use @ariestools/sdk-meta instead. @xylabs/sdk-meta is a compatibility shim only and will not receive further updates."
 }

package/dist/neutral/html/index.d.ts

@@ -1,2 +0,0 @@
-export * from './mergeDocumentHead.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/neutral/html/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/html/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA"}

package/dist/neutral/html/mergeDocumentHead.d.ts

@@ -1,9 +0,0 @@
-/**
- * Merges meta tags from the source HTML head into the destination HTML head.
- * Existing meta tags with matching property attributes are replaced; others are appended.
- * @param destination - The base HTML string to merge into.
- * @param source - The HTML string whose head meta tags will be merged.
- * @returns The merged HTML string.
- */
-export declare const mergeDocumentHead: (destination: string, source: string) => string;
-//# sourceMappingURL=mergeDocumentHead.d.ts.map

package/dist/neutral/html/mergeDocumentHead.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mergeDocumentHead.d.ts","sourceRoot":"","sources":["../../../src/html/mergeDocumentHead.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,aAAa,MAAM,EAAE,QAAQ,MAAM,WAuCpE,CAAA"}

package/dist/neutral/lib/getMetaAsDict.d.ts

@@ -1,10 +0,0 @@
-/** An object with string keys and arbitrary values, used for recursive meta flattening. */
-export type StringIndexable = Record<string, any>;
-/**
- * Recursively flattens a nested meta object into a flat dictionary with colon-delimited keys.
- * @param obj - The nested object to flatten.
- * @param parentKey - The accumulated key prefix from parent levels.
- * @returns A flat record mapping colon-delimited property names to string values.
- */
-export declare const getMetaAsDict: (obj: StringIndexable, parentKey?: string) => Record<string, string>;
-//# sourceMappingURL=getMetaAsDict.d.ts.map

package/dist/neutral/lib/getMetaAsDict.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getMetaAsDict.d.ts","sourceRoot":"","sources":["../../../src/lib/getMetaAsDict.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAE3F,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAIjD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,eAAe,EAAE,YAAY,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAe7F,CAAA"}

package/dist/neutral/lib/index.d.ts

@@ -1,2 +0,0 @@
-export * from './getMetaAsDict.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/neutral/lib/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA"}

package/dist/neutral/meta/builder.d.ts

@@ -1,18 +0,0 @@
-import type { CheerioAPI } from 'cheerio';
-import type { Meta } from '../models/index.ts';
-/**
- * Adds or replaces a meta tag in the document head.
- * @param $ - The Cheerio API instance for the document.
- * @param name - The meta property name.
- * @param value - The meta content value (string, array, or nested object).
- */
-export declare const addMetaToHead: ($: CheerioAPI, name: string, value: unknown) => void;
-/**
- * Injects meta properties, title, and description into an HTML string.
- * @param HTML - The base HTML string to modify.
- * @param meta - The metadata to inject.
- * @param handler - Optional meta-handler property value to include.
- * @returns The modified HTML string with injected metadata.
- */
-export declare const metaBuilder: (html: string, meta: Meta, handler?: string) => string;
-//# sourceMappingURL=builder.d.ts.map

package/dist/neutral/meta/builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/meta/builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAIzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAI9C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,UAAU,EAAE,MAAM,MAAM,EAAE,OAAO,OAAO,SAsBxE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,MAAM,IAAI,EAAE,UAAU,MAAM,WAmBrE,CAAA"}

package/dist/neutral/meta/index.d.ts

@@ -1,2 +0,0 @@
-export * from './builder.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/neutral/meta/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/meta/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}

package/dist/neutral/models/Meta.d.ts

@@ -1,10 +0,0 @@
-import type { OpenGraphMeta } from './OpenGraph/index.ts';
-import type { TwitterMeta } from './Twitter/index.ts';
-/** Represents page metadata including Open Graph and Twitter card properties. */
-export interface Meta {
-    description?: string;
-    og?: OpenGraphMeta;
-    title?: string;
-    twitter?: TwitterMeta;
-}
-//# sourceMappingURL=Meta.d.ts.map

package/dist/neutral/models/Meta.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Meta.d.ts","sourceRoot":"","sources":["../../../src/models/Meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,iFAAiF;AACjF,MAAM,WAAW,IAAI;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,EAAE,CAAC,EAAE,aAAa,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB"}

package/dist/neutral/models/OpenGraph/OpenGraphMeta.d.ts

@@ -1,15 +0,0 @@
-import type { OpenGraphStructuredProperty } from './OpenGraphStructuredProperty.ts';
-/** Open Graph protocol metadata for rich link previews. */
-export interface OpenGraphMeta {
-    audio?: OpenGraphStructuredProperty;
-    description?: string;
-    determiner?: string;
-    image?: OpenGraphStructuredProperty;
-    locale?: string | string[];
-    site_name?: string;
-    title?: string;
-    type?: string;
-    url?: string;
-    video?: OpenGraphStructuredProperty;
-}
-//# sourceMappingURL=OpenGraphMeta.d.ts.map

package/dist/neutral/models/OpenGraph/OpenGraphMeta.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"OpenGraphMeta.d.ts","sourceRoot":"","sources":["../../../../src/models/OpenGraph/OpenGraphMeta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAA;AAKnF,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,2BAA2B,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,2BAA2B,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,2BAA2B,CAAA;CACpC"}

package/dist/neutral/models/OpenGraph/OpenGraphStructured.d.ts

@@ -1,11 +0,0 @@
-/** Structured properties for an Open Graph media object (image, video, or audio). */
-export interface OpenGraphStructured {
-    ''?: string;
-    'alt'?: string;
-    'height'?: number;
-    'secure_url'?: string;
-    'type'?: string;
-    'url'?: string;
-    'width'?: number;
-}
-//# sourceMappingURL=OpenGraphStructured.d.ts.map

package/dist/neutral/models/OpenGraph/OpenGraphStructured.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"OpenGraphStructured.d.ts","sourceRoot":"","sources":["../../../../src/models/OpenGraph/OpenGraphStructured.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/dist/neutral/models/OpenGraph/OpenGraphStructuredProperty.d.ts

@@ -1,4 +0,0 @@
-import type { OpenGraphStructured } from './OpenGraphStructured.ts';
-/** A structured Open Graph property value: a URL string, a structured object, or an array of either. */
-export type OpenGraphStructuredProperty = string | OpenGraphStructured | (string | OpenGraphStructured)[];
-//# sourceMappingURL=OpenGraphStructuredProperty.d.ts.map

package/dist/neutral/models/OpenGraph/OpenGraphStructuredProperty.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"OpenGraphStructuredProperty.d.ts","sourceRoot":"","sources":["../../../../src/models/OpenGraph/OpenGraphStructuredProperty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,wGAAwG;AACxG,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,mBAAmB,GAAG,CAAC,MAAM,GAAG,mBAAmB,CAAC,EAAE,CAAA"}

package/dist/neutral/models/OpenGraph/index.d.ts

@@ -1,4 +0,0 @@
-export * from './OpenGraphMeta.ts';
-export * from './OpenGraphStructured.ts';
-export * from './OpenGraphStructuredProperty.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/neutral/models/OpenGraph/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/models/OpenGraph/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kCAAkC,CAAA"}

package/dist/neutral/models/Twitter/Twitter.d.ts

@@ -1,66 +0,0 @@
-import type { TwitterApp } from './TwitterApp.ts';
-import type { TwitterPlayer } from './TwitterPlayer.ts';
-/**
- * https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/markup
- */
-export interface TwitterMeta {
-    app?: TwitterApp;
-    /**
-     * The card type. Used with all cards. Fallback: og:type.
-     * If an og:type, og:title and og:description exist in the markup but
-     * twitter:card is absent, then a summary card may be rendered.
-     */
-    card?: 'summary' | 'summary_large_image' | 'app' | 'player';
-    creator?: {
-        /**
-         * The @username of content creator. Used with summary_large_image cards
-         */
-        ''?: string;
-        /**
-         * Twitter user ID of content creator. Used with summary,
-         * summary_large_image cards
-         */
-        'id'?: string;
-    };
-    /**
-     * Description of content (maximum 200 characters). Used with summary,
-     * summary_large_image, player cards. Fallback: og:description.
-     */
-    description?: string;
-    image?: {
-        /**
-         * URL of image to use in the card. Images must be less than 5MB in size.
-         * JPG, PNG, WebP and GIF formats are supported. Only the first frame of
-         * an animated GIF will be used. SVG is not supported. Used with summary,
-         * summary_large_image, player cards. Fallback: og:image
-         */
-        ''?: string;
-        /**
-         * A text description of the image conveying the essential nature of
-         * an image to users who are visually impaired. Maximum 420
-         * characters. Used with summary, summary_large_image, player cards
-         */
-        'alt'?: string;
-    };
-    player?: TwitterPlayer;
-    /**
-     * The @username of website. Either twitter:site or twitter:site:id is
-     * required. Used with summary, summary_large_image, app, player
-     * cards
-     */
-    site?: {
-        ''?: string;
-        /**
-         * Same as twitter:site, but the user’s Twitter ID. Either
-         * twitter:site or twitter:site:id is required. Used with
-         * summary, summary_large_image, player cards
-         */
-        'id'?: string;
-    };
-    /**
-     * Title of content (max 70 characters). Used with summary,
-     * summary_large_image, player cards. Fallback: og:title.
-     */
-    title?: string;
-}
-//# sourceMappingURL=Twitter.d.ts.map

package/dist/neutral/models/Twitter/Twitter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Twitter.d.ts","sourceRoot":"","sources":["../../../../src/models/Twitter/Twitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,qBAAqB,GAAG,KAAK,GAAG,QAAQ,CAAA;IAE3D,OAAO,CAAC,EAAE;QACR;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAA;QACX;;;WAGG;QACH,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE;QACN;;;;;WAKG;QACH,EAAE,CAAC,EAAE,MAAM,CAAA;QACX;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB;;;;OAIG;IACH,IAAI,CAAC,EAAE;QACL,EAAE,CAAC,EAAE,MAAM,CAAA;QACX;;;;WAIG;QACH,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/neutral/models/Twitter/TwitterApp.d.ts

@@ -1,19 +0,0 @@
-/** Twitter App Card metadata containing app store identifiers, names, and URLs per platform. */
-export interface TwitterApp {
-    id?: {
-        googleplay?: string;
-        ipad?: string;
-        iphone?: string;
-    };
-    name?: {
-        googleplay?: string;
-        ipad?: string;
-        iphone?: string;
-    };
-    url?: {
-        googleplay?: string;
-        ipad?: string;
-        iphone?: string;
-    };
-}
-//# sourceMappingURL=TwitterApp.d.ts.map

package/dist/neutral/models/Twitter/TwitterApp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TwitterApp.d.ts","sourceRoot":"","sources":["../../../../src/models/Twitter/TwitterApp.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE;QACH,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,GAAG,CAAC,EAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF"}

package/dist/neutral/models/Twitter/TwitterPlayer.d.ts

@@ -1,24 +0,0 @@
-/**
- * https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/player-card
- */
-export interface TwitterPlayer {
-    /**
-     * HTTPS URL to iFrame player. This must be a HTTPS URL which does not
-     * generate active mixed content warnings in a web browser. The audio or
-     * video player must not require plugins such as Adobe Flash.
-     */
-    '': string;
-    /**
-     * Height of iframe in pixels. Used with player card
-     */
-    'height'?: number;
-    /**
-     * URL to raw video or audio stream. Used with player card
-     */
-    'stream'?: string;
-    /**
-     * Width of iframe in pixels. Used with player card
-     */
-    'width'?: number;
-}
-//# sourceMappingURL=TwitterPlayer.d.ts.map

package/dist/neutral/models/Twitter/TwitterPlayer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TwitterPlayer.d.ts","sourceRoot":"","sources":["../../../../src/models/Twitter/TwitterPlayer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/dist/neutral/models/Twitter/index.d.ts

@@ -1,4 +0,0 @@
-export * from './Twitter.ts';
-export * from './TwitterApp.ts';
-export * from './TwitterPlayer.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/neutral/models/Twitter/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/models/Twitter/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA"}

package/dist/neutral/models/index.d.ts

@@ -1,4 +0,0 @@
-export * from './Meta.ts';
-export * from './OpenGraph/index.ts';
-export * from './Twitter/index.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/neutral/models/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA"}