handoff-app 2.0.0-12 → 2.0.0-13

package/src/app/pages/cli/device.tsx

@@ -20,7 +20,7 @@ export const getStaticProps: GetStaticProps = async () => ({ props: { config: ge
 
 export default function DeviceApprovalPage({ config }: { config: ClientConfig }) {
   if (process.env.HANDOFF_RUNTIME_MODE !== 'registry') {
-    return <AuthShell title="Authorize CLI">{null}</AuthShell>;
+    return <AuthShell config={config} title="Authorize CLI">{null}</AuthShell>;
   }
 
   return <RegistryDeviceApprovalPage config={config} />;

package/src/app/pages/foundations/colors.tsx

@@ -33,6 +33,10 @@ export const getStaticProps: GetStaticProps = async () => {
   };
 };
 
+// Tokens without a Figma group land under an empty key.
+const groupTitle = (group: string) => upperFirst(group) || 'Other';
+const groupId = (group: string) => group || 'other';
+
 const ColorsPage = ({
   content,
   menu,
@@ -82,20 +86,17 @@ const ColorsPage = ({
       <div className="lg:gap-10 lg:py-8 xl:grid xl:grid-cols-[1fr_280px]">
         <div className="flex flex-col gap-0">
           {Object.keys(colorGroups).map((group) => (
-            <ColorGrid
-              title={upperFirst(group)}
-              group={group}
-              description="Colors that are used most frequently across all pages and components."
-              colors={colorGroups[group]}
-              key={group}
-            />
+            <ColorGrid title={groupTitle(group)} group={groupId(group)} colors={colorGroups[group]} key={group} />
           ))}
           <PrevNextNav previous={null} next={{ title: 'Typography', href: '/foundations/typography' }} />
         </div>
 
         <AnchorNav
           groups={[
-            Object.assign({}, ...[...Object.keys(colorGroups).map((group) => ({ [`${group}-colors`]: `${upperFirst(group)} Colors` }))]),
+            Object.assign(
+              {},
+              ...[...Object.keys(colorGroups).map((group) => ({ [`${groupId(group)}-colors`]: `${groupTitle(group)} Colors` }))]
+            ),
           ]}
         />
 

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

@@ -50,7 +50,7 @@ const DesignPage = ({ content, menu, metadata, current, config }: DocumentationP
             },
             {
               title: 'Colors',
-              description: 'Official logo used for all digital and offline materials.',
+              description: 'Official color palette used for all digital products.',
               icon: Palette,
               link: '/foundations/colors',
               cta: 'Explore Colors',
@@ -74,14 +74,14 @@ const DesignPage = ({ content, menu, metadata, current, config }: DocumentationP
               description: 'Downloadable icon set for use in digital and offline materials.',
               icon: Shapes,
               link: '/foundations/icons',
-              cta: 'View Library',
+              cta: 'Explore Icons',
             },
             {
               title: 'Effects',
               description: 'Shadows, blurs, and other effects used in the design system.',
               icon: Sun,
               link: '/foundations/effects',
-              cta: 'View Effects',
+              cta: 'Explore Effects',
             },
           ]}
         />

package/src/app/pages/index.tsx

@@ -57,11 +57,11 @@ export const getStaticProps: GetStaticProps = async (context) => {
 
 export const Home = ({ content, menu, metadata, config, current }: DocumentationProps) => {
   return (
-    <Layout config={config} menu={menu} current={current} metadata={metadata} fullWidthHero={true}>
+    <Layout config={config} menu={menu} current={current} metadata={{ ...metadata, metaTitle: metadata.metaTitle || config?.app?.title }} fullWidthHero={true}>
       <div className="w-full bg-linear-to-r py-12 dark:from-gray-900 dark:to-gray-800 sm:py-20">
         <div className="container mx-auto px-8">
           <HeadersType.H1 className="max-w-4xl text-3xl font-semibold leading-[-0.05px]  sm:text-4xl">
-            {config?.app?.client} Design System
+            {config?.app?.title}
           </HeadersType.H1>
           {content && (
             <div className="text-lg max-w-4xl empty:hidden [&>*]:mt-6 [&>p]:font-light [&>h2:first-child]:mt-0 [&>h2:first-child]:font-normal sm:text-xl">

package/src/app/pages/login.tsx

@@ -2,29 +2,34 @@ import { Button } from '../components/ui/button';
 import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from '../components/ui/card';
 import { Input } from '../components/ui/input';
 import { Label } from '../components/ui/label';
+import type { ClientConfig } from '@handoff/types/config';
+import type { GetStaticProps } from 'next';
 import Link from 'next/link';
 import { signIn, useSession } from 'next-auth/react';
 import { useRouter } from 'next/router';
 import { FormEvent, useEffect, useState } from 'react';
 import { AuthShell } from '../components/Auth/AuthShell';
 import { loadInstallStatus } from '../components/Auth/installStatus';
+import { getClientRuntimeConfig } from '../components/util';
 
 const safeCallbackUrl = (value: unknown): string =>
   typeof value === 'string' && value.startsWith('/') && !value.startsWith('//') && !value.startsWith('/\\') ? value : '/';
 
-export default function LoginPage() {
+export const getStaticProps: GetStaticProps = async () => ({ props: { config: getClientRuntimeConfig() } });
+
+export default function LoginPage({ config }: { config: ClientConfig }) {
   if (process.env.HANDOFF_RUNTIME_MODE !== 'registry') {
     return (
-      <AuthShell title="Sign in" centered>
+      <AuthShell config={config} title="Sign in" centered>
         {null}
       </AuthShell>
     );
   }
 
-  return <RegistryLoginPage />;
+  return <RegistryLoginPage config={config} />;
 }
 
-function RegistryLoginPage() {
+function RegistryLoginPage({ config }: { config: ClientConfig }) {
   const router = useRouter();
   const { data: session, status } = useSession();
   const [pending, setPending] = useState(false);
@@ -77,7 +82,7 @@ function RegistryLoginPage() {
   };
 
   return (
-    <AuthShell title="Sign in" centered>
+    <AuthShell config={config} title="Sign in" centered>
       <Card>
         <CardHeader>
           <CardTitle>Sign in</CardTitle>

package/src/app/pages/reset-password.tsx

@@ -2,14 +2,19 @@ import { Button } from '../components/ui/button';
 import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from '../components/ui/card';
 import { Input } from '../components/ui/input';
 import { Label } from '../components/ui/label';
+import type { ClientConfig } from '@handoff/types/config';
+import type { GetStaticProps } from 'next';
 import Head from 'next/head';
 import Link from 'next/link';
 import { useRouter } from 'next/router';
 import { FormEvent, useEffect, useState } from 'react';
 import { AuthShell } from '../components/Auth/AuthShell';
 import { authApiUrl, readApiError } from '../components/Auth/api';
+import { getClientRuntimeConfig } from '../components/util';
 
-export default function ResetPasswordPage() {
+export const getStaticProps: GetStaticProps = async () => ({ props: { config: getClientRuntimeConfig() } });
+
+export default function ResetPasswordPage({ config }: { config: ClientConfig }) {
   const router = useRouter();
   const [token, setToken] = useState('');
   const [purpose, setPurpose] = useState<'invite' | 'reset'>('reset');
@@ -87,7 +92,7 @@ export default function ResetPasswordPage() {
   };
 
   return (
-    <AuthShell title={token ? 'Set a new password' : 'Reset password'} centered>
+    <AuthShell config={config} title={token ? 'Set a new password' : 'Reset password'} centered>
       <Head>
         <meta name="referrer" content="no-referrer" />
       </Head>

package/src/app/pages/system/component/[component]/index.tsx

@@ -96,9 +96,6 @@ export const getStaticProps = async (context) => {
   const previousComponent = sameGroupComponents[groupIndex - 1] ?? null;
   const nextComponent = sameGroupComponents[groupIndex + 1] ?? null;
 
-  const fallbackTitle = componentData.title || startCase(component as string);
-  const fallbackMetaTitle = `${fallbackTitle}${config?.app?.client ? ` | ${config.app.client} Design System` : ''}`;
-
   return {
     props: {
       id: component,
@@ -110,7 +107,7 @@ export const getStaticProps = async (context) => {
         ...componentData,
         title: componentData.title || docs.metadata.title || startCase(component as string),
         description: componentData.description,
-        metaTitle: docs.metadata.metaTitle || fallbackMetaTitle,
+        metaTitle: docs.metadata.metaTitle ?? '',
         metaDescription: docs.metadata.metaDescription || componentData.description,
         image: docs.metadata.image || 'hero-brand-assets',
       },
@@ -256,7 +253,7 @@ const GenericComponentPage = ({ menu, metadata, current, id, config, componentHo
               </Button>
             )}
             <Drawer direction="right">
-              <DrawerTrigger>
+              <DrawerTrigger asChild>
                 <Button variant="outline" size={'sm'} className="font-normal [&_svg]:size-3!">
                   API Reference
                 </Button>

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

@@ -107,20 +107,20 @@ const ComponentsPage = ({ content, menu, metadata, current, config }: ComponentP
         <div className="mt-3 flex flex-row justify-between gap-3">
           <p className="text-lg leading-relaxed text-gray-600 dark:text-gray-300">{metadata.description}</p>
           <Drawer direction="right">
-            <DrawerTrigger>
-              <TooltipProvider>
-                <Tooltip>
-                  <TooltipTrigger asChild>
+            <TooltipProvider>
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <DrawerTrigger asChild>
                     <Button variant="outline">
                       API <Webhook strokeWidth={1.5} />
                     </Button>
-                  </TooltipTrigger>
-                  <TooltipContent side="left">
-                    <Badge>{apiUrl}</Badge>
-                  </TooltipContent>
-                </Tooltip>
-              </TooltipProvider>
-            </DrawerTrigger>
+                  </DrawerTrigger>
+                </TooltipTrigger>
+                <TooltipContent side="left">
+                  <Badge>{apiUrl}</Badge>
+                </TooltipContent>
+              </Tooltip>
+            </TooltipProvider>
             <DrawerContent>
               <div className="mx-5 w-full max-w-lg">
                 <DrawerHeader>

package/src/app/pages/system/pattern/[pattern]/index.tsx

@@ -130,7 +130,7 @@ export const getStaticProps = async (context: { params: IParams }) => {
       metadata: {
         title: fallbackTitle,
         description: patternData?.description || '',
-        metaTitle: `${fallbackTitle}${config?.app?.client ? ` | ${config.app.client} Design System` : ''}`,
+        metaTitle: '',
         metaDescription: patternData?.description || '',
       },
       previousPattern,
@@ -189,7 +189,7 @@ const PatternPage = ({ menu, metadata, current, id, config, previousPattern, nex
 
   if (patternNotFound) {
     return (
-      <Layout config={config} menu={menu} current={current} metadata={{ ...metadata, title: '404 - Page Not Found', metaTitle: '404 - Page Not Found' }}>
+      <Layout config={config} menu={menu} current={current} metadata={{ ...metadata, title: 'Page Not Found', metaTitle: '' }}>
         <div className="flex min-h-[60vh] flex-col items-center justify-center">
           <NotFound />
         </div>

package/src/app/pages/system/tokens/components/[component]/index.tsx

@@ -70,14 +70,10 @@ export const getStaticProps = async (context) => {
     description = componentData?.description;
   }
 
-  const fallbackTitle = displayName || startCase(componentSlug);
-  const fallbackMetaTitle = `${fallbackTitle}${config?.app?.client ? ` | ${config.app.client} Design System` : ''}`;
-
   markdownProps.metadata = {
     ...markdownProps.metadata,
     title: displayName || markdownProps.metadata.title || startCase(componentSlug),
     description: markdownProps.metadata.description || description || '',
-    metaTitle: markdownProps.metadata.metaTitle || fallbackMetaTitle,
     metaDescription: markdownProps.metadata.metaDescription || description || '',
   };
 

package/src/app-builder/build.ts

@@ -300,14 +300,14 @@ const initializeProjectApp = async (handoff: Handoff, options: InitializeProject
   const escapedMcpEnabled = escapeForSingleQuotedJsString(String(isMcpEnabled(handoff.config)));
   const escapedRegistryDriver = escapeForSingleQuotedJsString(resolveRegistryDriver(handoff.config));
   const escapedDatabaseUrlEnv = escapeForSingleQuotedJsString(resolveDatabaseUrlEnv(handoff.config));
-  // Asset storage selection baked (adapter + module + options JSON with `{ $env }` references).
+  // Asset storage selection baked (provider + module + options JSON with `{ $env }` references).
   const assetStorage = resolveAssetStorageFromConfig(handoff.config);
-  const escapedAssetStorageAdapter = escapeForSingleQuotedJsString(assetStorage.adapterKind);
+  const escapedAssetStorageProvider = escapeForSingleQuotedJsString(assetStorage.provider);
   const escapedAssetStorageModule = escapeForSingleQuotedJsString(assetStorage.module ?? '');
   const escapedAssetStorageMaxInline = escapeForSingleQuotedJsString(String(assetStorage.maxInlineBytes));
   const escapedAssetStorageOptions = escapeForSingleQuotedJsString(JSON.stringify(assetStorage.options ?? {}));
   const email = resolveEmailFromConfig(handoff.config);
-  const escapedEmailProvider = escapeForSingleQuotedJsString(email.provider);
+  const escapedEmailProvider = escapeForSingleQuotedJsString(email.provider ?? '');
   const escapedEmailFrom = escapeForSingleQuotedJsString(email.from ?? '');
   const escapedEmailModule = escapeForSingleQuotedJsString(email.module ?? '');
   const escapedEmailOptions = escapeForSingleQuotedJsString(JSON.stringify(email.options));
@@ -330,7 +330,7 @@ const initializeProjectApp = async (handoff: Handoff, options: InitializeProject
     '%HANDOFF_MCP_ENABLED%': escapedMcpEnabled,
     '%HANDOFF_REGISTRY_DRIVER%': escapedRegistryDriver,
     '%HANDOFF_REGISTRY_DATABASE_URL_ENV%': escapedDatabaseUrlEnv,
-    '%HANDOFF_ASSET_STORAGE_ADAPTER%': escapedAssetStorageAdapter,
+    '%HANDOFF_ASSET_STORAGE_PROVIDER%': escapedAssetStorageProvider,
     '%HANDOFF_ASSET_STORAGE_MODULE%': escapedAssetStorageModule,
     '%HANDOFF_ASSET_STORAGE_MAX_INLINE_BYTES%': escapedAssetStorageMaxInline,
     '%HANDOFF_ASSET_STORAGE_OPTIONS%': escapedAssetStorageOptions,
@@ -474,7 +474,7 @@ merged over the list this build baked in, keyed by \`id\`. Use it to add or repo
 without rebuilding.
 `;
 
-  const assetStorageEnvs = assetStorage.adapterKind === 'custom' ? envReferenceNames(assetStorage.options) : [];
+  const assetStorageEnvs = assetStorage.provider === 'custom' ? envReferenceNames(assetStorage.options) : [];
   const emailEnvs = envReferenceNames(email.options);
   const emailSection = !email.from
     ? 'Email delivery is off because `runtime.registry.email.from` is not set. Invitation links are shown once to an administrator for manual delivery.'
@@ -498,7 +498,7 @@ and \`.next/static/\` already copied alongside so the server serves them.
 - \`${databaseUrlEnv}\` — PostgreSQL/Neon connection string, read at request time.
 - \`AUTH_SECRET\` — a long, random secret used to sign browser sessions.
 - \`AUTH_URL\` — the canonical public registry URL, including the configured base path.
-${assetStorageEnvs.map((name) => `- \`${name}\` — read by the custom asset storage adapter at request time.\n`).join('')}
+${assetStorageEnvs.map((name) => `- \`${name}\` — read by the custom asset storage provider at request time.\n`).join('')}
 ${emailSection}
 ${aiSection}
 ## Database migrations
@@ -569,8 +569,8 @@ For multi-instance self-hosting, front \`/_next/static\` with a CDN and configur
 
 ## Deploying to Vercel
 
-Vercel does **not** use \`output: 'standalone'\` — it ignores that setting and builds with its own
-adapter, so this pre-built bundle is **not** the artifact you deploy there. For Vercel, deploy the
+Vercel does **not** use \`output: 'standalone'\` — it ignores that setting and runs its
+own build, so this pre-built bundle is **not** the artifact you deploy there. For Vercel, deploy the
 registry app via Vercel's Git/CLI source build (it produces and serves the dynamic app itself) and
 supply the same environment variables above as project env vars. Use this standalone bundle for
 containers, custom Node servers, and other non-Vercel hosts.
@@ -635,7 +635,7 @@ const getCustomServerModules = (handoff: Handoff): string[] => {
   const assetStorage = resolveAssetStorageFromConfig(handoff.config);
   const email = resolveEmailFromConfig(handoff.config);
   const modules = [
-    assetStorage.adapterKind === 'custom' ? assetStorage.module : undefined,
+    assetStorage.provider === 'custom' ? assetStorage.module : undefined,
     email.provider === 'custom' ? email.module : undefined,
     ...resolveAiFromConfig(handoff.config).connections.map((connection) => connection.module),
   ];
@@ -667,7 +667,7 @@ const copyCustomServerModules = async (handoff: Handoff, tracingRoot: string, en
     }
     if ([...fileList].some((file) => file.split(path.sep).join('/').endsWith('node_modules/handoff-app/dist/index.js'))) {
       throw new HandoffBuildError(
-        `The custom server module "${module}" imports "handoff-app", which loads the whole CLI. Import the define helpers from "handoff-app/define".`
+        `The custom server module "${module}" imports "handoff-app", which loads the whole CLI. Import the define helpers from "handoff-app/providers".`
       );
     }
     fileList.forEach((file) => files.add(file));

package/src/app-builder/client-config.ts

@@ -64,7 +64,7 @@ const buildServerRuntimeConfig = (config: ResolvedConfig, modeOverride?: Runtime
       databaseUrlEnv: resolveDatabaseUrlEnv(config),
     },
     assetStorage: {
-      adapter: assetStorage.adapterKind,
+      provider: assetStorage.provider,
       module: assetStorage.module,
       maxInlineBytes: assetStorage.maxInlineBytes,
       options: assetStorage.options,

package/src/config/loader.ts

@@ -5,7 +5,6 @@ import mergeWith from 'lodash/mergeWith';
 import omit from 'lodash/omit';
 import { createRequire } from 'module';
 import path from 'path';
-import { DEFAULT_EMAIL_PROVIDER } from '../registry/email/resolve';
 import { Config, HandoffEmailConfig, ResolvedConfig } from '../types/config';
 import { Logger } from '../utils/logger';
 import { resolveWorkingPath } from '../utils/path';
@@ -240,7 +239,7 @@ const replaceValues = (destination: unknown, source: unknown) => {
  * the deep merge never mixes the settings of two providers.
  */
 const resetEmailOnProviderChange = (layers: Partial<Config>[]): Partial<Config>[] => {
-  let provider: string = DEFAULT_EMAIL_PROVIDER;
+  let provider: string | undefined;
   let start = 0;
   layers.forEach((layer, index) => {
     const next = layer.runtime?.registry?.email?.provider;

package/src/index.ts

@@ -697,13 +697,13 @@ export type {
   SourceFormat,
   RendererKind,
 } from './catalog';
-export { defineAssetStorage } from './registry/asset-storage/define';
+export { defineStorageProvider } from './registry/asset-storage/define';
 export type {
-  AssetStorage,
-  AssetStorageContext,
-  AssetStorageFactory,
-  AssetStorageInput,
-  AssetStorageReadResult,
+  StorageProvider,
+  StorageProviderContext,
+  StorageProviderFactory,
+  StorageInput,
+  StorageReadResult,
   AssetUpload,
   AssetUploadInput,
 } from './registry/asset-storage/types';

package/src/nav/index.ts

@@ -89,6 +89,6 @@ export interface NavData {
 export { getNavData } from './resolver';
 export type { GetNavDataInput } from './resolver';
 export { getWorkspaceNavData } from './workspace';
-export type { WorkspaceNavAdapterOptions, WorkspaceNavLoaders } from './workspace';
+export type { WorkspaceNavOptions, WorkspaceNavLoaders } from './workspace';
 export { getRegistryNavData } from './registry';
-export type { RegistryNavAdapterOptions, RegistryNavRecords } from './registry';
+export type { RegistryNavOptions, RegistryNavRecords } from './registry';

package/src/nav/registry.ts

@@ -9,7 +9,7 @@ export interface RegistryNavRecords {
   tokenSets: NavTokenSet[];
 }
 
-export interface RegistryNavAdapterOptions {
+export interface RegistryNavOptions {
   shell: SectionLink[];
   load: NavLoad;
   basePath?: string;
@@ -18,8 +18,8 @@ export interface RegistryNavAdapterOptions {
 
 const emptyRecords = (): RegistryNavRecords => ({ components: [], patterns: [], pages: [], tokenSets: [] });
 
-/** Registry adapter: shell-only initial load, or one best-effort runtime-record fetch on refresh. */
-export const getRegistryNavData = async (options: RegistryNavAdapterOptions): Promise<NavData> => {
+/** Registry nav data: shell-only initial load, or one best-effort runtime-record fetch on refresh. */
+export const getRegistryNavData = async (options: RegistryNavOptions): Promise<NavData> => {
   let records = emptyRecords();
   if (options.load === 'refresh') {
     try {

package/src/nav/workspace.ts

@@ -14,7 +14,7 @@ export interface WorkspaceNavLoaders {
   tokenSets: () => Awaitable<NavTokenSet[]>;
 }
 
-export interface WorkspaceNavAdapterOptions {
+export interface WorkspaceNavOptions {
   docRoot: string;
   workingPagesDir?: string;
   basePath?: string;
@@ -43,8 +43,8 @@ const markdownTitle = (id: string, docRoot: string, workingPagesDir?: string): s
   return undefined;
 };
 
-/** Workspace/static adapter: live filesystem shell plus best-effort local snapshot loaders. */
-export const getWorkspaceNavData = async (options: WorkspaceNavAdapterOptions): Promise<NavData> => {
+/** Workspace/static nav data: live filesystem shell plus best-effort local snapshot loaders. */
+export const getWorkspaceNavData = async (options: WorkspaceNavOptions): Promise<NavData> => {
   const [loadedComponents, patterns, pages, loadedTokenSets] = await Promise.all([
     safeLoad(options.loaders.components),
     safeLoad(options.loaders.patterns),

package/src/{define.ts → providers.ts}

@@ -1,16 +1,16 @@
 /**
- * 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.
+ * Define helpers for custom server modules: storage, email and AI providers. 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 { defineStorageProvider } from './registry/asset-storage/define';
 export type {
-  AssetStorage,
-  AssetStorageContext,
-  AssetStorageFactory,
-  AssetStorageInput,
-  AssetStorageReadResult,
+  StorageProvider,
+  StorageProviderContext,
+  StorageProviderFactory,
+  StorageInput,
+  StorageReadResult,
   AssetUpload,
   AssetUploadInput,
 } from './registry/asset-storage/types';

package/src/registry/asset-storage/define.ts

@@ -1,15 +1,15 @@
 /**
- * Typed identity helper for custom asset storage adapters (mirrors `defineCatalogItem`): a consumer
+ * Typed identity helper for custom asset storage providers (mirrors `defineCatalogItem`): a consumer
  * default-exports its result from a **server-only** module and points
  * `runtime.registry.assetStorage.module` at it. It must be its own module (not an inline
  * `defineConfig` function) so the build can trace it into the deployed registry. The default export
- * may be the adapter object, or a factory `(context) => AssetStorage` when it needs its options/env.
+ * may be the provider object, or a factory `(context) => StorageProvider` when it needs its options/env.
  */
 
-import type { AssetStorage, AssetStorageFactory } from './types';
+import type { StorageProvider, StorageProviderFactory } from './types';
 
-export function defineAssetStorage(adapter: AssetStorage): AssetStorage;
-export function defineAssetStorage(factory: AssetStorageFactory): AssetStorageFactory;
-export function defineAssetStorage(input: AssetStorage | AssetStorageFactory): AssetStorage | AssetStorageFactory {
+export function defineStorageProvider(provider: StorageProvider): StorageProvider;
+export function defineStorageProvider(factory: StorageProviderFactory): StorageProviderFactory;
+export function defineStorageProvider(input: StorageProvider | StorageProviderFactory): StorageProvider | StorageProviderFactory {
   return input;
 }

package/src/registry/asset-storage/resolve.ts

@@ -2,54 +2,50 @@
  * Asset storage settings resolution.
  *
  * `runtime.registry.assetStorage` selects the active provider for **new** uploads: the built-in
- * `database` inline default or a `custom` module. The build bakes the adapter, the module location,
+ * `database` inline default or a `custom` module. The build bakes the provider, the module location,
  * and the options. An option literal is baked as it is. An environment reference stays `{ $env }`
- * and is resolved at request time, before the custom adapter factory runs.
+ * and is resolved at request time, before the custom provider factory runs.
  */
 
 import { HandoffConfigError } from '../../config/errors';
 import type { ResolvedConfig } from '../../types/config';
 import type { AssetStorageProvider } from '../db/schema';
 
-/** Which adapter implementation is active. Recorded on each blob row as its storage provider. */
-export type AssetStorageAdapterKind = AssetStorageProvider;
-
 /** The raw, authored settings block (a structural copy of the config type, resolvable from bake). */
 export interface AssetStorageSettings {
-  adapter?: AssetStorageAdapterKind;
+  provider?: AssetStorageProvider;
   module?: string;
   maxInlineBytes?: number;
   options?: Record<string, unknown>;
 }
 
-const ADAPTERS: readonly AssetStorageAdapterKind[] = ['database', 'custom'];
+const PROVIDERS: readonly AssetStorageProvider[] = ['database', 'custom'];
 
-/** Default adapter when none is configured. */
-export const DEFAULT_ASSET_STORAGE_ADAPTER: AssetStorageAdapterKind = 'database';
+export const DEFAULT_ASSET_STORAGE_PROVIDER: AssetStorageProvider = 'database';
 
 /** Default max bytes kept inline in Postgres `bytea` (4 MB, under Vercel's ~4.5 MB function limit). */
 export const DEFAULT_MAX_INLINE_BYTES = 4 * 1024 * 1024;
 
 /** Fully resolved asset storage settings. */
 export interface ResolvedAssetStorage {
-  /** The active adapter implementation. */
-  adapterKind: AssetStorageAdapterKind;
-  /** For `custom`: the server-only adapter module path. */
+  /** Recorded on each new blob row as its storage provider. */
+  provider: AssetStorageProvider;
+  /** For `custom`: the server-only provider module path. */
   module?: string;
   /** For `database`: the inline-content size ceiling. */
   maxInlineBytes: number;
-  /** Adapter options: literals and `{ $env }` references, never secret values. */
+  /** Provider options: literals and `{ $env }` references, never secret values. */
   options: Record<string, unknown>;
 }
 
 /** Resolve raw asset storage settings into a fully-defaulted shape. */
 export const resolveAssetStorageSettings = (settings: AssetStorageSettings | null | undefined): ResolvedAssetStorage => {
-  const adapterKind = settings?.adapter ?? DEFAULT_ASSET_STORAGE_ADAPTER;
+  const provider = settings?.provider ?? DEFAULT_ASSET_STORAGE_PROVIDER;
   const options = settings?.options ?? {};
   const maxInlineBytes =
     typeof settings?.maxInlineBytes === 'number' && settings.maxInlineBytes > 0 ? settings.maxInlineBytes : DEFAULT_MAX_INLINE_BYTES;
 
-  return { adapterKind, module: settings?.module?.trim() || undefined, maxInlineBytes, options };
+  return { provider, module: settings?.module?.trim() || undefined, maxInlineBytes, options };
 };
 
 /** Resolve and validate the asset storage block from a loaded config (CLI/build side). An unusable block fails the build. */
@@ -59,17 +55,17 @@ export const resolveAssetStorageFromConfig = (config: ResolvedConfig | null | un
     throw new HandoffConfigError(`Config "runtime.registry.assetStorage": ${problem}`);
   };
 
-  const adapter = settings?.adapter ?? DEFAULT_ASSET_STORAGE_ADAPTER;
-  if (!ADAPTERS.includes(adapter as AssetStorageAdapterKind)) {
-    fail(`unknown adapter ${JSON.stringify(adapter)}. Use "database" or "custom".`);
+  const provider = settings?.provider ?? DEFAULT_ASSET_STORAGE_PROVIDER;
+  if (!PROVIDERS.includes(provider as AssetStorageProvider)) {
+    fail(`unknown provider ${JSON.stringify(provider)}. Use "database" or "custom".`);
   }
   const options = settings?.options;
   if (options !== undefined && (options === null || typeof options !== 'object' || Array.isArray(options))) {
     fail('"options" must be an object.');
   }
   const module = settings?.module;
-  if (adapter === 'custom' && (typeof module !== 'string' || !module.trim())) {
-    fail('adapter "custom" needs a "module" that default-exports a defineAssetStorage() result.');
+  if (provider === 'custom' && (typeof module !== 'string' || !module.trim())) {
+    fail('provider "custom" needs a "module" that default-exports a defineStorageProvider() result.');
   }
   const maxInlineBytes = settings?.maxInlineBytes;
   if (maxInlineBytes !== undefined && (typeof maxInlineBytes !== 'number' || !Number.isInteger(maxInlineBytes) || maxInlineBytes <= 0)) {