@deallony/shared 1.2.81 → 1.2.82

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/index.d.ts

@@ -13,3 +13,5 @@ export * from "./EventVisibility";
 export * from "./EventWeddingReligion";
 export * from "./EventTextPolicy";
 export * from "./EventDressCode";
+export * from "./EventHost";
+export * from "./EventGuests";

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

@@ -29,3 +29,5 @@ __exportStar(require("./EventVisibility"), exports);
 __exportStar(require("./EventWeddingReligion"), exports);
 __exportStar(require("./EventTextPolicy"), exports);
 __exportStar(require("./EventDressCode"), exports);
+__exportStar(require("./EventHost"), exports);
+__exportStar(require("./EventGuests"), exports);

package/dist/cjs/constants/routes/app.d.ts

@@ -513,6 +513,13 @@ export declare const APP_ROUTES: {
                 id: string | number;
             };
         };
+        /** People of the event (owner, organisers, guest managers) */
+        readonly hosts: (id: number | string) => {
+            pathname: string;
+            params: {
+                id: string | number;
+            };
+        };
     };
 };
 export type SharedAppRoutes = typeof APP_ROUTES;

package/dist/cjs/constants/routes/app.js

@@ -211,5 +211,7 @@ exports.APP_ROUTES = {
         publish: (id) => ({ pathname: "/event/publish/[id]", params: { id } }),
         edit: (id) => ({ pathname: "/event/new", params: { id } }),
         details: (id) => ({ pathname: "/event/details/[id]", params: { id } }),
+        /** People of the event (owner, organisers, guest managers) */
+        hosts: (id) => ({ pathname: "/event/hosts/[id]", params: { id } }),
     },
 };

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

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+import { addEventHostSchema, eventHostIdSchema, eventHostsListSchema, eventPersonInputSchema, updateEventHostSchema } from '../../schema/events/EventHost.schema';
+export type EventPersonInputDto = z.infer<typeof eventPersonInputSchema>;
+export type AddEventHostDto = z.infer<typeof addEventHostSchema>;
+export type UpdateEventHostDto = z.infer<typeof updateEventHostSchema>;
+export type EventHostIdDto = z.infer<typeof eventHostIdSchema>;
+export type EventHostsListDto = z.infer<typeof eventHostsListSchema>;

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/dto/events/index.d.ts

@@ -5,3 +5,4 @@ export * from './EventWedding.dto';
 export * from './EventBirthday.dto';
 export * from './EventOccasion.dto';
 export * from './EventVenue.dto';
+export * from './EventHost.dto';

package/dist/cjs/dto/events/index.js

@@ -21,3 +21,4 @@ __exportStar(require("./EventWedding.dto"), exports);
 __exportStar(require("./EventBirthday.dto"), exports);
 __exportStar(require("./EventOccasion.dto"), exports);
 __exportStar(require("./EventVenue.dto"), exports);
+__exportStar(require("./EventHost.dto"), exports);

package/dist/cjs/schema/communication/ai-conversation.schema.d.ts

@@ -173,9 +173,9 @@ export declare const AiApprovalSettingsSchema: z.ZodObject<{
  * outdated: the customer wrote again, so a newer draft replaced it. failed: approved but WhatsApp refused it.
  */
 export declare const AiDraftStatusSchema: z.ZodEnum<{
+    pending: "pending";
     scheduled: "scheduled";
     failed: "failed";
-    pending: "pending";
     sent: "sent";
     rejected: "rejected";
     outdated: "outdated";
@@ -190,9 +190,9 @@ export declare const AiDraftListSchema: z.ZodObject<{
     page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        pending: "pending";
         scheduled: "scheduled";
         failed: "failed";
-        pending: "pending";
         sent: "sent";
         rejected: "rejected";
         outdated: "outdated";

package/dist/cjs/schema/communication/offer.schema.d.ts

@@ -1,9 +1,9 @@
 import { z } from "zod";
 export declare const offerStatusSchema: z.ZodEnum<{
     pending: "pending";
+    declined: "declined";
     accepted: "accepted";
     countered: "countered";
-    declined: "declined";
 }>;
 /** PRICE_OFFER payload. Replies (accept, counter, decline) point at the offer they answer. */
 export declare const priceOfferPayloadSchema: z.ZodObject<{
@@ -17,9 +17,9 @@ export declare const priceOfferPayloadSchema: z.ZodObject<{
     }, z.core.$strip>;
     status: z.ZodOptional<z.ZodEnum<{
         pending: "pending";
+        declined: "declined";
         accepted: "accepted";
         countered: "countered";
-        declined: "declined";
     }>>;
     reply_to_message_id: z.ZodNullable<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
     note: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -36,9 +36,9 @@ export declare const rentOfferPayloadSchema: z.ZodObject<{
     }, z.core.$strip>;
     status: z.ZodOptional<z.ZodEnum<{
         pending: "pending";
+        declined: "declined";
         accepted: "accepted";
         countered: "countered";
-        declined: "declined";
     }>>;
     reply_to_message_id: z.ZodNullable<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
     note: z.ZodNullable<z.ZodOptional<z.ZodString>>;

package/dist/cjs/schema/events/Event.schema.d.ts

@@ -109,6 +109,7 @@ export declare const eventBaseSchema: z.ZodObject<{
     venue_id: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
     venue_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     location_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expected_guests: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
     invitation_scan_type: z.ZodOptional<z.ZodEnum<{
         none: "none";
         qrcode: "qrcode";
@@ -168,6 +169,13 @@ export declare const eventBaseSchema: z.ZodObject<{
         private: "private";
         public: "public";
     }>>;
+    creator_role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    people: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slot: z.ZodString;
+        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+        surprise: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const createEventSchema: z.ZodObject<{
     lat: z.ZodNullable<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
@@ -229,6 +237,7 @@ export declare const createEventSchema: z.ZodObject<{
     venue_id: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
     venue_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     location_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expected_guests: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
     invitation_scan_type: z.ZodOptional<z.ZodEnum<{
         none: "none";
         qrcode: "qrcode";
@@ -288,6 +297,13 @@ export declare const createEventSchema: z.ZodObject<{
         private: "private";
         public: "public";
     }>>;
+    creator_role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    people: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slot: z.ZodString;
+        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+        surprise: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const updateEventSchema: z.ZodObject<{
     lat: z.ZodNullable<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
@@ -349,6 +365,7 @@ export declare const updateEventSchema: z.ZodObject<{
     venue_id: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
     venue_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     location_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expected_guests: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
     invitation_scan_type: z.ZodOptional<z.ZodEnum<{
         none: "none";
         qrcode: "qrcode";
@@ -408,6 +425,13 @@ export declare const updateEventSchema: z.ZodObject<{
         private: "private";
         public: "public";
     }>>;
+    creator_role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    people: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slot: z.ZodString;
+        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+        surprise: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
     id: z.ZodCoercedNumber<unknown>;
 }, z.core.$strip>;
 export declare const saveEventSchema: z.ZodObject<{
@@ -470,6 +494,7 @@ export declare const saveEventSchema: z.ZodObject<{
     venue_id: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
     venue_name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     location_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expected_guests: z.ZodOptional<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
     invitation_scan_type: z.ZodOptional<z.ZodEnum<{
         none: "none";
         qrcode: "qrcode";
@@ -529,6 +554,13 @@ export declare const saveEventSchema: z.ZodObject<{
         private: "private";
         public: "public";
     }>>;
+    creator_role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    people: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slot: z.ZodString;
+        phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+        surprise: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
     id: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
 export declare const publishEventSchema: z.ZodObject<{

package/dist/cjs/schema/events/Event.schema.js

@@ -6,6 +6,7 @@ const EventTimeline_schema_1 = require("./EventTimeline.schema");
 const EventWedding_schema_1 = require("./EventWedding.schema");
 const EventBirthday_schema_1 = require("./EventBirthday.schema");
 const EventOccasion_schema_1 = require("./EventOccasion.schema");
+const EventHost_schema_1 = require("./EventHost.schema");
 const events_1 = require("../../constants/events");
 const EventTextPolicy_1 = require("../../constants/events/EventTextPolicy");
 const customizationText = zod_1.z
@@ -71,10 +72,16 @@ exports.eventBaseSchema = zod_1.z.object({
     venue_id: zod_1.z.coerce.number().int().positive().nullable().optional(),
     venue_name: zod_1.z.string().trim().max(255).nullable().optional(),
     location_label: zod_1.z.string().trim().nullable().optional(),
+    /** Expected number of guests; the app asks for it on every new event (old events may have none) */
+    expected_guests: zod_1.z.coerce.number().int().min(events_1.EVENT_EXPECTED_GUESTS_MIN).max(events_1.EVENT_EXPECTED_GUESTS_MAX).nullable().optional(),
     invitation_scan_type: zod_1.z.enum(events_1.EventInvitationScanTypeValues).optional(),
     customization: exports.eventCustomizationSchema.nullable().optional(),
     dress_code: exports.eventDressCodeSchema.nullable().optional(),
     visibility: zod_1.z.enum(events_1.EventVisibilityValues).optional(),
+    /** «من أنت في هذه المناسبة؟»: a slot key of the type, "company" or "other" */
+    creator_role: zod_1.z.string().trim().max(40).nullable().optional(),
+    /** Suggested people of the type (CONSTANTS.EVENTS.EventPeopleSlots) without their own field */
+    people: zod_1.z.array(EventHost_schema_1.eventPersonInputSchema).max(20).optional(),
 });
 exports.createEventSchema = exports.eventBaseSchema;
 exports.updateEventSchema = exports.eventBaseSchema.extend({

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

@@ -0,0 +1,36 @@
+import { z } from "zod";
+/** One suggested person in the create/edit form; an empty phone removes them */
+export declare const eventPersonInputSchema: z.ZodObject<{
+    slot: z.ZodString;
+    phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+    surprise: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Add someone to an event by hand */
+export declare const addEventHostSchema: z.ZodObject<{
+    event_id: z.ZodCoercedNumber<unknown>;
+    phone: z.ZodString;
+    role: z.ZodEnum<{
+        organiser: "organiser";
+        guests: "guests";
+    }>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+    surprise: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const updateEventHostSchema: z.ZodObject<{
+    host_id: z.ZodCoercedNumber<unknown>;
+    role: z.ZodOptional<z.ZodEnum<{
+        organiser: "organiser";
+        guests: "guests";
+    }>>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>>>;
+    surprise: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const eventHostIdSchema: z.ZodObject<{
+    host_id: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+export declare const eventHostsListSchema: z.ZodObject<{
+    event_id: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;

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

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventHostsListSchema = exports.eventHostIdSchema = exports.updateEventHostSchema = exports.addEventHostSchema = exports.eventPersonInputSchema = void 0;
+const zod_1 = require("zod");
+const Phone_schema_1 = require("../common/Phone.schema");
+const EventHost_1 = require("../../constants/events/EventHost");
+const hostName = zod_1.z
+    .string()
+    .trim()
+    .max(EventHost_1.EVENT_HOST_LABEL_MAX)
+    .transform((v) => (v.length ? v : null))
+    .nullable()
+    .optional();
+/** One suggested person in the create/edit form; an empty phone removes them */
+exports.eventPersonInputSchema = zod_1.z.object({
+    slot: zod_1.z.string().trim().min(1).max(40),
+    phone: Phone_schema_1.internationalPhoneSchema.nullable().optional(),
+    name: hostName,
+    /** Don't tell them or give access before the event ends */
+    surprise: zod_1.z.boolean().optional(),
+});
+/** Add someone to an event by hand */
+exports.addEventHostSchema = zod_1.z.object({
+    event_id: zod_1.z.coerce.number().int().positive(),
+    phone: Phone_schema_1.internationalPhoneSchema,
+    role: zod_1.z.enum(EventHost_1.EventHostRoleValues),
+    /** e.g. «أم العروس» */
+    label: hostName,
+    name: hostName,
+    surprise: zod_1.z.boolean().optional(),
+});
+exports.updateEventHostSchema = zod_1.z.object({
+    host_id: zod_1.z.coerce.number().int().positive(),
+    role: zod_1.z.enum(EventHost_1.EventHostRoleValues).optional(),
+    label: hostName,
+    name: hostName,
+    surprise: zod_1.z.boolean().optional(),
+});
+exports.eventHostIdSchema = zod_1.z.object({
+    host_id: zod_1.z.coerce.number().int().positive(),
+});
+exports.eventHostsListSchema = zod_1.z.object({
+    event_id: zod_1.z.coerce.number().int().positive(),
+});

package/dist/cjs/schema/events/index.d.ts

@@ -6,3 +6,4 @@ export * from "./EventBirthday.schema";
 export * from "./EventOccasion.schema";
 export * from "./EventVenue.schema";
 export { internationalPhoneSchema } from "../common/Phone.schema";
+export * from "./EventHost.schema";

package/dist/cjs/schema/events/index.js

@@ -24,3 +24,4 @@ __exportStar(require("./EventOccasion.schema"), exports);
 __exportStar(require("./EventVenue.schema"), exports);
 var Phone_schema_1 = require("../common/Phone.schema");
 Object.defineProperty(exports, "internationalPhoneSchema", { enumerable: true, get: function () { return Phone_schema_1.internationalPhoneSchema; } });
+__exportStar(require("./EventHost.schema"), exports);

package/dist/cjs/types/communication/Notification.d.ts

@@ -17,6 +17,12 @@ export declare enum NotificationTypeEnum {
     DEALLONY_NEWS = "deallony_news",
     /** A guest opened their personal invitation or replied to it */
     EVENT_GUESTS = "event_guests",
+    /** Someone added the user to an event (to accept) */
+    EVENT_HOST_ADDED = "event_host_added",
+    /** A person the owner added accepted and joined */
+    EVENT_HOST_JOINED = "event_host_joined",
+    /** The user no longer has access to an event */
+    EVENT_HOST_REMOVED = "event_host_removed",
     /** New ads match one of the user's saved searches */
     SAVED_SEARCH = "saved_search"
 }
@@ -51,6 +57,8 @@ export type INotificationData = {
     /** EVENT_GUESTS: the event and the guest it is about */
     event_id?: number;
     rsvp_id?: number;
+    /** EVENT_HOST_*: the host row it is about */
+    host_id?: number;
     /** SAVED_SEARCH: the saved search the new ads (ad_ids, count) match */
     saved_search_id?: number;
 };

package/dist/cjs/types/communication/Notification.js

@@ -20,6 +20,12 @@ var NotificationTypeEnum;
     NotificationTypeEnum["DEALLONY_NEWS"] = "deallony_news";
     /** A guest opened their personal invitation or replied to it */
     NotificationTypeEnum["EVENT_GUESTS"] = "event_guests";
+    /** Someone added the user to an event (to accept) */
+    NotificationTypeEnum["EVENT_HOST_ADDED"] = "event_host_added";
+    /** A person the owner added accepted and joined */
+    NotificationTypeEnum["EVENT_HOST_JOINED"] = "event_host_joined";
+    /** The user no longer has access to an event */
+    NotificationTypeEnum["EVENT_HOST_REMOVED"] = "event_host_removed";
     /** New ads match one of the user's saved searches */
     NotificationTypeEnum["SAVED_SEARCH"] = "saved_search";
 })(NotificationTypeEnum || (exports.NotificationTypeEnum = NotificationTypeEnum = {}));
@@ -44,5 +50,8 @@ exports.NOTIFICATION_CATEGORY = {
     [NotificationTypeEnum.POINTS_EARNED]: NotificationCategoryEnum.POINTS,
     [NotificationTypeEnum.DEALLONY_NEWS]: NotificationCategoryEnum.DEALLONY,
     [NotificationTypeEnum.EVENT_GUESTS]: NotificationCategoryEnum.EVENTS,
+    [NotificationTypeEnum.EVENT_HOST_ADDED]: NotificationCategoryEnum.EVENTS,
+    [NotificationTypeEnum.EVENT_HOST_JOINED]: NotificationCategoryEnum.EVENTS,
+    [NotificationTypeEnum.EVENT_HOST_REMOVED]: NotificationCategoryEnum.EVENTS,
     [NotificationTypeEnum.SAVED_SEARCH]: NotificationCategoryEnum.SAVED_SEARCHES,
 };

package/dist/cjs/types/events/Event.d.ts

@@ -6,9 +6,11 @@ import type { IEventOccasion } from "./EventOccasion";
 import type { IEventVenue } from "./EventVenue";
 import type { IEventCustomization } from "./EventCustomization";
 import type { IEventDressCode } from "./EventDressCode";
+import type { IEventHost } from "./EventHost";
 export type { IEventCustomization };
 import type { IUser } from "../user/User";
 import { EventInvitationScanType, EventVisibility } from "../../constants/events";
+import type { EventAccessRole, EventPermission } from "../../constants/events/EventHost";
 export type IEvent = {
     id?: number;
     lat: number | null;
@@ -37,6 +39,8 @@ export type IEvent = {
     venue?: IEventVenue | null;
     venue_name?: string | null;
     location_label?: string | null;
+    /** Expected number of guests; null for events created before it was asked */
+    expected_guests?: number | null;
     user_id?: number | null;
     user?: IUser | null;
     payment_id?: number | null;
@@ -48,4 +52,24 @@ export type IEvent = {
     preview_url?: string | null;
     /** Couple's secret guest-management page; returned to the owner only */
     manage_url?: string | null;
+    /** Who created it: a slot key of the type (bride, groom, graduate...), "company" or "other"; null for old events */
+    creator_role?: string | null;
+    /** What the signed-in user is on this event (owner, organiser or guests); null when they have no access yet */
+    my_role?: EventAccessRole | null;
+    /** What the signed-in user may do (CONSTANTS.EVENTS.EventRolePermissions of my_role) */
+    my_permissions?: EventPermission[];
+    /** The signed-in user's own host row, when they are not the owner (pending rows included) */
+    my_host?: IEventHost | null;
+    /** The type's suggested people as the form shows them; only for those who manage people */
+    people?: {
+        slot: string;
+        phone: string | null;
+        name: string | null;
+        surprise: boolean;
+        status: string;
+    }[];
+    /** Owner's display name, for people the event was shared with */
+    owner_name?: string | null;
+    /** Who saved last (owner or a host), for «آخر تعديل» */
+    updated_by_user_id?: number | null;
 };

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

@@ -0,0 +1,29 @@
+import type { EventHostRole, EventHostStatus } from "../../constants/events/EventHost";
+/** Someone other than the creator who can open and manage an event in the app */
+export type IEventHost = {
+    id: number;
+    event_id: number;
+    /** Normalized number; only people who can manage hosts get it */
+    phone?: string | null;
+    user_id?: number | null;
+    /** The account's name once linked */
+    user_name?: string | null;
+    role: EventHostRole;
+    /** Slot key of the event type (CONSTANTS.EVENTS.EventPeopleSlots) or "manual" */
+    source: string;
+    /** Free text for people added by hand (e.g. «أم العروس»); slots use their own label */
+    label: string | null;
+    /** Name typed by the owner */
+    name: string | null;
+    status: EventHostStatus;
+    /** Surprise: they get no notice or access until the event ends */
+    surprise: boolean;
+    /** Computed: when a surprise person gets access (the event's end); null when not hidden */
+    hidden_until?: string | Date | null;
+    /** Computed: still hidden from them now */
+    is_hidden?: boolean;
+    added_by_user_id: number | null;
+    linked_at: string | Date | null;
+    accepted_at: string | Date | null;
+    created_at?: string | Date;
+};

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/events/index.d.ts

@@ -6,3 +6,4 @@ export * from './EventBirthday';
 export * from './EventOccasion';
 export * from './EventCustomization';
 export * from "./EventDressCode";
+export * from './EventHost';

package/dist/cjs/types/events/index.js

@@ -22,3 +22,4 @@ __exportStar(require("./EventBirthday"), exports);
 __exportStar(require("./EventOccasion"), exports);
 __exportStar(require("./EventCustomization"), exports);
 __exportStar(require("./EventDressCode"), exports);
+__exportStar(require("./EventHost"), exports);

package/dist/cjs/types/index.d.ts

@@ -45,6 +45,7 @@ export * as EventWedding from './events/EventWedding';
 export * as EventBirthday from './events/EventBirthday';
 export * as EventOccasion from './events/EventOccasion';
 export * as EventVenue from './events/EventVenue';
+export * as EventHost from './events/EventHost';
 export * as User from "./user/User";
 export * as Role from "./user/Role";
 export * as Permission from "./user/Permission";

package/dist/cjs/types/index.js

@@ -36,8 +36,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Permission = exports.Role = exports.User = exports.EventVenue = exports.EventOccasion = exports.EventBirthday = exports.EventWedding = exports.EventTimeline = exports.EventRsvp = exports.Event = exports.District = exports.City = exports.AdminBoundary = exports.WorkType = exports.UsedProductCondition = exports.UsedProductAge = exports.Unit = exports.Transmission = exports.RegionalSpec = exports.PublisherType = exports.PropertyStatus = exports.PriceType = exports.OfferType = exports.LicenseType = exports.FuelType = exports.Feature = exports.Facility = exports.Currency = exports.Color = exports.CategoryWorkType = exports.Category = exports.CarBody = exports.UsedProduct = exports.Service = exports.PropertySubType = exports.Property = exports.MotorTrim = exports.Motor = exports.AdPromotion = exports.Addresses = exports.AdDailyViews = exports.AdLocation = exports.Ad = exports.FilterParams = exports.ModuleFetchEndpoints = exports.Config = exports.AccessType = exports.Status = exports.Response = exports.LocalizedName = void 0;
-exports.Payment = exports.Analysis = exports.GeminiApiKey = exports.Google = exports.Kyc = exports.SocialMediaProfile = exports.SocialMediaPlatform = exports.Image = exports.Media = exports.File = exports.Notification = exports.NotificationToken = exports.MessageTemplate = exports.Device = exports.Chat = exports.AppStartScreen = exports.MetaData = exports.Company = exports.PotentialUser = exports.Loyalty = exports.SavedSearch = exports.Favorite = exports.Wallet = void 0;
+exports.Role = exports.User = exports.EventHost = exports.EventVenue = exports.EventOccasion = exports.EventBirthday = exports.EventWedding = exports.EventTimeline = exports.EventRsvp = exports.Event = exports.District = exports.City = exports.AdminBoundary = exports.WorkType = exports.UsedProductCondition = exports.UsedProductAge = exports.Unit = exports.Transmission = exports.RegionalSpec = exports.PublisherType = exports.PropertyStatus = exports.PriceType = exports.OfferType = exports.LicenseType = exports.FuelType = exports.Feature = exports.Facility = exports.Currency = exports.Color = exports.CategoryWorkType = exports.Category = exports.CarBody = exports.UsedProduct = exports.Service = exports.PropertySubType = exports.Property = exports.MotorTrim = exports.Motor = exports.AdPromotion = exports.Addresses = exports.AdDailyViews = exports.AdLocation = exports.Ad = exports.FilterParams = exports.ModuleFetchEndpoints = exports.Config = exports.AccessType = exports.Status = exports.Response = exports.LocalizedName = void 0;
+exports.Payment = exports.Analysis = exports.GeminiApiKey = exports.Google = exports.Kyc = exports.SocialMediaProfile = exports.SocialMediaPlatform = exports.Image = exports.Media = exports.File = exports.Notification = exports.NotificationToken = exports.MessageTemplate = exports.Device = exports.Chat = exports.AppStartScreen = exports.MetaData = exports.Company = exports.PotentialUser = exports.Loyalty = exports.SavedSearch = exports.Favorite = exports.Wallet = exports.Permission = void 0;
 // common
 exports.LocalizedName = __importStar(require("./common/LocalizedName"));
 exports.Response = __importStar(require("./common/Response"));
@@ -90,6 +90,7 @@ exports.EventWedding = __importStar(require("./events/EventWedding"));
 exports.EventBirthday = __importStar(require("./events/EventBirthday"));
 exports.EventOccasion = __importStar(require("./events/EventOccasion"));
 exports.EventVenue = __importStar(require("./events/EventVenue"));
+exports.EventHost = __importStar(require("./events/EventHost"));
 // user
 exports.User = __importStar(require("./user/User"));
 exports.Role = __importStar(require("./user/Role"));

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

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

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

@@ -0,0 +1,147 @@
+/** organiser: full control like the owner; guests: the event's guests only */
+export const EventHostRoleValues = ["organiser", "guests"];
+export const EventHostRole = {
+    ORGANISER: "organiser",
+    GUESTS: "guests",
+};
+export const EventHostRoleNames = {
+    organiser: { ar: "منظم", en: "Organiser" },
+    guests: { ar: "إدارة المدعوين", en: "Manages guests" },
+};
+export const EventHostRoleHints = {
+    organiser: { ar: "يدير المناسبة كاملة", en: "Manages the whole event" },
+    guests: { ar: "يدير المدعوين ويرسل الدعوات ويتابع الردود", en: "Manages guests, sends invitations and follows replies" },
+};
+export const EventHostRoleOptions = EventHostRoleValues.map((value) => ({
+    value,
+    name: EventHostRoleNames[value],
+    hint: EventHostRoleHints[value],
+}));
+/** pending: waiting for the person to sign in and accept; active: accepted */
+export const EventHostStatusValues = ["pending", "active", "declined", "left", "removed"];
+export const EventHostStatus = {
+    PENDING: "pending",
+    ACTIVE: "active",
+    DECLINED: "declined",
+    LEFT: "left",
+    REMOVED: "removed",
+};
+export const 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) */
+export const EventHostOpenStatusValues = ["pending", "active"];
+/** What the signed-in user is on an event */
+export const EventAccessRoleValues = ["owner", "organiser", "guests"];
+export const 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",
+];
+export const EventRolePermissions = {
+    owner: EventPermissionValues,
+    organiser: EventPermissionValues,
+    guests: ["event.view", "guests.manage"],
+};
+export const hasEventPermission = (role, permission) => !!role && EventRolePermissions[role].includes(permission);
+export const EventAccessRoleNames = {
+    owner: { ar: "المالك", en: "Owner" },
+    organiser: EventHostRoleNames.organiser,
+    guests: 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.
+ */
+export const 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) */
+export const findEventPeopleSlots = (eventType) => (eventType && EventPeopleSlots[eventType]) || DEFAULT_PEOPLE;
+export const findEventPeopleSlot = (eventType, key) => key ? findEventPeopleSlots(eventType).find((s) => s.key === key) : undefined;
+/** Answers to «من أنت في هذه المناسبة؟» besides the type's slots */
+export const EventCreatorRoleExtra = {
+    COMPANY: "company",
+    OTHER: "other",
+};
+export const 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 */
+export const eventPersonLabel = (eventType, slotKey, fallback) => {
+    const s = findEventPeopleSlot(eventType, slotKey);
+    if (s)
+        return s.label;
+    if (slotKey === "company" || slotKey === "other")
+        return EventCreatorRoleExtraNames[slotKey];
+    return fallback ? { ar: fallback, en: fallback } : null;
+};
+export 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 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;
+};

package/dist/esm/constants/events/index.js

@@ -13,3 +13,5 @@ export * from "./EventVisibility.js";
 export * from "./EventWeddingReligion.js";
 export * from "./EventTextPolicy.js";
 export * from "./EventDressCode.js";
+export * from "./EventHost.js";
+export * from "./EventGuests.js";

package/dist/esm/constants/routes/app.js

@@ -208,5 +208,7 @@ export const APP_ROUTES = {
         publish: (id) => ({ pathname: "/event/publish/[id]", params: { id } }),
         edit: (id) => ({ pathname: "/event/new", params: { id } }),
         details: (id) => ({ pathname: "/event/details/[id]", params: { id } }),
+        /** People of the event (owner, organisers, guest managers) */
+        hosts: (id) => ({ pathname: "/event/hosts/[id]", params: { id } }),
     },
 };

package/dist/esm/dto/events/EventHost.dto.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/dto/events/index.js

@@ -5,3 +5,4 @@ export * from './EventWedding.dto.js';
 export * from './EventBirthday.dto.js';
 export * from './EventOccasion.dto.js';
 export * from './EventVenue.dto.js';
+export * from './EventHost.dto.js';

package/dist/esm/schema/events/Event.schema.js

@@ -3,7 +3,8 @@ import { saveEventTimelineSchema } from "./EventTimeline.schema.js";
 import { saveEventWeddingSchema } from "./EventWedding.schema.js";
 import { saveEventBirthdaySchema } from "./EventBirthday.schema.js";
 import { saveEventOccasionSchema } from "./EventOccasion.schema.js";
-import { EVENT_CUSTOMIZATION_TEXT_MAX, EVENT_DRESS_CODE_NOTE_MAX, EventDressCodeColorModeValues, EventDressCodeColorValues, EventDressCodeStyleValues, EventCustomizationFontValues, EventCustomizationOpeningValues, EventCustomizationPaletteValues, EventCustomizationSectionValues, EventCustomizationTrackValues, EventInvitationScanTypeValues, EventPublishPaymentMethodValues, EventVisibilityValues, } from "../../constants/events/index.js";
+import { eventPersonInputSchema } from "./EventHost.schema.js";
+import { EVENT_CUSTOMIZATION_TEXT_MAX, EVENT_DRESS_CODE_NOTE_MAX, EVENT_EXPECTED_GUESTS_MAX, EVENT_EXPECTED_GUESTS_MIN, EventDressCodeColorModeValues, EventDressCodeColorValues, EventDressCodeStyleValues, EventCustomizationFontValues, EventCustomizationOpeningValues, EventCustomizationPaletteValues, EventCustomizationSectionValues, EventCustomizationTrackValues, EventInvitationScanTypeValues, EventPublishPaymentMethodValues, EventVisibilityValues, } from "../../constants/events/index.js";
 import { BLOCKED_RELIGIOUS_TEXT_MESSAGE, hasBlockedReligiousText } from "../../constants/events/EventTextPolicy.js";
 const customizationText = z
     .string()
@@ -68,10 +69,16 @@ export const eventBaseSchema = z.object({
     venue_id: z.coerce.number().int().positive().nullable().optional(),
     venue_name: z.string().trim().max(255).nullable().optional(),
     location_label: z.string().trim().nullable().optional(),
+    /** Expected number of guests; the app asks for it on every new event (old events may have none) */
+    expected_guests: z.coerce.number().int().min(EVENT_EXPECTED_GUESTS_MIN).max(EVENT_EXPECTED_GUESTS_MAX).nullable().optional(),
     invitation_scan_type: z.enum(EventInvitationScanTypeValues).optional(),
     customization: eventCustomizationSchema.nullable().optional(),
     dress_code: eventDressCodeSchema.nullable().optional(),
     visibility: z.enum(EventVisibilityValues).optional(),
+    /** «من أنت في هذه المناسبة؟»: a slot key of the type, "company" or "other" */
+    creator_role: z.string().trim().max(40).nullable().optional(),
+    /** Suggested people of the type (CONSTANTS.EVENTS.EventPeopleSlots) without their own field */
+    people: z.array(eventPersonInputSchema).max(20).optional(),
 });
 export const createEventSchema = eventBaseSchema;
 export const updateEventSchema = eventBaseSchema.extend({

package/dist/esm/schema/events/EventHost.schema.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { internationalPhoneSchema } from "../common/Phone.schema.js";
+import { EVENT_HOST_LABEL_MAX, EventHostRoleValues } from "../../constants/events/EventHost.js";
+const hostName = z
+    .string()
+    .trim()
+    .max(EVENT_HOST_LABEL_MAX)
+    .transform((v) => (v.length ? v : null))
+    .nullable()
+    .optional();
+/** One suggested person in the create/edit form; an empty phone removes them */
+export const eventPersonInputSchema = z.object({
+    slot: z.string().trim().min(1).max(40),
+    phone: internationalPhoneSchema.nullable().optional(),
+    name: hostName,
+    /** Don't tell them or give access before the event ends */
+    surprise: z.boolean().optional(),
+});
+/** Add someone to an event by hand */
+export const addEventHostSchema = z.object({
+    event_id: z.coerce.number().int().positive(),
+    phone: internationalPhoneSchema,
+    role: z.enum(EventHostRoleValues),
+    /** e.g. «أم العروس» */
+    label: hostName,
+    name: hostName,
+    surprise: z.boolean().optional(),
+});
+export const updateEventHostSchema = z.object({
+    host_id: z.coerce.number().int().positive(),
+    role: z.enum(EventHostRoleValues).optional(),
+    label: hostName,
+    name: hostName,
+    surprise: z.boolean().optional(),
+});
+export const eventHostIdSchema = z.object({
+    host_id: z.coerce.number().int().positive(),
+});
+export const eventHostsListSchema = z.object({
+    event_id: z.coerce.number().int().positive(),
+});

package/dist/esm/schema/events/index.js

@@ -6,3 +6,4 @@ export * from "./EventBirthday.schema.js";
 export * from "./EventOccasion.schema.js";
 export * from "./EventVenue.schema.js";
 export { internationalPhoneSchema } from "../common/Phone.schema.js";
+export * from "./EventHost.schema.js";

package/dist/esm/types/communication/Notification.js

@@ -17,6 +17,12 @@ export var NotificationTypeEnum;
     NotificationTypeEnum["DEALLONY_NEWS"] = "deallony_news";
     /** A guest opened their personal invitation or replied to it */
     NotificationTypeEnum["EVENT_GUESTS"] = "event_guests";
+    /** Someone added the user to an event (to accept) */
+    NotificationTypeEnum["EVENT_HOST_ADDED"] = "event_host_added";
+    /** A person the owner added accepted and joined */
+    NotificationTypeEnum["EVENT_HOST_JOINED"] = "event_host_joined";
+    /** The user no longer has access to an event */
+    NotificationTypeEnum["EVENT_HOST_REMOVED"] = "event_host_removed";
     /** New ads match one of the user's saved searches */
     NotificationTypeEnum["SAVED_SEARCH"] = "saved_search";
 })(NotificationTypeEnum || (NotificationTypeEnum = {}));
@@ -41,5 +47,8 @@ export const NOTIFICATION_CATEGORY = {
     [NotificationTypeEnum.POINTS_EARNED]: NotificationCategoryEnum.POINTS,
     [NotificationTypeEnum.DEALLONY_NEWS]: NotificationCategoryEnum.DEALLONY,
     [NotificationTypeEnum.EVENT_GUESTS]: NotificationCategoryEnum.EVENTS,
+    [NotificationTypeEnum.EVENT_HOST_ADDED]: NotificationCategoryEnum.EVENTS,
+    [NotificationTypeEnum.EVENT_HOST_JOINED]: NotificationCategoryEnum.EVENTS,
+    [NotificationTypeEnum.EVENT_HOST_REMOVED]: NotificationCategoryEnum.EVENTS,
     [NotificationTypeEnum.SAVED_SEARCH]: NotificationCategoryEnum.SAVED_SEARCHES,
 };

package/dist/esm/types/events/EventHost.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/events/index.js

@@ -6,3 +6,4 @@ export * from './EventBirthday.js';
 export * from './EventOccasion.js';
 export * from './EventCustomization.js';
 export * from "./EventDressCode.js";
+export * from './EventHost.js';

package/dist/esm/types/index.js

@@ -53,6 +53,7 @@ export * as EventWedding from './events/EventWedding.js';
 export * as EventBirthday from './events/EventBirthday.js';
 export * as EventOccasion from './events/EventOccasion.js';
 export * as EventVenue from './events/EventVenue.js';
+export * as EventHost from './events/EventHost.js';
 // user
 export * as User from "./user/User.js";
 export * as Role from "./user/Role.js";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@deallony/shared",
-    "version": "1.2.81",
+    "version": "1.2.82",
     "private": false,
     "main": "dist/cjs/index.js",
     "module": "dist/esm/index.js",