@propriety/court-calendar 1.0.163 → 1.0.164

package/dist/__tests__/CalendarNavCreateGate.test.d.ts

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

package/dist/__tests__/ReferenceDataPermissions.test.d.ts

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

package/dist/__tests__/helpers/api/permissions.test.d.ts

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

package/dist/_components/Modal/DateDetails/CaseViewer.d.ts

@@ -6,7 +6,7 @@ declare const CaseViewer: import('react').NamedExoticComponent<{
     selectedDate: Date;
     isVillage: boolean;
     csvFileName?: string;
-    isAdmin?: boolean;
+    canEdit?: boolean;
     onSelectedCasesAdjournmentChange?: (cases: Case[], date: Date | null) => Promise<boolean>;
     onSelectedCasesClearDetermination?: (cases: Case[]) => Promise<boolean>;
     firstChair?: number | null;

package/dist/_components/Modal/DateDetails/DateDetails.d.ts

@@ -1,5 +1,5 @@
 import { AdjournmentEntry, Case, CourtDate, DateEditItem } from '../../../types';
-export default function DateDetails({ selectedCourtDate, cases, isVillage, isFetchingCases, onUpdateChair, adjournments, courtDateHistory, }: {
+export default function DateDetails({ selectedCourtDate, cases, isVillage, isFetchingCases, onUpdateChair, adjournments, courtDateHistory, canFileMotion, }: {
     selectedCourtDate: CourtDate | null;
     cases: Case[];
     isVillage: boolean;
@@ -7,4 +7,6 @@ export default function DateDetails({ selectedCourtDate, cases, isVillage, isFet
     onUpdateChair?: (position: 'first' | 'second', userId: number | null) => void;
     adjournments?: AdjournmentEntry[];
     courtDateHistory?: DateEditItem[];
+    /** Passed straight to MotionToPreclude — see the note on its own prop. */
+    canFileMotion: boolean;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/_components/Modal/DateDetails/DateTabs.d.ts

@@ -1,12 +1,12 @@
 import { Case, CourtDate } from '../../../types';
-export default function DateTabs({ cases, isFetchingCases, setClickedCase, selectedDate, isVillage, csvFileName, isAdmin, onSelectedCasesAdjournmentChange, onSelectedCasesClearDetermination, selectedCourtDate, }: {
+export default function DateTabs({ cases, isFetchingCases, setClickedCase, selectedDate, isVillage, csvFileName, canEdit, onSelectedCasesAdjournmentChange, onSelectedCasesClearDetermination, selectedCourtDate, }: {
     cases: Case[];
     isFetchingCases: boolean;
     setClickedCase: (caseItem: Case | null) => void;
     selectedDate: Date;
     isVillage: boolean;
     csvFileName?: string;
-    isAdmin?: boolean;
+    canEdit?: boolean;
     onSelectedCasesAdjournmentChange?: (cases: Case[], date: Date | null) => Promise<boolean>;
     onSelectedCasesClearDetermination?: (cases: Case[]) => Promise<boolean>;
     selectedCourtDate: CourtDate | null;

package/dist/_components/Modal/DateDetails/MotionToPreclude.d.ts

@@ -12,11 +12,18 @@ export interface MotionToast {
  * themselves through the status line and their tooltips.
  *
  * Callers gate on `isScarDate`: negotiation and collections dates never carry a motion.
+ *
+ * Download stays open to everyone — reading the draft is how a non-admin checks a motion
+ * before asking an admin to file it. Only the upload, which files with the court and
+ * cannot be undone, is restricted.
  */
-export default function MotionToPreclude({ courtDate, township, adjournments, cases, onNotify, }: {
+export default function MotionToPreclude({ courtDate, township, adjournments, cases, onNotify, canFileMotion, }: {
     courtDate: CourtDate;
     township: string;
     adjournments?: AdjournmentEntry[];
     cases?: Pick<Case, 'AdjournedDate'>[];
     onNotify: (toast: MotionToast) => void;
+    /** Required rather than optional: a forgotten prop should fail the build, not silently
+     *  hand every user an irreversible court filing. */
+    canFileMotion: boolean;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/_components/Modal/Layout/ModalActions.d.ts

@@ -1,10 +1,13 @@
 import { ModalMode } from '../types';
-export default function ModalActions({ modalMode, onDelete, onSave, setModalMode, setIsOpen, isAdmin, createdBy, createdOn, }: {
+export default function ModalActions({ modalMode, onDelete, onSave, setModalMode, setIsOpen, canEdit, isAdmin, createdBy, createdOn, }: {
     modalMode: ModalMode;
     onDelete: () => void | Promise<unknown>;
     onSave: () => void | Promise<unknown>;
     setModalMode: (mode: ModalMode) => void;
     setIsOpen: (isOpen: boolean) => void;
+    /** Gates Edit/Save — everyone who works on cases. */
+    canEdit: boolean;
+    /** Gates Delete only. Deleting a date is not recoverable from the UI. */
     isAdmin: boolean;
     createdBy?: number | null;
     createdOn?: Date | string | null;

package/dist/_components/Toolbar/CalendarNav.d.ts

@@ -1,5 +1,5 @@
 import { Calendar } from '@fullcalendar/core/index.js';
-export default function CalendarNav({ calendarApi, handleCreateClick, onPrint, onRefresh, currentView, setCurrentView, currentDate, setCurrentDate, isFetchingDates, isFetchingCases, lastFetchedAt, isAdmin, }: {
+export default function CalendarNav({ calendarApi, handleCreateClick, onPrint, onRefresh, currentView, setCurrentView, currentDate, setCurrentDate, isFetchingDates, isFetchingCases, lastFetchedAt, canEdit, }: {
     calendarApi: Calendar | null;
     handleCreateClick: () => void;
     onPrint: () => void;
@@ -11,5 +11,5 @@ export default function CalendarNav({ calendarApi, handleCreateClick, onPrint, o
     isFetchingDates: boolean;
     isFetchingCases: boolean;
     lastFetchedAt: Date | null;
-    isAdmin: boolean;
+    canEdit: boolean;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/constants.d.ts

@@ -5,7 +5,6 @@ export declare const S3_NOTICES_URL = "https://aventine-court-notices.s3.us-east
 export declare const S3_DOCS_URL = "https://aventine-court-docs.s3.amazonaws.com";
 export declare const SETTLED_ACTIONS: string[];
 export declare const EXCLUDED_USER_NAMES: string[];
-export declare const ADMIN_GROUP = "calendar-admin";
 export declare const PRIMARY_USER_IDS: number[];
 export declare const CASES_CACHE_EXPIRY: number;
 export declare const COURT_DATES_CACHE_EXPIRY: number;

package/dist/context/ReferenceDataContext.d.ts

@@ -9,6 +9,9 @@ interface ReferenceDataContextType {
     getTownshipName: (muniCode: string) => string;
     getCountyName: (muniCode: string) => string;
     isLoading: boolean;
+    /** May add and edit court dates and negotiation dates. Everyone who works on cases. */
+    canEdit: boolean;
+    /** May delete a date and file a Motion to Preclude. A much smaller set than canEdit. */
     isAdmin: boolean;
     apiKey: string;
     activeUser: number;

package/dist/helpers/api/courtDates.d.ts

@@ -11,7 +11,7 @@ export declare function getCourtDate(courtDateId: number, apiKey: string, type?:
  * edit-log trail, so both come back empty for negotiation dates rather than throwing.
  */
 export declare function getCourtDateDetail(courtDateId: number, apiKey: string, type?: DateType): Promise<CourtDateDetail | null>;
-export declare function deleteCourtDate(courtDateId: number, apiKey: string, type?: DateType): Promise<boolean>;
+export declare function deleteCourtDate(courtDateId: number, apiKey: string, type?: DateType, user?: number): Promise<boolean>;
 export declare function createCourtDate(courtDate: Date, muniCode: string, apiKey: string, courtCases?: string[], hearingTime?: string, multipleDates?: Date[], type?: DateType, noticeFiles?: File[], editUser?: number): Promise<number | null>;
 export declare function snoozeUploadDeadline(courtDateId: number, apiKey: string): Promise<boolean>;
 export declare function getDateEditLogs(courtDateId: number, apiKey: string, type?: DateType): Promise<DateEditLog | null>;

package/dist/helpers/api/headers.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Headers for a mutating request.
+ *
+ * The API key is shared across the team, so it identifies the *app*, not the person. The
+ * backend resolves the caller's roles from `X-User-Id` (see ../../../utility-api/utils/roles.py),
+ * so a write that omits it is rejected once role enforcement is on.
+ *
+ * `userId` is optional because a few callers genuinely have no user — background refreshes
+ * and the automated ingest paths. Those are reads, which are never gated; if one turns out
+ * to write, the missing header is the symptom to look for.
+ */
+export declare function writeHeaders(apiKey: string, userId?: number, extra?: Record<string, string>): Record<string, string>;

package/dist/helpers/api/people.d.ts

@@ -6,4 +6,25 @@ export interface HearingOfficer {
 }
 export declare function getAllUsers(apiKey: string): Promise<Record<number, User>>;
 export declare function getAllHearingOfficers(apiKey: string): Promise<Record<number, HearingOfficer>>;
-export declare function isUserAdmin(User: User, apiKey: string): Promise<boolean>;
+/** What the signed-in user may do on the calendar. */
+export interface CalendarPermissions {
+    /** Add and edit court dates and negotiation dates. An admin always may. */
+    canEdit: boolean;
+    /** Delete a date, and file a Motion to Preclude with the court. */
+    isAdmin: boolean;
+}
+/**
+ * Resolve what `userId` may do, from the roles held in `Rules.UserRoles`.
+ *
+ * Replaces an older check that asked whether the user's *email* was in the
+ * `calendar-admin` AWS Cognito group. Keying on the numeric UserID matters twice over:
+ * several active users have no email address at all, and `activeUser` already is a
+ * UserID — so permissions no longer have to wait for the user list to load before they
+ * can resolve.
+ *
+ * Fails closed on every path. The backend answers 200 with empty roles for a user who
+ * simply holds none, so any non-200 here is a genuine fault, and a fault must never read
+ * as permission. Comparisons are `=== true` because a `null` or the string `"true"`
+ * arriving from a changed backend would otherwise be truthy.
+ */
+export declare function getUserPermissions(userId: number, apiKey: string): Promise<CalendarPermissions>;