@rovela-ai/sdk 0.16.3 → 0.17.0

package/dist/admin/api/branding.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @rovela-ai/sdk/admin/api/branding
+ *
+ * Store-side branding asset management (logo + favicon) — the store admin's
+ * half of the branding architecture shared with the Rovela platform.
+ *
+ * ARCHITECTURE (lockstep with the platform's lib/branding-asset.ts): the ONE
+ * source of truth is the R2 object at the fixed key
+ * `stores/{STORE_ID}/branding/{logo|favicon}` (no extension — R2 serves the
+ * Content-Type from object metadata, so the URL never changes when the file
+ * format changes). Everything else is a pointer that only encodes existence:
+ *
+ *   - store_settings.logo_url / favicon_url — the store-side RUNTIME mirror.
+ *     StoreSettingsProvider, the storefront header, transactional emails and
+ *     the admin top bar all read settings-first, so writes here are live
+ *     immediately (no redeploy).
+ *   - projects.blueprint.store.{logoUrl|faviconUrl} — the PLATFORM-side
+ *     mirror (written by the platform branding routes; feeds the env vars at
+ *     deploy time). This handler cannot reach it, and doesn't need to: with
+ *     settings-first readers the env vars are a build-time fallback only.
+ *   - NEXT_PUBLIC_STORE_{LOGO|FAVICON}_URL — build-time fallback.
+ *
+ * Contract for every writer: update R2 + every mirror you can reach. This
+ * handler writes R2 + store_settings. GET reads the truth directly (an R2
+ * HEAD on the fixed key) so the admin UI can never lie about whether an
+ * asset exists, regardless of mirror state.
+ */
+import { NextRequest, NextResponse } from 'next/server';
+export type BrandingKind = 'logo' | 'favicon';
+interface BrandingApiError {
+    error: string;
+    code?: string;
+}
+export declare const logoGET: () => Promise<NextResponse<BrandingApiError> | NextResponse<{
+    success: boolean;
+    data: {
+        exists: boolean;
+        url: string | null;
+    };
+}>>;
+export declare const logoPOST: (req: NextRequest) => Promise<NextResponse<BrandingApiError> | NextResponse<{
+    success: boolean;
+    data: {
+        url: string;
+        key: string;
+        size: number;
+        type: string;
+        settingsUpdated: boolean;
+    };
+}>>;
+export declare const logoDELETE: () => Promise<NextResponse<BrandingApiError> | NextResponse<{
+    success: boolean;
+    deleted: boolean;
+    settingsUpdated: boolean;
+}>>;
+export declare const faviconGET: () => Promise<NextResponse<BrandingApiError> | NextResponse<{
+    success: boolean;
+    data: {
+        exists: boolean;
+        url: string | null;
+    };
+}>>;
+export declare const faviconPOST: (req: NextRequest) => Promise<NextResponse<BrandingApiError> | NextResponse<{
+    success: boolean;
+    data: {
+        url: string;
+        key: string;
+        size: number;
+        type: string;
+        settingsUpdated: boolean;
+    };
+}>>;
+export declare const faviconDELETE: () => Promise<NextResponse<BrandingApiError> | NextResponse<{
+    success: boolean;
+    deleted: boolean;
+    settingsUpdated: boolean;
+}>>;
+export {};
+//# sourceMappingURL=branding.d.ts.map

package/dist/admin/api/branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../../src/admin/api/branding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAcvD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,CAAA;AAE7C,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AA6QD,eAAO,MAAM,OAAO;;;;;;GAAmB,CAAA;AACvC,eAAO,MAAM,QAAQ,QA9MM,WAAW;;;;;;;;;GA8MG,CAAA;AACzC,eAAO,MAAM,UAAU;;;;GAAsB,CAAA;AAE7C,eAAO,MAAM,UAAU;;;;;;GAAsB,CAAA;AAC7C,eAAO,MAAM,WAAW,QAlNG,WAAW;;;;;;;;;GAkNS,CAAA;AAC/C,eAAO,MAAM,aAAa;;;;GAAyB,CAAA"}

package/dist/admin/api/branding.js

@@ -0,0 +1,238 @@
+/**
+ * @rovela-ai/sdk/admin/api/branding
+ *
+ * Store-side branding asset management (logo + favicon) — the store admin's
+ * half of the branding architecture shared with the Rovela platform.
+ *
+ * ARCHITECTURE (lockstep with the platform's lib/branding-asset.ts): the ONE
+ * source of truth is the R2 object at the fixed key
+ * `stores/{STORE_ID}/branding/{logo|favicon}` (no extension — R2 serves the
+ * Content-Type from object metadata, so the URL never changes when the file
+ * format changes). Everything else is a pointer that only encodes existence:
+ *
+ *   - store_settings.logo_url / favicon_url — the store-side RUNTIME mirror.
+ *     StoreSettingsProvider, the storefront header, transactional emails and
+ *     the admin top bar all read settings-first, so writes here are live
+ *     immediately (no redeploy).
+ *   - projects.blueprint.store.{logoUrl|faviconUrl} — the PLATFORM-side
+ *     mirror (written by the platform branding routes; feeds the env vars at
+ *     deploy time). This handler cannot reach it, and doesn't need to: with
+ *     settings-first readers the env vars are a build-time fallback only.
+ *   - NEXT_PUBLIC_STORE_{LOGO|FAVICON}_URL — build-time fallback.
+ *
+ * Contract for every writer: update R2 + every mirror you can reach. This
+ * handler writes R2 + store_settings. GET reads the truth directly (an R2
+ * HEAD on the fixed key) so the admin UI can never lie about whether an
+ * asset exists, regardless of mirror state.
+ */
+import { NextResponse } from 'next/server';
+import { PutObjectCommand, DeleteObjectCommand, HeadObjectCommand, } from '@aws-sdk/client-s3';
+import { requireAdmin } from '../server/admin-session';
+import { getR2Client, getBucketName, getPublicUrlBase, getStoreId } from '../../media/server';
+import { findSettings, upsertSettings, setOnboardingFlag } from '../../core/db/queries';
+const MAX_FILE_SIZE = 2 * 1024 * 1024; // 2MB
+const BASE_TYPES = ['image/png', 'image/jpeg', 'image/jpg', 'image/webp', 'image/svg+xml'];
+const KINDS = {
+    logo: {
+        settingsField: 'logoUrl',
+        envVar: 'NEXT_PUBLIC_STORE_LOGO_URL',
+        allowedTypes: BASE_TYPES,
+        label: 'Logo',
+    },
+    favicon: {
+        settingsField: 'faviconUrl',
+        envVar: 'NEXT_PUBLIC_STORE_FAVICON_URL',
+        // Favicons additionally accept .ico (both MIME spellings browsers emit).
+        allowedTypes: [...BASE_TYPES, 'image/x-icon', 'image/vnd.microsoft.icon'],
+        label: 'Favicon',
+    },
+};
+/** Fixed R2 key — mirror of the platform's getBrandingR2Key. No extension. */
+function brandingR2Key(storeId, kind) {
+    return `stores/${storeId}/branding/${kind}`;
+}
+/**
+ * Mirror the asset URL (or null on delete) into store_settings so every
+ * settings-first reader picks it up live. Awaited but non-fatal: R2 is the
+ * truth and GET reads R2 directly, so a mirror failure degrades to "shows
+ * after the next successful settings write" instead of failing the upload.
+ */
+async function mirrorToSettings(kind, url) {
+    try {
+        await upsertSettings({ [KINDS[kind].settingsField]: url });
+        return true;
+    }
+    catch (err) {
+        console.error(`[Branding API] store_settings ${KINDS[kind].settingsField} mirror failed:`, err);
+        return false;
+    }
+}
+// =============================================================================
+// Handler factory
+// =============================================================================
+function createBrandingHandlers(kind) {
+    const cfg = KINDS[kind];
+    async function POST(req) {
+        try {
+            // Branding is a settings write — owner + administrator only.
+            const guard = await requireAdmin({ permission: 'settings.write' });
+            if (!guard.ok)
+                return guard.response;
+            let storeId;
+            let bucketName;
+            let publicUrl;
+            try {
+                storeId = getStoreId();
+                bucketName = getBucketName();
+                publicUrl = getPublicUrlBase();
+            }
+            catch {
+                return NextResponse.json({ error: 'Media storage not configured', code: 'NOT_CONFIGURED' }, { status: 503 });
+            }
+            let formData;
+            try {
+                formData = await req.formData();
+            }
+            catch {
+                return NextResponse.json({ error: 'Invalid form data', code: 'INVALID_REQUEST' }, { status: 400 });
+            }
+            // Field name matches the kind ('logo' / 'favicon'); accept 'file' as a
+            // generic fallback so future callers don't have to know the kind.
+            const file = (formData.get(kind) ?? formData.get('file'));
+            if (!file) {
+                return NextResponse.json({ error: `No ${kind} file provided`, code: 'MISSING_FILE' }, { status: 400 });
+            }
+            if (file.size > MAX_FILE_SIZE) {
+                return NextResponse.json({ error: `${cfg.label} file exceeds maximum size of 2MB`, code: 'FILE_TOO_LARGE' }, { status: 400 });
+            }
+            if (!cfg.allowedTypes.includes(file.type)) {
+                return NextResponse.json({
+                    error: `Invalid file type. Allowed: PNG, JPG, WebP, SVG${kind === 'favicon' ? ', ICO' : ''}`,
+                    code: 'INVALID_TYPE',
+                }, { status: 400 });
+            }
+            const r2Key = brandingR2Key(storeId, kind);
+            try {
+                const arrayBuffer = await file.arrayBuffer();
+                await getR2Client().send(new PutObjectCommand({
+                    Bucket: bucketName,
+                    Key: r2Key,
+                    Body: Buffer.from(arrayBuffer),
+                    ContentType: file.type, // R2 serves this back — the fixed URL never changes
+                    // Explicit cache policy: the key is fixed, bytes get replaced in
+                    // place. Without this, browsers heuristic-cache a long-unchanged
+                    // asset for days; max-age=300 caps staleness at 5 minutes.
+                    CacheControl: 'public, max-age=300',
+                }));
+            }
+            catch (err) {
+                console.error(`[Branding API] Failed to upload ${kind}:`, err);
+                return NextResponse.json({ error: `Failed to upload ${kind}`, code: 'UPLOAD_FAILED' }, { status: 500 });
+            }
+            const url = `${publicUrl}/${r2Key}`;
+            const settingsUpdated = await mirrorToSettings(kind, url);
+            if (kind === 'logo') {
+                // Setup-guide writeback: mark "Upload your own logo" complete.
+                // Fire-and-forget — onboarding flag failures never block the upload.
+                setOnboardingFlag('logoUploaded', true).catch((err) => {
+                    console.error('[Branding API] onboarding writeback failed:', err);
+                });
+            }
+            console.log(`[Branding API] Uploaded ${kind} for store ${storeId}: ${r2Key} (${file.size} bytes, ${file.type}, settings mirror: ${settingsUpdated})`);
+            return NextResponse.json({
+                success: true,
+                data: { url, key: r2Key, size: file.size, type: file.type, settingsUpdated },
+            });
+        }
+        catch (error) {
+            console.error(`[Branding API] ${kind} POST error:`, error);
+            return NextResponse.json({ error: `Failed to process ${kind} upload`, code: 'INTERNAL_ERROR' }, { status: 500 });
+        }
+    }
+    async function DELETE() {
+        try {
+            const guard = await requireAdmin({ permission: 'settings.write' });
+            if (!guard.ok)
+                return guard.response;
+            let storeId;
+            let bucketName;
+            try {
+                storeId = getStoreId();
+                bucketName = getBucketName();
+            }
+            catch {
+                return NextResponse.json({ error: 'Media storage not configured', code: 'NOT_CONFIGURED' }, { status: 503 });
+            }
+            const r2Key = brandingR2Key(storeId, kind);
+            let deleted = false;
+            try {
+                await getR2Client().send(new DeleteObjectCommand({ Bucket: bucketName, Key: r2Key }));
+                deleted = true;
+                console.log(`[Branding API] Deleted ${kind}: ${r2Key}`);
+            }
+            catch {
+                // Object didn't exist — that's fine, the mirror clear below still runs.
+                console.log(`[Branding API] No ${kind} found to delete: ${r2Key}`);
+            }
+            const settingsUpdated = await mirrorToSettings(kind, null);
+            return NextResponse.json({ success: true, deleted, settingsUpdated });
+        }
+        catch (error) {
+            console.error(`[Branding API] ${kind} DELETE error:`, error);
+            return NextResponse.json({ error: `Failed to delete ${kind}`, code: 'INTERNAL_ERROR' }, { status: 500 });
+        }
+    }
+    async function GET() {
+        try {
+            // Every authenticated admin can read (the UI renders the asset).
+            const guard = await requireAdmin({ permission: 'settings.read' });
+            if (!guard.ok)
+                return guard.response;
+            // Truth first: HEAD the fixed R2 key. The object either exists or it
+            // doesn't — no mirror (env var, settings row, blueprint) can lie here.
+            try {
+                const storeId = getStoreId();
+                const bucketName = getBucketName();
+                const publicUrl = getPublicUrlBase();
+                const r2Key = brandingR2Key(storeId, kind);
+                let exists = false;
+                try {
+                    await getR2Client().send(new HeadObjectCommand({ Bucket: bucketName, Key: r2Key }));
+                    exists = true;
+                }
+                catch {
+                    exists = false; // 404 / NotFound — asset absent
+                }
+                return NextResponse.json({
+                    success: true,
+                    data: { exists, url: exists ? `${publicUrl}/${r2Key}` : null },
+                });
+            }
+            catch {
+                // R2 not configured — degrade to the pointer chain (settings → env).
+                const settings = await findSettings().catch(() => null);
+                const url = settings?.[cfg.settingsField] ||
+                    process.env[cfg.envVar] ||
+                    null;
+                return NextResponse.json({ success: true, data: { exists: !!url, url } });
+            }
+        }
+        catch (error) {
+            console.error(`[Branding API] ${kind} GET error:`, error);
+            return NextResponse.json({ error: `Failed to check ${kind}`, code: 'INTERNAL_ERROR' }, { status: 500 });
+        }
+    }
+    return { GET, POST, DELETE };
+}
+// =============================================================================
+// Exported handlers — template routes re-export these
+// =============================================================================
+const logoHandlers = createBrandingHandlers('logo');
+const faviconHandlers = createBrandingHandlers('favicon');
+export const logoGET = logoHandlers.GET;
+export const logoPOST = logoHandlers.POST;
+export const logoDELETE = logoHandlers.DELETE;
+export const faviconGET = faviconHandlers.GET;
+export const faviconPOST = faviconHandlers.POST;
+export const faviconDELETE = faviconHandlers.DELETE;
+//# sourceMappingURL=branding.js.map

package/dist/admin/api/branding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.js","sourceRoot":"","sources":["../../../src/admin/api/branding.ts"],"names":[],"mappings":"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"}

package/dist/admin/components/AdminTopBar.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 export interface AdminTopBarProps {
     /** Store name (falls back to StoreSettingsProvider, then 'Admin'). */
     storeName?: string;

package/dist/admin/components/AdminTopBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdminTopBar.d.ts","sourceRoot":"","sources":["../../../src/admin/components/AdminTopBar.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAQtC,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EAAE,aAAuB,EAClC,IAAI,EACJ,QAAc,EACd,SAAc,GACf,EAAE,gBAAgB,2CA4ElB"}
+{"version":3,"file":"AdminTopBar.d.ts","sourceRoot":"","sources":["../../../src/admin/components/AdminTopBar.tsx"],"names":[],"mappings":"AAoBA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAQ3D,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EAAE,aAAuB,EAClC,IAAI,EACJ,QAAc,EACd,SAAc,GACf,EAAE,gBAAgB,2CA8FlB"}

package/dist/admin/components/AdminTopBar.js

@@ -17,6 +17,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 import Link from 'next/link';
 import { ExternalLink, Pencil } from 'lucide-react';
+import { useEffect, useState } from 'react';
 import { useStoreSettingsOptional } from '../../core';
 import { AdminUserMenu } from './AdminUserMenu';
 // =============================================================================
@@ -29,7 +30,23 @@ export function AdminTopBar({ storeName: storeNameProp = 'Admin', logo, storeUrl
     const storeSettings = useStoreSettingsOptional();
     const settingsLoading = storeNameProp === 'Admin' && !!storeSettings?.isLoading && !storeSettings?.settings;
     const storeName = storeNameProp !== 'Admin' ? storeNameProp : (storeSettings?.storeName || storeNameProp);
+    // Brand tile mark: favicon FIRST (a square mark belongs in a 32px tile;
+    // wide logo lockups read cramped), then logo, then monogram. Each source
+    // is settings-first (live store_settings via the provider) with the
+    // build-time env var as fallback — the branding write contract keeps the
+    // settings mirror fresh, so store-side changes show without a redeploy.
+    const faviconUrl = storeSettings?.faviconUrl || process.env.NEXT_PUBLIC_STORE_FAVICON_URL || null;
     const logoUrl = storeSettings?.logoUrl || process.env.NEXT_PUBLIC_STORE_LOGO_URL || null;
+    const tileUrl = faviconUrl || logoUrl;
+    // A stale pointer (e.g. asset deleted store-side while an env var still
+    // carries the fixed URL) must degrade to the monogram, never a broken img.
+    const [tileBroken, setTileBroken] = useState(false);
+    useEffect(() => {
+        // Pattern A — reset internal state on prop change (retry when the URL changes).
+        // eslint-disable-next-line react-hooks/set-state-in-effect
+        setTileBroken(false);
+    }, [tileUrl]);
+    const tileSrc = tileBroken ? null : tileUrl;
     // Deep-link back to the Rovela editor (/generate/[id]) so the merchant has
     // a clean Manage ↔ Edit loop. Only rendered when NEXT_PUBLIC_ROVELA_PROJECT_ID
     // is set (present on every store rebuilt since buildStoreEnvVars started
@@ -41,8 +58,8 @@ export function AdminTopBar({ storeName: storeNameProp = 'Admin', logo, storeUrl
     const editStoreUrl = rovelaProjectId
         ? `${rovelaBase.replace(/\/$/, '')}/generate/${rovelaProjectId}`
         : null;
-    return (_jsxs("header", { className: `admin-topbar ${className}`.trim(), children: [_jsxs(Link, { href: "/admin", className: "admin-topbar-brand", children: [logo || (_jsx("span", { className: `admin-brand-tile ${logoUrl ? '' : 'admin-brand-tile-monogram'}`, children: logoUrl ? (
+    return (_jsxs("header", { className: `admin-topbar ${className}`.trim(), children: [_jsxs(Link, { href: "/admin", className: "admin-topbar-brand", children: [logo || (_jsx("span", { className: `admin-brand-tile ${tileSrc ? '' : 'admin-brand-tile-monogram'}`, children: tileSrc ? (
                         // eslint-disable-next-line @next/next/no-img-element
-                        _jsx("img", { src: logoUrl, alt: "" })) : settingsLoading ? (_jsx("span", { className: "admin-skeleton admin-brand-tile-skeleton" })) : (storeName.charAt(0).toUpperCase()) })), settingsLoading ? (_jsx("span", { className: "admin-skeleton admin-topbar-name-skeleton" })) : (_jsx("span", { className: "admin-topbar-store", children: storeName })), _jsx("span", { className: "admin-topbar-tag", children: "Admin" })] }), _jsxs("div", { className: "admin-topbar-actions", children: [_jsxs("a", { href: storeUrl, target: "_blank", rel: "noopener noreferrer", className: "admin-topbar-btn", children: [_jsx(ExternalLink, { className: "h-3.5 w-3.5", strokeWidth: 1.5 }), "View store"] }), editStoreUrl && (_jsxs("a", { href: editStoreUrl, target: "_blank", rel: "noopener noreferrer", className: "admin-topbar-btn", children: [_jsx(Pencil, { className: "h-3.5 w-3.5", strokeWidth: 1.5 }), "Edit store"] })), _jsx("span", { className: "admin-topbar-divider", "aria-hidden": "true" }), _jsx(AdminUserMenu, { compact: true })] })] }));
+                        _jsx("img", { src: tileSrc, alt: "", onError: () => setTileBroken(true) })) : settingsLoading ? (_jsx("span", { className: "admin-skeleton admin-brand-tile-skeleton" })) : (storeName.charAt(0).toUpperCase()) })), settingsLoading ? (_jsx("span", { className: "admin-skeleton admin-topbar-name-skeleton" })) : (_jsx("span", { className: "admin-topbar-store", children: storeName })), _jsx("span", { className: "admin-topbar-tag", children: "Admin" })] }), _jsxs("div", { className: "admin-topbar-actions", children: [_jsxs("a", { href: storeUrl, target: "_blank", rel: "noopener noreferrer", className: "admin-topbar-btn", children: [_jsx(ExternalLink, { className: "h-3.5 w-3.5", strokeWidth: 1.5 }), "View store"] }), editStoreUrl && (_jsxs("a", { href: editStoreUrl, target: "_blank", rel: "noopener noreferrer", className: "admin-topbar-btn", children: [_jsx(Pencil, { className: "h-3.5 w-3.5", strokeWidth: 1.5 }), "Edit store"] })), _jsx("span", { className: "admin-topbar-divider", "aria-hidden": "true" }), _jsx(AdminUserMenu, { compact: true })] })] }));
 }
 //# sourceMappingURL=AdminTopBar.js.map

package/dist/admin/components/AdminTopBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"AdminTopBar.js","sourceRoot":"","sources":["../../../src/admin/components/AdminTopBar.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"AdminTopBar.js","sourceRoot":"","sources":["../../../src/admin/components/AdminTopBar.tsx"],"names":[],"mappings":"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"}

package/dist/admin/components/BrandingAssetUpload.d.ts

@@ -0,0 +1,14 @@
+export interface BrandingAssetUploadProps {
+    /** Callback when the asset is successfully uploaded */
+    onUpload?: (url: string) => void;
+    /** Callback when the asset is successfully deleted */
+    onDelete?: () => void;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function BrandingAssetUpload({ kind, onUpload, onDelete, className, }: BrandingAssetUploadProps & {
+    kind: 'logo' | 'favicon';
+}): import("react/jsx-runtime").JSX.Element;
+export type FaviconUploadProps = BrandingAssetUploadProps;
+export declare function FaviconUpload(props: FaviconUploadProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BrandingAssetUpload.d.ts.map

package/dist/admin/components/BrandingAssetUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandingAssetUpload.d.ts","sourceRoot":"","sources":["../../../src/admin/components/BrandingAssetUpload.tsx"],"names":[],"mappings":"AAuBA,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA0DD,wBAAgB,mBAAmB,CAAC,EAClC,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,SAAc,GACf,EAAE,wBAAwB,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,2CAuTzD;AAMD,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,CAAA;AAEzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAEtD"}

package/dist/admin/components/BrandingAssetUpload.js

@@ -0,0 +1,207 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @rovela/sdk/admin/components/BrandingAssetUpload
+ *
+ * Kind-parameterized branding asset upload (logo + favicon) for the admin
+ * settings page. `LogoUpload` (LogoUpload.tsx) and `FaviconUpload` (below)
+ * are thin instantiations — one implementation, two assets, zero drift.
+ *
+ * Talks to /api/admin/branding/{kind} (SDK handlers — R2 fixed key +
+ * store_settings mirror + R2-HEAD GET, see admin/api/branding.ts). The
+ * client-side `?v=` cache-buster on previews covers the fixed-URL byte
+ * replacement within this surface; the server sets max-age=300 for
+ * everything else.
+ */
+import { useState, useEffect, useRef, useCallback } from 'react';
+import { fetchAdminApi } from '../hooks/fetchAdminApi';
+const BASE_TYPES = ['image/png', 'image/jpeg', 'image/jpg', 'image/webp', 'image/svg+xml'];
+const BASE_ACCEPT = 'image/png,image/jpeg,image/jpg,image/webp,image/svg+xml';
+const KIND_CONFIG = {
+    logo: {
+        endpoint: '/api/admin/branding/logo',
+        formField: 'logo',
+        label: 'Store Logo',
+        helper: 'Your logo appears in the header and emails. Recommended: 200x80px.',
+        allowedTypes: BASE_TYPES,
+        accept: BASE_ACCEPT,
+        invalidTypeMessage: 'Invalid file type. Use PNG, JPG, WebP, or SVG.',
+        preview: 'wide',
+    },
+    favicon: {
+        endpoint: '/api/admin/branding/favicon',
+        formField: 'favicon',
+        label: 'Favicon',
+        helper: 'The small square icon in the browser tab and the admin top bar. Recommended: a square PNG or SVG, at least 64x64px. Your logo is used when no favicon is set.',
+        allowedTypes: [...BASE_TYPES, 'image/x-icon', 'image/vnd.microsoft.icon'],
+        accept: `${BASE_ACCEPT},image/x-icon,image/vnd.microsoft.icon,.ico`,
+        invalidTypeMessage: 'Invalid file type. Use PNG, JPG, WebP, SVG, or ICO.',
+        preview: 'tile',
+    },
+};
+const MAX_SIZE = 2 * 1024 * 1024; // 2MB (mirrored server-side)
+// =============================================================================
+// Component
+// =============================================================================
+export function BrandingAssetUpload({ kind, onUpload, onDelete, className = '', }) {
+    const cfg = KIND_CONFIG[kind];
+    const [asset, setAsset] = useState({
+        exists: false,
+        url: null,
+        isLoading: true,
+        isUploading: false,
+        isDeleting: false,
+        error: null,
+    });
+    const [preview, setPreview] = useState(null);
+    const [isDragging, setIsDragging] = useState(false);
+    const [successMessage, setSuccessMessage] = useState(null);
+    const [cacheBuster, setCacheBuster] = useState(() => Date.now());
+    const fileInputRef = useRef(null);
+    // Fetch status on mount — the GET is an R2 HEAD, so this reflects the
+    // actual object, not a possibly-stale env var or settings row.
+    useEffect(() => {
+        let cancelled = false;
+        async function fetchStatus() {
+            const res = await fetchAdminApi(cfg.endpoint);
+            if (cancelled)
+                return;
+            if (!res.ok) {
+                setAsset((prev) => ({ ...prev, isLoading: false, error: res.error }));
+                return;
+            }
+            setAsset({
+                exists: res.data.data.exists,
+                url: res.data.data.url,
+                isLoading: false,
+                isUploading: false,
+                isDeleting: false,
+                error: null,
+            });
+        }
+        fetchStatus();
+        return () => {
+            cancelled = true;
+        };
+    }, [cfg.endpoint]);
+    const uploadAsset = useCallback(async (file) => {
+        setAsset((prev) => ({ ...prev, isUploading: true, error: null }));
+        const formData = new FormData();
+        formData.append(cfg.formField, file);
+        const res = await fetchAdminApi(cfg.endpoint, {
+            method: 'POST',
+            body: formData,
+        });
+        if (!res.ok) {
+            setAsset((prev) => ({ ...prev, isUploading: false, error: res.error }));
+            setPreview(null);
+            return;
+        }
+        setCacheBuster(Date.now());
+        setAsset({
+            exists: true,
+            url: res.data.data.url,
+            isLoading: false,
+            isUploading: false,
+            isDeleting: false,
+            error: null,
+        });
+        setPreview(null);
+        setSuccessMessage(`${cfg.label} uploaded successfully!`);
+        setTimeout(() => setSuccessMessage(null), 3000);
+        onUpload?.(res.data.data.url);
+    }, [cfg.endpoint, cfg.formField, cfg.label, onUpload]);
+    const handleFileSelect = useCallback((file) => {
+        setAsset((prev) => ({ ...prev, error: null }));
+        setSuccessMessage(null);
+        if (!cfg.allowedTypes.includes(file.type)) {
+            setAsset((prev) => ({ ...prev, error: cfg.invalidTypeMessage }));
+            return;
+        }
+        if (file.size > MAX_SIZE) {
+            setAsset((prev) => ({ ...prev, error: 'File too large. Maximum size is 2MB.' }));
+            return;
+        }
+        const reader = new FileReader();
+        reader.onload = (e) => {
+            setPreview(e.target?.result);
+        };
+        reader.readAsDataURL(file);
+        uploadAsset(file);
+    }, [cfg.allowedTypes, cfg.invalidTypeMessage, uploadAsset]);
+    const handleDelete = async () => {
+        if (!asset.exists)
+            return;
+        setAsset((prev) => ({ ...prev, isDeleting: true, error: null }));
+        setSuccessMessage(null);
+        const res = await fetchAdminApi(cfg.endpoint, { method: 'DELETE' });
+        if (!res.ok) {
+            setAsset((prev) => ({ ...prev, isDeleting: false, error: res.error }));
+            return;
+        }
+        setAsset({
+            exists: false,
+            url: null,
+            isLoading: false,
+            isUploading: false,
+            isDeleting: false,
+            error: null,
+        });
+        setSuccessMessage(`${cfg.label} removed successfully!`);
+        setTimeout(() => setSuccessMessage(null), 3000);
+        onDelete?.();
+    };
+    const handleFileInputChange = (e) => {
+        const file = e.target.files?.[0];
+        if (file) {
+            handleFileSelect(file);
+        }
+        if (fileInputRef.current) {
+            fileInputRef.current.value = '';
+        }
+    };
+    const handleDragOver = (e) => {
+        e.preventDefault();
+        setIsDragging(true);
+    };
+    const handleDragLeave = (e) => {
+        e.preventDefault();
+        setIsDragging(false);
+    };
+    const handleDrop = (e) => {
+        e.preventDefault();
+        setIsDragging(false);
+        const file = e.dataTransfer.files?.[0];
+        if (file) {
+            handleFileSelect(file);
+        }
+    };
+    const getDisplayUrl = () => {
+        if (preview)
+            return preview;
+        if (asset.url)
+            return `${asset.url}?v=${cacheBuster}`;
+        return null;
+    };
+    const displayUrl = getDisplayUrl();
+    const isWorking = asset.isLoading || asset.isUploading || asset.isDeleting;
+    return (_jsxs("div", { className: className, children: [_jsx("label", { className: "admin-label", children: cfg.label }), _jsx("p", { className: "admin-helper-text mb-3", children: cfg.helper }), asset.error && (_jsx("div", { className: "admin-alert admin-alert-error mb-3", children: _jsx("div", { className: "admin-alert-description text-sm", children: asset.error }) })), successMessage && (_jsx("div", { className: "admin-alert admin-alert-success mb-3", children: _jsx("div", { className: "admin-alert-description text-sm", children: successMessage }) })), displayUrl ? (_jsxs("div", { className: "space-y-3", children: [_jsxs("div", { className: "relative rounded-lg border border-[hsl(var(--admin-border))] bg-[hsl(var(--admin-background-subtle))] p-4", children: [_jsx("div", { className: cfg.preview === 'tile'
+                                    ? 'flex items-center justify-center min-h-[56px]'
+                                    : 'flex items-center justify-center min-h-[80px]', children: _jsx("img", { src: displayUrl, alt: cfg.label, className: cfg.preview === 'tile'
+                                        ? 'h-12 w-12 rounded-md object-contain'
+                                        : 'max-h-[80px] max-w-full object-contain' }) }), asset.isUploading && (_jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-[hsl(var(--admin-background))]/80 rounded-lg", children: _jsxs("div", { className: "flex items-center gap-2 text-sm admin-text-muted", children: [_jsx("div", { className: "admin-spinner h-4 w-4" }), "Uploading..."] }) }))] }), _jsxs("div", { className: "flex gap-2", children: [_jsx("input", { ref: fileInputRef, type: "file", accept: cfg.accept, onChange: handleFileInputChange, className: "hidden" }), _jsx("button", { type: "button", onClick: () => fileInputRef.current?.click(), disabled: isWorking, className: "admin-btn admin-btn-secondary admin-btn-sm disabled:opacity-50", children: "Replace" }), _jsx("button", { type: "button", onClick: handleDelete, disabled: isWorking, className: "admin-btn admin-btn-destructive admin-btn-sm disabled:opacity-50", children: asset.isDeleting ? 'Removing...' : 'Remove' })] })] })) : (_jsxs("div", { onClick: () => !isWorking && fileInputRef.current?.click(), onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, className: `
+            relative flex min-h-[120px] cursor-pointer flex-col items-center justify-center
+            rounded-lg border-2 border-dashed transition-all
+            ${isDragging
+                    ? 'border-[hsl(var(--admin-primary))] bg-[hsl(var(--admin-primary)/0.05)]'
+                    : 'border-[hsl(var(--admin-border))] hover:border-[hsl(var(--admin-primary)/0.5)]'}
+            ${isWorking ? 'opacity-50 cursor-not-allowed' : ''}
+          `, children: [_jsx("input", { ref: fileInputRef, type: "file", accept: cfg.accept, onChange: handleFileInputChange, className: "hidden" }), asset.isLoading ? (_jsxs("div", { className: "flex items-center gap-2 admin-text-muted", children: [_jsx("div", { className: "admin-spinner h-5 w-5" }), _jsx("span", { className: "text-sm", children: "Checking..." })] })) : (_jsxs("div", { className: "flex flex-col items-center gap-2 p-4 text-center", children: [_jsx("div", { className: `
+                  flex h-10 w-10 items-center justify-center rounded-full transition-colors
+                  ${isDragging ? 'bg-[hsl(var(--admin-primary)/0.2)]' : 'bg-[hsl(var(--admin-background-subtle))]'}
+                `, children: _jsx("svg", { className: `h-5 w-5 transition-colors ${isDragging ? 'text-[hsl(var(--admin-primary))]' : 'admin-icon-muted'}`, fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M4 16l4.586-4.586a2 2 0 012.828 0L16 16m-2-2l1.586-1.586a2 2 0 012.828 0L20 14m-6-6h.01M6 20h12a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v12a2 2 0 002 2z" }) }) }), _jsxs("div", { children: [_jsx("p", { className: "text-sm font-medium admin-text", children: isDragging ? 'Drop here' : 'Click or drag to upload' }), _jsx("p", { className: "admin-helper-text mt-1", children: kind === 'favicon' ? 'PNG, JPG, WebP, SVG, ICO (max 2MB)' : 'PNG, JPG, WebP, SVG (max 2MB)' })] })] }))] }))] }));
+}
+export function FaviconUpload(props) {
+    return _jsx(BrandingAssetUpload, { kind: "favicon", ...props });
+}
+//# sourceMappingURL=BrandingAssetUpload.js.map