@artinstack/migrator 0.1.7 → 0.1.8

package/dist/lib/index.js

@@ -1,19 +1,48 @@
+import "../chunk-EJTWYEAX.js";
 import {
+  linkToPath,
+  sanitizeSlug
+} from "../chunk-XRCF73DA.js";
+import {
+  MIGRATION_MEDIA_REF_SCHEME,
+  buildContentMediaUrlIndex,
+  buildMigrationMediaUrlIndex,
+  canonicalizeInlineAssetUrl,
+  createMigrationMediaRefReplaceWith,
+  createWpContentGatewayRewrite,
   discoverContentAssetUrls,
   discoverFeaturedAssetCandidateUrls,
   discoverRawImgSrcs,
   extractInlineImageSrcs,
+  formatMigrationMediaRef,
   isLikelyImageUrl,
+  isMigrationMediaRef,
   normalizeAssetUrl,
-  resolveFeaturedContentAssetUrl
-} from "../chunk-XYP3VYDH.js";
+  parseMigrationMediaRef,
+  resolveFeaturedContentAssetUrl,
+  resolveMigrationMediaSourceId,
+  rewriteOriginUrlsInText
+} from "../chunk-WHGUE5FC.js";
 export {
+  MIGRATION_MEDIA_REF_SCHEME,
+  buildContentMediaUrlIndex,
+  buildMigrationMediaUrlIndex,
+  canonicalizeInlineAssetUrl,
+  createMigrationMediaRefReplaceWith,
+  createWpContentGatewayRewrite,
   discoverContentAssetUrls,
   discoverFeaturedAssetCandidateUrls,
   discoverRawImgSrcs,
   extractInlineImageSrcs,
+  formatMigrationMediaRef,
   isLikelyImageUrl,
+  isMigrationMediaRef,
+  linkToPath,
   normalizeAssetUrl,
-  resolveFeaturedContentAssetUrl
+  parseMigrationMediaRef,
+  resolveFeaturedContentAssetUrl,
+  resolveMigrationMediaSourceId,
+  rewriteOriginUrlsInText,
+  sanitizeSlug
 };
 //# sourceMappingURL=index.js.map

package/dist/media-urls-w46-CWUp.d.ts

@@ -0,0 +1,74 @@
+interface OriginUrlRewriteRule {
+    /** Literal substring or regex matched against the full text block. */
+    match: string | RegExp;
+    replace: string;
+}
+interface OriginUrlRewriteConfig {
+    rules: OriginUrlRewriteRule[];
+}
+/** Swap legacy gateway/staging host fragments before parse, fetch, or asset discovery. */
+declare function rewriteOriginUrlsInText(text: string, config: OriginUrlRewriteConfig): string;
+/** Build a rule that rewrites API-gateway `/prod/wp-content/` paths to a public origin. */
+declare function createWpContentGatewayRewrite(gatewayBase: string, publicOrigin: string): OriginUrlRewriteConfig;
+/** All `<img src>` values (including those not ingested as vault assets). */
+declare function discoverRawImgSrcs(content: string): string[];
+/** Normalize protocol-relative and trim; skip data URIs. */
+declare function normalizeAssetUrl(raw: string): string | undefined;
+/** Heuristic: URL likely points at a raster/vector image asset, not a page link. */
+declare function isLikelyImageUrl(url: string): boolean;
+/**
+ * Ordered featured-image candidates when `_thumbnail_id` is missing — heroes
+ * (`data-bg-image`, CSS backgrounds, `bg_image=`) before inline assets; within
+ * each tier, first in document order wins. Filename tokens (`_w`, `_2048`, …)
+ * are not interpreted as quality signals.
+ */
+declare function discoverFeaturedAssetCandidateUrls(content: string): string[];
+/** Best featured-image URL from post/page HTML when attachment id is unavailable. */
+declare function resolveFeaturedContentAssetUrl(content: string): string | undefined;
+/**
+ * Generic content-discovery pass: collect image URLs from HTML `<img>` tags,
+ * section hero markers (`data-bg-image`), inline CSS backgrounds, and common
+ * shortcode/builder attributes (`src=`, `image=`, `bg_image=`, …) without
+ * parsing builder-specific structure (Tatsu, Elementor, etc.).
+ */
+declare function discoverContentAssetUrls(content: string): string[];
+/** @deprecated Use discoverContentAssetUrls — kept for call-site clarity during transition. */
+declare function extractInlineImageSrcs(content: string): string[];
+/** Pseudo-URL scheme for portable migration asset pointers (not WordPress shortcodes). */
+declare const MIGRATION_MEDIA_REF_SCHEME = "artinstack-migration://asset/";
+/** Build `artinstack-migration://asset/{sourceId}` (percent-encodes the normalizer source id). */
+declare function formatMigrationMediaRef(sourceAssetId: string): string;
+declare function isMigrationMediaRef(value: string): boolean;
+/** Parse a migration media ref back to the normalizer `sourceId`, or `undefined` if not a ref. */
+declare function parseMigrationMediaRef(value: string): string | undefined;
+/** Default `replaceWith` for `rewriteInlineImages` / `stampMigrationMediaRefs` (OSS-14). */
+declare function createMigrationMediaRefReplaceWith(): (ref: {
+    sourceAssetId?: string;
+}) => string;
+interface CanonicalInlineAssetUrl {
+    /** Canonical absolute URL stored on `NormalizedAsset.sourceUrl`. */
+    canonicalUrl: string;
+    /** Normalizer id: `url:{canonicalUrl}`. */
+    sourceId: string;
+}
+/**
+ * OSS-15: one canonical key for inline `url:` assets — apply origin rewrite then
+ * `normalizeAssetUrl` so discovery, refs, and vault entities share the same id.
+ */
+declare function canonicalizeInlineAssetUrl(raw: string, originUrlRewrite?: OriginUrlRewriteConfig): CanonicalInlineAssetUrl | undefined;
+/**
+ * Map normalized upload URLs (and pathnames) → normalizer `sourceId`.
+ * Attachment ids are WXR `post_id` strings; inline discoveries use `url:{src}`.
+ */
+declare function buildMigrationMediaUrlIndex(entries: Iterable<{
+    sourceUrl: string;
+    sourceId: string;
+}>): Map<string, string>;
+declare function resolveMigrationMediaSourceId(src: string, urlIndex: Map<string, string>, originUrlRewrite?: OriginUrlRewriteConfig): string | undefined;
+/** Merge attachment + inline asset rows into one stamp/lookup index (OSS-15). */
+declare function buildContentMediaUrlIndex(entries: Iterable<{
+    sourceUrl: string;
+    sourceId: string;
+}>, originUrlRewrite?: OriginUrlRewriteConfig): Map<string, string>;
+
+export { type CanonicalInlineAssetUrl as C, MIGRATION_MEDIA_REF_SCHEME as M, type OriginUrlRewriteConfig as O, type OriginUrlRewriteRule as a, buildContentMediaUrlIndex as b, buildMigrationMediaUrlIndex as c, canonicalizeInlineAssetUrl as d, createMigrationMediaRefReplaceWith as e, createWpContentGatewayRewrite as f, discoverContentAssetUrls as g, discoverFeaturedAssetCandidateUrls as h, discoverRawImgSrcs as i, extractInlineImageSrcs as j, formatMigrationMediaRef as k, isLikelyImageUrl as l, isMigrationMediaRef as m, normalizeAssetUrl as n, resolveMigrationMediaSourceId as o, parseMigrationMediaRef as p, rewriteOriginUrlsInText as q, resolveFeaturedContentAssetUrl as r };

package/dist/{rewrite-inline-images-Bq16bJA5.d.ts → rewrite-inline-images-DyxKUNs3.d.ts}

@@ -1,3 +1,5 @@
+import { O as OriginUrlRewriteConfig } from './media-urls-w46-CWUp.js';
+
 interface RewriteInlineImageRef {
     originalSrc: string;
     sourceAssetId?: string;
@@ -29,6 +31,8 @@ declare function rewriteInlineImages(html: string, options: RewriteInlineImagesO
 interface StampMigrationMediaRefsOptions {
     /** Pre-built url/pathname → sourceId map (from attachments + inline assets). */
     urlToSourceId: Map<string, string>;
+    /** Canonicalize lookup keys during stamp (OSS-15). */
+    originUrlRewrite?: OriginUrlRewriteConfig;
     replaceWith?: RewriteInlineImagesOptions["replaceWith"];
     requireUploaded?: boolean;
 }

package/dist/sinks/index.d.ts

@@ -1,8 +1,9 @@
 import { d as NormalizedCategory, e as NormalizedTag, b as NormalizedAsset, c as NormalizedPortfolio, N as NormalizedPost, a as NormalizedPage, P as PortfolioMediaLink, E as EntityKey, f as NormalizedEntity, g as MigrationPlatform, M as MigrationAdapter } from '../types-DWOP8Dcy.js';
 import { Readable } from 'node:stream';
-import { a as RewriteInlineImagesOptions } from '../rewrite-inline-images-Bq16bJA5.js';
-export { b as RewriteInlineImagesResult, r as rewriteInlineImages } from '../rewrite-inline-images-Bq16bJA5.js';
+import { a as RewriteInlineImagesOptions } from '../rewrite-inline-images-DyxKUNs3.js';
+export { b as RewriteInlineImagesResult, r as rewriteInlineImages } from '../rewrite-inline-images-DyxKUNs3.js';
 import { E as EntityBundle } from '../bundle-uAAHehbv.js';
+import '../media-urls-w46-CWUp.js';
 
 interface CreatePostResult {
     targetId: string;

package/dist/sinks/index.js

@@ -18,12 +18,13 @@ import {
   runMigrationFromBundle,
   staleUrlsFromEstimate,
   writeFilesystemExport
-} from "../chunk-MDSY3FEZ.js";
+} from "../chunk-Z3L6N63Y.js";
 import "../chunk-HI7JHWZU.js";
 import {
   rewriteInlineImages
-} from "../chunk-BOYB6XRA.js";
-import "../chunk-XYP3VYDH.js";
+} from "../chunk-KYNKJ4XV.js";
+import "../chunk-XRCF73DA.js";
+import "../chunk-WHGUE5FC.js";
 export {
   FALLBACK_ASSET_BYTES,
   FilesystemMigrationSink,

package/dist/transformers/index.d.ts

@@ -1,4 +1,170 @@
-export { E as ExpandMigrationMediaRefsResult, G as GrapesComponent, a as GrapesProjectSnapshot, b as GrapesStyleRule, H as HtmlToGrapesOptions, c as HtmlToTiptapOptions, L as LayoutKind, d as LayoutTypeMap, T as TiptapDoc, e as TiptapMark, f as TiptapNode, V as ValidateGrapesProjectSnapshotOptions, g as ValidateTiptapDocOptions, h as buildMigrationMediaUrlIndex, i as cssToStyles, j as expandMigrationMediaRefs, k as grapesComponentSchema, l as grapesProjectSnapshotSchema, m as grapesStyleRuleSchema, n as htmlToGrapes, o as htmlToTiptap, t as tiptapDocSchema, p as tiptapMarkSchema, q as tiptapNodeSchema, v as validateGrapesProjectSnapshot, s as validateTiptapDoc } from '../index-Dp6nqBqe.js';
-export { R as RewriteInlineImageRef, a as RewriteInlineImagesOptions, b as RewriteInlineImagesResult, S as StampMigrationMediaRefsOptions, U as UploadedAssetRef, r as rewriteInlineImages, s as stampMigrationMediaRefs } from '../rewrite-inline-images-Bq16bJA5.js';
-import 'zod';
-import '../types-DWOP8Dcy.js';
+import { z } from 'zod';
+import { l as ValidationResult } from '../types-DWOP8Dcy.js';
+export { R as RewriteInlineImageRef, a as RewriteInlineImagesOptions, b as RewriteInlineImagesResult, S as StampMigrationMediaRefsOptions, U as UploadedAssetRef, r as rewriteInlineImages, s as stampMigrationMediaRefs } from '../rewrite-inline-images-DyxKUNs3.js';
+export { c as buildMigrationMediaUrlIndex } from '../media-urls-w46-CWUp.js';
+
+type LayoutKind = "section" | "row" | "column";
+/** Map OSS-2 `data-layout` markers to Grapes component types (host may override). */
+interface LayoutTypeMap {
+    section?: string;
+    row?: string;
+    column?: string;
+}
+interface HtmlToGrapesOptions {
+    /** Map source class names to Grapes component types. */
+    componentMap?: Record<string, string>;
+    /** Map HTML tag names to Grapes component types (e.g. `h2` → `heading`). */
+    tagMap?: Record<string, string>;
+    /** Map `data-layout` section/row/column markers to Grapes component types. */
+    layoutTypeMap?: LayoutTypeMap;
+    /** Grapes type for OSS-12 `data-wp-widget` markers. Default: `wp-widget`. */
+    widgetComponentType?: string;
+}
+interface GrapesStyleRule {
+    selectors: string[];
+    style: Record<string, string>;
+}
+interface GrapesComponent {
+    type: string;
+    tagName?: string;
+    attributes?: Record<string, string>;
+    classes?: string[];
+    components?: GrapesComponent[];
+    content?: string;
+    void?: boolean;
+}
+interface GrapesProjectSnapshot {
+    content: GrapesComponent[];
+    styles: GrapesStyleRule[];
+    contentHtml?: string;
+    contentCss?: string;
+}
+
+/** Cheerio HTML walk → Grapes `content` + root `styles`. */
+declare function htmlToGrapes(html: string, options?: HtmlToGrapesOptions): GrapesProjectSnapshot;
+
+/** ProseMirror / Tiptap mark (inline formatting). */
+interface TiptapMark {
+    type: string;
+    attrs?: Record<string, string>;
+}
+/** ProseMirror / Tiptap node — text nodes use `text`; others use `content`. */
+interface TiptapNode {
+    type: string;
+    attrs?: Record<string, unknown>;
+    content?: TiptapNode[];
+    marks?: TiptapMark[];
+    text?: string;
+}
+/** Root Tiptap document (`content_json` shape). */
+interface TiptapDoc {
+    type: "doc";
+    content: TiptapNode[];
+}
+interface HtmlToTiptapOptions {
+    /**
+     * Unwrap OSS-2 `data-layout` scaffolding (section/row/column divs) into prose blocks.
+     * @default true
+     */
+    unwrapLayoutMarkers?: boolean;
+}
+
+/** Cheerio HTML walk → Tiptap / ProseMirror `doc` JSON for blog `content_json`. */
+declare function htmlToTiptap(html: string, options?: HtmlToTiptapOptions): TiptapDoc;
+
+/** Parse `<style>` blocks and class rules into Grapes root `styles[]`. */
+declare function cssToStyles(css: string): GrapesStyleRule[];
+
+declare const grapesStyleRuleSchema: z.ZodObject<{
+    selectors: z.ZodArray<z.ZodString, "many">;
+    style: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    style: Record<string, string>;
+    selectors: string[];
+}, {
+    style: Record<string, string>;
+    selectors: string[];
+}>;
+declare const grapesComponentSchema: z.ZodType<GrapesComponent>;
+declare const grapesProjectSnapshotSchema: z.ZodObject<{
+    content: z.ZodArray<z.ZodType<GrapesComponent, z.ZodTypeDef, GrapesComponent>, "many">;
+    styles: z.ZodArray<z.ZodObject<{
+        selectors: z.ZodArray<z.ZodString, "many">;
+        style: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        style: Record<string, string>;
+        selectors: string[];
+    }, {
+        style: Record<string, string>;
+        selectors: string[];
+    }>, "many">;
+    contentHtml: z.ZodOptional<z.ZodString>;
+    contentCss: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: GrapesComponent[];
+    styles: {
+        style: Record<string, string>;
+        selectors: string[];
+    }[];
+    contentHtml?: string | undefined;
+    contentCss?: string | undefined;
+}, {
+    content: GrapesComponent[];
+    styles: {
+        style: Record<string, string>;
+        selectors: string[];
+    }[];
+    contentHtml?: string | undefined;
+    contentCss?: string | undefined;
+}>;
+interface ValidateGrapesProjectSnapshotOptions {
+    /** When set, every component `type` in the tree must be in this allowlist. */
+    allowedComponentTypes?: string[];
+}
+/**
+ * Opt-in structural check for a Grapes project snapshot (not a full Grapes editor project file).
+ * Does not validate host-specific component registries unless `allowedComponentTypes` is passed.
+ */
+declare function validateGrapesProjectSnapshot(snapshot: unknown, options?: ValidateGrapesProjectSnapshotOptions): ValidationResult;
+
+declare const tiptapMarkSchema: z.ZodObject<{
+    type: z.ZodString;
+    attrs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    attrs?: Record<string, string> | undefined;
+}, {
+    type: string;
+    attrs?: Record<string, string> | undefined;
+}>;
+declare const tiptapNodeSchema: z.ZodType<TiptapNode>;
+declare const tiptapDocSchema: z.ZodObject<{
+    type: z.ZodLiteral<"doc">;
+    content: z.ZodArray<z.ZodType<TiptapNode, z.ZodTypeDef, TiptapNode>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "doc";
+    content: TiptapNode[];
+}, {
+    type: "doc";
+    content: TiptapNode[];
+}>;
+interface ValidateTiptapDocOptions {
+    /** When set, every node `type` in the tree must be in this allowlist. */
+    allowedNodeTypes?: string[];
+    /** When set, every mark `type` must be in this allowlist. */
+    allowedMarkTypes?: string[];
+}
+/** Opt-in structural check for a Tiptap / ProseMirror document. */
+declare function validateTiptapDoc(doc: unknown, options?: ValidateTiptapDocOptions): ValidationResult;
+
+interface ExpandMigrationMediaRefsResult {
+    html: string;
+    unresolved: string[];
+}
+/**
+ * Expand OSS-14 `artinstack-migration://asset/…` refs to host CDN URLs.
+ * Lookup (`migration_entities` → `publicUrl`) is host-supplied via `resolvePublicUrl`.
+ */
+declare function expandMigrationMediaRefs(html: string, resolvePublicUrl: (sourceId: string) => string | undefined): ExpandMigrationMediaRefsResult;
+
+export { type ExpandMigrationMediaRefsResult, type GrapesComponent, type GrapesProjectSnapshot, type GrapesStyleRule, type HtmlToGrapesOptions, type HtmlToTiptapOptions, type LayoutKind, type LayoutTypeMap, type TiptapDoc, type TiptapMark, type TiptapNode, type ValidateGrapesProjectSnapshotOptions, type ValidateTiptapDocOptions, cssToStyles, expandMigrationMediaRefs, grapesComponentSchema, grapesProjectSnapshotSchema, grapesStyleRuleSchema, htmlToGrapes, htmlToTiptap, tiptapDocSchema, tiptapMarkSchema, tiptapNodeSchema, validateGrapesProjectSnapshot, validateTiptapDoc };

package/dist/transformers/index.js

@@ -11,13 +11,14 @@ import {
   tiptapNodeSchema,
   validateGrapesProjectSnapshot,
   validateTiptapDoc
-} from "../chunk-S4XYG4SM.js";
+} from "../chunk-ALLFBWBO.js";
 import {
-  buildMigrationMediaUrlIndex,
   rewriteInlineImages,
   stampMigrationMediaRefs
-} from "../chunk-BOYB6XRA.js";
-import "../chunk-XYP3VYDH.js";
+} from "../chunk-KYNKJ4XV.js";
+import {
+  buildMigrationMediaUrlIndex
+} from "../chunk-WHGUE5FC.js";
 export {
   buildMigrationMediaUrlIndex,
   cssToStyles,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artinstack/migrator",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Stateless content normalizer and migration framework — WordPress, SmugMug, Squarespace → platform-agnostic schema",
   "license": "MIT",
   "author": "ArtInStack",

package/dist/chunk-BOYB6XRA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/lib/migration-media-ref.ts","../src/lib/migration-media-url-index.ts","../src/transformers/rewrite-inline-images.ts"],"sourcesContent":["/** Pseudo-URL scheme for portable migration asset pointers (not WordPress shortcodes). */\nexport const MIGRATION_MEDIA_REF_SCHEME = \"artinstack-migration://asset/\";\n\n/** Build `artinstack-migration://asset/{sourceId}` (percent-encodes the normalizer source id). */\nexport function formatMigrationMediaRef(sourceAssetId: string): string {\n  return `${MIGRATION_MEDIA_REF_SCHEME}${encodeURIComponent(sourceAssetId)}`;\n}\n\nexport function isMigrationMediaRef(value: string): boolean {\n  return value.trim().startsWith(MIGRATION_MEDIA_REF_SCHEME);\n}\n\n/** Parse a migration media ref back to the normalizer `sourceId`, or `undefined` if not a ref. */\nexport function parseMigrationMediaRef(value: string): string | undefined {\n  const trimmed = value.trim();\n  if (!trimmed.startsWith(MIGRATION_MEDIA_REF_SCHEME)) return undefined;\n  const encoded = trimmed.slice(MIGRATION_MEDIA_REF_SCHEME.length);\n  if (!encoded) return undefined;\n  try {\n    return decodeURIComponent(encoded);\n  } catch {\n    return undefined;\n  }\n}\n\n/** Default `replaceWith` for `rewriteInlineImages` / `stampMigrationMediaRefs` (OSS-14). */\nexport function createMigrationMediaRefReplaceWith(): (\n  ref: { sourceAssetId?: string },\n) => string {\n  return (ref) => {\n    if (!ref.sourceAssetId) return \"\";\n    return formatMigrationMediaRef(ref.sourceAssetId);\n  };\n}\n","import { normalizeAssetUrl } from \"./content-asset-urls.js\";\n\nfunction urlPathname(url: string): string | undefined {\n  try {\n    return new URL(url, \"http://migration.local\").pathname;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Map normalized upload URLs (and pathnames) → normalizer `sourceId`.\n * Attachment ids are WXR `post_id` strings; inline discoveries use `url:{src}`.\n */\nexport function buildMigrationMediaUrlIndex(\n  entries: Iterable<{ sourceUrl: string; sourceId: string }>,\n): Map<string, string> {\n  const index = new Map<string, string>();\n\n  for (const entry of entries) {\n    index.set(entry.sourceUrl, entry.sourceId);\n    const normalized = normalizeAssetUrl(entry.sourceUrl);\n    if (normalized) index.set(normalized, entry.sourceId);\n    const pathname = urlPathname(entry.sourceUrl);\n    if (pathname) index.set(pathname, entry.sourceId);\n  }\n\n  return index;\n}\n\nexport function resolveMigrationMediaSourceId(\n  src: string,\n  urlIndex: Map<string, string>,\n): string | undefined {\n  const normalized = normalizeAssetUrl(src);\n  if (!normalized) return undefined;\n\n  return (\n    urlIndex.get(normalized) ??\n    urlIndex.get(src) ??\n    (urlPathname(normalized) ? urlIndex.get(urlPathname(normalized)!) : undefined)\n  );\n}\n","import * as cheerio from \"cheerio\";\n\nimport { normalizeAssetUrl } from \"../lib/content-asset-urls.js\";\nimport {\n  createMigrationMediaRefReplaceWith,\n  isMigrationMediaRef,\n} from \"../lib/migration-media-ref.js\";\nimport {\n  buildMigrationMediaUrlIndex,\n  resolveMigrationMediaSourceId,\n} from \"../lib/migration-media-url-index.js\";\n\nexport interface RewriteInlineImageRef {\n  originalSrc: string;\n  sourceAssetId?: string;\n}\n\nexport interface UploadedAssetRef {\n  targetId: string;\n  publicUrl?: string;\n}\n\nexport interface RewriteInlineImagesOptions {\n  resolveAsset: (src: string) => RewriteInlineImageRef | undefined;\n  /**\n   * Replace a resolved source id with a migration ref or CDN URL.\n   * When omitted, defaults to OSS-14 `artinstack-migration://asset/…` refs.\n   */\n  replaceWith?: (ref: RewriteInlineImageRef, uploaded?: UploadedAssetRef) => string;\n  /**\n   * When true, skip URLs that cannot be matched to an uploaded vault target.\n   * Default: false when using migration refs; true when a custom `replaceWith` is supplied.\n   */\n  requireUploaded?: boolean;\n}\n\nexport interface RewriteInlineImagesResult {\n  html: string;\n  referencedSources: string[];\n  unresolved: string[];\n}\n\n/** Inline CSS `background` / `background-image: url(…)` (quoted or bare). */\nconst BACKGROUND_IMAGE_URL_PATTERN =\n  /background(?:-image)?\\s*:[^;]*?url\\s*\\(\\s*(['\"]?)([^'\")]+)\\1\\s*\\)/gi;\n\nfunction resolveRewriteOptions(\n  options: RewriteInlineImagesOptions,\n): Required<Pick<RewriteInlineImagesOptions, \"replaceWith\" | \"requireUploaded\">> {\n  const replaceWith = options.replaceWith ?? createMigrationMediaRefReplaceWith();\n  const requireUploaded = options.requireUploaded ?? Boolean(options.replaceWith);\n  return { replaceWith, requireUploaded };\n}\n\nfunction tryRewriteUrl(\n  src: string,\n  options: RewriteInlineImagesOptions,\n  uploadedBySourceId: Map<string, UploadedAssetRef>,\n  referencedSources: Set<string>,\n  unresolved: Set<string>,\n): string | undefined {\n  const normalized = normalizeAssetUrl(src);\n  if (!normalized) return undefined;\n\n  if (isMigrationMediaRef(normalized)) {\n    referencedSources.add(normalized);\n    return normalized;\n  }\n\n  referencedSources.add(normalized);\n  const ref = options.resolveAsset(normalized);\n  if (!ref?.sourceAssetId) {\n    unresolved.add(normalized);\n    return undefined;\n  }\n\n  const { replaceWith, requireUploaded } = resolveRewriteOptions(options);\n  const uploaded = uploadedBySourceId.get(ref.sourceAssetId);\n  if (requireUploaded && !uploaded) {\n    unresolved.add(normalized);\n    return undefined;\n  }\n\n  return replaceWith(ref, uploaded);\n}\n\nfunction rewriteBackgroundUrlsInStyle(\n  style: string,\n  options: RewriteInlineImagesOptions,\n  uploadedBySourceId: Map<string, UploadedAssetRef>,\n  referencedSources: Set<string>,\n  unresolved: Set<string>,\n): string {\n  return style.replace(BACKGROUND_IMAGE_URL_PATTERN, (full, quote: string, rawUrl: string) => {\n    const replaced = tryRewriteUrl(rawUrl.trim(), options, uploadedBySourceId, referencedSources, unresolved);\n    if (!replaced) return full;\n\n    const urlCall = quote\n      ? `url(${quote}${replaced}${quote})`\n      : `url(${replaced})`;\n    return full.replace(/url\\s*\\(\\s*(['\"]?)([^'\")]+)\\1\\s*\\)/i, urlCall);\n  });\n}\n\nfunction rewriteSrcset(\n  srcset: string,\n  options: RewriteInlineImagesOptions,\n  uploadedBySourceId: Map<string, UploadedAssetRef>,\n  referencedSources: Set<string>,\n  unresolved: Set<string>,\n): string {\n  return srcset\n    .split(\",\")\n    .map((entry) => {\n      const trimmed = entry.trim();\n      if (!trimmed) return entry;\n      const [urlPart, descriptor] = trimmed.split(/\\s+/, 2);\n      const replaced = tryRewriteUrl(urlPart ?? \"\", options, uploadedBySourceId, referencedSources, unresolved);\n      if (!replaced) return entry;\n      return descriptor ? `${replaced} ${descriptor}` : replaced;\n    })\n    .join(\", \");\n}\n\n/** Rewrite `<img src>` / `srcset`, `data-bg-image`, and inline CSS backgrounds using uploaded asset targets. */\nexport function rewriteInlineImages(\n  html: string,\n  options: RewriteInlineImagesOptions,\n  uploadedBySourceId: Map<string, UploadedAssetRef>,\n): RewriteInlineImagesResult {\n  if (!html.trim()) {\n    return { html, referencedSources: [], unresolved: [] };\n  }\n\n  const $ = cheerio.load(html, { xml: false });\n  const referencedSources = new Set<string>();\n  const unresolved = new Set<string>();\n\n  $(\"img\").each((_, element) => {\n    const img = $(element);\n    const src = img.attr(\"src\")?.trim();\n    if (src && !src.startsWith(\"data:\")) {\n      const replaced = tryRewriteUrl(src, options, uploadedBySourceId, referencedSources, unresolved);\n      if (replaced) img.attr(\"src\", replaced);\n    }\n\n    const srcset = img.attr(\"srcset\")?.trim();\n    if (srcset) {\n      img.attr(\"srcset\", rewriteSrcset(srcset, options, uploadedBySourceId, referencedSources, unresolved));\n    }\n  });\n\n  $(\"[data-bg-image]\").each((_, element) => {\n    const node = $(element);\n    const bgImage = node.attr(\"data-bg-image\")?.trim();\n    if (!bgImage || bgImage.startsWith(\"data:\")) return;\n    const replaced = tryRewriteUrl(bgImage, options, uploadedBySourceId, referencedSources, unresolved);\n    if (replaced) node.attr(\"data-bg-image\", replaced);\n  });\n\n  $(\"[style]\").each((_, element) => {\n    const node = $(element);\n    const style = node.attr(\"style\");\n    if (!style?.includes(\"background\")) return;\n    const rewritten = rewriteBackgroundUrlsInStyle(\n      style,\n      options,\n      uploadedBySourceId,\n      referencedSources,\n      unresolved,\n    );\n    if (rewritten !== style) node.attr(\"style\", rewritten);\n  });\n\n  return {\n    html: $.root().html() ?? html,\n    referencedSources: [...referencedSources],\n    unresolved: [...unresolved],\n  };\n}\n\nexport interface StampMigrationMediaRefsOptions {\n  /** Pre-built url/pathname → sourceId map (from attachments + inline assets). */\n  urlToSourceId: Map<string, string>;\n  replaceWith?: RewriteInlineImagesOptions[\"replaceWith\"];\n  requireUploaded?: boolean;\n}\n\n/**\n * OSS-14 — replace resolved `wp-content/uploads` URLs with `artinstack-migration://asset/…`\n * refs. Does not invent refs for unknown URLs (left unchanged + listed in `unresolved`).\n */\nexport function stampMigrationMediaRefs(\n  html: string,\n  options: StampMigrationMediaRefsOptions,\n): RewriteInlineImagesResult {\n  return rewriteInlineImages(\n    html,\n    {\n      resolveAsset: (src) => {\n        const sourceAssetId = resolveMigrationMediaSourceId(src, options.urlToSourceId);\n        if (!sourceAssetId) return undefined;\n        return { originalSrc: src, sourceAssetId };\n      },\n      replaceWith: options.replaceWith,\n      requireUploaded: options.requireUploaded ?? false,\n    },\n    new Map(),\n  );\n}\n\n/** Build a url index from attachment rows and/or normalized assets. */\nexport { buildMigrationMediaUrlIndex };\n"],"mappings":"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","names":[]}