@artinstack/migrator 0.1.7 → 0.1.9

package/dist/index.d.ts

@@ -1,27 +1,15 @@
-import { M as MigrationAdapter, g as MigrationPlatform } from './types-DWOP8Dcy.js';
-export { A as AdapterContext, E as EntityKey, h as EntityType, i as MigrationCursor, b as NormalizedAsset, j as NormalizedAssetExif, d as NormalizedCategory, f as NormalizedEntity, a as NormalizedPage, c as NormalizedPortfolio, N as NormalizedPost, e as NormalizedTag, P as PortfolioMediaLink, k as PublishStatus, S as SourceMetadata, V as ValidationIssue, l as ValidationResult, m as entityKey } from './types-DWOP8Dcy.js';
+import { M as MigrationAdapter, g as MigrationPlatform } from './types-Ce4r6zqt.js';
+export { A as AdapterContext, E as EntityKey, h as EntityType, i as MigrationCursor, b as NormalizedAsset, j as NormalizedAssetExif, d as NormalizedCategory, f as NormalizedEntity, a as NormalizedPage, c as NormalizedPortfolio, N as NormalizedPost, e as NormalizedTag, P as PortfolioMediaLink, k as PublishStatus, S as SourceMetadata, V as ValidationIssue, l as ValidationResult, m as entityKey } from './types-Ce4r6zqt.js';
 export { EntityState, MigrationCheckpoint, TrackedEntity, buildPortfolioMediaLinks, isTerminalState, normalizedAssetExifSchema, normalizedAssetSchema, normalizedCategorySchema, normalizedEntitySchema, normalizedPageSchema, normalizedPortfolioSchema, normalizedPostSchema, normalizedTagSchema, shouldProcessEntity, sourceMetadataSchema, validateNormalizedAsset, validateNormalizedCategory, validateNormalizedEntity, validateNormalizedPage, validateNormalizedPortfolio, validateNormalizedPost, validateNormalizedTag } from './normalizer/index.js';
-export { B as BundleCounts, E as EntityBundle, b as bundleCounts, c as collectEntities, e as emptyBundle } from './bundle-uAAHehbv.js';
-export { ConflictReport, DryRunOptions, DryRunResult, FALLBACK_ASSET_BYTES, FilesystemMigrationSink, MIGRATION_WRITE_STAGES, MigrationRedirect, MigrationReport, MigrationRunMode, MigrationRunOptions, MigrationRunResult, MigrationSink, MigrationWriteStage, StorageEstimate, UploadAssetInput, UploadAssetResult, WriteFilesystemOptions, analyzeConflicts, buildMigrationReport, buildRedirectMap, bundleToCombinedJson, createFilesystemMigrationSink, detectRedirectLoops, emptyConflictReport, estimateStorage, hasBlockingConflicts, hasWarnings, portfolioMediaMatchesBundle, runDryRun, runMigration, runMigrationFromBundle, staleUrlsFromEstimate, writeFilesystemExport } from './sinks/index.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';
-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, r as resolveMigrationMediaSourceId, t as tiptapDocSchema, p as tiptapMarkSchema, q as tiptapNodeSchema, v as validateGrapesProjectSnapshot, s as validateTiptapDoc } from './index-Dp6nqBqe.js';
-export { discoverContentAssetUrls, discoverFeaturedAssetCandidateUrls, discoverRawImgSrcs, extractInlineImageSrcs, isLikelyImageUrl, normalizeAssetUrl, resolveFeaturedContentAssetUrl } from './lib/index.js';
+export { B as BundleCounts, E as EntityBundle, b as bundleCounts, c as collectEntities, e as emptyBundle } from './bundle-B3XS20r_.js';
+export { AssetDiscoverySummary, ConflictReport, DryRunOptions, DryRunResult, FALLBACK_ASSET_BYTES, FilesystemMigrationSink, MIGRATION_WRITE_STAGES, MigrationRedirect, MigrationReport, MigrationRunMode, MigrationRunOptions, MigrationRunResult, MigrationSink, MigrationWriteStage, StorageEstimate, UploadAssetInput, UploadAssetResult, WriteFilesystemOptions, analyzeConflicts, buildMigrationReport, buildRedirectMap, bundleToCombinedJson, createFilesystemMigrationSink, detectRedirectLoops, emptyConflictReport, estimateStorage, hasBlockingConflicts, hasWarnings, portfolioMediaMatchesBundle, runDryRun, runMigration, runMigrationFromBundle, staleUrlsFromEstimate, summarizeAssetDiscovery, writeFilesystemExport } from './sinks/index.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-BsgSquzV.js';
+export { ExpandMigrationMediaRefsResult, GrapesComponent, GrapesProjectSnapshot, GrapesStyleRule, HtmlToGrapesOptions, HtmlToTiptapOptions, LayoutKind, LayoutTypeMap, TiptapDoc, TiptapMark, TiptapNode, ValidateGrapesProjectSnapshotOptions, ValidateTiptapDocOptions, cssToStyles, expandMigrationMediaRefs, grapesComponentSchema, grapesProjectSnapshotSchema, grapesStyleRuleSchema, htmlToGrapes, htmlToTiptap, tiptapDocSchema, tiptapMarkSchema, tiptapNodeSchema, validateGrapesProjectSnapshot, validateTiptapDoc } from './transformers/index.js';
+export { C as CanonicalInlineAssetUrl, a as ContentAssetDiscovery, M as MIGRATION_MEDIA_REF_SCHEME, O as OriginUrlRewriteConfig, b as OriginUrlRewriteRule, c as buildContentMediaUrlIndex, d as buildMigrationMediaUrlIndex, e as canonicalizeInlineAssetUrl, f as createMigrationMediaRefReplaceWith, g as createWpContentGatewayRewrite, h as discoverContentAssetUrls, i as discoverContentAssets, j as discoverFeaturedAssetCandidateUrls, k as discoverRawImgSrcs, l as extractInlineImageSrcs, m as formatMigrationMediaRef, n as isLikelyImageUrl, o as isMigrationMediaRef, p as normalizeAssetUrl, q as parseMigrationMediaRef, r as resolveFeaturedContentAssetUrl, s as resolveMigrationMediaSourceId, t as rewriteOriginUrlsInText } from './media-urls-u49RCyPn.js';
+export { linkToPath, sanitizeSlug } from './lib/index.js';
 import { z } from 'zod';
 import 'node:stream';
 
-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;
-
 declare const wordpressAdapter: MigrationAdapter;
 
 /** Flat relational dump (Folders / Albums / Images tables). */
@@ -521,16 +509,4 @@ declare const wixAdapter: MigrationAdapter;
 
 declare function getAdapter(platform: MigrationPlatform): MigrationAdapter;
 
-/** 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;
-
-export { MIGRATION_MEDIA_REF_SCHEME, MigrationAdapter, MigrationPlatform, type OriginUrlRewriteConfig, type OriginUrlRewriteRule, SMUGMUG_API_BASE, SMUGMUG_OAUTH_ENDPOINTS, SQUARESPACE_JSON_FORMAT, SmugMugApiClient, type SmugMugClientOptions, type SmugMugCredentials, type SquarespaceClientOptions, type SquarespaceCollectTarget, SquarespaceCollectionClient, WixCollectionClient, WixPageSnapshotCollector, buildJsonPrettyUrl, buildSmugMugAuthorizationHeader, createMigrationMediaRefReplaceWith, createWpContentGatewayRewrite, formatMigrationMediaRef, getAdapter, isMigrationMediaRef, mapJsonPrettyWire, parseMigrationMediaRef, readSmugMugCredentialsFromEnv, rewriteOriginUrlsInText, signSmugMugOAuthRequest, smugMugCredentialsSchema, smugmugAdapter, squarespaceAdapter, wixAdapter, wordpressAdapter };
+export { MigrationAdapter, MigrationPlatform, SMUGMUG_API_BASE, SMUGMUG_OAUTH_ENDPOINTS, SQUARESPACE_JSON_FORMAT, SmugMugApiClient, type SmugMugClientOptions, type SmugMugCredentials, type SquarespaceClientOptions, type SquarespaceCollectTarget, SquarespaceCollectionClient, WixCollectionClient, WixPageSnapshotCollector, buildJsonPrettyUrl, buildSmugMugAuthorizationHeader, getAdapter, mapJsonPrettyWire, readSmugMugCredentialsFromEnv, signSmugMugOAuthRequest, smugMugCredentialsSchema, smugmugAdapter, squarespaceAdapter, wixAdapter, wordpressAdapter };

package/dist/index.js

@@ -5,17 +5,15 @@ import {
   WixCollectionClient,
   WixPageSnapshotCollector,
   buildSmugMugAuthorizationHeader,
-  createWpContentGatewayRewrite,
   getAdapter,
   readSmugMugCredentialsFromEnv,
-  rewriteOriginUrlsInText,
   signSmugMugOAuthRequest,
   smugMugCredentialsSchema,
   smugmugAdapter,
   squarespaceAdapter,
   wixAdapter,
   wordpressAdapter
-} from "./chunk-KF7G7DM6.js";
+} from "./chunk-FB3MMCHY.js";
 import {
   normalizedAssetExifSchema,
   normalizedAssetSchema,
@@ -57,8 +55,9 @@ import {
   runMigration,
   runMigrationFromBundle,
   staleUrlsFromEstimate,
+  summarizeAssetDiscovery,
   writeFilesystemExport
-} from "./chunk-MDSY3FEZ.js";
+} from "./chunk-PPT5RIZ4.js";
 import {
   buildPortfolioMediaLinks,
   bundleCounts,
@@ -67,7 +66,7 @@ import {
   entityKey,
   isTerminalState,
   shouldProcessEntity
-} from "./chunk-HI7JHWZU.js";
+} from "./chunk-KTQGOM45.js";
 import {
   cssToStyles,
   expandMigrationMediaRefs,
@@ -81,27 +80,37 @@ import {
   tiptapNodeSchema,
   validateGrapesProjectSnapshot,
   validateTiptapDoc
-} from "./chunk-S4XYG4SM.js";
+} from "./chunk-S4SUJT2D.js";
 import {
-  MIGRATION_MEDIA_REF_SCHEME,
-  buildMigrationMediaUrlIndex,
-  createMigrationMediaRefReplaceWith,
-  formatMigrationMediaRef,
-  isMigrationMediaRef,
-  parseMigrationMediaRef,
-  resolveMigrationMediaSourceId,
   rewriteInlineImages,
   stampMigrationMediaRefs
-} from "./chunk-BOYB6XRA.js";
+} from "./chunk-BONZ3U3I.js";
+import "./chunk-EJTWYEAX.js";
+import {
+  linkToPath,
+  sanitizeSlug
+} from "./chunk-XRCF73DA.js";
 import {
+  MIGRATION_MEDIA_REF_SCHEME,
+  buildContentMediaUrlIndex,
+  buildMigrationMediaUrlIndex,
+  canonicalizeInlineAssetUrl,
+  createMigrationMediaRefReplaceWith,
+  createWpContentGatewayRewrite,
   discoverContentAssetUrls,
+  discoverContentAssets,
   discoverFeaturedAssetCandidateUrls,
   discoverRawImgSrcs,
   extractInlineImageSrcs,
+  formatMigrationMediaRef,
   isLikelyImageUrl,
+  isMigrationMediaRef,
   normalizeAssetUrl,
-  resolveFeaturedContentAssetUrl
-} from "./chunk-XYP3VYDH.js";
+  parseMigrationMediaRef,
+  resolveFeaturedContentAssetUrl,
+  resolveMigrationMediaSourceId,
+  rewriteOriginUrlsInText
+} from "./chunk-S4GMDRGX.js";
 export {
   FALLBACK_ASSET_BYTES,
   FilesystemMigrationSink,
@@ -115,6 +124,7 @@ export {
   WixCollectionClient,
   WixPageSnapshotCollector,
   analyzeConflicts,
+  buildContentMediaUrlIndex,
   buildJsonPrettyUrl,
   buildMigrationMediaUrlIndex,
   buildMigrationReport,
@@ -123,6 +133,7 @@ export {
   buildSmugMugAuthorizationHeader,
   bundleCounts,
   bundleToCombinedJson,
+  canonicalizeInlineAssetUrl,
   collectEntities,
   createFilesystemMigrationSink,
   createMigrationMediaRefReplaceWith,
@@ -130,6 +141,7 @@ export {
   cssToStyles,
   detectRedirectLoops,
   discoverContentAssetUrls,
+  discoverContentAssets,
   discoverFeaturedAssetCandidateUrls,
   discoverRawImgSrcs,
   emptyBundle,
@@ -150,6 +162,7 @@ export {
   isLikelyImageUrl,
   isMigrationMediaRef,
   isTerminalState,
+  linkToPath,
   mapJsonPrettyWire,
   normalizeAssetUrl,
   normalizedAssetExifSchema,
@@ -170,6 +183,7 @@ export {
   runDryRun,
   runMigration,
   runMigrationFromBundle,
+  sanitizeSlug,
   shouldProcessEntity,
   signSmugMugOAuthRequest,
   smugMugCredentialsSchema,
@@ -178,6 +192,7 @@ export {
   squarespaceAdapter,
   staleUrlsFromEstimate,
   stampMigrationMediaRefs,
+  summarizeAssetDiscovery,
   tiptapDocSchema,
   tiptapMarkSchema,
   tiptapNodeSchema,

package/dist/lib/index.d.ts

@@ -1,26 +1,8 @@
-/** 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[];
+export { C as CanonicalInlineAssetUrl, a as ContentAssetDiscovery, M as MIGRATION_MEDIA_REF_SCHEME, O as OriginUrlRewriteConfig, b as OriginUrlRewriteRule, c as buildContentMediaUrlIndex, d as buildMigrationMediaUrlIndex, e as canonicalizeInlineAssetUrl, f as createMigrationMediaRefReplaceWith, g as createWpContentGatewayRewrite, h as discoverContentAssetUrls, i as discoverContentAssets, j as discoverFeaturedAssetCandidateUrls, k as discoverRawImgSrcs, l as extractInlineImageSrcs, m as formatMigrationMediaRef, n as isLikelyImageUrl, o as isMigrationMediaRef, p as normalizeAssetUrl, q as parseMigrationMediaRef, r as resolveFeaturedContentAssetUrl, s as resolveMigrationMediaSourceId, t as rewriteOriginUrlsInText } from '../media-urls-u49RCyPn.js';
 
-export { discoverContentAssetUrls, discoverFeaturedAssetCandidateUrls, discoverRawImgSrcs, extractInlineImageSrcs, isLikelyImageUrl, normalizeAssetUrl, resolveFeaturedContentAssetUrl };
+/** Lowercase URL-safe slug from WordPress post_name or title. */
+declare function sanitizeSlug(raw: string): string;
+/** Normalize absolute permalink to root-relative path. */
+declare function linkToPath(link: string | undefined): string | undefined;
+
+export { linkToPath, sanitizeSlug };

package/dist/lib/index.js

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

package/dist/media-urls-u49RCyPn.d.ts

@@ -0,0 +1,88 @@
+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;
+interface ContentAssetDiscovery {
+    /** Network-resolvable image paths (`<img>`, backgrounds, shortcode `image=` attrs, …). */
+    urls: string[];
+    /**
+     * WordPress attachment post ids referenced in content without an inline URL in this
+     * file context (`data-wp-attachment-id`, `[gallery ids=…]`, `[oshine_gallery ids=…]`, …).
+     */
+    unresolvedAttachmentIds: string[];
+}
+/** 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 resolvable image URLs and attachment ids
+ * that still need an index / REST / crawl resolution step.
+ */
+declare function discoverContentAssets(content: string): ContentAssetDiscovery;
+/**
+ * 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 ContentAssetDiscovery as a, type OriginUrlRewriteRule as b, buildContentMediaUrlIndex as c, buildMigrationMediaUrlIndex as d, canonicalizeInlineAssetUrl as e, createMigrationMediaRefReplaceWith as f, createWpContentGatewayRewrite as g, discoverContentAssetUrls as h, discoverContentAssets as i, discoverFeaturedAssetCandidateUrls as j, discoverRawImgSrcs as k, extractInlineImageSrcs as l, formatMigrationMediaRef as m, isLikelyImageUrl as n, isMigrationMediaRef as o, normalizeAssetUrl as p, parseMigrationMediaRef as q, resolveFeaturedContentAssetUrl as r, resolveMigrationMediaSourceId as s, rewriteOriginUrlsInText as t };

package/dist/normalizer/index.d.ts

@@ -1,7 +1,7 @@
-import { i as MigrationCursor, E as EntityKey, P as PortfolioMediaLink, l as ValidationResult } from '../types-DWOP8Dcy.js';
-export { A as AdapterContext, h as EntityType, M as MigrationAdapter, g as MigrationPlatform, b as NormalizedAsset, j as NormalizedAssetExif, d as NormalizedCategory, f as NormalizedEntity, a as NormalizedPage, c as NormalizedPortfolio, N as NormalizedPost, e as NormalizedTag, k as PublishStatus, S as SourceMetadata, V as ValidationIssue, m as entityKey } from '../types-DWOP8Dcy.js';
-import { E as EntityBundle } from '../bundle-uAAHehbv.js';
-export { B as BundleCounts, b as bundleCounts, c as collectEntities, e as emptyBundle } from '../bundle-uAAHehbv.js';
+import { i as MigrationCursor, E as EntityKey, P as PortfolioMediaLink, l as ValidationResult } from '../types-Ce4r6zqt.js';
+export { A as AdapterContext, h as EntityType, M as MigrationAdapter, g as MigrationPlatform, b as NormalizedAsset, j as NormalizedAssetExif, d as NormalizedCategory, f as NormalizedEntity, a as NormalizedPage, c as NormalizedPortfolio, N as NormalizedPost, e as NormalizedTag, k as PublishStatus, S as SourceMetadata, V as ValidationIssue, m as entityKey } from '../types-Ce4r6zqt.js';
+import { E as EntityBundle } from '../bundle-B3XS20r_.js';
+export { B as BundleCounts, b as bundleCounts, c as collectEntities, e as emptyBundle } from '../bundle-B3XS20r_.js';
 import { z } from 'zod';
 
 /** Portable entity state for resume / idempotency (not Directus field names). */

package/dist/normalizer/index.js

@@ -24,7 +24,7 @@ import {
   entityKey,
   isTerminalState,
   shouldProcessEntity
-} from "../chunk-HI7JHWZU.js";
+} from "../chunk-KTQGOM45.js";
 export {
   buildPortfolioMediaLinks,
   bundleCounts,

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

@@ -1,3 +1,5 @@
+import { O as OriginUrlRewriteConfig } from './media-urls-u49RCyPn.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 { 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-Ce4r6zqt.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 { E as EntityBundle } from '../bundle-uAAHehbv.js';
+import { a as RewriteInlineImagesOptions } from '../rewrite-inline-images-BsgSquzV.js';
+export { b as RewriteInlineImagesResult, r as rewriteInlineImages } from '../rewrite-inline-images-BsgSquzV.js';
+import { E as EntityBundle } from '../bundle-B3XS20r_.js';
+import '../media-urls-u49RCyPn.js';
 
 interface CreatePostResult {
     targetId: string;
@@ -115,6 +116,18 @@ interface RedirectLoopConflict {
     toPath: string;
     blocked: boolean;
 }
+interface AssetDiscoverySummary {
+    /** Unique resolvable image URLs found in post/page HTML. */
+    urlsDiscovered: number;
+    /** Unique WordPress attachment ids referenced in content (`data-wp-attachment-id`, gallery `ids=`). */
+    attachmentRefs: number;
+    /** Attachment ids that resolved to a `media.json` row in this job. */
+    attachmentRefsResolved: number;
+    /** Attachment ids still lacking a URL in this export context. */
+    attachmentRefsUnresolved: number;
+    /** Sorted unresolved ids (for scan UI / follow-up REST export). */
+    unresolvedAttachmentIds: string[];
+}
 interface ConflictReport {
     duplicatePostSlugs: DuplicateSlugConflict[];
     duplicatePageSlugs: DuplicateSlugConflict[];
@@ -124,7 +137,9 @@ interface ConflictReport {
     unresolvedInlineImages: UnresolvedInlineImageConflict[];
     unsupportedBlocks: UnsupportedBlockConflict[];
     redirectLoops: RedirectLoopConflict[];
+    assetDiscovery: AssetDiscoverySummary;
 }
+declare function summarizeAssetDiscovery(bundle: EntityBundle): AssetDiscoverySummary;
 declare function emptyConflictReport(): ConflictReport;
 declare function analyzeConflicts(bundle: EntityBundle, options?: {
     staleAssetUrls?: StaleAssetUrlConflict[];
@@ -157,6 +172,7 @@ interface MigrationReport {
         categories: number;
         tags: number;
         storageBytesEstimated?: number;
+        assetDiscovery?: AssetDiscoverySummary;
     };
     warnings: string[];
     errors: string[];
@@ -259,4 +275,4 @@ declare function staleUrlsFromEstimate(estimate: StorageEstimate): {
     reason: string;
 }[];
 
-export { type ConflictReport, type DryRunOptions, type DryRunResult, FALLBACK_ASSET_BYTES, FilesystemMigrationSink, MIGRATION_WRITE_STAGES, type MigrationRedirect, type MigrationReport, type MigrationRunMode, type MigrationRunOptions, type MigrationRunResult, type MigrationSink, type MigrationWriteStage, RewriteInlineImagesOptions, type StorageEstimate, type UploadAssetInput, type UploadAssetResult, type WriteFilesystemOptions, analyzeConflicts, buildMigrationReport, buildRedirectMap, bundleToCombinedJson, createFilesystemMigrationSink, detectRedirectLoops, emptyConflictReport, estimateStorage, hasBlockingConflicts, hasWarnings, portfolioMediaMatchesBundle, runDryRun, runMigration, runMigrationFromBundle, staleUrlsFromEstimate, writeFilesystemExport };
+export { type AssetDiscoverySummary, type ConflictReport, type DryRunOptions, type DryRunResult, FALLBACK_ASSET_BYTES, FilesystemMigrationSink, MIGRATION_WRITE_STAGES, type MigrationRedirect, type MigrationReport, type MigrationRunMode, type MigrationRunOptions, type MigrationRunResult, type MigrationSink, type MigrationWriteStage, RewriteInlineImagesOptions, type StorageEstimate, type UploadAssetInput, type UploadAssetResult, type WriteFilesystemOptions, analyzeConflicts, buildMigrationReport, buildRedirectMap, bundleToCombinedJson, createFilesystemMigrationSink, detectRedirectLoops, emptyConflictReport, estimateStorage, hasBlockingConflicts, hasWarnings, portfolioMediaMatchesBundle, runDryRun, runMigration, runMigrationFromBundle, staleUrlsFromEstimate, summarizeAssetDiscovery, writeFilesystemExport };

package/dist/sinks/index.js

@@ -17,13 +17,15 @@ import {
   runMigration,
   runMigrationFromBundle,
   staleUrlsFromEstimate,
+  summarizeAssetDiscovery,
   writeFilesystemExport
-} from "../chunk-MDSY3FEZ.js";
-import "../chunk-HI7JHWZU.js";
+} from "../chunk-PPT5RIZ4.js";
+import "../chunk-KTQGOM45.js";
 import {
   rewriteInlineImages
-} from "../chunk-BOYB6XRA.js";
-import "../chunk-XYP3VYDH.js";
+} from "../chunk-BONZ3U3I.js";
+import "../chunk-XRCF73DA.js";
+import "../chunk-S4GMDRGX.js";
 export {
   FALLBACK_ASSET_BYTES,
   FilesystemMigrationSink,
@@ -44,6 +46,7 @@ export {
   runMigration,
   runMigrationFromBundle,
   staleUrlsFromEstimate,
+  summarizeAssetDiscovery,
   writeFilesystemExport
 };
 //# sourceMappingURL=index.js.map