@nfcard/validation 0.19.0 → 0.20.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { z } from 'zod';
+import * as _nfcard_types from '@nfcard/types';
 import { CardAsset, CardElement, ElementTransform } from '@nfcard/types';
+import { z } from 'zod';
 
 /**
  * Manufacturing-printability envelope for the free-transform element layer
@@ -5181,6 +5182,15 @@ declare const ctaButtonsSchema: z.ZodEffects<z.ZodArray<z.ZodObject<{
     url?: string | undefined;
     label?: string | undefined;
 }[]>;
+declare const tipJarSchema: z.ZodEffects<z.ZodUnknown, {
+    provider: _nfcard_types.TipProviderId;
+    handle: string;
+    label: string;
+} | {
+    provider: _nfcard_types.TipProviderId;
+    handle: string;
+    label?: undefined;
+} | undefined, unknown>;
 declare const digitalConfigSchema: z.ZodObject<{
     templateId: z.ZodEnum<["minimal", "bold", "card", "aurora", "classic", "spotlight", "marquee", "riso"]>;
     accentColor: z.ZodString;
@@ -5268,6 +5278,15 @@ declare const digitalConfigSchema: z.ZodObject<{
         url?: string | undefined;
         label?: string | undefined;
     }[]>>;
+    tipJar: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+        provider: _nfcard_types.TipProviderId;
+        handle: string;
+        label: string;
+    } | {
+        provider: _nfcard_types.TipProviderId;
+        handle: string;
+        label?: undefined;
+    } | undefined, unknown>>;
 }, "strip", z.ZodTypeAny, {
     fontKey: string;
     templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -5303,6 +5322,15 @@ declare const digitalConfigSchema: z.ZodObject<{
         url: string;
         label: string;
     }[] | undefined;
+    tipJar?: {
+        provider: _nfcard_types.TipProviderId;
+        handle: string;
+        label: string;
+    } | {
+        provider: _nfcard_types.TipProviderId;
+        handle: string;
+        label?: undefined;
+    } | undefined;
 }, {
     fontKey: string;
     templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -5338,6 +5366,7 @@ declare const digitalConfigSchema: z.ZodObject<{
         url?: string | undefined;
         label?: string | undefined;
     }[] | undefined;
+    tipJar?: unknown;
 }>;
 declare const entrySourceSchema: z.ZodObject<{
     output: z.ZodOptional<z.ZodEnum<["with-card", "digital-only"]>>;
@@ -8831,6 +8860,15 @@ declare const configurationCreateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[]>>;
+        tipJar: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined, unknown>>;
     }, "strip", z.ZodTypeAny, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -8866,6 +8904,15 @@ declare const configurationCreateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     }, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -8901,6 +8948,7 @@ declare const configurationCreateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     }>;
     quantity: z.ZodDefault<z.ZodNumber>;
     existingProfileId: z.ZodOptional<z.ZodString>;
@@ -9285,6 +9333,15 @@ declare const configurationCreateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     };
     quantity: number;
     existingProfileId?: string | undefined;
@@ -9651,6 +9708,7 @@ declare const configurationCreateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     };
     quantity?: number | undefined;
     existingProfileId?: string | undefined;
@@ -13129,6 +13187,15 @@ declare const configurationUpdateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[]>>;
+        tipJar: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined, unknown>>;
     }, "strip", z.ZodTypeAny, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -13164,6 +13231,15 @@ declare const configurationUpdateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     }, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -13199,6 +13275,7 @@ declare const configurationUpdateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     }>>;
     quantity: z.ZodOptional<z.ZodNumber>;
     existingProfileId: z.ZodOptional<z.ZodString>;
@@ -13554,6 +13631,15 @@ declare const configurationUpdateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     } | undefined;
     quantity?: number | undefined;
     existingProfileId?: string | undefined;
@@ -13909,6 +13995,7 @@ declare const configurationUpdateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     } | undefined;
     quantity?: number | undefined;
     existingProfileId?: string | undefined;
@@ -14015,6 +14102,15 @@ declare const cardUpdateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[]>>>>;
+        tipJar: z.ZodOptional<z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | 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, {
@@ -14054,6 +14150,15 @@ declare const cardUpdateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     }, {
         profilePhotoUrl?: string | undefined;
         companyLogoUrl?: string | undefined;
@@ -14091,6 +14196,7 @@ declare const cardUpdateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     }>>;
     status: z.ZodOptional<z.ZodEnum<["active", "suspended", "archived"]>>;
 }, "strip", z.ZodTypeAny, {
@@ -14132,6 +14238,15 @@ declare const cardUpdateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     } | undefined;
 }, {
     status?: "active" | "suspended" | "archived" | undefined;
@@ -14172,6 +14287,7 @@ declare const cardUpdateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     } | undefined;
 }>;
 declare const adminCardCreateSchema: z.ZodObject<{
@@ -14351,6 +14467,15 @@ declare const adminCardCreateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[]>>;
+        tipJar: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined, unknown>>;
     }, "strip", z.ZodTypeAny, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -14386,6 +14511,15 @@ declare const adminCardCreateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     }, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -14421,6 +14555,7 @@ declare const adminCardCreateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     }>;
     physicalConfig: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodObject<{
         material: z.ZodEnum<["plastic", "3dprint_standard", "metal", "bamboo"]>;
@@ -17769,6 +17904,15 @@ declare const adminCardCreateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     };
     targetUserId: string;
     physicalConfig?: {
@@ -18122,6 +18266,7 @@ declare const adminCardCreateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     };
     targetUserId: string;
     physicalConfig?: {
@@ -18686,6 +18831,15 @@ declare const profileCreateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[]>>;
+        tipJar: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined, unknown>>;
     }, "strip", z.ZodTypeAny, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -18721,6 +18875,15 @@ declare const profileCreateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     }, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -18756,6 +18919,7 @@ declare const profileCreateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     }>;
     visibility: z.ZodDefault<z.ZodEnum<["public", "private", "link_only"]>>;
     accessPin: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
@@ -18820,6 +18984,15 @@ declare const profileCreateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     };
     label?: string | undefined;
     cardId?: string | undefined;
@@ -18885,6 +19058,7 @@ declare const profileCreateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     };
     label?: string | undefined;
     visibility?: "public" | "private" | "link_only" | undefined;
@@ -19077,6 +19251,15 @@ declare const signupWithProfileSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[]>>;
+        tipJar: z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined, unknown>>;
     }, "strip", z.ZodTypeAny, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -19112,6 +19295,15 @@ declare const signupWithProfileSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     }, {
         fontKey: string;
         templateId: "minimal" | "bold" | "card" | "aurora" | "classic" | "spotlight" | "marquee" | "riso";
@@ -19147,6 +19339,7 @@ declare const signupWithProfileSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     }>;
 }, "strip", z.ZodTypeAny, {
     email: string;
@@ -19209,6 +19402,15 @@ declare const signupWithProfileSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     };
     password: string;
     acceptedTerms: true;
@@ -19278,6 +19480,7 @@ declare const signupWithProfileSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     };
     password: string;
     acceptedTerms: true;
@@ -19466,6 +19669,15 @@ declare const profileUpdateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[]>>>>;
+        tipJar: z.ZodOptional<z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodUnknown, {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | 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, {
@@ -19505,6 +19717,15 @@ declare const profileUpdateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     }, {
         profilePhotoUrl?: string | undefined;
         companyLogoUrl?: string | undefined;
@@ -19542,6 +19763,7 @@ declare const profileUpdateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     }>>;
     visibility: z.ZodOptional<z.ZodEnum<["public", "private", "link_only"]>>;
     accessPin: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
@@ -19609,6 +19831,15 @@ declare const profileUpdateSchema: z.ZodObject<{
             url: string;
             label: string;
         }[] | undefined;
+        tipJar?: {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label: string;
+        } | {
+            provider: _nfcard_types.TipProviderId;
+            handle: string;
+            label?: undefined;
+        } | undefined;
     } | undefined;
     icon?: string | undefined;
     accessPin?: string | undefined;
@@ -19676,6 +19907,7 @@ declare const profileUpdateSchema: z.ZodObject<{
             url?: string | undefined;
             label?: string | undefined;
         }[] | undefined;
+        tipJar?: unknown;
     } | undefined;
     icon?: string | undefined;
     accessPin?: string | undefined;
@@ -19824,4 +20056,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, 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, sanitizeHttpUrl, sanitizeText, signupWithProfileSchema, socialLinksSchema, socialOverridesSchema, textAdvanceEm, 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, 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, sanitizeHttpUrl, sanitizeText, signupWithProfileSchema, socialLinksSchema, socialOverridesSchema, textAdvanceEm, tipJarSchema, userDataSchema, validateConfiguration, validateDigitalConfig, validatePhysicalConfig, validateUserData, webAddressSchema };

package/dist/index.js

@@ -1,5 +1,6 @@
 // src/index.ts
 import { z } from "zod";
+import { isTipProviderId, normalizeTipHandle } from "@nfcard/types";
 
 // src/printability.ts
 var CARD_W_MM = 85.6;
@@ -735,6 +736,15 @@ var ctaButtonSchema = z.object({
 var ctaButtonsSchema = z.array(ctaButtonSchema).max(50).transform(
   (arr) => arr.filter((b) => b.url !== "" && b.label !== "").slice(0, MAX_CTA_BUTTONS)
 );
+var tipJarSchema = z.unknown().transform((raw) => {
+  if (!raw || typeof raw !== "object") return void 0;
+  const rec = raw;
+  if (!isTipProviderId(rec.provider)) return void 0;
+  const handle = normalizeTipHandle(rec.provider, rec.handle);
+  if (!handle) return void 0;
+  const label = typeof rec.label === "string" ? sanitizeText(rec.label, 40) : "";
+  return label ? { provider: rec.provider, handle, label } : { provider: rec.provider, handle };
+});
 var digitalConfigSchema = z.object({
   templateId: z.enum(["minimal", "bold", "card", "aurora", "classic", "spotlight", "marquee", "riso"]),
   accentColor: z.string().regex(/^#[0-9A-Fa-f]{6}$/),
@@ -753,7 +763,8 @@ var digitalConfigSchema = z.object({
   // NFCARD-211 — Pro-only custom CTA buttons. Sanitised + capped here; the
   // public renderer additionally gates them on the owner's tier (free →
   // none). Optional, so existing profiles/configs validate unchanged.
-  ctaButtons: ctaButtonsSchema.optional()
+  ctaButtons: ctaButtonsSchema.optional(),
+  tipJar: tipJarSchema.optional()
 });
 var entrySourceSchema = z.object({
   output: z.enum(["with-card", "digital-only"]).optional(),
@@ -1011,6 +1022,7 @@ export {
   socialLinksSchema,
   socialOverridesSchema,
   textAdvanceEm,
+  tipJarSchema,
   userDataSchema,
   validateConfiguration,
   validateDigitalConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nfcard/validation",
-  "version": "0.19.0",
+  "version": "0.20.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.13.2"
+    "@nfcard/types": "0.14.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0"

package/src/tipJar.test.ts

@@ -0,0 +1,77 @@
+import { describe, expect, it } from 'vitest'
+import { tipJarSchema, digitalConfigSchema } from './index'
+
+const baseConfig = {
+  templateId: 'classic' as const,
+  accentColor: '#123456',
+  fontKey: 'inter',
+  showAvatar: true,
+}
+
+describe('tipJarSchema', () => {
+  it('accepts a valid provider + handle and stores only { provider, handle }', () => {
+    expect(tipJarSchema.parse({ provider: 'kofi', handle: 'ricsi' })).toEqual({
+      provider: 'kofi',
+      handle: 'ricsi',
+    })
+  })
+
+  it('normalizes a pasted full URL down to the handle', () => {
+    expect(tipJarSchema.parse({ provider: 'kofi', handle: 'https://ko-fi.com/ricsi?x=1' })).toEqual(
+      { provider: 'kofi', handle: 'ricsi' },
+    )
+  })
+
+  it('lowercases revolut handles', () => {
+    expect(tipJarSchema.parse({ provider: 'revolut', handle: 'RicSi' })).toEqual({
+      provider: 'revolut',
+      handle: 'ricsi',
+    })
+  })
+
+  it('keeps a sanitized custom label, capped at 40 chars', () => {
+    const out = tipJarSchema.parse({
+      provider: 'kofi',
+      handle: 'ricsi',
+      label: '<b>Támogass</b> ' + 'x'.repeat(60),
+    })
+    expect(out?.provider).toBe('kofi')
+    expect(out?.label).not.toContain('<')
+    expect((out?.label ?? '').length).toBeLessThanOrEqual(40)
+  })
+
+  it('drops everything invalid to undefined instead of throwing (never 400)', () => {
+    expect(tipJarSchema.parse(undefined)).toBeUndefined()
+    expect(tipJarSchema.parse(null)).toBeUndefined()
+    expect(tipJarSchema.parse('nonsense')).toBeUndefined()
+    expect(tipJarSchema.parse({})).toBeUndefined()
+    expect(tipJarSchema.parse({ provider: 'stripe', handle: 'ricsi' })).toBeUndefined()
+    expect(tipJarSchema.parse({ provider: 'kofi', handle: 'x' })).toBeUndefined() // too short
+    expect(tipJarSchema.parse({ provider: 'kofi', handle: 'https://evil.com/ricsi' })).toBeUndefined()
+    expect(tipJarSchema.parse({ provider: 'kofi', handle: 'javascript:alert(1)' })).toBeUndefined()
+    expect(tipJarSchema.parse({ provider: 'kofi', handle: 123 })).toBeUndefined()
+  })
+})
+
+describe('digitalConfigSchema — tipJar field', () => {
+  it('round-trips a valid tipJar', () => {
+    const parsed = digitalConfigSchema.parse({
+      ...baseConfig,
+      tipJar: { provider: 'revolut', handle: 'ricsi' },
+    })
+    expect(parsed.tipJar).toEqual({ provider: 'revolut', handle: 'ricsi' })
+  })
+
+  it('drops an invalid tipJar without failing the whole config save', () => {
+    const parsed = digitalConfigSchema.parse({
+      ...baseConfig,
+      tipJar: { provider: 'kofi', handle: 'https://evil.com/x' },
+    })
+    expect(parsed.tipJar).toBeUndefined()
+  })
+
+  it('is optional — a config without a tipJar parses fine', () => {
+    const parsed = digitalConfigSchema.parse(baseConfig)
+    expect(parsed.tipJar).toBeUndefined()
+  })
+})