@netlify/spark-ui 1.31.0-alpha.2 → 1.31.0-alpha.4

package/dist/drop-core/index.js

@@ -0,0 +1,51 @@
+import { getDigest as o } from "./digest.js";
+import { getSingleNonIndexHtmlFileName as i, hasMultipleHtmlFilesWithoutIndex as l, readDataTransfer as p, readFileList as a, renameSingleNonIndexHtmlToIndex as d } from "./readFiles.js";
+import { getFileTypes as m } from "./fileTypes.js";
+import { detectBuild as u, inferBuildSettings as s } from "./detectBuild.js";
+import { AnonymousDropClient as f, apiError as D } from "./client.js";
+import { DEFAULT_API_BASE as A, DEFAULT_POLL_INTERVAL_MS as T, DEFAULT_PROXY_BASE as h, DEFAULT_TIMEOUT_MS as F, createSiteInAccount as B, pollDeployUntilSettled as _ } from "./authedApi.js";
+import { AuthenticatedDropClient as g } from "./authedDropClient.js";
+import { AuthenticatedBuildClient as L } from "./buildClient.js";
+import { generateNetlifyToml as y, zipFiles as U } from "./zip.js";
+import { clearDropStash as M, hasDropStashMarker as O, loadDropStash as P, saveDropStash as H } from "./buildStash.js";
+import { deployBuild as z, deployFiles as V, deployZippedBuild as Z } from "./deploy.js";
+import { BuildCreateError as v, BuildFailedError as W, BuildTimeoutError as X, NotAuthenticatedError as Y, SiteCreateError as b, UnsupportedDropError as j, humanizeDropError as q } from "./errors.js";
+import { DROPZONE_EVENTS as G } from "./analytics.js";
+export {
+  f as AnonymousDropClient,
+  L as AuthenticatedBuildClient,
+  g as AuthenticatedDropClient,
+  v as BuildCreateError,
+  W as BuildFailedError,
+  X as BuildTimeoutError,
+  A as DEFAULT_API_BASE,
+  T as DEFAULT_POLL_INTERVAL_MS,
+  h as DEFAULT_PROXY_BASE,
+  F as DEFAULT_TIMEOUT_MS,
+  G as DROPZONE_EVENTS,
+  Y as NotAuthenticatedError,
+  b as SiteCreateError,
+  j as UnsupportedDropError,
+  D as apiError,
+  M as clearDropStash,
+  B as createSiteInAccount,
+  z as deployBuild,
+  V as deployFiles,
+  Z as deployZippedBuild,
+  u as detectBuild,
+  y as generateNetlifyToml,
+  o as getDigest,
+  m as getFileTypes,
+  i as getSingleNonIndexHtmlFileName,
+  O as hasDropStashMarker,
+  l as hasMultipleHtmlFilesWithoutIndex,
+  q as humanizeDropError,
+  s as inferBuildSettings,
+  P as loadDropStash,
+  _ as pollDeployUntilSettled,
+  p as readDataTransfer,
+  a as readFileList,
+  d as renameSingleNonIndexHtmlToIndex,
+  H as saveDropStash,
+  U 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.2",
+  "version": "1.31.0-alpha.4",
   "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,
@@ -93,6 +94,13 @@ interface Props {
    * static path. Distinct from `client`, which is the anonymous fallback.
    */
   authenticatedDropClient?: DropClient;
+  /**
+   * API root for the authenticated paths' JSON calls, which go through your
+   * access-control rewrite so the session cookie authorizes them. Defaults to
+   * `/access-control/bb-api/api/v1`. (Uploads always go direct to
+   * `api.netlify.com` — the proxy can't carry bodies that large.)
+   */
+  proxyBase?: string;
   /** Create the visitor's new project in this account. Omit for their default account. */
   accountSlug?: string;
   /**
@@ -116,6 +124,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;
   /**
@@ -180,10 +204,13 @@ export default function DropZone({
   getUploadToken,
   buildClient,
   authenticatedDropClient,
+  proxyBase,
   accountSlug,
   buildDeployUrl = defaultBuildDeployUrl,
   waitForBuild,
   onBuildRequired,
+  onBuildSignupHandoff,
+  resumeStashedBuilds,
   onDeploy,
   onBuildDeploy,
   onError,
@@ -206,10 +233,13 @@ export default function DropZone({
     getUploadToken,
     buildClient,
     authenticatedDropClient,
+    proxyBase,
     accountSlug,
     buildDeployUrl,
     waitForBuild,
     onBuildRequired,
+    onBuildSignupHandoff,
+    resumeStashedBuilds,
     onDeploy,
     onBuildDeploy,
     onError,
@@ -220,7 +250,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';