handoff-app 2.0.0-11 → 2.0.0-13

package/src/types/config.ts

@@ -129,16 +129,6 @@ interface HandoffEmailBase {
   from?: string;
 }
 
-/** Send through the Resend HTTP API. */
-export interface HandoffResendEmail extends HandoffEmailBase {
-  /** @default "resend" */
-  provider?: 'resend';
-  options?: {
-    /** Environment reference to the Resend API key. @default fromEnv('RESEND_API_KEY') */
-    apiKey?: RuntimeEnvReference<string>;
-  };
-}
-
 /** Send through an SMTP server, such as Amazon SES, SendGrid, Postmark, Mailgun or Microsoft 365. */
 export interface HandoffSmtpEmail extends HandoffEmailBase {
   provider: 'smtp';
@@ -170,7 +160,7 @@ export interface HandoffCustomEmail extends HandoffEmailBase {
 }
 
 /** Registry email settings. `provider` selects the shape of `options`. */
-export type HandoffEmailConfig = HandoffResendEmail | HandoffSmtpEmail | HandoffCustomEmail;
+export type HandoffEmailConfig = HandoffSmtpEmail | HandoffCustomEmail;
 
 /**
  * One AI connection the deployment declares. Connections are the whole surface: a reader can add a
@@ -277,13 +267,13 @@ export interface HandoffRuntimeConfig {
        * `custom` module for object storage.
        * @default "database"
        */
-      adapter?: 'database' | 'custom';
-      /** For `adapter: "custom"` - server-only module path default-exporting a `defineAssetStorage` adapter. */
+      provider?: 'database' | 'custom';
+      /** For `provider: "custom"` - server-only module path default-exporting a `defineStorageProvider()` result. */
       module?: string;
       /** Max bytes kept inline in the database `bytea` column (larger uploads are rejected). @default 4194304 */
       maxInlineBytes?: number;
       /**
-       * Options passed to the adapter factory. Literals are baked. Environment references are resolved
+       * Options passed to the provider factory. Literals are baked. Environment references are resolved
        * at request time, so secrets must be environment references.
        */
       options?: Record<string, unknown>;

package/.editorconfig

@@ -1,19 +0,0 @@
-# EditorConfig is awesome: https://EditorConfig.org
-
-# top-most EditorConfig file
-root = true
-
-[*.{css,scss,sass}]
-charset = utf-8
-indent_style = tab
-indent_size = unset
-end_of_line = lf
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.{js,ts,jsx,tsx}]
-charset = utf-8
-indent_style = space
-end_of_line = lf
-trim_trailing_whitespace = true
-insert_final_newline = true

package/.eslintrc.json

@@ -1,4 +0,0 @@
-{
-  "extends": ["next", "prettier"],
-  "ignorePatterns": ["./src/app/out/**/*", "**/*.js"]
-}

package/.prettierrc.json

@@ -1,8 +0,0 @@
-{
-    "trailingComma": "es5",
-    "semi": true,
-    "tabWidth": 2,
-    "singleQuote": true,
-    "jsxSingleQuote": true,
-    "plugins": ["prettier-plugin-tailwindcss"]
-  }

package/.vscode/settings.json

@@ -1,17 +0,0 @@
-{
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-  "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
-  "editor.formatOnSave": true,
-  "editor.codeActionsOnSave": {
-    "source.organizeImports": "explicit"
-  },
-  "[xml]": {
-    "editor.defaultFormatter": "redhat.vscode-xml"
-  },
-  "[typescriptreact]": {
-    "editor.defaultFormatter": "vscode.typescript-language-features"
-  },
-  "[markdown]": {
-    "editor.defaultFormatter": "unifiedjs.vscode-remark"
-  }
-}

package/dist/define.d.ts

@@ -1,10 +0,0 @@
-/**
- * Define helpers for custom server modules. This entry point has no runtime dependencies, so a module
- * that imports it does not pull the CLI into the registry bundle.
- */
-export { defineAiProvider } from './ai/define';
-export type { AiProvider, AiProviderContext, AiProviderFactory } from './ai/types';
-export { defineAssetStorage } from './registry/asset-storage/define';
-export type { AssetStorage, AssetStorageContext, AssetStorageFactory, AssetStorageInput, AssetStorageReadResult, AssetUpload, AssetUploadInput, } from './registry/asset-storage/types';
-export { defineEmailProvider } from './registry/email/define';
-export type { EmailMessage, EmailProvider, EmailProviderContext, EmailProviderFactory } from './registry/email/types';

package/dist/registry/email/adapters/resend.d.ts

@@ -1,7 +0,0 @@
-/**
- * Built-in Resend provider, selected with `runtime.registry.email.provider: "resend"` (the default).
- * A plain `fetch` to the Resend HTTP API, so it adds no dependency.
- */
-import type { EmailProvider } from '../types';
-/** Build a Resend provider from options whose references are already resolved. */
-export declare const createResendProvider: (options: Record<string, unknown>) => EmailProvider;

package/dist/registry/email/adapters/resend.js

@@ -1,35 +0,0 @@
-"use strict";
-/**
- * Built-in Resend provider, selected with `runtime.registry.email.provider: "resend"` (the default).
- * A plain `fetch` to the Resend HTTP API, so it adds no dependency.
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createResendProvider = void 0;
-/** Build a Resend provider from options whose references are already resolved. */
-const createResendProvider = (options) => ({
-    send(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ from, to, subject, html, text }) {
-            const apiKey = typeof options.apiKey === 'string' ? options.apiKey : '';
-            if (!apiKey)
-                throw new Error('The Resend API key is not set.');
-            const response = yield fetch('https://api.resend.com/emails', {
-                method: 'POST',
-                headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
-                body: JSON.stringify({ from, to: [to], subject, html, text }),
-            });
-            if (!response.ok) {
-                throw new Error(`Resend rejected the email (HTTP ${response.status}): ${yield response.text()}`);
-            }
-        });
-    },
-});
-exports.createResendProvider = createResendProvider;

package/src/app/components/old/Header.tsx

@@ -1,89 +0,0 @@
-import { ClientConfig } from '@handoff/types/config';
-import Link from 'next/link';
-import React from 'react';
-import NavLink from '../NavLink';
-import { useNav } from '../context/NavProvider';
-
-interface HeaderProps {
-  config: ClientConfig;
-}
-
-function Header({ config }: HeaderProps) {
-  const { menu } = useNav();
-  const [mobile, setMobile] = React.useState('');
-  const toggle = () => {
-    if (mobile === 'is-active') {
-      setMobile('');
-    } else {
-      setMobile('is-active');
-    }
-  };
-
-  return (
-    <>
-      <header id="site-header" className="c-site-header">
-        <div className="o-container-fluid">
-          <div className="c-site-header__wrapper">
-            <div>
-              <div className="c-site-menu">
-                <button className={`c-hamburger-icon c-hamburger-icon--slider ${mobile}`} onClick={toggle}>
-                  <div className="c-hamburger-icon__box">
-                    <div className="c-hamburger-icon__inner"></div>
-                  </div>
-                </button>
-              </div>
-              <div className="c-site-title">
-                <Link href="/" className="c-site-logo c-site-logo--basic" title="" rel="home" aria-label="logo">
-                  {/* eslint-disable-next-line @next/next/no-img-element */}
-                  <img src={`${process.env.HANDOFF_APP_BASE_PATH ?? ''}/logo.svg`} alt={config?.app?.title} />
-                </Link>
-              </div>
-
-              <nav className="c-site-nav">
-                <ul>
-                  {menu.map((item) => (
-                    <li key={item.path}>
-                      <NavLink href={`${item.path}`}>{item.title}</NavLink>
-                    </li>
-                  ))}
-                </ul>
-              </nav>
-            </div>
-            <div>
-              {
-                // TODO: Reimpliment cmd k search
-                false && <small>hit cmd+k to search</small>
-              }
-            </div>
-          </div>
-        </div>
-      </header>
-      <div className={`c-offcanvas c-offcanvas--menu ${mobile}`}>
-        <div className="c-offcanvas__inner">
-          <nav className="c-mobilenav">
-            <ul className="c-mobilenav__menu">
-              {menu.map((item) => (
-                <li key={`mobile-${item.path}`}>
-                  <NavLink href={`${item.path}`}>{item.title}</NavLink>
-                  {item.subSections.length > 0 && (
-                    <ul className="c-mobilenav__submenu">
-                      {item.subSections
-                        .filter((sub) => sub.path)
-                        .map((sub) => (
-                          <li key={sub.path}>
-                            <NavLink href={`${sub.path}`}>{sub.title}</NavLink>
-                          </li>
-                        ))}
-                    </ul>
-                  )}
-                </li>
-              ))}
-            </ul>
-          </nav>
-        </div>
-      </div>
-    </>
-  );
-}
-
-export default Header;

package/src/app/pages/assets/fonts.tsx

@@ -1,129 +0,0 @@
-import * as fs from 'fs-extra';
-import uniq from 'lodash/uniq';
-import { FileArchive } from 'lucide-react';
-import type { GetStaticProps } from 'next';
-import Head from 'next/head';
-import path from 'path';
-import * as React from 'react';
-import ReactMarkdown from 'react-markdown';
-import rehypeRaw from 'rehype-raw';
-import remarkGfm from 'remark-gfm';
-import Footer from '../../components/Footer';
-import { MarkdownComponents, remarkCodeMeta } from '../../components/Markdown/MarkdownComponents';
-import Header from '../../components/old/Header';
-import { buildTimeFoundationDesign, fetchDocPageMarkdown, FontDocumentationProps, getClientRuntimeConfig } from '../../components/util';
-import { useFoundationTokens } from '../../components/util/useFoundationTokens';
-
-const basePath = process.env.HANDOFF_APP_BASE_PATH ?? '';
-const isRegistry = process.env.HANDOFF_RUNTIME_MODE === 'registry';
-
-/**
- * This statically renders content from the markdown, creating menu and providing
- * metadata
- *
- * This is all done statically at build time
- * @param context GetStaticProps
- * @returns
- */
-export const getStaticProps: GetStaticProps = async () => {
-  // Workspace/static reads the mirrored font archives; a registry build has none (hydrated at runtime).
-  const customFonts: string[] = [];
-  try {
-    const fontDir = path.resolve(process.env.HANDOFF_MODULE_PATH ?? '', '.handoff', `${process.env.HANDOFF_PROJECT_ID}`, 'public', 'fonts');
-    for (const font of fs.readdirSync(fontDir)) {
-      if (font.endsWith('.zip')) customFonts.push(font.replace('.zip', ''));
-    }
-  } catch {
-    // No local font archives (e.g. a registry build), so customFonts stays empty.
-  }
-
-  return {
-    props: {
-      ...(await fetchDocPageMarkdown('docs/assets/', 'fonts', `/assets`)).props,
-      design: buildTimeFoundationDesign(),
-      config: getClientRuntimeConfig(),
-      customFonts,
-    },
-  };
-};
-
-const FontsPage = ({ content, menu, metadata, customFonts, design, config }: FontDocumentationProps) => {
-  // Registry hydrates typography tokens (for the family list) + the published font archives at runtime.
-  const tokens = useFoundationTokens('typography', { design });
-  const [hydratedFonts, setHydratedFonts] = React.useState<string[]>(customFonts);
-  React.useEffect(() => {
-    if (!isRegistry) return;
-    let active = true;
-    fetch(`${basePath}/api/docs/assets/fonts`)
-      .then((res) => (res.ok ? res.json() : null))
-      .then((data) => {
-        if (!active || !data?.assets) return;
-        const names = (data.assets as { path: string }[])
-          .filter((a) => typeof a.path === 'string' && /^fonts\/.+\.zip$/i.test(a.path))
-          .map((a) => a.path.slice('fonts/'.length).replace(/\.zip$/i, ''));
-        setHydratedFonts(names);
-      })
-      .catch(() => {});
-    return () => {
-      active = false;
-    };
-  }, []);
-
-  const typography = tokens.design?.typography ?? [];
-  const fontFamilies: string[] = uniq(typography.map((type) => type.values.fontFamily));
-  const fontLinks: string[] = fontFamilies.map((fontFamily) => {
-    const machineName = fontFamily.replace(/\s/g, '');
-    const custom = hydratedFonts.find((font) => font === machineName);
-    if (custom) {
-      return isRegistry ? `${basePath}/api/docs/assets/fonts/fonts/${machineName}.zip` : `/fonts/${machineName}.zip`;
-    }
-    return `https://fonts.google.com/specimen/${fontFamily}`;
-  });
-  return (
-    <div className="c-page">
-      <Head>
-        <title>{metadata.metaTitle}</title>
-        <meta name="description" content={metadata.metaDescription} />
-      </Head>
-      <Header config={config} />
-      <section className="c-content">
-        <div className="o-container-fluid">
-          <div className="c-hero">
-            <div>
-              <h1>{metadata.title}</h1>
-              <p>{metadata.description}</p>
-            </div>
-          </div>
-          {fontFamilies.map((fontFamily, i) => (
-            <React.Fragment key={fontFamily}>
-              <div className="o-row u-justify-between">
-                <div className="o-col-5@md">
-                  <h4>{fontFamily}</h4>
-                </div>
-                <div className="o-col-6@md">
-                  <div className="c-card">
-                    <FileArchive />
-                    <h4>{fontFamily}</h4>
-                    <p>Font files for installing on a local machine.</p>
-                    <p>
-                      <a href={fontLinks[i]}>Download Font</a>
-                    </p>
-                  </div>
-                </div>
-              </div>
-              <hr />
-            </React.Fragment>
-          ))}
-
-          <div className="prose">
-            <ReactMarkdown components={MarkdownComponents} remarkPlugins={[remarkGfm, remarkCodeMeta]} rehypePlugins={[rehypeRaw]}>
-              {content}
-            </ReactMarkdown>
-          </div>
-        </div>
-      </section>
-      <Footer config={config} />
-    </div>
-  );
-};
-export default FontsPage;

package/src/app/pages/assets/index.tsx

@@ -1,91 +0,0 @@
-import { File, FileArchive } from 'lucide-react';
-import type { GetStaticProps } from 'next';
-import Head from 'next/head';
-import ReactMarkdown from 'react-markdown';
-import rehypeRaw from 'rehype-raw';
-import remarkGfm from 'remark-gfm';
-import Footer from '../../components/Footer';
-import { MarkdownComponents, remarkCodeMeta } from '../../components/Markdown/MarkdownComponents';
-import NavLink from '../../components/NavLink';
-import Header from '../../components/old/Header';
-import { DocumentationProps, fetchDocPageMarkdown, getClientRuntimeConfig } from '../../components/util';
-
-/**
- * This statically renders content from the markdown, creating menu and providing
- * metadata
- *
- * This is all done statically at build time
- * @param context GetStaticProps
- * @returns
- */
-export const getStaticProps: GetStaticProps = async () => {
-  return {
-    props: {
-      ...(await fetchDocPageMarkdown('docs/', 'assets', `/assets`)).props,
-      config: getClientRuntimeConfig(),
-    },
-  };
-};
-
-const AssetsPage = ({ content, menu, metadata, config }: DocumentationProps) => {
-  return (
-    <div className="c-page">
-      <Head>
-        <title>{metadata.metaTitle}</title>
-        <meta name="description" content={metadata.metaDescription} />
-      </Head>
-      <Header config={config} />
-      <section className="c-content">
-        <div className="o-container-fluid">
-          <div className="c-hero c-hero--boxed c-hero--bg-red">
-            <div>
-              <h1 className="c-title--extra-large">{metadata.title}</h1>
-              <p>{metadata.description}</p>
-            </div>
-          </div>
-
-          <div className="o-row">
-            <div className="o-col-6@md">
-              <div className="c-card">
-                <FileArchive />
-                <h4>Logos</h4>
-                <p>Official logo used for all digital and offline materials.</p>
-                <p>
-                  <NavLink href="/assets/logos">View Logos</NavLink>
-                </p>
-              </div>
-            </div>
-            <div className="o-col-6@md">
-              <div className="c-card">
-                <FileArchive />
-                <h4>Fonts</h4>
-                <p>Font family and weights for all {config?.app?.client} visuals.</p>
-                <p>
-                  <NavLink href="/assets/fonts">View Fonts</NavLink>
-                </p>
-              </div>
-            </div>
-            <div className="o-col-6@md">
-              <div className="c-card">
-                <File />
-                <h4>Iconography</h4>
-                <p>Library of approved vector iconography.</p>
-                <p>
-                  <NavLink href="/assets/icons">View Icons</NavLink>
-                </p>
-              </div>
-            </div>
-          </div>
-
-          <div className="prose">
-            <ReactMarkdown components={MarkdownComponents} remarkPlugins={[remarkGfm, remarkCodeMeta]} rehypePlugins={[rehypeRaw]}>
-              {content}
-            </ReactMarkdown>
-          </div>
-        </div>
-      </section>
-      <Footer config={config} />
-    </div>
-  );
-};
-export default AssetsPage;

package/src/app/pages/assets/logos.tsx

@@ -1,75 +0,0 @@
-import { FileArchive } from 'lucide-react';
-import type { GetStaticProps } from 'next';
-import Head from 'next/head';
-import ReactMarkdown from 'react-markdown';
-import rehypeRaw from 'rehype-raw';
-import remarkGfm from 'remark-gfm';
-import Footer from '../../components/Footer';
-import { MarkdownComponents, remarkCodeMeta } from '../../components/Markdown/MarkdownComponents';
-import { buildAssetDownloadUrl } from '@handoff/artifacts/url';
-import Header from '../../components/old/Header';
-import { DocumentationProps, fetchDocPageMarkdown, getClientRuntimeConfig } from '../../components/util';
-
-/**
- * This statically renders content from the markdown, creating menu and providing
- * metadata
- *
- * This is all done statically at build time
- * @param context GetStaticProps
- * @returns
- */
-export const getStaticProps: GetStaticProps = async () => {
-  return {
-    props: {
-      ...(await fetchDocPageMarkdown('docs/assets/', 'logos', `/assets`)).props,
-      config: getClientRuntimeConfig(),
-    },
-  };
-};
-
-const AssetsLogosPage = ({ content, menu, metadata, config }: DocumentationProps) => {
-  return (
-    <div className="c-page">
-      <Head>
-        <title>{metadata.metaTitle}</title>
-        <meta name="description" content={metadata.metaDescription} />
-      </Head>
-      <Header config={config} />
-      <section className="c-content">
-        <div className="o-container-fluid">
-          <div className="c-hero">
-            <div>
-              <h1>{metadata.title}</h1>
-              <p>{metadata.description}</p>
-            </div>
-          </div>
-          <div className="o-row u-justify-between">
-            <div className="o-col-5@md">
-              <h4>{config?.app?.client} Logo</h4>
-            </div>
-            <div className="o-col-6@md">
-              <div className="c-card">
-                <FileArchive />
-                <h4>{config?.app?.client} Logo</h4>
-                <p>Vector files of approved {config?.app?.client} logos.</p>
-                <p>
-                  <a href={config?.assets_zip_links?.logos ?? buildAssetDownloadUrl('logos', process.env.HANDOFF_APP_BASE_PATH)} download>
-                    Download Logos
-                  </a>
-                </p>
-              </div>
-            </div>
-          </div>
-          <div className="prose">
-            <ReactMarkdown components={MarkdownComponents} remarkPlugins={[remarkGfm, remarkCodeMeta]} rehypePlugins={[rehypeRaw]}>
-              {content}
-            </ReactMarkdown>
-          </div>
-          <hr />
-        </div>
-      </section>
-      <Footer config={config} />
-    </div>
-  );
-};
-export default AssetsLogosPage;

package/src/registry/email/adapters/resend.ts

@@ -1,22 +0,0 @@
-/**
- * Built-in Resend provider, selected with `runtime.registry.email.provider: "resend"` (the default).
- * A plain `fetch` to the Resend HTTP API, so it adds no dependency.
- */
-
-import type { EmailProvider } from '../types';
-
-/** Build a Resend provider from options whose references are already resolved. */
-export const createResendProvider = (options: Record<string, unknown>): EmailProvider => ({
-  async send({ from, to, subject, html, text }) {
-    const apiKey = typeof options.apiKey === 'string' ? options.apiKey : '';
-    if (!apiKey) throw new Error('The Resend API key is not set.');
-    const response = await fetch('https://api.resend.com/emails', {
-      method: 'POST',
-      headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
-      body: JSON.stringify({ from, to: [to], subject, html, text }),
-    });
-    if (!response.ok) {
-      throw new Error(`Resend rejected the email (HTTP ${response.status}): ${await response.text()}`);
-    }
-  },
-});