@nfcard/validation 0.22.1 → 0.23.0

package/dist/index.d.ts

@@ -5256,6 +5256,22 @@ declare const bookingSchema: z.ZodEffects<z.ZodUnknown, {
     handle: string;
     label?: undefined;
 } | undefined, unknown>;
+declare const profileBackgroundSchema: z.ZodEffects<z.ZodUnknown, {
+    kind: "solid";
+    from?: undefined;
+    to?: undefined;
+    angleDeg?: undefined;
+} | {
+    kind: "gradient";
+    from: string;
+    to: string;
+    angleDeg?: undefined;
+} | {
+    kind: "gradient";
+    from: string;
+    to: string;
+    angleDeg: number;
+} | undefined, unknown>;
 declare const digitalConfigSchema: z.ZodObject<{
     templateId: z.ZodEnum<["minimal", "bold", "card", "aurora", "classic", "spotlight", "marquee", "riso"]>;
     accentColor: z.ZodString;
@@ -5361,11 +5377,43 @@ declare const digitalConfigSchema: z.ZodObject<{
         handle: string;
         label?: undefined;
     } | undefined, unknown>>;
+    background: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+        kind: "solid";
+        from?: undefined;
+        to?: undefined;
+        angleDeg?: undefined;
+    } | {
+        kind: "gradient";
+        from: string;
+        to: string;
+        angleDeg?: undefined;
+    } | {
+        kind: "gradient";
+        from: string;
+        to: string;
+        angleDeg: number;
+    } | undefined, unknown>>;
 }, "strip", z.ZodTypeAny, {
     fontKey: string;
     templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
     accentColor: string;
     showAvatar: boolean;
+    background?: {
+        kind: "solid";
+        from?: undefined;
+        to?: undefined;
+        angleDeg?: undefined;
+    } | {
+        kind: "gradient";
+        from: string;
+        to: string;
+        angleDeg?: undefined;
+    } | {
+        kind: "gradient";
+        from: string;
+        to: string;
+        angleDeg: number;
+    } | undefined;
     primaryColor?: string | undefined;
     secondaryColor?: string | undefined;
     textColor?: string | undefined;
@@ -5419,6 +5467,7 @@ declare const digitalConfigSchema: z.ZodObject<{
     templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
     accentColor: string;
     showAvatar: boolean;
+    background?: unknown;
     primaryColor?: string | undefined;
     secondaryColor?: string | undefined;
     textColor?: string | undefined;
@@ -8997,11 +9046,43 @@ declare const configurationCreateSchema: z.ZodObject<{
             handle: string;
             label?: undefined;
         } | undefined, unknown>>;
+        background: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined, unknown>>;
     }, "strip", z.ZodTypeAny, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -9055,6 +9136,7 @@ declare const configurationCreateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: unknown;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -9444,6 +9526,22 @@ declare const configurationCreateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -9831,6 +9929,7 @@ declare const configurationCreateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: unknown;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -13394,11 +13493,43 @@ declare const configurationUpdateSchema: z.ZodObject<{
             handle: string;
             label?: undefined;
         } | undefined, unknown>>;
+        background: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined, unknown>>;
     }, "strip", z.ZodTypeAny, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -13452,6 +13583,7 @@ declare const configurationUpdateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: unknown;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -13812,6 +13944,22 @@ declare const configurationUpdateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -14188,6 +14336,7 @@ declare const configurationUpdateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: unknown;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -14344,6 +14493,22 @@ declare const cardUpdateSchema: z.ZodObject<{
             handle: string;
             label?: undefined;
         } | undefined, unknown>>>>;
+        background: z.ZodOptional<z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined, unknown>>>>;
         profilePhotoUrl: z.ZodOptional<z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>>;
         companyLogoUrl: z.ZodOptional<z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>>;
     }, "strip", z.ZodTypeAny, {
@@ -14351,6 +14516,22 @@ declare const cardUpdateSchema: z.ZodObject<{
         companyLogoUrl?: string | undefined;
         fontKey?: string | undefined;
         templateId?: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso" | undefined;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         accentColor?: string | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
@@ -14406,6 +14587,7 @@ declare const cardUpdateSchema: z.ZodObject<{
         companyLogoUrl?: string | undefined;
         fontKey?: string | undefined;
         templateId?: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso" | undefined;
+        background?: unknown;
         accentColor?: string | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
@@ -14449,6 +14631,22 @@ declare const cardUpdateSchema: z.ZodObject<{
         companyLogoUrl?: string | undefined;
         fontKey?: string | undefined;
         templateId?: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso" | undefined;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         accentColor?: string | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
@@ -14507,6 +14705,7 @@ declare const cardUpdateSchema: z.ZodObject<{
         companyLogoUrl?: string | undefined;
         fontKey?: string | undefined;
         templateId?: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso" | undefined;
+        background?: unknown;
         accentColor?: string | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
@@ -14738,11 +14937,43 @@ declare const adminCardCreateSchema: z.ZodObject<{
             handle: string;
             label?: undefined;
         } | undefined, unknown>>;
+        background: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined, unknown>>;
     }, "strip", z.ZodTypeAny, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -14796,6 +15027,7 @@ declare const adminCardCreateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: unknown;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -18181,6 +18413,22 @@ declare const adminCardCreateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -18555,6 +18803,7 @@ declare const adminCardCreateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: unknown;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -19172,11 +19421,43 @@ declare const profileCreateSchema: z.ZodObject<{
             handle: string;
             label?: undefined;
         } | undefined, unknown>>;
+        background: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined, unknown>>;
     }, "strip", z.ZodTypeAny, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -19230,6 +19511,7 @@ declare const profileCreateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: unknown;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -19296,6 +19578,22 @@ declare const profileCreateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -19379,6 +19677,7 @@ declare const profileCreateSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: unknown;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -19621,11 +19920,43 @@ declare const signupWithProfileSchema: z.ZodObject<{
             handle: string;
             label?: undefined;
         } | undefined, unknown>>;
+        background: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined, unknown>>;
     }, "strip", z.ZodTypeAny, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -19679,6 +20010,7 @@ declare const signupWithProfileSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: unknown;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -19743,6 +20075,22 @@ declare const signupWithProfileSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -19830,6 +20178,7 @@ declare const signupWithProfileSchema: z.ZodObject<{
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
         accentColor: string;
         showAvatar: boolean;
+        background?: unknown;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
         textColor?: string | undefined;
@@ -20068,6 +20417,22 @@ declare const profileUpdateSchema: z.ZodObject<{
             handle: string;
             label?: undefined;
         } | undefined, unknown>>>>;
+        background: z.ZodOptional<z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined, unknown>>>>;
         profilePhotoUrl: z.ZodOptional<z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>>;
         companyLogoUrl: z.ZodOptional<z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>>;
     }, "strip", z.ZodTypeAny, {
@@ -20075,6 +20440,22 @@ declare const profileUpdateSchema: z.ZodObject<{
         companyLogoUrl?: string | undefined;
         fontKey?: string | undefined;
         templateId?: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso" | undefined;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         accentColor?: string | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
@@ -20130,6 +20511,7 @@ declare const profileUpdateSchema: z.ZodObject<{
         companyLogoUrl?: string | undefined;
         fontKey?: string | undefined;
         templateId?: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso" | undefined;
+        background?: unknown;
         accentColor?: string | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
@@ -20199,6 +20581,22 @@ declare const profileUpdateSchema: z.ZodObject<{
         companyLogoUrl?: string | undefined;
         fontKey?: string | undefined;
         templateId?: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso" | undefined;
+        background?: {
+            kind: "solid";
+            from?: undefined;
+            to?: undefined;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg?: undefined;
+        } | {
+            kind: "gradient";
+            from: string;
+            to: string;
+            angleDeg: number;
+        } | undefined;
         accentColor?: string | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
@@ -20284,6 +20682,7 @@ declare const profileUpdateSchema: z.ZodObject<{
         companyLogoUrl?: string | undefined;
         fontKey?: string | undefined;
         templateId?: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso" | undefined;
+        background?: unknown;
         accentColor?: string | undefined;
         primaryColor?: string | undefined;
         secondaryColor?: string | undefined;
@@ -20466,4 +20865,4 @@ declare function validatePhysicalConfig(data: unknown): ValidationResult<z.infer
 declare function validateDigitalConfig(data: unknown): ValidationResult<z.infer<typeof digitalConfigSchema>>;
 declare function validateConfiguration(data: unknown): ValidationResult<z.infer<typeof configurationCreateSchema>>;
 
-export { ADVANCE_FALLBACK_EM, CARD_H_MM, CARD_W_MM, CHIP_RADIUS_MM, CHIP_SCALE_FLOOR, type ChipAxis, EDGE_MARGIN_MM, EMPTY_TEXT_FLOOR_EM, ITALIC_OVERHANG_EM, MAX_CTA_BUTTONS, MIN_WALL_MM, NFC_COIL_DIAMETER_MM, NFC_RADIAL_CLEARANCE_MM, type PrintabilityCtx, type Pt, QR_MATRIX_CELLS, QR_MIN_SIZE_MM, QR_MODULE_MIN_MM, TEXT_LINE_FACTOR_EM, TEXT_MIN_EM_MM, type ValidationResult, type Violation, adminCardCreateSchema, bookingSchema, cardAssetSchema, cardDesignMaterialSchema, cardDesignPatternSchema, cardDesignSchema, cardElementSchema, cardElementsSchema, cardProfileUpdateSchema, cardUpdateSchema, chipAnchorToMm, chipPlacementMaxXY, comboIdSchema, configurationCreateSchema, configurationUpdateSchema, contactDetailTogglesSchema, contactExchangeSchema, cornersOnCard, createOrderSchema, ctaButtonSchema, ctaButtonsSchema, digitalConfigSchema, digitalVisibilitySchema, elementPrintability, elementTransformSchema, entrySourceSchema, footprintOf, hubConfigSchema, hubProfilesUpdateSchema, isFiniteTransform, materialSchema, mmToNearestChipAnchor, obbCorners, patternFamilySchema, physicalConfigSchema, physicalContentOverridesSchema, profileAccessTokenCreateSchema, profileCreateSchema, profilePinVerifySchema, profileUpdateSchema, profileUserDataSchema, profileVisibilitySchema, qrModeSchema, sanitizeHttpUrl, sanitizeText, signupWithProfileSchema, socialLinksSchema, socialOverridesSchema, textAdvanceEm, tipJarSchema, userDataSchema, validateConfiguration, validateDigitalConfig, validatePhysicalConfig, validateUserData, webAddressSchema };
+export { ADVANCE_FALLBACK_EM, CARD_H_MM, CARD_W_MM, CHIP_RADIUS_MM, CHIP_SCALE_FLOOR, type ChipAxis, EDGE_MARGIN_MM, EMPTY_TEXT_FLOOR_EM, ITALIC_OVERHANG_EM, MAX_CTA_BUTTONS, MIN_WALL_MM, NFC_COIL_DIAMETER_MM, NFC_RADIAL_CLEARANCE_MM, type PrintabilityCtx, type Pt, QR_MATRIX_CELLS, QR_MIN_SIZE_MM, QR_MODULE_MIN_MM, TEXT_LINE_FACTOR_EM, TEXT_MIN_EM_MM, type ValidationResult, type Violation, adminCardCreateSchema, bookingSchema, cardAssetSchema, cardDesignMaterialSchema, cardDesignPatternSchema, cardDesignSchema, cardElementSchema, cardElementsSchema, cardProfileUpdateSchema, cardUpdateSchema, chipAnchorToMm, chipPlacementMaxXY, comboIdSchema, configurationCreateSchema, configurationUpdateSchema, contactDetailTogglesSchema, contactExchangeSchema, cornersOnCard, createOrderSchema, ctaButtonSchema, ctaButtonsSchema, digitalConfigSchema, digitalVisibilitySchema, elementPrintability, elementTransformSchema, entrySourceSchema, footprintOf, hubConfigSchema, hubProfilesUpdateSchema, isFiniteTransform, materialSchema, mmToNearestChipAnchor, obbCorners, patternFamilySchema, physicalConfigSchema, physicalContentOverridesSchema, profileAccessTokenCreateSchema, profileBackgroundSchema, profileCreateSchema, profilePinVerifySchema, profileUpdateSchema, profileUserDataSchema, profileVisibilitySchema, qrModeSchema, sanitizeHttpUrl, sanitizeText, signupWithProfileSchema, socialLinksSchema, socialOverridesSchema, textAdvanceEm, tipJarSchema, userDataSchema, validateConfiguration, validateDigitalConfig, validatePhysicalConfig, validateUserData, webAddressSchema };

package/dist/index.js

@@ -763,6 +763,18 @@ var bookingSchema = z.unknown().transform((raw) => {
   const label = typeof rec.label === "string" ? sanitizeText(rec.label, 40) : "";
   return label ? { provider: rec.provider, handle, label } : { provider: rec.provider, handle };
 });
+var profileBackgroundSchema = z.unknown().transform((raw) => {
+  if (!raw || typeof raw !== "object") return void 0;
+  const rec = raw;
+  if (rec.kind === "solid") return { kind: "solid" };
+  if (rec.kind !== "gradient") return void 0;
+  const hex = /^#[0-9A-Fa-f]{6}$/;
+  const from = typeof rec.from === "string" && hex.test(rec.from) ? rec.from : null;
+  const to = typeof rec.to === "string" && hex.test(rec.to) ? rec.to : null;
+  if (!from || !to) return void 0;
+  const angleDeg = typeof rec.angleDeg === "number" && Number.isFinite(rec.angleDeg) ? (Math.round(rec.angleDeg) % 360 + 360) % 360 : void 0;
+  return angleDeg === void 0 ? { kind: "gradient", from, to } : { kind: "gradient", from, to, angleDeg };
+});
 var digitalConfigSchema = z.object({
   templateId: z.enum(["minimal", "bold", "card", "aurora", "classic", "spotlight", "marquee", "riso"]),
   accentColor: z.string().regex(/^#[0-9A-Fa-f]{6}$/),
@@ -783,7 +795,10 @@ var digitalConfigSchema = z.object({
   // none). Optional, so existing profiles/configs validate unchanged.
   ctaButtons: ctaButtonsSchema.optional(),
   tipJar: tipJarSchema.optional(),
-  booking: bookingSchema.optional()
+  booking: bookingSchema.optional(),
+  // NFCARD-641 — absent means solid `secondaryColor`, so every profile that
+  // exists today validates unchanged and no backfill is needed.
+  background: profileBackgroundSchema.optional()
 });
 var entrySourceSchema = z.object({
   output: z.enum(["with-card", "digital-only"]).optional(),
@@ -1031,6 +1046,7 @@ export {
   physicalConfigSchema,
   physicalContentOverridesSchema,
   profileAccessTokenCreateSchema,
+  profileBackgroundSchema,
   profileCreateSchema,
   profilePinVerifySchema,
   profileUpdateSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nfcard/validation",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "description": "Shared Zod validation schemas for the NFCard product family.",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
   ],
   "dependencies": {
     "zod": "^3.24.0",
-    "@nfcard/types": "0.16.0"
+    "@nfcard/types": "0.17.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0"

package/src/elements.test.ts

@@ -270,79 +270,79 @@ describe('per-element override fields survive validation (#1  P0 contract)', ()
     expect(a).toMatchObject({ rasterBgDataUrl: 'data:,bg', rasterAspect: 1.5 })
   })
 })
-
-// ── NFCARD-561: qr.mode makes "point to profile" data, not a string match ──
-//
-// The API used to detect it with a QR_PROFILE_TARGETS sentinel set
-// ('' / https://nfcard.hu / http://nfcard.hu). Any near-miss — a www. host, a
-// trailing path, a stale buyer-typed value — printed verbatim, and a printed
-// card cannot be corrected afterwards.
-
-describe('qr.mode (NFCARD-561)', () => {
-  it("accepts mode 'redirect' with NO url — the target is resolved at card creation", () => {
-    const res = cardDesignSchema.safeParse(
-      withElements([chipEl(), { ...qrEl(), url: undefined, mode: 'redirect' }]),
-    )
-    expect(res.success).toBe(true)
-  })
-
-  it("accepts mode 'redirect' with an empty-string url (the pre-561 free-layout spelling)", () => {
-    const res = cardDesignSchema.safeParse(
-      withElements([chipEl(), { ...qrEl(), url: '', mode: 'redirect' }]),
-    )
-    expect(res.success).toBe(true)
-  })
-
-  it("accepts mode 'raw' alongside a buyer-typed url", () => {
-    const res = cardDesignSchema.safeParse(
-      withElements([chipEl(), { ...qrEl(), url: 'https://acme.example/team', mode: 'raw' }]),
-    )
-    expect(res.success).toBe(true)
-  })
-
-  it('rejects an unknown mode', () => {
-    const res = cardDesignSchema.safeParse(
-      withElements([chipEl(), { ...qrEl(), mode: 'profile' }]),
-    )
-    expect(res.success).toBe(false)
-  })
-
-  it('still rejects a malformed url whatever the mode', () => {
-    const res = cardDesignSchema.safeParse(
-      withElements([chipEl(), { ...qrEl(), url: 'not-a-url', mode: 'raw' }]),
-    )
-    expect(codes(res)).toContain('invalidUrl')
-  })
-
-  it('a mode-less QR element still validates (pre-561 designs are untouched)', () => {
-    expect(cardDesignSchema.safeParse(withElements([chipEl(), qrEl()])).success).toBe(true)
-  })
-
-  it('carries mode through the legacy qr channel too', () => {
-    const parsed = cardDesignSchema.parse({
-      ...legacyDesign,
-      qr: { enabled: true, mode: 'redirect' },
-    }) as { qr: Record<string, unknown> }
-    expect(parsed.qr).toMatchObject({ enabled: true, mode: 'redirect' })
-  })
-})
-
-describe('printability — a redirect QR needs no url (NFCARD-561)', () => {
-  const at = (over = {}) =>
-    ({ ...qrEl(), transform: { xMm: 0, yMm: 0, rotationDeg: 0, scale: 1, z: 2 }, ...over }) as never
-
-  it("does not raise qrEmptyUrl for mode 'redirect' with no url", () => {
-    const codes = elementPrintability(at({ url: undefined, mode: 'redirect' })).map((v) => v.code)
-    expect(codes).not.toContain('qrEmptyUrl')
-  })
-
-  it("still raises qrEmptyUrl for mode 'raw' with no url", () => {
-    const codes = elementPrintability(at({ url: '', mode: 'raw' })).map((v) => v.code)
-    expect(codes).toContain('qrEmptyUrl')
-  })
-
-  it('still raises qrEmptyUrl for a mode-less QR with no url (legacy behaviour)', () => {
-    const codes = elementPrintability(at({ url: '' })).map((v) => v.code)
-    expect(codes).toContain('qrEmptyUrl')
-  })
-})
+
+// ── NFCARD-561: qr.mode makes "point to profile" data, not a string match ──
+//
+// The API used to detect it with a QR_PROFILE_TARGETS sentinel set
+// ('' / https://nfcard.hu / http://nfcard.hu). Any near-miss — a www. host, a
+// trailing path, a stale buyer-typed value — printed verbatim, and a printed
+// card cannot be corrected afterwards.
+
+describe('qr.mode (NFCARD-561)', () => {
+  it("accepts mode 'redirect' with NO url — the target is resolved at card creation", () => {
+    const res = cardDesignSchema.safeParse(
+      withElements([chipEl(), { ...qrEl(), url: undefined, mode: 'redirect' }]),
+    )
+    expect(res.success).toBe(true)
+  })
+
+  it("accepts mode 'redirect' with an empty-string url (the pre-561 free-layout spelling)", () => {
+    const res = cardDesignSchema.safeParse(
+      withElements([chipEl(), { ...qrEl(), url: '', mode: 'redirect' }]),
+    )
+    expect(res.success).toBe(true)
+  })
+
+  it("accepts mode 'raw' alongside a buyer-typed url", () => {
+    const res = cardDesignSchema.safeParse(
+      withElements([chipEl(), { ...qrEl(), url: 'https://acme.example/team', mode: 'raw' }]),
+    )
+    expect(res.success).toBe(true)
+  })
+
+  it('rejects an unknown mode', () => {
+    const res = cardDesignSchema.safeParse(
+      withElements([chipEl(), { ...qrEl(), mode: 'profile' }]),
+    )
+    expect(res.success).toBe(false)
+  })
+
+  it('still rejects a malformed url whatever the mode', () => {
+    const res = cardDesignSchema.safeParse(
+      withElements([chipEl(), { ...qrEl(), url: 'not-a-url', mode: 'raw' }]),
+    )
+    expect(codes(res)).toContain('invalidUrl')
+  })
+
+  it('a mode-less QR element still validates (pre-561 designs are untouched)', () => {
+    expect(cardDesignSchema.safeParse(withElements([chipEl(), qrEl()])).success).toBe(true)
+  })
+
+  it('carries mode through the legacy qr channel too', () => {
+    const parsed = cardDesignSchema.parse({
+      ...legacyDesign,
+      qr: { enabled: true, mode: 'redirect' },
+    }) as { qr: Record<string, unknown> }
+    expect(parsed.qr).toMatchObject({ enabled: true, mode: 'redirect' })
+  })
+})
+
+describe('printability — a redirect QR needs no url (NFCARD-561)', () => {
+  const at = (over = {}) =>
+    ({ ...qrEl(), transform: { xMm: 0, yMm: 0, rotationDeg: 0, scale: 1, z: 2 }, ...over }) as never
+
+  it("does not raise qrEmptyUrl for mode 'redirect' with no url", () => {
+    const codes = elementPrintability(at({ url: undefined, mode: 'redirect' })).map((v) => v.code)
+    expect(codes).not.toContain('qrEmptyUrl')
+  })
+
+  it("still raises qrEmptyUrl for mode 'raw' with no url", () => {
+    const codes = elementPrintability(at({ url: '', mode: 'raw' })).map((v) => v.code)
+    expect(codes).toContain('qrEmptyUrl')
+  })
+
+  it('still raises qrEmptyUrl for a mode-less QR with no url (legacy behaviour)', () => {
+    const codes = elementPrintability(at({ url: '' })).map((v) => v.code)
+    expect(codes).toContain('qrEmptyUrl')
+  })
+})

package/src/profileBackground.test.ts

@@ -0,0 +1,116 @@
+/**
+ * NFCARD-641 (564d/S4) Phase 1 — the profile background write gate.
+ *
+ * Lenient by design, like tipJar/booking/ctaButtons: a malformed background is
+ * dropped to `undefined` rather than 400-ing the whole profile save. The tests
+ * that matter are therefore the ones proving it drops rather than *mangles* —
+ * a half-applied gradient would render as a surprise nobody asked for.
+ */
+import { describe, expect, it } from 'vitest'
+import { digitalConfigSchema, profileBackgroundSchema } from './index'
+
+const base = {
+  templateId: 'classic' as const,
+  accentColor: '#F47B20',
+  fontKey: 'inter',
+  showAvatar: true,
+}
+
+describe('profileBackgroundSchema', () => {
+  it('accepts a solid background', () => {
+    expect(profileBackgroundSchema.parse({ kind: 'solid' })).toEqual({ kind: 'solid' })
+  })
+
+  it('accepts a two-stop gradient and keeps both stops', () => {
+    expect(
+      profileBackgroundSchema.parse({ kind: 'gradient', from: '#101820', to: '#F47B20' }),
+    ).toEqual({ kind: 'gradient', from: '#101820', to: '#F47B20' })
+  })
+
+  it('🔴 drops a HALF-valid gradient rather than inventing the missing stop', () => {
+    // Storing `{from}` with no `to` would render as a gradient to… something.
+    // Both stops or nothing.
+    expect(profileBackgroundSchema.parse({ kind: 'gradient', from: '#101820' })).toBeUndefined()
+    expect(profileBackgroundSchema.parse({ kind: 'gradient', to: '#101820' })).toBeUndefined()
+    expect(
+      profileBackgroundSchema.parse({ kind: 'gradient', from: '#101820', to: 'red' }),
+    ).toBeUndefined()
+    expect(
+      profileBackgroundSchema.parse({ kind: 'gradient', from: 'nothex', to: '#101820' }),
+    ).toBeUndefined()
+  })
+
+  it('🔴 rejects any non-hex stop — nothing user-typed reaches the CSS', () => {
+    for (const hostile of [
+      'red',
+      '#fff',
+      '#1018200',
+      'var(--brand)',
+      'url(javascript:alert(1))',
+      '#101820; background: url(x)',
+      'rgb(0,0,0)',
+    ]) {
+      expect(
+        profileBackgroundSchema.parse({ kind: 'gradient', from: hostile, to: '#101820' }),
+        hostile,
+      ).toBeUndefined()
+    }
+  })
+
+  it('normalises the angle into [0,360) so the render never defends against it', () => {
+    const at = (angleDeg: unknown) =>
+      profileBackgroundSchema.parse({ kind: 'gradient', from: '#101820', to: '#F47B20', angleDeg })
+    expect(at(160)).toMatchObject({ angleDeg: 160 })
+    expect(at(0)).toMatchObject({ angleDeg: 0 })
+    expect(at(-40)).toMatchObject({ angleDeg: 320 })
+    expect(at(400)).toMatchObject({ angleDeg: 40 })
+    expect(at(160.4)).toMatchObject({ angleDeg: 160 })
+    // Not a usable number → omit the key entirely and let the render default.
+    for (const bad of ['160', NaN, Infinity, null, {}]) {
+      expect(at(bad), String(bad)).not.toHaveProperty('angleDeg')
+    }
+  })
+
+  it('drops an unknown kind, and anything that is not an object', () => {
+    expect(profileBackgroundSchema.parse({ kind: 'image', url: 'https://x/y.png' })).toBeUndefined()
+    expect(profileBackgroundSchema.parse({ kind: 'gradient' })).toBeUndefined()
+    for (const v of [null, undefined, 'gradient', 42, []]) {
+      expect(profileBackgroundSchema.parse(v), String(v)).toBeUndefined()
+    }
+  })
+
+  it('does not yet accept an image — that is NFCARD-645', () => {
+    // Pinned deliberately: shipping the type without the sanitiser would be an
+    // unguarded URL on the render path.
+    expect(
+      profileBackgroundSchema.parse({ kind: 'image', url: 'https://cdn.example.com/a.jpg' }),
+    ).toBeUndefined()
+  })
+})
+
+describe('digitalConfigSchema × background', () => {
+  it('every profile that exists today still validates — background is optional', () => {
+    const parsed = digitalConfigSchema.parse(base)
+    expect(parsed.background).toBeUndefined()
+  })
+
+  it('carries a valid gradient through', () => {
+    const parsed = digitalConfigSchema.parse({
+      ...base,
+      background: { kind: 'gradient', from: '#101820', to: '#F47B20', angleDeg: 160 },
+    })
+    expect(parsed.background).toEqual({
+      kind: 'gradient',
+      from: '#101820',
+      to: '#F47B20',
+      angleDeg: 160,
+    })
+  })
+
+  it('a malformed background does not fail the whole save', () => {
+    // The lenient contract: the profile still saves, minus the background.
+    const parsed = digitalConfigSchema.parse({ ...base, background: { kind: 'gradient', from: 'x' } })
+    expect(parsed.background).toBeUndefined()
+    expect(parsed.templateId).toBe('classic')
+  })
+})