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

package/dist/drop-core/errors.js

@@ -0,0 +1,119 @@
+var a = Object.defineProperty;
+var n = (e, r, t) => r in e ? a(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t;
+var o = (e, r, t) => n(e, typeof r != "symbol" ? r + "" : r, t);
+class l extends Error {
+  constructor() {
+    super("unsupported single file");
+    o(this, "code", "unsupported-drop");
+    this.name = "UnsupportedDropError";
+  }
+}
+class s extends Error {
+  constructor(t = "not authenticated") {
+    super(t);
+    o(this, "code", "not-authenticated");
+    this.name = "NotAuthenticatedError";
+  }
+}
+function u(e) {
+  return e instanceof s ? !0 : e instanceof Error && e.code === "not-authenticated";
+}
+class c extends Error {
+  constructor(t) {
+    super(`site create failed${t ? `: ${t}` : ""}`);
+    o(this, "code", "site-create-failed");
+    o(this, "status");
+    this.name = "SiteCreateError", this.status = t;
+  }
+}
+class p extends Error {
+  constructor(t) {
+    super(`build create failed${t ? `: ${t}` : ""}`);
+    o(this, "code", "build-create-failed");
+    o(this, "status");
+    this.name = "BuildCreateError", this.status = t;
+  }
+}
+class f extends Error {
+  constructor(t) {
+    super(t ? `build failed: ${t}` : "build failed");
+    o(this, "code", "build-failed");
+    this.reason = t, this.name = "BuildFailedError";
+  }
+}
+class y extends Error {
+  constructor() {
+    super("Build did not finish in time");
+    o(this, "code", "build-timeout");
+    this.name = "BuildTimeoutError";
+  }
+}
+class h extends Error {
+  constructor(t) {
+    super(t ? `deploy failed: ${t}` : "deploy failed");
+    o(this, "code", "deploy-failed");
+    this.reason = t, this.name = "DeployFailedError";
+  }
+}
+class g extends Error {
+  constructor() {
+    super("Deploy did not become ready in time");
+    o(this, "code", "deploy-timeout");
+    this.name = "DeployTimeoutError";
+  }
+}
+function m(e) {
+  if (!(e instanceof Error)) return "Something went wrong. Please try again.";
+  const r = e.code;
+  if (r === "unsupported-drop")
+    return "To deploy, drop a folder or a .zip file — or a single HTML page.";
+  if (r === "not-authenticated")
+    return "Please log in to Netlify to deploy this project, then try again.";
+  if (r === "site-create-failed")
+    return "We couldn't create a project for this build. Please try again.";
+  if (r === "build-failed") {
+    const i = e.reason;
+    return i ? `Your build failed: ${i}` : "Your build failed. Check your build settings and try again.";
+  }
+  if (r === "deploy-failed") {
+    const i = e.reason;
+    return i ? `Your deploy failed: ${i}` : "Your deploy failed. Please try again.";
+  }
+  if (r === "build-timeout")
+    return "Your build is taking longer than expected. It may still finish — check your Netlify dashboard.";
+  if (r === "deploy-timeout")
+    return "Your site is taking longer than expected to go live. Please try again in a moment.";
+  if (e instanceof TypeError)
+    return "Couldn't connect to Netlify. Check your internet connection and try again.";
+  const t = "status" in e && typeof e.status == "number" ? e.status : void 0;
+  switch (t) {
+    case 429:
+      return "Too many attempts — please wait a moment and try again.";
+    case 413:
+      return "Your upload is too large to deploy this way.";
+    case 404:
+      return "We couldn't find that deploy. Please try again.";
+    case 401:
+    case 403:
+      return "That request wasn't allowed. Please try again.";
+    case 500:
+    case 502:
+    case 503:
+    case 504:
+      return "Netlify's servers are having trouble right now. Please try again shortly.";
+    default:
+      return t ? "Something went wrong talking to Netlify. Please try again." : "Something went wrong. Please try again.";
+  }
+}
+export {
+  p as BuildCreateError,
+  f as BuildFailedError,
+  y as BuildTimeoutError,
+  h as DeployFailedError,
+  g as DeployTimeoutError,
+  s as NotAuthenticatedError,
+  c as SiteCreateError,
+  l as UnsupportedDropError,
+  m as humanizeDropError,
+  u as isNotAuthenticatedError
+};

package/dist/drop-core/errors.test.d.ts

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

package/dist/drop-core/fileTypes.test.d.ts

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

package/dist/drop-core/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The public surface of drop-core — nothing is public unless named here.
+ * `export *` is reserved for the three modules that are contracts in their
+ * entirety: types, errors, and the analytics event map.
+ */
+export * from './types';
+export * from './errors';
+export * from './analytics';
+export { getSingleNonIndexHtmlFileName, hasMultipleHtmlFilesWithoutIndex, readDataTransfer, readFileList, renameSingleNonIndexHtmlToIndex, } from './readFiles';
+export { getFileTypes } from './fileTypes';
+export { detectBuild, inferBuildSettings } from './detectBuild';
+export type { BuildDetection, BuildReason, InferredBuildSettings } from './detectBuild';
+export { zipFiles } from './zip';
+export type { ZipOptions, ZipResult } from './zip';
+export { AnonymousDropClient } from './client';
+export type { DropClient } from './client';
+export { AuthenticatedDropClient } from './authedDropClient';
+export type { AuthenticatedDropClientConfig } from './authedDropClient';
+export { AuthenticatedBuildClient } from './buildClient';
+export type { AuthenticatedBuildClientConfig, BuildClient, BuildResponse } from './buildClient';
+export { deployBuild, deployFiles, deployZippedBuild } from './deploy';
+export type { BuildDeployOptions, BuildDeployResult, DeployOptions } from './deploy';
+export { clearDropStash, hasDropStashMarker, loadDropStash, saveDropStash } from './buildStash';
+export type { DropBuildStash } from './buildStash';
+export { DEFAULT_API_BASE, DEFAULT_PROXY_BASE, UPLOAD_RETRY_DELAYS_MS } from './constants';

package/dist/drop-core/index.js

@@ -0,0 +1,47 @@
+import { BuildCreateError as o, BuildFailedError as t, BuildTimeoutError as i, DeployFailedError as l, DeployTimeoutError as p, NotAuthenticatedError as d, SiteCreateError as a, UnsupportedDropError as n, humanizeDropError as m, isNotAuthenticatedError as u } from "./errors.js";
+import { DROPZONE_EVENTS as s } from "./analytics.js";
+import { getSingleNonIndexHtmlFileName as D, hasMultipleHtmlFilesWithoutIndex as f, readDataTransfer as S, readFileList as h, renameSingleNonIndexHtmlToIndex as A } from "./readFiles.js";
+import { getFileTypes as F } from "./fileTypes.js";
+import { detectBuild as _, inferBuildSettings as y } from "./detectBuild.js";
+import { zipFiles as c } from "./zip.js";
+import { AnonymousDropClient as C } from "./client.js";
+import { AuthenticatedDropClient as L } from "./authedDropClient.js";
+import { AuthenticatedBuildClient as P } from "./buildClient.js";
+import { deployBuild as U, deployFiles as H, deployZippedBuild as M } from "./deploy.js";
+import { clearDropStash as z, hasDropStashMarker as Z, loadDropStash as k, saveDropStash as v } from "./buildStash.js";
+import { DEFAULT_API_BASE as W, DEFAULT_PROXY_BASE as X, UPLOAD_RETRY_DELAYS_MS as b } from "./constants.js";
+export {
+  C as AnonymousDropClient,
+  P as AuthenticatedBuildClient,
+  L as AuthenticatedDropClient,
+  o as BuildCreateError,
+  t as BuildFailedError,
+  i as BuildTimeoutError,
+  W as DEFAULT_API_BASE,
+  X as DEFAULT_PROXY_BASE,
+  s as DROPZONE_EVENTS,
+  l as DeployFailedError,
+  p as DeployTimeoutError,
+  d as NotAuthenticatedError,
+  a as SiteCreateError,
+  b as UPLOAD_RETRY_DELAYS_MS,
+  n as UnsupportedDropError,
+  z as clearDropStash,
+  U as deployBuild,
+  H as deployFiles,
+  M as deployZippedBuild,
+  _ as detectBuild,
+  F as getFileTypes,
+  D as getSingleNonIndexHtmlFileName,
+  Z as hasDropStashMarker,
+  f as hasMultipleHtmlFilesWithoutIndex,
+  m as humanizeDropError,
+  y as inferBuildSettings,
+  u as isNotAuthenticatedError,
+  k as loadDropStash,
+  S as readDataTransfer,
+  h as readFileList,
+  A as renameSingleNonIndexHtmlToIndex,
+  v as saveDropStash,
+  c as zipFiles
+};

package/dist/{components/preact/DropZone/drop-core → drop-core}/readFiles.js

@@ -1,4 +1,4 @@
-import { g as P } from "../../../../chunks/_commonjsHelpers.C6fGbg64.js";
+import { g as P } from "../chunks/_commonjsHelpers.C6fGbg64.js";
 import { UnsupportedDropError as U } from "./errors.js";
 var L = { exports: {} }, G = L.exports, D;
 function J() {
@@ -579,7 +579,7 @@ async function Q(y) {
   return M(w);
 }
 async function I(y) {
-  const { unzip: m } = await import("../../../../chunks/browser.Ca2rTNTu.js"), w = new Uint8Array(await y.arrayBuffer()), _ = await new Promise(
+  const { unzip: m } = await import("../chunks/browser.Ca2rTNTu.js"), w = new Uint8Array(await y.arrayBuffer()), _ = await new Promise(
     (v, s) => m(w, (g, u) => g ? s(g) : v(u))
   ), h = [];
   for (const [v, s] of Object.entries(_)) {

package/dist/drop-core/readFiles.test.d.ts

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

package/dist/{components/preact/DropZone/drop-core → drop-core}/types.d.ts

@@ -41,3 +41,13 @@ export interface DeployProgress {
     uploaded?: number;
     total?: number;
 }
+/** The subset of a Netlify Site the drop flow needs to redirect and report. */
+export interface BuildSite {
+    /** site id (UUID) */
+    id: string;
+    /** the *.netlify.app subdomain, also the app's URL segment */
+    name: string;
+    /** https://<name>.netlify.app */
+    ssl_url?: string;
+    url?: string;
+}

package/dist/{components/preact/DropZone/drop-core → drop-core}/zip.js

@@ -29,7 +29,7 @@ async function $(e, { name: i = "source.zip", synthesizeNetlifyToml: p = !0 } =
 ${n}` : n;
     l["netlify.toml"] = m.encode(c);
   }
-  const { zip: f } = await import("../../../../chunks/browser.Ca2rTNTu.js"), o = await new Promise(
+  const { zip: f } = await import("../chunks/browser.Ca2rTNTu.js"), o = await new Promise(
     (t, n) => f(l, { level: 6 }, (c, s) => c ? n(c) : t(s))
   ), u = o.buffer.slice(
     o.byteOffset,

package/dist/drop-core/zip.test.d.ts

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@netlify/spark-ui",
   "description": "Assets, design tokens, components, and utilities",
-  "version": "1.31.0-alpha.3",
+  "version": "1.31.0-alpha.5",
   "type": "module",
   "main": "dist/components/preact/index.js",
   "types": "dist/components/preact/index.d.ts",
@@ -26,6 +26,7 @@
   ],
   "exports": {
     "./preact": "./dist/components/preact/index.js",
+    "./drop-core": "./dist/drop-core/index.js",
     "./assets/*.css": "./dist/assets/*.css",
     "./assets/icons/*.svg": "./packages/assets/icons/*.svg",
     "./logos/*.svg": "./packages/assets/logos/*.svg",
@@ -61,7 +62,9 @@
     "eslint": "^10.0.0",
     "eslint-config-prettier": "^10.1.1",
     "eslint-plugin-astro": "^1.3.1",
+    "fake-indexeddb": "^6.2.5",
     "glob": "^11.0.1",
+    "happy-dom": "^20.11.6",
     "jsdom": "^30.0.0",
     "preact": "^10.26.4",
     "prettier": "^3.5.3",

package/packages/components/index.ts

@@ -11,6 +11,15 @@ export {
   AnonymousDropClient,
   AuthenticatedBuildClient,
   AuthenticatedDropClient,
+  BuildCreateError,
+  BuildFailedError,
+  BuildTimeoutError,
+  DROPZONE_EVENTS,
+  getFileTypes,
+  humanizeDropError,
+  NotAuthenticatedError,
+  SiteCreateError,
+  UnsupportedDropError,
   deployBuild,
   deployFiles,
   detectBuild,
@@ -23,6 +32,16 @@ export type {
   AuthenticatedBuildClientConfig,
   AuthenticatedDropClientConfig,
   BuildClient,
+  BuildDeployOptions,
+  BuildReason,
+  BuildResponse,
+  DeployError,
+  DeployStatus,
+  DropZoneEventName,
+  DropZoneEventProperties,
+  TrackFn,
+  ZipOptions,
+  ZipResult,
   BuildDeployResult,
   BuildDetection,
   BuildSite,

package/packages/components/preact/DropZone/DropZone.test.ts

@@ -0,0 +1,71 @@
+// @vitest-environment happy-dom
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { h, render } from 'preact';
+import DropZone from './DropZone';
+
+function mountZone(props: Record<string, unknown> = {}) {
+  const events: Array<{ event: string; props: Record<string, unknown> | undefined }> = [];
+  const container = document.createElement('div');
+  document.body.appendChild(container);
+  render(
+    h(DropZone as never, {
+      onTrack: (event: string, properties?: Record<string, unknown>) =>
+        void events.push({ event, props: properties }),
+      ...props,
+    }),
+    container
+  );
+  const zone = container.querySelector<HTMLElement>('.n-dropzone')!;
+  return {
+    events,
+    zone,
+    unmount: () => {
+      render(null, container);
+      container.remove();
+    },
+  };
+}
+
+afterEach(() => vi.restoreAllMocks());
+
+describe('DropZone', () => {
+  it('opens the picker from the keyboard and tracks it as such', () => {
+    const { zone, events, unmount } = mountZone();
+    zone.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }));
+    expect(events).toEqual([{ event: 'dropzone_browse_opened', props: { method: 'keyboard' } }]);
+    unmount();
+  });
+
+  it("opens the picker from a click on the zone's own empty area", () => {
+    const { zone, events, unmount } = mountZone();
+    zone.dispatchEvent(new MouseEvent('click', { bubbles: true }));
+    expect(events).toEqual([{ event: 'dropzone_browse_opened', props: { method: 'click' } }]);
+    unmount();
+  });
+
+  it('stamps dropzone_id onto every event when analyticsId is set — and only then', () => {
+    const tagged = mountZone({ analyticsId: 'homepage_hero' });
+    tagged.zone.dispatchEvent(new KeyboardEvent('keydown', { key: ' ', bubbles: true }));
+    expect(tagged.events[0].props).toEqual({ dropzone_id: 'homepage_hero', method: 'keyboard' });
+    tagged.unmount();
+
+    const untagged = mountZone();
+    untagged.zone.dispatchEvent(new KeyboardEvent('keydown', { key: ' ', bubbles: true }));
+    expect(untagged.events[0].props).not.toHaveProperty('dropzone_id');
+    untagged.unmount();
+  });
+
+  it('mirrors the deploy status on data-state for bare-mode consumers', () => {
+    const { zone, unmount } = mountZone({ showStatus: false });
+    // Idle at rest — the attribute CSS keys off (`[data-state='error']` etc.).
+    expect(zone.getAttribute('data-state')).toBe('idle');
+    expect(zone.className).toContain('is-bare');
+    unmount();
+  });
+
+  it('renders no overlay until there is something to show', () => {
+    const { zone, unmount } = mountZone();
+    expect(zone.querySelector('.n-dropzone-overlay')).toBeNull();
+    unmount();
+  });
+});

package/packages/components/preact/DropZone/DropZone.tsx

@@ -1,13 +1,14 @@
 import { useEffect, useRef, useState } from 'preact/hooks';
 import type { ComponentChildren } from 'preact';
 import {
+  DROPZONE_EVENTS,
   getFileTypes,
   readDataTransfer,
   readFileList,
   type BuildClient,
   type BuildDetection,
   type DropClient,
-} from './drop-core';
+} from '../../../drop-core';
 import {
   useDropDeploy,
   type DeployedBuild,
@@ -63,12 +64,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;
   /**
@@ -78,7 +78,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>;
@@ -123,6 +123,22 @@ 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;
   /**
@@ -192,6 +208,8 @@ export default function DropZone({
   buildDeployUrl = defaultBuildDeployUrl,
   waitForBuild,
   onBuildRequired,
+  onBuildSignupHandoff,
+  resumeStashedBuilds,
   onDeploy,
   onBuildDeploy,
   onError,
@@ -219,6 +237,8 @@ export default function DropZone({
     buildDeployUrl,
     waitForBuild,
     onBuildRequired,
+    onBuildSignupHandoff,
+    resumeStashedBuilds,
     onDeploy,
     onBuildDeploy,
     onError,
@@ -229,7 +249,7 @@ export default function DropZone({
 
   const inputRef = useRef<HTMLInputElement>(null);
   const openPicker = (method: 'keyboard' | 'click') => {
-    track('dropzone_browse_opened', { method });
+    track(DROPZONE_EVENTS.BROWSE_OPENED, { method });
     inputRef.current?.click();
   };
 

package/packages/components/preact/DropZone/index.tsx

@@ -1,6 +1,7 @@
 export { default as DropZone } from './DropZone';
 export {
   AnonymousDropClient,
+  DROPZONE_EVENTS,
   AuthenticatedBuildClient,
   AuthenticatedDropClient,
   BuildCreateError,
@@ -18,9 +19,13 @@ export {
   SiteCreateError,
   UnsupportedDropError,
   zipFiles,
-} from './drop-core';
+} from '../../../drop-core';
 export type {
   AuthenticatedBuildClientConfig,
+  DropMethod,
+  DropZoneEventName,
+  DropZoneEventProperties,
+  TrackFn,
   AuthenticatedDropClientConfig,
   BuildClient,
   BuildDeployOptions,
@@ -39,5 +44,11 @@ export type {
   ProcessedFile,
   ZipOptions,
   ZipResult,
-} from './drop-core';
-export type { DeployedBuild, DeployedSite, DeployError, DeployStatus } from './useDropDeploy';
+} from '../../../drop-core';
+export type {
+  DeployedBuild,
+  DeployedSite,
+  DeployError,
+  DeploySource,
+  DeployStatus,
+} from './useDropDeploy';