uapp-communication-sdk 1.0.0-dev.54

package/types/features/settings/domain/group-category.d.ts

@@ -0,0 +1,39 @@
+export type CategoryFieldType = 'text' | 'id' | 'pill' | 'date' | 'link' | 'person';
+export declare const CATEGORY_FIELD_TYPES: readonly {
+    readonly id: CategoryFieldType;
+    readonly label: string;
+}[];
+/** Icons a category can wear in the chat header avatar. Each maps to a lucide icon in presentation. */
+export declare const CATEGORY_ICONS: readonly ["Hash", "GraduationCap", "Users", "Building2", "Briefcase", "BookOpen", "Globe"];
+export type CategoryIcon = (typeof CATEGORY_ICONS)[number];
+export declare const CATEGORY_ACCENTS: readonly string[];
+export interface CategoryField {
+    readonly id: string;
+    readonly key: string;
+    readonly label: string;
+    readonly type: CategoryFieldType;
+    readonly icon: string;
+    readonly source: string;
+    readonly visible: boolean;
+}
+export interface GroupCategory {
+    readonly id: string;
+    readonly tenantId: string;
+    readonly name: string;
+    /** The default "General" category is locked — it cannot be renamed or deleted. */
+    readonly locked: boolean;
+    readonly description: string;
+    readonly accent: string;
+    /** Avatar icon shown in the chat header for groups in this category. */
+    readonly icon: CategoryIcon;
+    readonly fields: readonly CategoryField[];
+    /** Registry endpoint id for this category's inbound feed; null when no feed is connected. */
+    readonly webhookId: string | null;
+}
+/** Build a new (unlocked) category with no fields and no connected feed. */
+export declare const newGroupCategory: (params: {
+    readonly id: string;
+    readonly tenantId: string;
+    readonly name: string;
+}) => GroupCategory;
+//# sourceMappingURL=group-category.d.ts.map

package/types/features/settings/domain/group-category.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-category.d.ts","sourceRoot":"","sources":["../../../../../../src/features/settings/domain/group-category.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpF,eAAO,MAAM,oBAAoB,EAAE,SAAS;IAC1C,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,EAOA,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,cAAc,4FAQjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAe7C,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,GAAI,QAAQ;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,KAAG,aAUF,CAAC"}

package/types/features/settings/domain/index.d.ts

@@ -0,0 +1,23 @@
+export * from './errors/settings-errors';
+export * from './array-move';
+export * from './feed-pref';
+export * from './feed-template';
+export * from './feed-category-item';
+export * from './group-category';
+export * from './org-settings';
+export * from './webhook-registry';
+export * from './promotion';
+export * from './promo-fields';
+export * from './promo-samples';
+export * from './usage';
+export * from './webhook';
+export { SettingName } from './value-objects/setting-name';
+export type { SettingsGateway } from './ports/settings-gateway';
+export type { UsageGateway } from './ports/usage-gateway';
+export type { PromotionsGateway } from './ports/promotions-gateway';
+export type { FeedPreferencesGateway } from './ports/feed-preferences-gateway';
+export type { OrgSettingsGateway } from './ports/org-settings-gateway';
+export type { WebhookGateway } from './ports/webhook-gateway';
+export type { GroupCategoriesGateway } from './ports/group-categories-gateway';
+export type { GroupProvisioningGateway, ProvisionGroupInput, ProvisionGroupMemberInput, ProvisionGroupResult, } from './ports/group-provisioning-gateway';
+//# sourceMappingURL=index.d.ts.map

package/types/features/settings/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/features/settings/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC/E,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC/E,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oCAAoC,CAAC"}

package/types/features/settings/domain/org-settings.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Org-wide timezone & work-hours configuration, set by a tenant's System Admin for everyone.
+ * Each branch keeps its own timezone; work hours have an org default that branches inherit
+ * until a per-branch override is created. All transforms here are pure (return a new value).
+ */
+import { type WeekdayId, type WeekdayMeta } from '@core/domain';
+export type { WeekdayId };
+/** The org work-hours editor uses the shared kernel weekday shape. */
+export type OrgWeekday = WeekdayMeta;
+/** Monday-first week for the work-hours editor, sourced from the shared kernel. */
+export declare const ORG_WEEKDAYS: readonly OrgWeekday[];
+/** Hours for a single weekday; an inactive day reads as "Closed". */
+export interface DayHours {
+    readonly active: boolean;
+    readonly from: string;
+    readonly to: string;
+}
+export type WeeklyHours = Readonly<Record<WeekdayId, DayHours>>;
+export interface OrgBranch {
+    readonly id: string;
+    readonly name: string;
+    readonly address: string;
+    /** Flag emoji shown in the branch avatar. */
+    readonly flag: string;
+    /** Brand colour the branch avatar is tinted with. */
+    readonly color: string;
+    /**
+     * The branch's timezone as stored on the first-class Branch registry (an IANA id, e.g. "Europe/London").
+     * READ-ONLY here — branch definitions, including the timezone, are managed in Org Access (the branch admin
+     * endpoint); this org-settings surface only echoes it so the work-hours editor can show which zone the
+     * hours are in. The org-settings save deliberately ignores the branch list.
+     */
+    readonly timezone: string;
+    readonly isDefault?: boolean;
+}
+export interface OrgDetails {
+    readonly name: string;
+    readonly headquarters: string;
+}
+export interface OrgSettings {
+    readonly details: OrgDetails;
+    readonly branches: readonly OrgBranch[];
+    readonly defaultHours: WeeklyHours;
+    /** Per-branch overrides keyed by branch id; a missing entry means the branch inherits `defaultHours`. */
+    readonly branchHours: Readonly<Record<string, WeeklyHours>>;
+}
+/** The "org default" pseudo-branch used as the first tab in the work-hours editor. */
+export declare const ORG_DEFAULT_KEY = "default";
+/** True when the branch keeps its own work-hours override (rather than inheriting the default). */
+export declare const hasBranchOverride: (settings: OrgSettings, branchId: string) => boolean;
+/** The effective weekly hours for a branch (its override, or the org default). */
+export declare const resolveBranchHours: (settings: OrgSettings, branchId: string) => WeeklyHours;
+/** Replace one weekday in the org-default table. */
+export declare const setDefaultDay: (settings: OrgSettings, day: WeekdayId, hours: DayHours) => OrgSettings;
+/**
+ * Replace one weekday for a branch. Editing a branch that has no override yet forks the
+ * currently-effective table into a fresh override, so the org default is left untouched.
+ */
+export declare const setBranchDay: (settings: OrgSettings, branchId: string, day: WeekdayId, hours: DayHours) => OrgSettings;
+/** Drop a branch's override so it inherits the org default again. */
+export declare const clearBranchOverride: (settings: OrgSettings, branchId: string) => OrgSettings;
+/** Update the organisation name / headquarters. */
+export declare const setOrgDetails: (settings: OrgSettings, details: Partial<OrgDetails>) => OrgSettings;
+/**
+ * The org work-hours invariant: `defaultHours` AND every per-branch override must have a valid
+ * time range on each active day (an inactive day is "Closed" and is ignored). Pure — no I/O.
+ */
+export declare const orgWorkHoursAreValid: (settings: OrgSettings) => boolean;
+//# sourceMappingURL=org-settings.d.ts.map

package/types/features/settings/domain/org-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-settings.d.ts","sourceRoot":"","sources":["../../../../../../src/features/settings/domain/org-settings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAuB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErF,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,sEAAsE;AACtE,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC,mFAAmF;AACnF,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAAa,CAAC;AAE5D,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEhE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,yGAAyG;IACzG,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;CAC7D;AAED,sFAAsF;AACtF,eAAO,MAAM,eAAe,YAAY,CAAC;AAEzC,mGAAmG;AACnG,eAAO,MAAM,iBAAiB,GAAI,UAAU,WAAW,EAAE,UAAU,MAAM,KAAG,OACN,CAAC;AAEvE,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,GAC7B,UAAU,WAAW,EACrB,UAAU,MAAM,KACf,WAAsE,CAAC;AAE1E,oDAAoD;AACpD,eAAO,MAAM,aAAa,GACxB,UAAU,WAAW,EACrB,KAAK,SAAS,EACd,OAAO,QAAQ,KACd,WAGD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,WAAW,EACrB,UAAU,MAAM,EAChB,KAAK,SAAS,EACd,OAAO,QAAQ,KACd,WAMF,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,GAC9B,UAAU,WAAW,EACrB,UAAU,MAAM,KACf,WAGF,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,aAAa,GACxB,UAAU,WAAW,EACrB,SAAS,OAAO,CAAC,UAAU,CAAC,KAC3B,WAGD,CAAC;AAQH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,WAAW,KAAG,OAEqB,CAAC"}

package/types/features/settings/domain/ports/feed-preferences-gateway.d.ts

@@ -0,0 +1,19 @@
+import type { Result } from '@core/result';
+import type { SettingsError } from '../errors/settings-errors';
+import type { ContentPrefs, FeedCategory } from '../feed-pref';
+import type { FeedTemplate } from '../feed-template';
+import type { FeedCategoryItem } from '../feed-category-item';
+export interface FeedPreferencesGateway {
+    getContentPrefs(): Promise<Result<ContentPrefs, SettingsError>>;
+    saveContentPrefs(prefs: ContentPrefs): Promise<Result<ContentPrefs, SettingsError>>;
+    listFeedCategories(): Promise<Result<readonly FeedCategory[], SettingsError>>;
+    saveFeedCategories(categories: readonly FeedCategory[]): Promise<Result<readonly FeedCategory[], SettingsError>>;
+    listFeedTemplates(): Promise<Result<readonly FeedTemplate[], SettingsError>>;
+    saveFeedTemplate(template: FeedTemplate): Promise<Result<FeedTemplate, SettingsError>>;
+    deleteFeedTemplate(id: string): Promise<Result<string, SettingsError>>;
+    listFeedCategoryItems(categoryKey?: string): Promise<Result<readonly FeedCategoryItem[], SettingsError>>;
+    listExternalFeedCategoryItems(categoryKey: string, query?: string): Promise<Result<readonly FeedCategoryItem[], SettingsError>>;
+    saveFeedCategoryItem(item: FeedCategoryItem): Promise<Result<FeedCategoryItem, SettingsError>>;
+    deleteFeedCategoryItem(id: string): Promise<Result<string, SettingsError>>;
+}
+//# sourceMappingURL=feed-preferences-gateway.d.ts.map

package/types/features/settings/domain/ports/feed-preferences-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed-preferences-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/settings/domain/ports/feed-preferences-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IAChE,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IACpF,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9E,kBAAkB,CAChB,UAAU,EAAE,SAAS,YAAY,EAAE,GAClC,OAAO,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAE3D,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7E,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IACvF,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAEvE,qBAAqB,CACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,SAAS,gBAAgB,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/D,6BAA6B,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,SAAS,gBAAgB,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/D,oBAAoB,CAClB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAAC;IACpD,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CAC5E"}

package/types/features/settings/domain/ports/group-categories-gateway.d.ts

@@ -0,0 +1,10 @@
+import type { Result } from '@core/result';
+import type { GroupCategory } from '../group-category';
+import type { SettingsError } from '../errors/settings-errors';
+/** Port to the backend group-category CRUD (list / upsert / delete), tenant-scoped. */
+export interface GroupCategoriesGateway {
+    listGroupCategories(): Promise<Result<readonly GroupCategory[], SettingsError>>;
+    saveGroupCategory(category: GroupCategory): Promise<Result<GroupCategory, SettingsError>>;
+    deleteGroupCategory(id: string): Promise<Result<string, SettingsError>>;
+}
+//# sourceMappingURL=group-categories-gateway.d.ts.map

package/types/features/settings/domain/ports/group-categories-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-categories-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/settings/domain/ports/group-categories-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,uFAAuF;AACvF,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAChF,iBAAiB,CACf,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC;IACjD,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CACzE"}

package/types/features/settings/domain/ports/group-provisioning-gateway.d.ts

@@ -0,0 +1,34 @@
+import type { Result } from '@core/result';
+import type { SettingsError } from '../errors/settings-errors';
+/** One member (or the creator) supplied to the group simulator. */
+export interface ProvisionGroupMemberInput {
+    readonly externalUserId?: string;
+    readonly email?: string;
+    readonly name: string;
+    readonly role?: string;
+    readonly isAdmin: boolean;
+}
+/**
+ * Wire input to create-or-update a chat group from a feed. The in-app simulator and a third-party webhook
+ * share this shape; re-sending the same `externalId` with a higher `version` UPSERTs the same group.
+ */
+export interface ProvisionGroupInput {
+    readonly source?: string;
+    readonly externalId: string;
+    readonly version: number;
+    readonly name: string;
+    readonly categoryId?: string | null;
+    readonly creator?: ProvisionGroupMemberInput | null;
+    readonly members: readonly ProvisionGroupMemberInput[];
+    readonly fields: Readonly<Record<string, string>>;
+}
+export interface ProvisionGroupResult {
+    readonly conversationId: string;
+    readonly isNew: boolean;
+    readonly skipped: boolean;
+}
+/** Port to the backend group-provisioning endpoint (the real path a third-party webhook also drives). */
+export interface GroupProvisioningGateway {
+    provisionGroup(input: ProvisionGroupInput): Promise<Result<ProvisionGroupResult, SettingsError>>;
+}
+//# sourceMappingURL=group-provisioning-gateway.d.ts.map

package/types/features/settings/domain/ports/group-provisioning-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-provisioning-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/settings/domain/ports/group-provisioning-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,mEAAmE;AACnE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,yGAAyG;AACzG,MAAM,WAAW,wBAAwB;IACvC,cAAc,CACZ,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAAC;CACzD"}

package/types/features/settings/domain/ports/org-settings-gateway.d.ts

@@ -0,0 +1,13 @@
+import type { Result } from '@core/result';
+import type { SettingsError } from '../errors/settings-errors';
+import type { OrgSettings } from '../org-settings';
+/**
+ * Port to the tenant's organisation (Team Settings) — the org details, branches, and the org-default +
+ * per-branch work-hours tables an admin configures. Split out of the broad {@link SettingsGateway} (like
+ * {@link FeedPreferencesGateway}) because this slice is wired to the REAL backend.
+ */
+export interface OrgSettingsGateway {
+    getOrgSettings(): Promise<Result<OrgSettings, SettingsError>>;
+    saveOrgSettings(settings: OrgSettings): Promise<Result<OrgSettings, SettingsError>>;
+}
+//# sourceMappingURL=org-settings-gateway.d.ts.map

package/types/features/settings/domain/ports/org-settings-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-settings-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/settings/domain/ports/org-settings-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9D,eAAe,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;CACrF"}

package/types/features/settings/domain/ports/promotions-gateway.d.ts

@@ -0,0 +1,14 @@
+import type { Result } from '@core/result';
+import type { SettingsError } from '../errors/settings-errors';
+import type { CommTemplate, PromoCategory, Promotion } from '../promotion';
+export interface PromotionsGateway {
+    listPromoCategories(): Promise<Result<readonly PromoCategory[], SettingsError>>;
+    savePromoCategories(categories: readonly PromoCategory[]): Promise<Result<readonly PromoCategory[], SettingsError>>;
+    listCommTemplates(): Promise<Result<readonly CommTemplate[], SettingsError>>;
+    saveCommTemplate(template: CommTemplate): Promise<Result<CommTemplate, SettingsError>>;
+    deleteCommTemplate(id: string): Promise<Result<string, SettingsError>>;
+    listPromotions(): Promise<Result<readonly Promotion[], SettingsError>>;
+    savePromotion(promotion: Promotion): Promise<Result<Promotion, SettingsError>>;
+    deletePromotion(id: string): Promise<Result<string, SettingsError>>;
+}
+//# sourceMappingURL=promotions-gateway.d.ts.map

package/types/features/settings/domain/ports/promotions-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotions-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/settings/domain/ports/promotions-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAChF,mBAAmB,CACjB,UAAU,EAAE,SAAS,aAAa,EAAE,GACnC,OAAO,CAAC,MAAM,CAAC,SAAS,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAC5D,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7E,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IACvF,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAEvE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,SAAS,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACvE,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/E,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CACrE"}

package/types/features/settings/domain/ports/settings-gateway.d.ts

@@ -0,0 +1,14 @@
+import type { Result } from '@core/result';
+import type { SettingsError } from '../errors/settings-errors';
+import type { GroupCategory } from '../group-category';
+import type { WebhookData } from '../webhook';
+import type { PromotionsGateway } from './promotions-gateway';
+import type { UsageGateway } from './usage-gateway';
+/** Port to every settings data source (usage, webhooks, templates, promotions, feed prefs). */
+export interface SettingsGateway extends PromotionsGateway, UsageGateway {
+    getWebhookData(): Promise<Result<WebhookData, SettingsError>>;
+    listGroupCategories(): Promise<Result<readonly GroupCategory[], SettingsError>>;
+    saveGroupCategory(category: GroupCategory): Promise<Result<GroupCategory, SettingsError>>;
+    deleteGroupCategory(id: string): Promise<Result<string, SettingsError>>;
+}
+//# sourceMappingURL=settings-gateway.d.ts.map

package/types/features/settings/domain/ports/settings-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/settings/domain/ports/settings-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,+FAA+F;AAC/F,MAAM,WAAW,eAAgB,SAAQ,iBAAiB,EAAE,YAAY;IACtE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IAE9D,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,aAAa,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAChF,iBAAiB,CACf,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC;IACjD,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CACzE"}

package/types/features/settings/domain/ports/usage-gateway.d.ts

@@ -0,0 +1,9 @@
+import type { Result } from '@core/result';
+import type { SettingsError } from '../errors/settings-errors';
+import type { UsagePeriod, UsageRecord } from '../usage';
+/** Port to the read-only communication-usage analytics source (per-staff message / credit usage). */
+export interface UsageGateway {
+    /** Lists per-staff usage for the given reporting window (message counts are bounded to it). */
+    listUsage(period: UsagePeriod): Promise<Result<readonly UsageRecord[], SettingsError>>;
+}
+//# sourceMappingURL=usage-gateway.d.ts.map

package/types/features/settings/domain/ports/usage-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/settings/domain/ports/usage-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzD,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,+FAA+F;IAC/F,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,WAAW,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;CACxF"}

package/types/features/settings/domain/ports/webhook-gateway.d.ts

@@ -0,0 +1,17 @@
+import type { Result } from '@core/result';
+import type { SettingsError } from '../errors/settings-errors';
+import type { WebhookEndpoint } from '../webhook-registry';
+import type { WebhookData } from '../webhook';
+/** Port to handle webhook registry integrations (endpoints). */
+export interface WebhookGateway {
+    listWebhookEndpoints(): Promise<Result<readonly WebhookEndpoint[], SettingsError>>;
+    saveWebhookEndpoint(endpoint: WebhookEndpoint): Promise<Result<WebhookEndpoint, SettingsError>>;
+    deleteWebhookEndpoint(id: string): Promise<Result<string, SettingsError>>;
+    /** Rotates the endpoint's signing secret server-side; resolves to the endpoint carrying the NEW secret. */
+    rotateSecret(id: string): Promise<Result<WebhookEndpoint, SettingsError>>;
+    getWebhookData(): Promise<Result<WebhookData, SettingsError>>;
+    sendTestEvent(id: string): Promise<Result<void, SettingsError>>;
+    retryWebhook(id: string): Promise<Result<void, SettingsError>>;
+    skipWebhook(id: string): Promise<Result<void, SettingsError>>;
+}
+//# sourceMappingURL=webhook-gateway.d.ts.map

package/types/features/settings/domain/ports/webhook-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-gateway.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/settings/domain/ports/webhook-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,eAAe,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACnF,mBAAmB,CACjB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;IACnD,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAC1E,2GAA2G;IAC3G,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;IAC1E,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAChE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;CAC/D"}

package/types/features/settings/domain/promo-fields.d.ts

@@ -0,0 +1,65 @@
+import type { CommTemplate, PromoField, Promotion } from './promotion';
+/** The fields each promo type's live data provides — i.e. the valid `{{tokens}}` for that type. */
+export declare const PROMO_FIELDS: Readonly<Record<string, readonly PromoField[]>>;
+/**
+ * Tokens the SYSTEM computes for EVERY template — not entered per campaign and not from the API.
+ * `item_count` (the category's row count) lives here, not on any type's category fields.
+ */
+export declare const SYSTEM_FIELDS: readonly PromoField[];
+/** The valid fields for a promo type (falls back to the generic field set). */
+export declare const promoFieldsFor: (type: string) => readonly PromoField[];
+/** The fields a template binds to: a custom template's own fields, else its type's built-in set. */
+export declare const templateFields: (template: {
+    readonly type: string;
+    readonly fields?: readonly PromoField[];
+}) => readonly PromoField[];
+/** Derive a safe `{{token}}` name from a human field label (snake_case, alnum only). */
+export declare const tokenize: (label: string) => string;
+/** Extract the `{{token}}` names used in a piece of template text. Pure. */
+export declare const tokensIn: (text: string) => readonly string[];
+/** A template's 8 card fields with their `{{tokens}}` resolved against live values. */
+export interface ResolvedCard {
+    readonly statusLabel: string;
+    readonly mainHeader: string;
+    readonly cardTitle: string;
+    readonly cardSubtitle: string;
+    readonly dateLine: string;
+    readonly badgeText: string;
+    readonly amountText: string;
+    readonly ctaText: string;
+}
+/** Resolve a template's card fields against a campaign's (merged) values for display. Pure. */
+export declare const resolvedTemplateCard: (template: CommTemplate, values: Readonly<Record<string, string>>) => ResolvedCard;
+/** The editable free-text keys of a template (excludes id/type/custom/fields). */
+export type TemplateTextKey = 'statusLabel' | 'mainHeader' | 'cardTitle' | 'cardSubtitle' | 'dateLine' | 'badgeText' | 'amountText' | 'ctaText';
+export declare const TEMPLATE_TEXT_KEYS: readonly TemplateTextKey[];
+export interface PromotionCard {
+    readonly title: string;
+    readonly subtitle: string;
+    readonly amount: string;
+    readonly badge: string;
+    readonly date: string;
+}
+/** Normalise a campaign's values into a display card for the feed rail / panel. */
+export declare const promotionCard: (promotion: Promotion, fields: readonly PromoField[]) => PromotionCard;
+/** A short two-line summary of a campaign for list display, from its first two type fields. */
+export declare const campaignSummary: (promotion: Promotion, fields: readonly PromoField[]) => {
+    readonly primary: string;
+    readonly secondary: string;
+};
+/** True when a field is auto-computed and so must not be an editable campaign input. */
+export declare const isAutoField: (field: PromoField) => boolean;
+/** One filled, label-bearing field of a campaign, for rich list display. */
+export interface CampaignDetail {
+    readonly token: string;
+    readonly label: string;
+    readonly value: string;
+}
+/**
+ * The campaign's remaining filled fields (everything past the title/subtitle the summary already
+ * shows), so the list can surface the rest of the entered data instead of hiding it. Pure.
+ */
+export declare const campaignDetails: (promotion: Promotion, fields: readonly PromoField[]) => readonly CampaignDetail[];
+/** Tokens used in a template that aren't valid fields for its type — these won't be filled. */
+export declare const unknownTokens: (template: CommTemplate, fields: readonly PromoField[]) => readonly string[];
+//# sourceMappingURL=promo-fields.d.ts.map

package/types/features/settings/domain/promo-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promo-fields.d.ts","sourceRoot":"","sources":["../../../../../../src/features/settings/domain/promo-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvE,mGAAmG;AACnG,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC,CAuGxE,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,UAAU,EAmB9C,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,SAAS,UAAU,EAC3B,CAAC;AAEvC,oGAAoG;AACpG,eAAO,MAAM,cAAc,GAAI,UAAU;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC,KAAG,SAAS,UAAU,EAAsD,CAAC;AAE9E,wFAAwF;AACxF,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,KAAG,MAKb,CAAC;AAE7B,4EAA4E;AAC5E,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,SAAS,MAAM,EAGnB,CAAC;AAErC,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAYD,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB,GAC/B,UAAU,YAAY,EACtB,QAAQ,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KACvC,YASD,CAAC;AAEH,kFAAkF;AAClF,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,YAAY,GACZ,WAAW,GACX,cAAc,GACd,UAAU,GACV,WAAW,GACX,YAAY,GACZ,SAAS,CAAC;AAEd,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EASxD,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,mFAAmF;AACnF,eAAO,MAAM,aAAa,GACxB,WAAW,SAAS,EACpB,QAAQ,SAAS,UAAU,EAAE,KAC5B,aAgBF,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,eAAe,GAC1B,WAAW,SAAS,EACpB,QAAQ,SAAS,UAAU,EAAE,KAC5B;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAOxD,CAAC;AAaF,wFAAwF;AACxF,eAAO,MAAM,WAAW,GAAI,OAAO,UAAU,KAAG,OAAuC,CAAC;AAExF,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,SAAS,EACpB,QAAQ,SAAS,UAAU,EAAE,KAC5B,SAAS,cAAc,EASkB,CAAC;AAE7C,+FAA+F;AAC/F,eAAO,MAAM,aAAa,GACxB,UAAU,YAAY,EACtB,QAAQ,SAAS,UAAU,EAAE,KAC5B,SAAS,MAAM,EASjB,CAAC"}

package/types/features/settings/domain/promo-samples.d.ts

@@ -0,0 +1,4 @@
+import type { CommTemplate, Promotion } from './promotion';
+/** Two sample campaigns from a template's own (non-auto) fields — for a live design preview. */
+export declare const sampleCampaigns: (template: CommTemplate) => readonly Promotion[];
+//# sourceMappingURL=promo-samples.d.ts.map

package/types/features/settings/domain/promo-samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promo-samples.d.ts","sourceRoot":"","sources":["../../../../../../src/features/settings/domain/promo-samples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAc,SAAS,EAAE,MAAM,aAAa,CAAC;AA0CvE,gGAAgG;AAChG,eAAO,MAAM,eAAe,GAAI,UAAU,YAAY,KAAG,SAAS,SAAS,EAQ1E,CAAC"}

package/types/features/settings/domain/promotion.d.ts

@@ -0,0 +1,73 @@
+export interface PromoCategory {
+    readonly id: string;
+    readonly name: string;
+    readonly priority: number;
+    readonly color: string;
+    readonly active: boolean;
+    readonly templateId: string;
+    readonly webhookId: string | null;
+}
+export declare const PROMO_COLORS: readonly string[];
+export declare const TEMPLATE_TYPES: readonly {
+    readonly id: string;
+    readonly label: string;
+    readonly color: string;
+}[];
+/**
+ * The data kinds a promo field can hold. Curated for marketing cards (no phone/email — those
+ * never belong on a promotion card); the type drives the campaign form's input + light display
+ * formatting.
+ */
+export type PromoFieldType = 'text' | 'number' | 'currency' | 'date' | 'link' | 'badge';
+export declare const PROMO_FIELD_TYPES: readonly {
+    readonly id: PromoFieldType;
+    readonly label: string;
+}[];
+/** A live-data field a promo template can bind to — shown in the editor's field palette. */
+export interface PromoField {
+    readonly token: string;
+    readonly label: string;
+    readonly description: string;
+    /** How this field is entered/shown. Defaults to plain text when omitted. */
+    readonly type?: PromoFieldType;
+}
+export interface CommTemplate {
+    readonly id: string;
+    readonly type: string;
+    readonly name: string;
+    readonly statusLabel: string;
+    readonly mainHeader: string;
+    readonly cardTitle: string;
+    readonly cardSubtitle: string;
+    readonly dateLine: string;
+    readonly badgeText: string;
+    readonly amountText: string;
+    readonly ctaText: string;
+    /** True for user-created templates (built-in type templates omit it). */
+    readonly custom?: boolean;
+    /** Custom templates carry their own dynamically-created fields; built-ins use PROMO_FIELDS. */
+    readonly fields?: readonly PromoField[];
+}
+/**
+ * A published campaign item that belongs to a promotion category and shows in the feed rail.
+ * Its `values` are keyed by the category type's field tokens (see `PROMO_FIELDS`), so the
+ * campaign form and the template's `{{tokens}}` always line up.
+ */
+export interface Promotion {
+    readonly id: string;
+    readonly categoryId: string;
+    readonly values: Readonly<Record<string, string>>;
+}
+/** Build a blank campaign for a category — the admin fills its type's fields via the panel. */
+export declare const newPromotion: (categoryId: string, id: string) => Promotion;
+/** Renumber priorities to match list order (1-based). Pure. */
+export declare const normalizePriorities: (cats: readonly PromoCategory[]) => PromoCategory[];
+/** Move a category up (-1) or down (+1) and renumber priorities. Pure. */
+export declare const moveCategory: (cats: readonly PromoCategory[], id: string, delta: number) => PromoCategory[];
+/** Move the category at index `from` to index `to` (drag-and-drop) and renumber priorities. Pure. */
+export declare const reorderCategories: (cats: readonly PromoCategory[], from: number, to: number) => PromoCategory[];
+/** Toggle a category's active flag. Pure. */
+export declare const toggleCategoryActive: (cats: readonly PromoCategory[], id: string) => PromoCategory[];
+/** Point any category on `templateId` at `fallbackId` instead — used when a template is deleted. */
+export declare const detachTemplate: (cats: readonly PromoCategory[], templateId: string, fallbackId: string) => PromoCategory[];
+//# sourceMappingURL=promotion.d.ts.map

package/types/features/settings/domain/promotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.d.ts","sourceRoot":"","sources":["../../../../../../src/features/settings/domain/promotion.ts"],"names":[],"mappings":"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"}

package/types/features/settings/domain/usage.d.ts

@@ -0,0 +1,48 @@
+export type UsagePeriod = 'week' | 'month' | 'quarter' | 'all';
+export declare const USAGE_PERIODS: readonly {
+    readonly id: UsagePeriod;
+    readonly label: string;
+}[];
+/** Default monthly message credit by staff level, ported from the prototype. */
+export declare const CREDIT_LIMITS: Readonly<Record<number, number>>;
+export declare const USAGE_COLORS: {
+    readonly msg: "#2563EB";
+    readonly audio: "#10B981";
+    readonly video: "#045d5e";
+};
+export interface UsageRecordProps {
+    readonly id: string;
+    readonly name: string;
+    readonly role: string;
+    readonly level: number;
+    readonly msgs: number;
+    readonly audioCalls: number;
+    readonly audioMins: number;
+    readonly videoCalls: number;
+    readonly videoMins: number;
+}
+/** A staff member's communication usage for the period. Immutable. */
+export declare class UsageRecord {
+    readonly id: string;
+    readonly name: string;
+    readonly role: string;
+    readonly level: number;
+    readonly msgs: number;
+    readonly audioCalls: number;
+    readonly audioMins: number;
+    readonly videoCalls: number;
+    readonly videoMins: number;
+    constructor(props: UsageRecordProps);
+    get creditLimit(): number;
+    /** How much of the message credit this person has consumed, as a percentage. */
+    get usagePct(): number;
+}
+export interface UsageTotals {
+    readonly totalMsgs: number;
+    readonly totalAudioMins: number;
+    readonly totalVideoMins: number;
+    readonly avgUsagePct: number;
+}
+/** Pure domain service: roll a set of usage records up into the four KPI figures. */
+export declare const summarizeUsage: (records: readonly UsageRecord[]) => UsageTotals;
+//# sourceMappingURL=usage.d.ts.map

package/types/features/settings/domain/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../../../../src/features/settings/domain/usage.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;AAE/D,eAAO,MAAM,aAAa,EAAE,SAAS;IACnC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,EAKA,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK1D,CAAC;AAEF,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,sEAAsE;AACtE,qBAAa,WAAW;IACtB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEf,KAAK,EAAE,gBAAgB;IAY1C,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,gFAAgF;IAChF,IAAW,QAAQ,IAAI,MAAM,CAE5B;CACF;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,qFAAqF;AACrF,eAAO,MAAM,cAAc,GAAI,SAAS,SAAS,WAAW,EAAE,KAAG,WAWhE,CAAC"}

package/types/features/settings/domain/value-objects/setting-name.d.ts

@@ -0,0 +1,17 @@
+import { type Result } from '@core/result';
+import { InvalidSettingFieldError } from '../errors/settings-errors';
+/**
+ * A required settings display name — a promotion category, custom template, or campaign title.
+ * Immutable and self-validating: trimmed, non-empty, and bounded in length. Construct through
+ * `SettingName.create` (returns a `Result`) — the private constructor makes an invalid name
+ * unrepresentable. Mirrors `StudentName`/`UniversityName`: the same rule guards both the form
+ * (via the `domainResolver`) and the save use case.
+ */
+export declare class SettingName {
+    readonly value: string;
+    static readonly maxLength = 80;
+    private constructor();
+    static create(raw: string): Result<SettingName, InvalidSettingFieldError>;
+    toString(): string;
+}
+//# sourceMappingURL=setting-name.d.ts.map

package/types/features/settings/domain/value-objects/setting-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-name.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/settings/domain/value-objects/setting-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAIrE;;;;;;GAMG;AACH,qBAAa,WAAW;aAGc,KAAK,EAAE,MAAM;IAFjD,gBAAuB,SAAS,MAAc;IAE9C,OAAO;WAEO,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAazE,QAAQ,IAAI,MAAM;CAG1B"}