@bridge-ds/core 0.19.0 → 0.21.0

package/dist/previews-github.d.ts

@@ -1,5 +1,6 @@
 import type { BridgeConfig } from './config';
 import type { GitHubClient } from './github-client';
+import type { ProductConfig } from './products';
 import { type BranchPreview, type PreviewApps } from './previews';
 export interface BranchPreviewOptions {
     /** Branch and head commit when the caller knows them (skips reading the pull request). */
@@ -20,3 +21,15 @@ export declare function branchPreviewUrls(gh: GitHubClient, ref: number | string
         apps?: PreviewApps | undefined;
     } | undefined;
 } | undefined, opts?: BranchPreviewOptions): Promise<BranchPreview[]>;
+/**
+ * The preview of a branch of a product that has its own repository (products[].repo): the URL Vercel reports in that
+ * repository (deployments, commit statuses, its pull request comment), the product's `preview` template only when
+ * Vercel cannot have shortened it. Vercel shortens a branch alias over 63 characters with a hash nobody can predict
+ * (`bridge-demo-shop-git-explore-wishlis-f9937d-...`), so most exploration branches need the reported URL. Null when
+ * the product has no preview. `gh` reads the product repository; a failed read leaves that source out.
+ */
+export declare function productPreviewOnGitHub(gh: GitHubClient, product: Pick<ProductConfig, 'key' | 'name' | 'preview'>, e: {
+    number: number;
+    branch: string;
+    sha?: string | undefined;
+}): Promise<BranchPreview | null>;

package/dist/previews.d.ts

@@ -114,6 +114,11 @@ export interface BranchPreview {
     url: string | null;
     state: PreviewState;
     source: PreviewUrlSource | null;
+    /**
+     * Vercel skipped the latest build (its Ignored Build Step: nothing the app is built from changed on the branch), so
+     * the branch has no build of its own and its link opens a canceled deployment. Set only when true.
+     */
+    skipped?: true;
 }
 /** A GitHub deployment with its latest status, as `GitHubClient.listDeployments` returns it. */
 export interface DeploymentLike {
@@ -126,6 +131,8 @@ export interface CommitStatusLike {
     context: string;
     state: string;
     target_url?: string | null | undefined;
+    /** "Canceled by Ignored Build Step" when Vercel skipped the build. */
+    description?: string | null | undefined;
 }
 /** One project of the Vercel bot comment. */
 export interface VercelCommentProject {
@@ -171,7 +178,7 @@ export interface BranchPreviewSources {
  * The state comes from the freshest signal: commit status, then deployment, then the comment.
  */
 export declare function resolveBranchPreviews(apps: PreviewApps, ctx: PreviewContext, sources?: BranchPreviewSources): BranchPreview[];
-/** The previews that have a URL, as links (`{ app, label, url }`), in the stable app order. */
+/** The previews that have a URL, as links (`{ app, label, url }`), in the stable app order. A skipped build has none. */
 export declare const previewLinksOf: (previews: BranchPreview[]) => {
     app: keyof PreviewApps;
     label: string;