@netlify/spark-ui 1.31.0-alpha.3 → 1.31.0-alpha.5

package/dist/components/index.d.ts

@@ -5,6 +5,6 @@ export { default as SearchLink } from './preact/SearchModal/components/SearchLin
 export { default as SearchHeading } from './preact/SearchModal/components/SearchHeading/SearchHeading';
 export { default as SearchToggle } from './preact/SearchModal/components/SearchToggle/SearchToggle';
 export { default as SearchModal } from './preact/SearchModal/components/SearchModal/SearchModal';
-export { DropZone, AnonymousDropClient, AuthenticatedBuildClient, AuthenticatedDropClient, deployBuild, deployFiles, detectBuild, inferBuildSettings, readDataTransfer, readFileList, zipFiles, } from './preact/DropZone';
-export type { AuthenticatedBuildClientConfig, AuthenticatedDropClientConfig, BuildClient, BuildDeployResult, BuildDetection, BuildSite, DeployedBuild, DeployedSite, DropClient, DropResponse, Digest, DeployResult, DeployProgress, DeployPhase, InferredBuildSettings, ProcessedFile, } from './preact/DropZone';
+export { DropZone, AnonymousDropClient, AuthenticatedBuildClient, AuthenticatedDropClient, BuildCreateError, BuildFailedError, BuildTimeoutError, DROPZONE_EVENTS, getFileTypes, humanizeDropError, NotAuthenticatedError, SiteCreateError, UnsupportedDropError, deployBuild, deployFiles, detectBuild, inferBuildSettings, readDataTransfer, readFileList, zipFiles, } from './preact/DropZone';
+export type { AuthenticatedBuildClientConfig, AuthenticatedDropClientConfig, BuildClient, BuildDeployOptions, BuildReason, BuildResponse, DeployError, DeployStatus, DropZoneEventName, DropZoneEventProperties, TrackFn, ZipOptions, ZipResult, BuildDeployResult, BuildDetection, BuildSite, DeployedBuild, DeployedSite, DropClient, DropResponse, Digest, DeployResult, DeployProgress, DeployPhase, InferredBuildSettings, ProcessedFile, } from './preact/DropZone';
 export { type IconName } from './preact/Icon';

package/dist/components/preact/DropZone/DropZone.d.ts

@@ -1,5 +1,5 @@
 import { ComponentChildren } from 'preact';
-import { BuildClient, BuildDetection, DropClient } from './drop-core';
+import { BuildClient, BuildDetection, DropClient } from '../../../drop-core';
 import { DeployedBuild, DeployedSite, DeployError, TrackFn } from './useDropDeploy';
 interface Props {
     /** Content the drop layer sits on top of. The zone is invisible until you drag over it. */
@@ -17,12 +17,11 @@ interface Props {
      */
     siteDashboardUrl?: (siteName: string) => string;
     /**
-     * Where to send a build-required drop (framework source, build command,
-     * functions) that can't be built here — no `getUploadToken`/`buildClient`, or a
-     * visitor who isn't logged in. Such projects can't deploy through the anonymous
-     * static drop API, so by default the user is redirected here — the app signup
-     * page with `next=/drop` — to build on the authenticated Drop page. Override to
-     * point at your own destination.
+     * The signup hand-off for a build-required drop that can't be built here (no
+     * session, or no build wiring). The drop is stashed on this origin first, so
+     * a flow that returns the visitor to this page deploys it automatically —
+     * see `resumeStashedBuilds`. Defaults to the app signup page with
+     * `next=/drop`.
      */
     buildSignupUrl?: string;
     /**
@@ -32,7 +31,7 @@ interface Props {
      * build-required drops build in place instead of being handed off to the app.
      * On netlify.com this reads `GET /access-control/generate-access-control-token`.
      * Resolving `null` means "no session": static drops fall back to the anonymous
-     * claim flow, build drops to `buildSignupUrl`.
+     * claim flow; build drops are stashed and handed to `buildSignupUrl`.
      * See [Logged-in visitors](#logged-in-visitors).
      */
     getUploadToken?: () => Promise<string | null>;
@@ -77,6 +76,25 @@ interface Props {
      * redirects. The static drop path is unaffected either way.
      */
     onBuildRequired?: (info: BuildDetection) => void;
+    /**
+     * Called instead of the `buildSignupUrl` redirect when a build-required drop
+     * can't be built here (no session). By this point the drop has been stashed
+     * on this origin (`stashed` says whether that succeeded) — own the hand-off
+     * however fits your auth flow, e.g. open a signup popup that keeps the
+     * visitor on the page. Once they're back authenticated, a remount of the
+     * zone deploys the stash automatically.
+     */
+    onBuildSignupHandoff?: (info: {
+        stashed: boolean;
+        detection: BuildDetection;
+    }) => void;
+    /**
+     * Deploy a previously stashed build drop automatically when the zone mounts
+     * with an authenticated visitor (default `true`). The stash is written when a
+     * logged-out build drop is handed to signup; see
+     * [Signup hand-off and auto-resume](#signup-hand-off-and-auto-resume).
+     */
+    resumeStashedBuilds?: boolean;
     /** Called once the deploy is live. */
     onDeploy?: (result: DeployedSite) => void;
     /**
@@ -130,5 +148,5 @@ interface Props {
     analyticsId?: string;
     className?: string;
 }
-export default function DropZone({ children, apiBase, client, claimUrl, siteDashboardUrl, buildSignupUrl, getUploadToken, buildClient, authenticatedDropClient, proxyBase, accountSlug, buildDeployUrl, waitForBuild, onBuildRequired, onDeploy, onBuildDeploy, onError, showStatus, onTrack, analyticsId, className, }: Props): import("preact").JSX.Element;
+export default function DropZone({ children, apiBase, client, claimUrl, siteDashboardUrl, buildSignupUrl, getUploadToken, buildClient, authenticatedDropClient, proxyBase, accountSlug, buildDeployUrl, waitForBuild, onBuildRequired, onBuildSignupHandoff, resumeStashedBuilds, onDeploy, onBuildDeploy, onError, showStatus, onTrack, analyticsId, className, }: Props): import("preact").JSX.Element;
 export {};

package/dist/components/preact/DropZone/DropZone.js

@@ -1,57 +1,62 @@
 import { u as e } from "../../../chunks/jsxRuntime.module.Bzuv3cXw.js";
-import { A as j, d as G, y as K } from "../../../chunks/hooks.module.DRcxknIz.js";
-import { readFileList as L, readDataTransfer as Z } from "./drop-core/readFiles.js";
-import { getFileTypes as D } from "./drop-core/fileTypes.js";
-import "./drop-core/detectBuild.js";
-import "./drop-core/zip.js";
-import { useDropDeploy as q } from "./useDropDeploy.js";
+import { A as E, d as K, y as L } from "../../../chunks/hooks.module.DRcxknIz.js";
+import { DROPZONE_EVENTS as W } from "../../../drop-core/analytics.js";
+import { readFileList as q, readDataTransfer as H } from "../../../drop-core/readFiles.js";
+import { getFileTypes as z } from "../../../drop-core/fileTypes.js";
+import "../../../drop-core/detectBuild.js";
+import "../../../drop-core/zip.js";
+import { useDropDeploy as J } from "./useDropDeploy.js";
 import { Fragment as w } from "preact";
-import '../../../assets/DropZone.css';const H = 120, J = (r) => `https://app.netlify.com/drop/${r}`, Q = (r) => `https://app.netlify.com/projects/${r}`, W = "https://app.netlify.com/signup?next=/drop&utm_campaign=drop", X = ({ siteName: r }) => `https://app.netlify.com/projects/${r}`;
-function ce({
+import '../../../assets/DropZone.css';const Q = 120, X = (r) => `https://app.netlify.com/drop/${r}`, Y = (r) => `https://app.netlify.com/projects/${r}`, ee = "https://app.netlify.com/signup?next=/drop&utm_campaign=drop", re = ({ siteName: r }) => `https://app.netlify.com/projects/${r}`;
+function fe({
   children: r,
   apiBase: a,
   client: l,
-  claimUrl: c = J,
-  siteDashboardUrl: u = Q,
-  buildSignupUrl: A = W,
+  claimUrl: c = X,
+  siteDashboardUrl: u = Y,
+  buildSignupUrl: S = ee,
   getUploadToken: T,
-  buildClient: C,
-  authenticatedDropClient: S,
-  proxyBase: _,
-  accountSlug: $,
-  buildDeployUrl: B = X,
-  waitForBuild: U,
-  onBuildRequired: P,
-  onDeploy: R,
-  onBuildDeploy: x,
-  onError: E,
+  buildClient: j,
+  authenticatedDropClient: A,
+  proxyBase: C,
+  accountSlug: B,
+  buildDeployUrl: O = re,
+  waitForBuild: P,
+  onBuildRequired: R,
+  onBuildSignupHandoff: _,
+  resumeStashedBuilds: $,
+  onDeploy: N,
+  onBuildDeploy: U,
+  onError: x,
   showStatus: f = !0,
   onTrack: d,
   analyticsId: g,
   className: F
 }) {
-  const y = (t, n = {}) => d == null ? void 0 : d(t, g ? { dropzone_id: g, ...n } : n), { status: s, warning: b, busy: i, deploy: m, reset: I } = q({
+  const m = (t, n = {}) => d == null ? void 0 : d(t, g ? { dropzone_id: g, ...n } : n), { status: s, warning: y, busy: i, deploy: b, reset: I } = J({
     apiBase: a,
     client: l,
     claimUrl: c,
     siteDashboardUrl: u,
-    buildSignupUrl: A,
+    buildSignupUrl: S,
     getUploadToken: T,
-    buildClient: C,
-    authenticatedDropClient: S,
-    proxyBase: _,
-    accountSlug: $,
-    buildDeployUrl: B,
-    waitForBuild: U,
-    onBuildRequired: P,
-    onDeploy: R,
-    onBuildDeploy: x,
-    onError: E,
-    track: y
-  }), { active: p, keepActive: M, endDrag: N } = Y(), h = j(null), v = (t) => {
+    buildClient: j,
+    authenticatedDropClient: A,
+    proxyBase: C,
+    accountSlug: B,
+    buildDeployUrl: O,
+    waitForBuild: P,
+    onBuildRequired: R,
+    onBuildSignupHandoff: _,
+    resumeStashedBuilds: $,
+    onDeploy: N,
+    onBuildDeploy: U,
+    onError: x,
+    track: m
+  }), { active: p, keepActive: V, endDrag: M } = te(), h = E(null), v = (t) => {
     var n;
-    y("dropzone_browse_opened", { method: t }), (n = h.current) == null || n.click();
-  }, O = f && (p || i || s.kind === "error"), V = [
+    m(W.BROWSE_OPENED, { method: t }), (n = h.current) == null || n.click();
+  }, Z = f && (p || i || s.kind === "error"), G = [
     "n-dropzone",
     p && "is-active",
     i && "is-busy",
@@ -61,19 +66,19 @@ function ce({
   return /* @__PURE__ */ e(
     "div",
     {
-      class: V,
+      class: G,
       "data-state": s.kind,
       role: "button",
       tabIndex: i ? -1 : 0,
       "aria-label": "Drop a site folder or zip here to deploy it, or press Enter to browse for files",
       "aria-busy": i,
       onDragOver: (t) => {
-        i || (t.preventDefault(), M());
+        i || (t.preventDefault(), V());
       },
       onDrop: (t) => {
-        if (t.preventDefault(), N(), i) return;
+        if (t.preventDefault(), M(), i) return;
         const n = t.dataTransfer;
-        n && m(() => Z(n), "drag", D(n.files));
+        n && b(() => H(n), "drag", z(n.files));
       },
       onClick: (t) => {
         !i && t.target === t.currentTarget && v("click");
@@ -93,23 +98,23 @@ function ce({
             webkitdirectory: "",
             directory: "",
             onChange: (t) => {
-              var k;
+              var D;
               const n = t.currentTarget;
-              if ((k = n.files) != null && k.length) {
-                const z = n.files;
-                m(() => L(z), "browse", D(z));
+              if ((D = n.files) != null && D.length) {
+                const k = n.files;
+                b(() => q(k), "browse", z(k));
               }
               n.value = "";
             }
           }
         ),
-        O && /* @__PURE__ */ e(
+        Z && /* @__PURE__ */ e(
           "div",
           {
             class: "n-dropzone-overlay n-fadeIn",
             children: [
-              /* @__PURE__ */ e(ee, { status: s, active: p, onReset: I }),
-              b && s.kind !== "error" && i && /* @__PURE__ */ e("p", { class: "n-dropzone-warning", role: "status", children: b })
+              /* @__PURE__ */ e(ne, { status: s, active: p, onReset: I }),
+              y && s.kind !== "error" && i && /* @__PURE__ */ e("p", { class: "n-dropzone-warning", role: "status", children: y })
             ]
           },
           s.kind === "idle" ? "active" : s.kind
@@ -118,15 +123,15 @@ function ce({
     }
   );
 }
-function Y() {
-  const [r, a] = G(!1), l = j();
-  return K(() => () => clearTimeout(l.current), []), { active: r, keepActive: () => {
-    a(!0), clearTimeout(l.current), l.current = setTimeout(() => a(!1), H);
+function te() {
+  const [r, a] = K(!1), l = E();
+  return L(() => () => clearTimeout(l.current), []), { active: r, keepActive: () => {
+    a(!0), clearTimeout(l.current), l.current = setTimeout(() => a(!1), Q);
   }, endDrag: () => {
     clearTimeout(l.current), a(!1);
   } };
 }
-function ee({
+function ne({
   status: r,
   active: a,
   onReset: l
@@ -182,5 +187,5 @@ function o({ label: r }) {
   ] });
 }
 export {
-  ce as default
+  fe as default
 };

package/dist/components/preact/DropZone/DropZone.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/preact/DropZone/index.d.ts

@@ -1,4 +1,4 @@
 export { default as DropZone } from './DropZone';
-export { AnonymousDropClient, AuthenticatedBuildClient, AuthenticatedDropClient, BuildCreateError, BuildFailedError, BuildTimeoutError, deployBuild, deployFiles, detectBuild, getFileTypes, humanizeDropError, inferBuildSettings, NotAuthenticatedError, readDataTransfer, readFileList, SiteCreateError, UnsupportedDropError, zipFiles, } from './drop-core';
-export type { AuthenticatedBuildClientConfig, AuthenticatedDropClientConfig, BuildClient, BuildDeployOptions, BuildDeployResult, BuildDetection, BuildReason, BuildResponse, BuildSite, DropClient, DropResponse, Digest, DeployResult, DeployProgress, DeployPhase, InferredBuildSettings, ProcessedFile, ZipOptions, ZipResult, } from './drop-core';
-export type { DeployedBuild, DeployedSite, DeployError, DeployStatus } from './useDropDeploy';
+export { AnonymousDropClient, DROPZONE_EVENTS, AuthenticatedBuildClient, AuthenticatedDropClient, BuildCreateError, BuildFailedError, BuildTimeoutError, deployBuild, deployFiles, detectBuild, getFileTypes, humanizeDropError, inferBuildSettings, NotAuthenticatedError, readDataTransfer, readFileList, SiteCreateError, UnsupportedDropError, zipFiles, } from '../../../drop-core';
+export type { AuthenticatedBuildClientConfig, DropMethod, DropZoneEventName, DropZoneEventProperties, TrackFn, AuthenticatedDropClientConfig, BuildClient, BuildDeployOptions, BuildDeployResult, BuildDetection, BuildReason, BuildResponse, BuildSite, DropClient, DropResponse, Digest, DeployResult, DeployProgress, DeployPhase, InferredBuildSettings, ProcessedFile, ZipOptions, ZipResult, } from '../../../drop-core';
+export type { DeployedBuild, DeployedSite, DeployError, DeploySource, DeployStatus, } from './useDropDeploy';

package/dist/components/preact/DropZone/index.js

@@ -1,31 +1,33 @@
 import { default as o } from "./DropZone.js";
-import { readDataTransfer as i, readFileList as p } from "./drop-core/readFiles.js";
-import { getFileTypes as l } from "./drop-core/fileTypes.js";
-import { detectBuild as a, inferBuildSettings as n } from "./drop-core/detectBuild.js";
-import { AnonymousDropClient as m } from "./drop-core/client.js";
-import { AuthenticatedDropClient as s } from "./drop-core/authedDropClient.js";
-import { AuthenticatedBuildClient as E } from "./drop-core/buildClient.js";
-import { zipFiles as C } from "./drop-core/zip.js";
-import { deployBuild as c, deployFiles as h } from "./drop-core/deploy.js";
-import { BuildCreateError as A, BuildFailedError as T, BuildTimeoutError as g, NotAuthenticatedError as z, SiteCreateError as S, UnsupportedDropError as L, humanizeDropError as N } from "./drop-core/errors.js";
+import { BuildCreateError as i, BuildFailedError as p, BuildTimeoutError as d, NotAuthenticatedError as l, SiteCreateError as u, UnsupportedDropError as a, humanizeDropError as f } from "../../../drop-core/errors.js";
+import { DROPZONE_EVENTS as n } from "../../../drop-core/analytics.js";
+import { readDataTransfer as E, readFileList as s } from "../../../drop-core/readFiles.js";
+import { getFileTypes as D } from "../../../drop-core/fileTypes.js";
+import { detectBuild as F, inferBuildSettings as c } from "../../../drop-core/detectBuild.js";
+import { zipFiles as y } from "../../../drop-core/zip.js";
+import { AnonymousDropClient as T } from "../../../drop-core/client.js";
+import { AuthenticatedDropClient as S } from "../../../drop-core/authedDropClient.js";
+import { AuthenticatedBuildClient as z } from "../../../drop-core/buildClient.js";
+import { deployBuild as Z, deployFiles as L } from "../../../drop-core/deploy.js";
 export {
-  m as AnonymousDropClient,
-  E as AuthenticatedBuildClient,
-  s as AuthenticatedDropClient,
-  A as BuildCreateError,
-  T as BuildFailedError,
-  g as BuildTimeoutError,
+  T as AnonymousDropClient,
+  z as AuthenticatedBuildClient,
+  S as AuthenticatedDropClient,
+  i as BuildCreateError,
+  p as BuildFailedError,
+  d as BuildTimeoutError,
+  n as DROPZONE_EVENTS,
   o as DropZone,
-  z as NotAuthenticatedError,
-  S as SiteCreateError,
-  L as UnsupportedDropError,
-  c as deployBuild,
-  h as deployFiles,
-  a as detectBuild,
-  l as getFileTypes,
-  N as humanizeDropError,
-  n as inferBuildSettings,
-  i as readDataTransfer,
-  p as readFileList,
-  C as zipFiles
+  l as NotAuthenticatedError,
+  u as SiteCreateError,
+  a as UnsupportedDropError,
+  Z as deployBuild,
+  L as deployFiles,
+  F as detectBuild,
+  D as getFileTypes,
+  f as humanizeDropError,
+  c as inferBuildSettings,
+  E as readDataTransfer,
+  s as readFileList,
+  y as zipFiles
 };

package/dist/components/preact/DropZone/useDropDeploy.d.ts

@@ -1,6 +1,6 @@
-import { BuildClient, BuildDetection, DropClient, InferredBuildSettings, ProcessedFile } from './drop-core';
+import { BuildClient, BuildDetection, DropClient, DropMethod, TrackFn, InferredBuildSettings, ProcessedFile } from '../../../drop-core';
 /** How the files reached the zone — carried through to analytics. */
-export type DeploySource = 'drag' | 'browse';
+export type DeploySource = DropMethod;
 /** The live site handed back once a deploy succeeds. */
 export interface DeployedSite {
     url: string;
@@ -57,8 +57,7 @@ export type DeployStatus = {
     kind: 'error';
     message: string;
 };
-/** Provider-agnostic analytics sink. */
-export type TrackFn = (event: string, properties?: Record<string, unknown>) => void;
+export type { TrackFn };
 interface UseDropDeployOptions {
     apiBase?: string;
     client?: DropClient;
@@ -73,6 +72,11 @@ interface UseDropDeployOptions {
     buildDeployUrl: (build: DeployedBuild) => string;
     waitForBuild?: boolean;
     onBuildRequired?: (info: BuildDetection) => void;
+    onBuildSignupHandoff?: (info: {
+        stashed: boolean;
+        detection: BuildDetection;
+    }) => void;
+    resumeStashedBuilds?: boolean;
     onDeploy?: (site: DeployedSite) => void;
     onBuildDeploy?: (build: DeployedBuild) => void;
     onError?: (error: DeployError) => void;
@@ -82,11 +86,10 @@ interface UseDropDeployOptions {
  * Owns the deploy state machine and its side effects (upload, local persistence,
  * analytics, redirect), keeping DropZone a thin view over the returned `status`.
  */
-export declare function useDropDeploy({ apiBase, client, claimUrl, siteDashboardUrl, buildSignupUrl, buildClient, authenticatedDropClient, getUploadToken, proxyBase, accountSlug, buildDeployUrl, waitForBuild, onBuildRequired, onDeploy, onBuildDeploy, onError, track, }: UseDropDeployOptions): {
+export declare function useDropDeploy({ apiBase, client, claimUrl, siteDashboardUrl, buildSignupUrl, buildClient, authenticatedDropClient, getUploadToken, proxyBase, accountSlug, buildDeployUrl, waitForBuild, onBuildRequired, onBuildSignupHandoff, resumeStashedBuilds, onDeploy, onBuildDeploy, onError, track, }: UseDropDeployOptions): {
     status: DeployStatus;
     warning: string | null;
     busy: boolean;
     deploy: (read: () => Promise<ProcessedFile[]>, source: DeploySource, fileTypes: string[]) => Promise<void>;
     reset: () => void;
 };
-export {};