@pagebridge/core 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { GSCClient, type GSCClientOptions, type IndexStatusResult, type IndexVerdict, } from "./gsc-client.js";
 export { SyncEngine, type SyncOptions, type SyncResult, type IndexStatusSyncResult, type SnapshotInsights, type PublishingImpact, type CannibalizationTarget, type DailyMetricPoint, } from "./sync-engine.js";
 export { DecayDetector, defaultRules, type DecayRule, type DecaySignal, type QuietPeriodConfig, } from "./decay-detector.js";
-export { URLMatcher, type MatchResult, type URLMatcherConfig, type UnmatchReason, type MatchDiagnostics, } from "./url-matcher.js";
+export { URLMatcher, type MatchResult, type URLMatcherConfig, type ContentTypeUrlConfig, type UnmatchReason, type MatchDiagnostics, } from "./url-matcher.js";
 export { TaskGenerator, type TaskGeneratorOptions, type QueryContext, } from "./task-generator.js";
 export { QuickWinAnalyzer, type QuickWinQuery, type QuickWinConfig, } from "./quick-win-analyzer.js";
 export { CtrAnomalyAnalyzer, EXPECTED_CTR_BY_POSITION, type CtrAnomaly, type CtrAnomalySeverity, type CtrAnomalyConfig, type InsightAlert, } from "./ctr-anomaly-analyzer.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,YAAY,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,wBAAwB,EACxB,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,YAAY,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,wBAAwB,EACxB,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/url-matcher.d.ts

@@ -14,17 +14,37 @@ export interface MatchResult {
     matchedSlug?: string;
     unmatchReason: UnmatchReason;
     extractedSlug?: string;
+    matchedContentType?: string;
     diagnostics?: MatchDiagnostics;
 }
-export interface URLMatcherConfig {
-    contentTypes: string[];
+/**
+ * Configuration for a single content type's URL structure
+ */
+export interface ContentTypeUrlConfig {
+    contentType: string;
+    pathPrefix?: string;
     slugField: string;
+}
+/**
+ * URLMatcher configuration with support for multiple content types and path structures
+ * @deprecated If using the old flat structure (contentTypes, slugField, pathPrefix),
+ * migrate to urlConfigs for more flexible URL path handling.
+ */
+export interface URLMatcherConfig {
+    /** New format: array of per-content-type URL configs (recommended) */
+    urlConfigs?: ContentTypeUrlConfig[];
+    /** @deprecated Use urlConfigs instead. Kept for backward compatibility. */
+    contentTypes?: string[];
+    /** @deprecated Use urlConfigs instead. Kept for backward compatibility. */
+    slugField?: string;
+    /** @deprecated Use urlConfigs instead. Kept for backward compatibility. */
     pathPrefix?: string;
     baseUrl: string;
 }
 export declare class URLMatcher {
     private sanityClient;
     private config;
+    private normalizedConfigs;
     constructor(sanityClient: SanityClient, config: URLMatcherConfig);
     matchUrls(gscUrls: string[]): Promise<MatchResult[]>;
     /**
@@ -33,7 +53,6 @@ export declare class URLMatcher {
     getAvailableSlugs(): Promise<string[]>;
     private matchSingleUrl;
     private normalizeUrl;
-    private extractSlug;
     private extractSlugWithDiagnostics;
     private escapeRegex;
     private normalizeSlug;

package/dist/url-matcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-matcher.d.ts","sourceRoot":"","sources":["../src/url-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,mBAAmB,GACnB,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,OAAO,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD,qBAAa,UAAU;IAEnB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,MAAM;gBADN,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,gBAAgB;IAG5B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAyB1D;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAc5C,OAAO,CAAC,cAAc;IAoGtB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,0BAA0B;IA0ClC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CA8B5B"}
+{"version":3,"file":"url-matcher.d.ts","sourceRoot":"","sources":["../src/url-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,mBAAmB,GACnB,sBAAsB,GACtB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,OAAO,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,qBAAa,UAAU;IAInB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,iBAAiB,CAAyB;gBAGxC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,gBAAgB;IAuB5B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAuC1D;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB5C,OAAO,CAAC,cAAc;IA0GtB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,0BAA0B;IA2ClC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CA8B5B"}

package/dist/url-matcher.js

@@ -1,130 +1,152 @@
 export class URLMatcher {
     sanityClient;
     config;
+    normalizedConfigs;
     constructor(sanityClient, config) {
         this.sanityClient = sanityClient;
         this.config = config;
+        // Normalize config: convert old format to new format if needed
+        if (config.urlConfigs) {
+            this.normalizedConfigs = config.urlConfigs;
+        }
+        else if (config.contentTypes) {
+            // Backward compatibility: convert old flat format to new format
+            console.warn("[URLMatcher] Deprecated: contentTypes, slugField, and pathPrefix are deprecated. " +
+                "Please use urlConfigs instead for more flexible URL path handling per content type.");
+            this.normalizedConfigs = config.contentTypes.map((contentType) => ({
+                contentType,
+                slugField: config.slugField || "slug",
+                pathPrefix: config.pathPrefix,
+            }));
+        }
+        else {
+            throw new Error("URLMatcher requires either 'urlConfigs' (new format) or 'contentTypes' (deprecated format)");
+        }
     }
     async matchUrls(gscUrls) {
-        const query = `*[_type in $types]{
-      _id,
-      _type,
-      "${this.config.slugField}": ${this.config.slugField}.current,
-      _createdAt
-    }`;
-        const documents = await this.sanityClient.fetch(query, {
-            types: this.config.contentTypes,
-        });
-        const slugToDoc = new Map();
+        // Query documents for each content type with its configured slug field
+        const slugToDocMap = new Map();
         const allSlugs = [];
-        for (const doc of documents) {
-            const slug = doc[this.config.slugField];
-            if (slug) {
-                const normalized = this.normalizeSlug(slug);
-                slugToDoc.set(normalized, doc);
-                allSlugs.push(normalized);
+        for (const urlConfig of this.normalizedConfigs) {
+            const query = `*[_type == $type]{
+        _id,
+        _type,
+        "${urlConfig.slugField}": ${urlConfig.slugField}.current,
+        _createdAt
+      }`;
+            const documents = await this.sanityClient.fetch(query, {
+                type: urlConfig.contentType,
+            });
+            for (const doc of documents) {
+                const slug = doc[urlConfig.slugField];
+                if (slug) {
+                    const normalized = this.normalizeSlug(slug);
+                    const key = `${urlConfig.contentType}:${normalized}`;
+                    slugToDocMap.set(key, {
+                        _id: doc._id,
+                        _createdAt: doc._createdAt,
+                        contentType: urlConfig.contentType,
+                    });
+                    allSlugs.push(normalized);
+                }
             }
         }
-        return gscUrls.map((url) => this.matchSingleUrl(url, slugToDoc, allSlugs));
+        return gscUrls.map((url) => this.matchSingleUrl(url, slugToDocMap, allSlugs));
     }
     /**
      * Get all available slugs from Sanity for diagnostic purposes
      */
     async getAvailableSlugs() {
-        const query = `*[_type in $types]{
-      "${this.config.slugField}": ${this.config.slugField}.current
-    }`;
-        const documents = await this.sanityClient.fetch(query, {
-            types: this.config.contentTypes,
-        });
-        return documents
-            .map((doc) => doc[this.config.slugField])
-            .filter((slug) => !!slug)
-            .map((slug) => this.normalizeSlug(slug));
+        const allSlugs = [];
+        for (const urlConfig of this.normalizedConfigs) {
+            const query = `*[_type == $type]{
+        "${urlConfig.slugField}": ${urlConfig.slugField}.current
+      }`;
+            const documents = await this.sanityClient.fetch(query, {
+                type: urlConfig.contentType,
+            });
+            const slugs = documents
+                .map((doc) => doc[urlConfig.slugField])
+                .filter((slug) => !!slug)
+                .map((slug) => this.normalizeSlug(slug));
+            allSlugs.push(...slugs);
+        }
+        return allSlugs;
     }
-    matchSingleUrl(gscUrl, slugToDoc, allSlugs) {
+    matchSingleUrl(gscUrl, slugToDocMap, allSlugs) {
         const normalized = this.normalizeUrl(gscUrl);
-        const extractionResult = this.extractSlugWithDiagnostics(normalized);
-        // Check if URL is outside path prefix
-        if (extractionResult.outsidePrefix) {
-            return {
-                gscUrl,
-                sanityId: undefined,
-                confidence: "none",
-                unmatchReason: "outside_path_prefix",
-                diagnostics: {
-                    normalizedUrl: normalized,
-                    pathAfterPrefix: null,
-                    configuredPrefix: this.config.pathPrefix ?? null,
-                    availableSlugsCount: slugToDoc.size,
-                    similarSlugs: [],
-                },
-            };
-        }
-        const slug = extractionResult.slug;
-        if (!slug) {
-            return {
-                gscUrl,
-                sanityId: undefined,
-                confidence: "none",
-                unmatchReason: "no_slug_extracted",
-                diagnostics: {
-                    normalizedUrl: normalized,
-                    pathAfterPrefix: extractionResult.pathAfterPrefix,
-                    configuredPrefix: this.config.pathPrefix ?? null,
-                    availableSlugsCount: slugToDoc.size,
-                    similarSlugs: [],
-                },
-            };
-        }
-        const exactMatch = slugToDoc.get(slug);
-        if (exactMatch) {
-            return {
-                gscUrl,
-                sanityId: exactMatch._id,
-                confidence: "exact",
-                matchedSlug: slug,
-                unmatchReason: "matched",
-                extractedSlug: slug,
-            };
-        }
-        const withoutTrailing = slug.replace(/\/$/, "");
-        const trailingMatch = slugToDoc.get(withoutTrailing);
-        if (trailingMatch) {
-            return {
-                gscUrl,
-                sanityId: trailingMatch._id,
-                confidence: "normalized",
-                matchedSlug: withoutTrailing,
-                unmatchReason: "matched",
-                extractedSlug: slug,
-            };
-        }
-        const withTrailing = slug + "/";
-        const addedTrailingMatch = slugToDoc.get(withTrailing);
-        if (addedTrailingMatch) {
-            return {
-                gscUrl,
-                sanityId: addedTrailingMatch._id,
-                confidence: "normalized",
-                matchedSlug: withTrailing,
-                unmatchReason: "matched",
-                extractedSlug: slug,
-            };
+        // Try to match against each content type's path prefix
+        for (const urlConfig of this.normalizedConfigs) {
+            const extractionResult = this.extractSlugWithDiagnostics(normalized, urlConfig.pathPrefix);
+            if (extractionResult.outsidePrefix) {
+                continue; // Try next content type
+            }
+            const slug = extractionResult.slug;
+            if (!slug) {
+                continue; // Try next content type
+            }
+            // Try exact match
+            const key = `${urlConfig.contentType}:${slug}`;
+            const exactMatch = slugToDocMap.get(key);
+            if (exactMatch) {
+                return {
+                    gscUrl,
+                    sanityId: exactMatch._id,
+                    confidence: "exact",
+                    matchedSlug: slug,
+                    matchedContentType: urlConfig.contentType,
+                    unmatchReason: "matched",
+                    extractedSlug: slug,
+                };
+            }
+            // Try without trailing slash
+            const withoutTrailing = slug.replace(/\/$/, "");
+            const keyWithoutTrailing = `${urlConfig.contentType}:${withoutTrailing}`;
+            const trailingMatch = slugToDocMap.get(keyWithoutTrailing);
+            if (trailingMatch) {
+                return {
+                    gscUrl,
+                    sanityId: trailingMatch._id,
+                    confidence: "normalized",
+                    matchedSlug: withoutTrailing,
+                    matchedContentType: urlConfig.contentType,
+                    unmatchReason: "matched",
+                    extractedSlug: slug,
+                };
+            }
+            // Try with trailing slash
+            const withTrailing = slug + "/";
+            const keyWithTrailing = `${urlConfig.contentType}:${withTrailing}`;
+            const addedTrailingMatch = slugToDocMap.get(keyWithTrailing);
+            if (addedTrailingMatch) {
+                return {
+                    gscUrl,
+                    sanityId: addedTrailingMatch._id,
+                    confidence: "normalized",
+                    matchedSlug: withTrailing,
+                    matchedContentType: urlConfig.contentType,
+                    unmatchReason: "matched",
+                    extractedSlug: slug,
+                };
+            }
         }
-        // No match found - find similar slugs for suggestions
-        const similarSlugs = this.findSimilarSlugs(slug, allSlugs, 3);
+        // No match found across any content type - return diagnostic info
+        const firstConfig = this.normalizedConfigs[0];
+        const firstExtractionResult = this.extractSlugWithDiagnostics(normalized, firstConfig?.pathPrefix);
+        const similarSlugs = this.findSimilarSlugs(firstExtractionResult.slug || "", allSlugs, 3);
         return {
             gscUrl,
             sanityId: undefined,
             confidence: "none",
-            unmatchReason: "no_matching_document",
-            extractedSlug: slug,
+            unmatchReason: firstExtractionResult.outsidePrefix
+                ? "outside_path_prefix"
+                : "no_matching_document",
+            extractedSlug: firstExtractionResult.slug,
             diagnostics: {
                 normalizedUrl: normalized,
-                pathAfterPrefix: extractionResult.pathAfterPrefix,
-                configuredPrefix: this.config.pathPrefix ?? null,
-                availableSlugsCount: slugToDoc.size,
+                pathAfterPrefix: firstExtractionResult.pathAfterPrefix,
+                configuredPrefix: firstConfig?.pathPrefix ?? null,
+                availableSlugsCount: slugToDocMap.size,
                 similarSlugs,
             },
         };
@@ -141,16 +163,13 @@ export class URLMatcher {
             return url.toLowerCase();
         }
     }
-    extractSlug(normalizedUrl) {
-        return this.extractSlugWithDiagnostics(normalizedUrl).slug;
-    }
-    extractSlugWithDiagnostics(normalizedUrl) {
+    extractSlugWithDiagnostics(normalizedUrl, pathPrefix) {
         try {
             const parsed = new URL(normalizedUrl);
             let path = parsed.pathname;
             // Check if the URL is outside the configured path prefix
-            if (this.config.pathPrefix) {
-                const prefixRegex = new RegExp(`^${this.escapeRegex(this.config.pathPrefix)}(/|$)`);
+            if (pathPrefix) {
+                const prefixRegex = new RegExp(`^${this.escapeRegex(pathPrefix)}(/|$)`);
                 if (!prefixRegex.test(path)) {
                     return {
                         slug: undefined,
@@ -158,7 +177,7 @@ export class URLMatcher {
                         outsidePrefix: true,
                     };
                 }
-                path = path.replace(new RegExp(`^${this.escapeRegex(this.config.pathPrefix)}`), "");
+                path = path.replace(new RegExp(`^${this.escapeRegex(pathPrefix)}`), "");
             }
             const slug = path.replace(/^\/+|\/+$/g, "");
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagebridge/core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Core engine for PageBridge — GSC sync, URL matching, content decay detection, and task generation",
   "license": "MIT",
   "private": false,