@thallylabs/migrate 0.2.42 → 0.2.43

package/README.md

@@ -734,3 +734,11 @@ initialized one at a time, best-effort,
 after a successful clone — a submodule that can't be fetched (private,
 deleted, network trouble) is named in a warning instead of failing the
 whole migration.
+
+`migrateUrl({ sourceUrl, openapiUrl })` accepts an explicit HTTPS OpenAPI URL,
+using the same bounded specification fetch boundary as repository imports.
+A single publisher-linked `openapi.json` or `openapi.yaml` can also be discovered.
+Crawled endpoint pages with a unique tag/title route become interactive while
+retaining their prose; generated API navigation lists only unrepresented operations.
+This HTTP adapter never reads local paths. Trusted local CLI imports use a separate
+bounded snapshot before calling the existing repository converter.

package/dist/index.d.ts

@@ -113,9 +113,37 @@ options?: {
 declare function detectRepositoryPlatform(repositoryDir: string, docsDir?: string): MigrationPlatform;
 /** Pick the first conventional content root containing Markdown. */
 declare function detectRepositoryDocsDir(repositoryDir: string): string;
+/** Enumerate generated endpoint routes using the same spec visibility, tab ids and slugs as migration linking. */
+declare function migrationApiRoutes(bundle: Pick<MigrationBundle, 'docsConfig' | 'assets'>): Array<string>;
 /** Import an already-available repository directory into a canonical bundle. */
 declare function migrateRepository(options: RepositoryMigrationOptions): MigrationBundle;
 
+/**
+ * Final pass over a migrated redirect set. Next.js applies a redirect before it
+ * looks for a page, so a redirect whose source is a served page hides that page,
+ * and two redirects that point at each other never settle. Next also parses a
+ * redirect source as a route pattern, so one with pattern operators fails the
+ * whole build. Every platform and every step that adds redirects (source
+ * config, generated aliases, remote API specs) is checked here once, instead of
+ * each caller guarding its own additions.
+ *
+ * A site runs on either of two servers: `next start` matches a redirect source
+ * without regard to letter case, while the Cloudflare build matches it exactly.
+ * A conflict is judged by the stricter reading, so a redirect that would hide a
+ * page or loop on either server is left out.
+ */
+
+/** `exactRoute` in lower case: the form routes are compared in, so `/Guide` and `/guide` are one address. */
+declare function literalRoute(route: string): string | null;
+/**
+ * Every address that opens a page. That is `pageRoutes`, plus the site root for
+ * the home document: the runtime serves `introduction` at `/` (`navigationPagePath`
+ * in `@thallylabs/core`, which is also what its sidebar links to) and still accepts
+ * `/introduction` as an alias (`matchesNavigationPath`). A redirect that has to take
+ * a page over must cover all of them.
+ */
+declare function pageEntryRoutes(page: Pick<MigrationPage, 'id'>): Array<string>;
+
 /**
  * Mintlify-only helpers: page access rules, site-wide CSS/JS/font assets,
  * and appearance settings. Kept apart from the generic repository walk so the
@@ -342,6 +370,8 @@ declare function validateIntegrations(integrations: unknown): Array<string>;
 
 interface UrlMigrationOptions {
     sourceUrl: string;
+    /** Explicit HTTPS OpenAPI specification when the publisher has no operation mirrors. */
+    openapiUrl?: string;
     /** Explicit caller selection; omitted callers retain source auto-detection. */
     platform?: MigrationPlatform;
     fetcher?: MigrationFetcher;
@@ -356,6 +386,9 @@ declare const defaultMigrationFetcher: MigrationFetcher;
 /** Crawl one public docs origin into a canonical, caller-independent bundle. */
 declare function migrateUrl(options: UrlMigrationOptions): Promise<MigrationBundle>;
 
+/** Bind unique crawled endpoints in place and generate only missing operation navigation. */
+declare function hydrateUrlOpenApi(bundle: MigrationBundle, specUrl: string, fetcher?: MigrationFetcher): Promise<MigrationBundle>;
+
 /**
  * Attach safely downloaded specs to the exact authored API tabs. A spec
  * mounted under Mintlify `directory` folders gets a redirect from each
@@ -371,4 +404,4 @@ declare function migrateUrl(options: UrlMigrationOptions): Promise<MigrationBund
  */
 declare function hydrateRemoteApiSpecs(bundle: MigrationBundle, fetcher?: MigrationFetcher): Promise<MigrationBundle>;
 
-export { type GitHubRepositorySource, MigrationAsset, MigrationBundle, MigrationDocsConfig, MigrationFetcher, MigrationNavigationGroup, MigrationPage, MigrationPlatform, MigrationWarning, RenderedMigrationFile, type RepositoryMigrationOptions, SOURCE_REF_MAX_BYTES, SOURCE_REF_MAX_FILES, SOURCE_REF_MAX_REPOSITORY_KB, type SourceRefImport, type SourceRefMapping, type UrlMigrationOptions, addMintlifyDirectoryRedirects, buildNavigationFromPages, cloneGitHubRepository, defaultMigrationFetcher, detectRepositoryDocsDir, detectRepositoryPlatform, gitmodulePaths, hydrateRemoteApiSpecs, importSourceRef, migrateRepository, migrateUrl, normalizeMdx, parseGitHubRepositoryUrl, parseMarkdownPage, parseSourceRefFlags, projectFernNavigation, projectMintlifyIntegrations, projectMintlifyNavigation, pruneMissingNavigationPages, readFernConfig, readMintlifyConfig, sourceRefOversizeReason, validateIntegrations, validateMigrationUrl };
+export { type GitHubRepositorySource, MigrationAsset, MigrationBundle, MigrationDocsConfig, MigrationFetcher, MigrationNavigationGroup, MigrationPage, MigrationPlatform, MigrationWarning, RenderedMigrationFile, type RepositoryMigrationOptions, SOURCE_REF_MAX_BYTES, SOURCE_REF_MAX_FILES, SOURCE_REF_MAX_REPOSITORY_KB, type SourceRefImport, type SourceRefMapping, type UrlMigrationOptions, addMintlifyDirectoryRedirects, buildNavigationFromPages, cloneGitHubRepository, defaultMigrationFetcher, detectRepositoryDocsDir, detectRepositoryPlatform, gitmodulePaths, hydrateRemoteApiSpecs, hydrateUrlOpenApi, importSourceRef, literalRoute, migrateRepository, migrateUrl, migrationApiRoutes, normalizeMdx, pageEntryRoutes, parseGitHubRepositoryUrl, parseMarkdownPage, parseSourceRefFlags, projectFernNavigation, projectMintlifyIntegrations, projectMintlifyNavigation, pruneMissingNavigationPages, readFernConfig, readMintlifyConfig, sourceRefOversizeReason, validateIntegrations, validateMigrationUrl };