@deallony/shared 1.2.80 → 1.2.82

package/dist/cjs/constants/events/EventBirthday.d.ts

@@ -0,0 +1,2 @@
+import { TYPES } from '../..';
+export declare const emptyEventBirthday: TYPES.EventBirthday.IEventBirthday;

package/dist/cjs/constants/events/EventBirthday.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyEventBirthday = void 0;
+exports.emptyEventBirthday = {
+    id: 0,
+    event_id: 0,
+    cover: null,
+    celebrant_name: null,
+    age: null,
+    host_name: null,
+    phone: null,
+};

package/dist/cjs/constants/events/EventCustomization.d.ts

@@ -40,6 +40,8 @@ export type EventCustomizationTrack = {
     };
     /** Path on the event site */
     src: string;
+    /** Event types the track is offered for */
+    event_types: string[];
 };
 /** Music the owner can pick; add a track here once its file is on the event site under /music */
 export declare const EventCustomizationTracks: EventCustomizationTrack[];
@@ -50,6 +52,7 @@ export declare const EventCustomizationSection: {
     readonly GALLERY: "gallery";
     readonly RSVP: "rsvp";
     readonly MUSIC: "music";
+    readonly DRESS_CODE: "dress_code";
 };
 export type EventCustomizationSectionKey = (typeof EventCustomizationSection)[keyof typeof EventCustomizationSection];
 export declare const EventCustomizationSectionOptions: {
@@ -60,10 +63,28 @@ export declare const EventCustomizationSectionOptions: {
     };
 }[];
 export declare const EVENT_CUSTOMIZATION_TEXT_MAX = 160;
+/** How the invitation opens for a guest; no value keeps the template's own opening */
+export declare const EventCustomizationOpening: {
+    readonly NONE: "none";
+    readonly ENVELOPE: "envelope";
+    readonly CURTAIN: "curtain";
+    readonly CARD: "card";
+};
+export type EventCustomizationOpeningValue = (typeof EventCustomizationOpening)[keyof typeof EventCustomizationOpening];
+export declare const EventCustomizationOpeningOptions: {
+    value: EventCustomizationOpeningValue;
+    name: {
+        en: string;
+        ar: string;
+    };
+}[];
 export declare const EventCustomizationPaletteValues: [string, ...string[]];
 export declare const EventCustomizationFontValues: [string, ...string[]];
 export declare const EventCustomizationTrackValues: [string, ...string[]];
 export declare const EventCustomizationSectionValues: [EventCustomizationSectionKey, ...EventCustomizationSectionKey[]];
+export declare const EventCustomizationOpeningValues: [EventCustomizationOpeningValue, ...EventCustomizationOpeningValue[]];
 export declare const findEventCustomizationPalette: (value: string | null | undefined) => EventCustomizationPalette | null;
 export declare const findEventCustomizationFont: (value: string | null | undefined) => EventCustomizationFont | null;
+/** Tracks offered for an event type; events without a type are weddings */
+export declare const eventCustomizationTracksFor: (eventType: string | null | undefined) => EventCustomizationTrack[];
 export declare const findEventCustomizationTrack: (value: string | null | undefined) => EventCustomizationTrack | null;

package/dist/cjs/constants/events/EventCustomization.js

@@ -4,7 +4,7 @@
  * Every field is optional: an empty value keeps the chosen template's own look.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findEventCustomizationTrack = exports.findEventCustomizationFont = exports.findEventCustomizationPalette = exports.EventCustomizationSectionValues = exports.EventCustomizationTrackValues = exports.EventCustomizationFontValues = exports.EventCustomizationPaletteValues = exports.EVENT_CUSTOMIZATION_TEXT_MAX = exports.EventCustomizationSectionOptions = exports.EventCustomizationSection = exports.EventCustomizationTracks = exports.EventCustomizationFonts = exports.EventCustomizationPalettes = void 0;
+exports.findEventCustomizationTrack = exports.eventCustomizationTracksFor = exports.findEventCustomizationFont = exports.findEventCustomizationPalette = exports.EventCustomizationOpeningValues = exports.EventCustomizationSectionValues = exports.EventCustomizationTrackValues = exports.EventCustomizationFontValues = exports.EventCustomizationPaletteValues = exports.EventCustomizationOpeningOptions = exports.EventCustomizationOpening = exports.EVENT_CUSTOMIZATION_TEXT_MAX = exports.EventCustomizationSectionOptions = exports.EventCustomizationSection = exports.EventCustomizationTracks = exports.EventCustomizationFonts = exports.EventCustomizationPalettes = void 0;
 exports.EventCustomizationPalettes = [
     { value: "night", name: { en: "Night", ar: "ليلي" }, background: "#0f0c18", surface: "#1b1628", text: "#efe8f6", accent: "#d6b36a", is_dark: true },
     { value: "ivory", name: { en: "Ivory", ar: "عاجي" }, background: "#fbf6ee", surface: "#ffffff", text: "#2a2118", accent: "#9c6b3c", is_dark: false },
@@ -20,7 +20,9 @@ exports.EventCustomizationFonts = [
 ];
 /** Music the owner can pick; add a track here once its file is on the event site under /music */
 exports.EventCustomizationTracks = [
-    { value: "wedding-theme", name: { en: "Wedding theme", ar: "لحن الزفاف" }, src: "/music/wedding-theme.mp3" },
+    { value: "wedding-theme", name: { en: "Wedding theme", ar: "لحن الزفاف" }, src: "/music/wedding-theme.mp3", event_types: ["wedding", "engagement", "marriage", "proposal", "valentine"] },
+    { value: "birthday-theme", name: { en: "Happy birthday", ar: "لحن عيد الميلاد" }, src: "/music/birthday-theme.mp3", event_types: ["birthday"] },
+    { value: "celebration-theme", name: { en: "Celebration", ar: "لحن الاحتفال" }, src: "/music/celebration-theme.mp3", event_types: ["bachelor", "newborn", "gender_reveal", "circumcision", "graduation", "hajj", "mothers_day", "valentine", "opening", "general", "proposal", "engagement", "marriage"] },
 ];
 exports.EventCustomizationSection = {
     COUNTDOWN: "countdown",
@@ -29,6 +31,7 @@ exports.EventCustomizationSection = {
     GALLERY: "gallery",
     RSVP: "rsvp",
     MUSIC: "music",
+    DRESS_CODE: "dress_code",
 };
 exports.EventCustomizationSectionOptions = [
     { value: "countdown", name: { en: "Countdown", ar: "العد التنازلي" } },
@@ -37,15 +40,33 @@ exports.EventCustomizationSectionOptions = [
     { value: "gallery", name: { en: "Photos", ar: "الصور" } },
     { value: "rsvp", name: { en: "RSVP", ar: "تأكيد الحضور" } },
     { value: "music", name: { en: "Music", ar: "الموسيقى" } },
+    { value: "dress_code", name: { en: "Dress code", ar: "اللباس المطلوب" } },
 ];
 exports.EVENT_CUSTOMIZATION_TEXT_MAX = 160;
+/** How the invitation opens for a guest; no value keeps the template's own opening */
+exports.EventCustomizationOpening = {
+    NONE: "none",
+    ENVELOPE: "envelope",
+    CURTAIN: "curtain",
+    CARD: "card",
+};
+exports.EventCustomizationOpeningOptions = [
+    { value: "none", name: { en: "None", ar: "بدون" } },
+    { value: "envelope", name: { en: "Envelope", ar: "ظرف" } },
+    { value: "curtain", name: { en: "Curtain", ar: "ستارة" } },
+    { value: "card", name: { en: "Card", ar: "بطاقة" } },
+];
 exports.EventCustomizationPaletteValues = exports.EventCustomizationPalettes.map((p) => p.value);
 exports.EventCustomizationFontValues = exports.EventCustomizationFonts.map((f) => f.value);
 exports.EventCustomizationTrackValues = exports.EventCustomizationTracks.map((t) => t.value);
 exports.EventCustomizationSectionValues = exports.EventCustomizationSectionOptions.map((s) => s.value);
+exports.EventCustomizationOpeningValues = exports.EventCustomizationOpeningOptions.map((o) => o.value);
 const findEventCustomizationPalette = (value) => { var _a; return (_a = exports.EventCustomizationPalettes.find((p) => p.value === value)) !== null && _a !== void 0 ? _a : null; };
 exports.findEventCustomizationPalette = findEventCustomizationPalette;
 const findEventCustomizationFont = (value) => { var _a; return (_a = exports.EventCustomizationFonts.find((f) => f.value === value)) !== null && _a !== void 0 ? _a : null; };
 exports.findEventCustomizationFont = findEventCustomizationFont;
+/** Tracks offered for an event type; events without a type are weddings */
+const eventCustomizationTracksFor = (eventType) => exports.EventCustomizationTracks.filter((t) => t.event_types.includes(eventType || "wedding"));
+exports.eventCustomizationTracksFor = eventCustomizationTracksFor;
 const findEventCustomizationTrack = (value) => { var _a; return (_a = exports.EventCustomizationTracks.find((t) => t.value === value)) !== null && _a !== void 0 ? _a : null; };
 exports.findEventCustomizationTrack = findEventCustomizationTrack;

package/dist/cjs/constants/events/EventDressCode.d.ts

@@ -0,0 +1,65 @@
+/** Optional dress code an event owner can show on the invitation (all event types) */
+export declare const EventDressCodeStyleValues: readonly ["formal", "evening", "semi_formal", "smart_casual", "traditional", "custom"];
+export type EventDressCodeStyle = (typeof EventDressCodeStyleValues)[number];
+export declare const EventDressCodeStyleOptions: {
+    value: EventDressCodeStyle;
+    name: {
+        en: string;
+        ar: string;
+    };
+}[];
+/** wear = colours guests are asked to wear, avoid = colours guests should not wear */
+export declare const EventDressCodeColorModeValues: readonly ["wear", "avoid"];
+export type EventDressCodeColorMode = (typeof EventDressCodeColorModeValues)[number];
+export declare const EventDressCodeColorModeNames: Record<EventDressCodeColorMode, {
+    en: string;
+    ar: string;
+}>;
+/** Heading shown on the invitation above the colour dots */
+export declare const EventDressCodeColorModeTitles: Record<EventDressCodeColorMode, {
+    en: string;
+    ar: string;
+}>;
+export declare const EventDressCodeColors: {
+    value: string;
+    hex: string;
+    name: {
+        en: string;
+        ar: string;
+    };
+}[];
+export declare const EventDressCodeColorValues: [string, ...string[]];
+/** @deprecated colours are no longer limited; kept for older imports */
+export declare const EVENT_DRESS_CODE_MAX_COLORS = 9;
+export declare const EVENT_DRESS_CODE_NOTE_MAX = 120;
+export declare const findEventDressCodeStyle: (value: string | null | undefined) => {
+    value: EventDressCodeStyle;
+    name: {
+        en: string;
+        ar: string;
+    };
+} | null;
+export declare const findEventDressCodeColor: (value: string | null | undefined) => {
+    value: string;
+    hex: string;
+    name: {
+        en: string;
+        ar: string;
+    };
+} | null;
+/** True when the owner filled at least one part of the dress code */
+export declare const hasEventDressCode: (dc: {
+    style?: string | null;
+    colors?: string[] | null;
+    avoid_colors?: string[] | null;
+    note?: string | null;
+} | null | undefined) => boolean;
+/** Wanted and avoided colours, reading old saves where color_mode "avoid" marked `colors` */
+export declare const eventDressCodeColorLists: (dc: {
+    colors?: string[] | null;
+    avoid_colors?: string[] | null;
+    color_mode?: string | null;
+} | null | undefined) => {
+    wear: string[];
+    avoid: string[];
+};

package/dist/cjs/constants/events/EventDressCode.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventDressCodeColorLists = exports.hasEventDressCode = exports.findEventDressCodeColor = exports.findEventDressCodeStyle = exports.EVENT_DRESS_CODE_NOTE_MAX = exports.EVENT_DRESS_CODE_MAX_COLORS = exports.EventDressCodeColorValues = exports.EventDressCodeColors = exports.EventDressCodeColorModeTitles = exports.EventDressCodeColorModeNames = exports.EventDressCodeColorModeValues = exports.EventDressCodeStyleOptions = exports.EventDressCodeStyleValues = void 0;
+/** Optional dress code an event owner can show on the invitation (all event types) */
+exports.EventDressCodeStyleValues = ["formal", "evening", "semi_formal", "smart_casual", "traditional", "custom"];
+exports.EventDressCodeStyleOptions = [
+    { value: "formal", name: { en: "Formal", ar: "رسمي" } },
+    { value: "evening", name: { en: "Evening wear", ar: "سهرة" } },
+    { value: "semi_formal", name: { en: "Semi-formal", ar: "شبه رسمي" } },
+    { value: "smart_casual", name: { en: "Smart casual", ar: "كاجوال أنيق" } },
+    { value: "traditional", name: { en: "Traditional", ar: "تقليدي" } },
+    { value: "custom", name: { en: "Custom text", ar: "نص خاص" } },
+];
+/** wear = colours guests are asked to wear, avoid = colours guests should not wear */
+exports.EventDressCodeColorModeValues = ["wear", "avoid"];
+exports.EventDressCodeColorModeNames = {
+    wear: { en: "Colours to wear", ar: "ألوان مرغوبة" },
+    avoid: { en: "Colours to avoid", ar: "ألوان يجب تجنبها" },
+};
+/** Heading shown on the invitation above the colour dots */
+exports.EventDressCodeColorModeTitles = {
+    wear: { en: "Suggested colours", ar: "ألوان مقترحة" },
+    avoid: { en: "Please avoid", ar: "نرجو تجنّب" },
+};
+exports.EventDressCodeColors = [
+    { value: "white", hex: "#FFFFFF", name: { en: "White", ar: "أبيض" } },
+    { value: "black", hex: "#000000", name: { en: "Black", ar: "أسود" } },
+    { value: "gold", hex: "#D4AF37", name: { en: "Gold", ar: "ذهبي" } },
+    { value: "beige", hex: "#C9C0B3", name: { en: "Beige", ar: "بيج" } },
+    { value: "navy", hex: "#1F3A5F", name: { en: "Navy", ar: "كحلي" } },
+    { value: "burgundy", hex: "#7A1F2B", name: { en: "Burgundy", ar: "عنابي" } },
+    { value: "sage", hex: "#B7C9A8", name: { en: "Light green", ar: "أخضر فاتح" } },
+    { value: "pink", hex: "#E8B4BC", name: { en: "Pink", ar: "وردي" } },
+    { value: "grey", hex: "#9AA5B1", name: { en: "Grey", ar: "رمادي" } },
+];
+exports.EventDressCodeColorValues = exports.EventDressCodeColors.map((c) => c.value);
+/** @deprecated colours are no longer limited; kept for older imports */
+exports.EVENT_DRESS_CODE_MAX_COLORS = 9;
+exports.EVENT_DRESS_CODE_NOTE_MAX = 120;
+const findEventDressCodeStyle = (value) => { var _a; return (_a = exports.EventDressCodeStyleOptions.find((s) => s.value === value)) !== null && _a !== void 0 ? _a : null; };
+exports.findEventDressCodeStyle = findEventDressCodeStyle;
+const findEventDressCodeColor = (value) => { var _a; return (_a = exports.EventDressCodeColors.find((c) => c.value === value)) !== null && _a !== void 0 ? _a : null; };
+exports.findEventDressCodeColor = findEventDressCodeColor;
+/** True when the owner filled at least one part of the dress code */
+const hasEventDressCode = (dc) => { var _a, _b, _c; return !!dc && (!!dc.style || !!((_a = dc.colors) === null || _a === void 0 ? void 0 : _a.length) || !!((_b = dc.avoid_colors) === null || _b === void 0 ? void 0 : _b.length) || !!((_c = dc.note) === null || _c === void 0 ? void 0 : _c.trim())); };
+exports.hasEventDressCode = hasEventDressCode;
+/** Wanted and avoided colours, reading old saves where color_mode "avoid" marked `colors` */
+const eventDressCodeColorLists = (dc) => {
+    var _a, _b, _c;
+    const legacyAvoid = (dc === null || dc === void 0 ? void 0 : dc.color_mode) === "avoid";
+    return {
+        wear: legacyAvoid ? [] : ((_a = dc === null || dc === void 0 ? void 0 : dc.colors) !== null && _a !== void 0 ? _a : []),
+        avoid: [...(legacyAvoid ? ((_b = dc === null || dc === void 0 ? void 0 : dc.colors) !== null && _b !== void 0 ? _b : []) : []), ...((_c = dc === null || dc === void 0 ? void 0 : dc.avoid_colors) !== null && _c !== void 0 ? _c : [])],
+    };
+};
+exports.eventDressCodeColorLists = eventDressCodeColorLists;

package/dist/cjs/constants/events/EventGuests.d.ts

@@ -0,0 +1,3 @@
+/** Limits of the expected guest count asked when creating an event */
+export declare const EVENT_EXPECTED_GUESTS_MIN = 1;
+export declare const EVENT_EXPECTED_GUESTS_MAX = 100000;

package/dist/cjs/constants/events/EventGuests.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVENT_EXPECTED_GUESTS_MAX = exports.EVENT_EXPECTED_GUESTS_MIN = void 0;
+/** Limits of the expected guest count asked when creating an event */
+exports.EVENT_EXPECTED_GUESTS_MIN = 1;
+exports.EVENT_EXPECTED_GUESTS_MAX = 100000;

package/dist/cjs/constants/events/EventHost.d.ts

@@ -0,0 +1,79 @@
+/**
+ * People of an event other than its creator: who they are (a slot of the event type),
+ * what they may do (role) and the permission map shared by the backend check and the app.
+ */
+type Text = {
+    en: string;
+    ar: string;
+};
+/** organiser: full control like the owner; guests: the event's guests only */
+export declare const EventHostRoleValues: readonly ["organiser", "guests"];
+export type EventHostRole = (typeof EventHostRoleValues)[number];
+export declare const EventHostRole: {
+    readonly ORGANISER: "organiser";
+    readonly GUESTS: "guests";
+};
+export declare const EventHostRoleNames: Record<EventHostRole, Text>;
+export declare const EventHostRoleHints: Record<EventHostRole, Text>;
+export declare const EventHostRoleOptions: {
+    value: "organiser" | "guests";
+    name: Text;
+    hint: Text;
+}[];
+/** pending: waiting for the person to sign in and accept; active: accepted */
+export declare const EventHostStatusValues: readonly ["pending", "active", "declined", "left", "removed"];
+export type EventHostStatus = (typeof EventHostStatusValues)[number];
+export declare const EventHostStatus: {
+    readonly PENDING: "pending";
+    readonly ACTIVE: "active";
+    readonly DECLINED: "declined";
+    readonly LEFT: "left";
+    readonly REMOVED: "removed";
+};
+export declare const EventHostStatusNames: Record<EventHostStatus, Text>;
+/** Statuses that still hold the number on the event (one row per number) */
+export declare const EventHostOpenStatusValues: EventHostStatus[];
+/** What the signed-in user is on an event */
+export declare const EventAccessRoleValues: readonly ["owner", "organiser", "guests"];
+export type EventAccessRole = (typeof EventAccessRoleValues)[number];
+export declare const EventPermissionValues: readonly ["event.view", "event.edit", "event.publish", "event.delete", "guests.manage", "hosts.manage"];
+export type EventPermission = (typeof EventPermissionValues)[number];
+export declare const EventRolePermissions: Record<EventAccessRole, readonly EventPermission[]>;
+export declare const hasEventPermission: (role: EventAccessRole | null | undefined, permission: EventPermission) => boolean;
+export declare const EventAccessRoleNames: Record<EventAccessRole, Text>;
+/** Old single-number fields a slot is kept in sync with */
+export type EventPeopleSlotMirror = "wedding.bride_phone" | "wedding.groom_phone" | "occasion.phone";
+/** A suggested person of an event type: one optional phone field in the form */
+export type EventPeopleSlot = {
+    key: string;
+    label: Text;
+    /** Role they get unless the owner changes it */
+    role: EventHostRole;
+    /** The existing form field that already holds this number */
+    mirrors?: EventPeopleSlotMirror;
+    /** Hidden from them until the event ends when the type's details.surprise is "yes" */
+    surprise_when_details_surprise?: boolean;
+};
+/**
+ * Suggested people of each event type. The person the event is for manages guests;
+ * whoever organises or invites gets full control. Anyone else is added by hand.
+ */
+export declare const EventPeopleSlots: Record<string, EventPeopleSlot[]>;
+/** Suggested people of a type (a type without its own list gets the organiser only) */
+export declare const findEventPeopleSlots: (eventType: string | null | undefined) => EventPeopleSlot[];
+export declare const findEventPeopleSlot: (eventType: string | null | undefined, key: string | null | undefined) => EventPeopleSlot | undefined;
+/** Answers to «من أنت في هذه المناسبة؟» besides the type's slots */
+export declare const EventCreatorRoleExtra: {
+    readonly COMPANY: "company";
+    readonly OTHER: "other";
+};
+export declare const EventCreatorRoleExtraNames: Record<(typeof EventCreatorRoleExtra)[keyof typeof EventCreatorRoleExtra], Text>;
+/** Label of the person a host row (or the creator) is: slot label, or the free text */
+export declare const eventPersonLabel: (eventType: string | null | undefined, slotKey: string | null | undefined, fallback?: string | null) => Text | null;
+export declare const EVENT_HOST_LABEL_MAX = 60;
+/**
+ * One spelling for a phone number so numbers typed differently still match:
+ * digits only with a leading +, 00 → +, and no 0 right after a known country code.
+ */
+export declare const normalizeEventPhone: (value: string | null | undefined) => string | null;
+export {};

package/dist/cjs/constants/events/EventHost.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeEventPhone = exports.EVENT_HOST_LABEL_MAX = exports.eventPersonLabel = exports.EventCreatorRoleExtraNames = exports.EventCreatorRoleExtra = exports.findEventPeopleSlot = exports.findEventPeopleSlots = exports.EventPeopleSlots = exports.EventAccessRoleNames = exports.hasEventPermission = exports.EventRolePermissions = exports.EventPermissionValues = exports.EventAccessRoleValues = exports.EventHostOpenStatusValues = exports.EventHostStatusNames = exports.EventHostStatus = exports.EventHostStatusValues = exports.EventHostRoleOptions = exports.EventHostRoleHints = exports.EventHostRoleNames = exports.EventHostRole = exports.EventHostRoleValues = void 0;
+/** organiser: full control like the owner; guests: the event's guests only */
+exports.EventHostRoleValues = ["organiser", "guests"];
+exports.EventHostRole = {
+    ORGANISER: "organiser",
+    GUESTS: "guests",
+};
+exports.EventHostRoleNames = {
+    organiser: { ar: "منظم", en: "Organiser" },
+    guests: { ar: "إدارة المدعوين", en: "Manages guests" },
+};
+exports.EventHostRoleHints = {
+    organiser: { ar: "يدير المناسبة كاملة", en: "Manages the whole event" },
+    guests: { ar: "يدير المدعوين ويرسل الدعوات ويتابع الردود", en: "Manages guests, sends invitations and follows replies" },
+};
+exports.EventHostRoleOptions = exports.EventHostRoleValues.map((value) => ({
+    value,
+    name: exports.EventHostRoleNames[value],
+    hint: exports.EventHostRoleHints[value],
+}));
+/** pending: waiting for the person to sign in and accept; active: accepted */
+exports.EventHostStatusValues = ["pending", "active", "declined", "left", "removed"];
+exports.EventHostStatus = {
+    PENDING: "pending",
+    ACTIVE: "active",
+    DECLINED: "declined",
+    LEFT: "left",
+    REMOVED: "removed",
+};
+exports.EventHostStatusNames = {
+    pending: { ar: "بانتظار القبول", en: "Waiting to accept" },
+    active: { ar: "انضم", en: "Joined" },
+    declined: { ar: "رفض", en: "Declined" },
+    left: { ar: "غادر", en: "Left" },
+    removed: { ar: "أزيل", en: "Removed" },
+};
+/** Statuses that still hold the number on the event (one row per number) */
+exports.EventHostOpenStatusValues = ["pending", "active"];
+/** What the signed-in user is on an event */
+exports.EventAccessRoleValues = ["owner", "organiser", "guests"];
+exports.EventPermissionValues = [
+    /** See the event (drafts included) and its invitation link */
+    "event.view",
+    /** Details, names, date, timeline, dress code, design, photos, visibility, preview */
+    "event.edit",
+    /** Publish (pay), unpublish */
+    "event.publish",
+    "event.delete",
+    /** Guests: add, edit, remove, send links, read status, replies, check-in, guest reports */
+    "guests.manage",
+    /** Add/remove people of the event and change their role */
+    "hosts.manage",
+];
+exports.EventRolePermissions = {
+    owner: exports.EventPermissionValues,
+    organiser: exports.EventPermissionValues,
+    guests: ["event.view", "guests.manage"],
+};
+const hasEventPermission = (role, permission) => !!role && exports.EventRolePermissions[role].includes(permission);
+exports.hasEventPermission = hasEventPermission;
+exports.EventAccessRoleNames = {
+    owner: { ar: "المالك", en: "Owner" },
+    organiser: exports.EventHostRoleNames.organiser,
+    guests: exports.EventHostRoleNames.guests,
+};
+const slot = (key, ar, en, role, extra = {}) => ({ key, label: { ar, en }, role, ...extra });
+const organiser = (ar = "المنظم", en = "Organiser") => slot("organiser", ar, en, "organiser", { mirrors: "occasion.phone" });
+const weddingPeople = [
+    slot("bride", "العروس", "Bride", "guests", { mirrors: "wedding.bride_phone" }),
+    slot("groom", "العريس", "Groom", "guests", { mirrors: "wedding.groom_phone" }),
+    slot("organiser", "المنظم", "Organiser", "organiser"),
+];
+/**
+ * Suggested people of each event type. The person the event is for manages guests;
+ * whoever organises or invites gets full control. Anyone else is added by hand.
+ */
+exports.EventPeopleSlots = {
+    wedding: weddingPeople,
+    engagement: weddingPeople,
+    marriage: weddingPeople,
+    proposal: [
+        slot("proposer", "من سيطلب", "Who is proposing", "organiser"),
+        slot("partner", "الشريك", "Partner", "guests", { surprise_when_details_surprise: true }),
+        organiser(),
+    ],
+    bachelor: [slot("celebrant", "العروس أو العريس", "Bride or groom", "guests"), organiser()],
+    birthday: [slot("celebrant", "صاحب عيد الميلاد", "Birthday person", "guests"), organiser("من يدعو", "Who is inviting")],
+    newborn: [slot("mother", "الأم", "Mother", "organiser", { mirrors: "occasion.phone" }), slot("father", "الأب", "Father", "organiser")],
+    gender_reveal: [slot("mother", "الأم", "Mother", "organiser", { mirrors: "occasion.phone" }), slot("father", "الأب", "Father", "organiser")],
+    circumcision: [slot("mother", "الأم", "Mother", "organiser", { mirrors: "occasion.phone" }), slot("father", "الأب", "Father", "organiser")],
+    graduation: [slot("graduate", "الخريج", "Graduate", "guests"), organiser("من يدعو", "Who is inviting")],
+    hajj: [
+        slot("pilgrim", "الحاج أو الحاجة", "Pilgrim", "guests"),
+        slot("pilgrim2", "الحاج الثاني", "Second pilgrim", "guests"),
+        organiser("من يدعو", "Who is inviting"),
+    ],
+    mothers_day: [slot("mother", "الأم", "Mother", "guests"), organiser("من يدعو", "Who is inviting")],
+    valentine: [
+        slot("first", "الشخص الأول", "First person", "guests"),
+        slot("second", "الشخص الثاني", "Second person", "guests"),
+        organiser("من يدعو", "Who is inviting"),
+    ],
+    opening: [slot("shop_owner", "صاحب المحل", "Business owner", "organiser", { mirrors: "occasion.phone" })],
+    general: [organiser()],
+};
+const DEFAULT_PEOPLE = [organiser()];
+/** Suggested people of a type (a type without its own list gets the organiser only) */
+const findEventPeopleSlots = (eventType) => (eventType && exports.EventPeopleSlots[eventType]) || DEFAULT_PEOPLE;
+exports.findEventPeopleSlots = findEventPeopleSlots;
+const findEventPeopleSlot = (eventType, key) => key ? (0, exports.findEventPeopleSlots)(eventType).find((s) => s.key === key) : undefined;
+exports.findEventPeopleSlot = findEventPeopleSlot;
+/** Answers to «من أنت في هذه المناسبة؟» besides the type's slots */
+exports.EventCreatorRoleExtra = {
+    COMPANY: "company",
+    OTHER: "other",
+};
+exports.EventCreatorRoleExtraNames = {
+    company: { ar: "شركة", en: "A company" },
+    other: { ar: "شخص آخر", en: "Someone else" },
+};
+/** Label of the person a host row (or the creator) is: slot label, or the free text */
+const eventPersonLabel = (eventType, slotKey, fallback) => {
+    const s = (0, exports.findEventPeopleSlot)(eventType, slotKey);
+    if (s)
+        return s.label;
+    if (slotKey === "company" || slotKey === "other")
+        return exports.EventCreatorRoleExtraNames[slotKey];
+    return fallback ? { ar: fallback, en: fallback } : null;
+};
+exports.eventPersonLabel = eventPersonLabel;
+exports.EVENT_HOST_LABEL_MAX = 60;
+/**
+ * One spelling for a phone number so numbers typed differently still match:
+ * digits only with a leading +, 00 → +, and no 0 right after a known country code.
+ */
+const normalizeEventPhone = (value) => {
+    if (!value)
+        return null;
+    let digits = String(value).trim().replace(/[^\d+]/g, "");
+    if (digits.startsWith("00"))
+        digits = "+" + digits.slice(2);
+    if (!digits.startsWith("+"))
+        digits = "+" + digits.replace(/\+/g, "");
+    digits = "+" + digits.slice(1).replace(/\+/g, "");
+    for (const code of ["+963", "+971", "+965", "+961", "+90", "+966", "+962", "+974"]) {
+        if (digits.startsWith(code + "0")) {
+            digits = code + digits.slice(code.length + 1);
+            break;
+        }
+    }
+    return digits.length > 4 ? digits : null;
+};
+exports.normalizeEventPhone = normalizeEventPhone;

package/dist/cjs/constants/events/EventOccasion.d.ts

@@ -0,0 +1,63 @@
+import type { IEventOccasion } from "../../types/events/EventOccasion";
+type Text = {
+    en: string;
+    ar: string;
+};
+/** Where a field is saved: a column of event.occasion, or a key inside its `details` */
+export type EventOccasionFieldKey = "primary_name" | "secondary_name" | "host_name" | `details.${string}`;
+export type EventOccasionField = {
+    key: EventOccasionFieldKey;
+    label: Text;
+    /** text (default), multiline, number, date (YYYY-MM-DD) or choice */
+    input?: "text" | "multiline" | "number" | "date" | "choice";
+    required?: boolean;
+    hint?: Text;
+    placeholder?: Text;
+    options?: {
+        value: string;
+        label: Text;
+    }[];
+    min?: number;
+    max?: number;
+};
+/** Form and wording of an occasion type (every type whose details live in event.occasion) */
+export type EventOccasionTypeConfig = {
+    type: string;
+    /** Short line on the type card */
+    description: Text;
+    /** Name fields first, then the type's own details */
+    fields: EventOccasionField[];
+    /** Title in lists and page titles; {name} is primary_name (or its fallback) */
+    title: Text;
+    /** Used for {name} while primary_name is empty */
+    name_fallback: Text;
+    /** First line of the invitation; {host} is host_name */
+    invite_line: {
+        with_host: Text;
+        without_host: Text;
+    };
+    /** Default welcome text under the name */
+    welcome: Text;
+    /** Default text above the RSVP form */
+    rsvp: Text;
+    /** New events of this type are public (listed, indexed) unless the owner changes it */
+    default_public?: boolean;
+};
+export declare const EVENT_OCCASION_TEXT_MAX = 255;
+export declare const EVENT_OCCASION_LONG_TEXT_MAX = 500;
+export declare const EVENT_BIRTHDAY_AGE_LIMIT = 120;
+export declare const EventOccasionTypeConfigs: Record<string, EventOccasionTypeConfig>;
+export declare const findEventOccasionConfig: (eventType: string | null | undefined) => EventOccasionTypeConfig | null;
+/** Value of a field (column or details key) */
+export declare const eventOccasionFieldValue: (occasion: Partial<IEventOccasion> | null | undefined, key: EventOccasionFieldKey) => unknown;
+/** «تخرج أحمد», «افتتاح بن الشام» */
+export declare const eventOccasionTitle: (eventType: string | null | undefined, occasion: Partial<IEventOccasion> | null | undefined, lang?: "ar" | "en") => string;
+/** First line of the invitation, e.g. «عائلة أحمد يدعونكم لحفل تخرج» */
+export declare const eventOccasionInviteLine: (eventType: string | null | undefined, occasion: Partial<IEventOccasion> | null | undefined, lang?: "ar" | "en") => string;
+/** Answer keys a guest can send with an RSVP */
+export declare const EventRsvpAnswerKeys: {
+    /** Gender reveal guess: boy | girl */
+    readonly GENDER_GUESS: "gender_guess";
+};
+export declare const emptyEventOccasion: IEventOccasion;
+export {};