@7365admin1/layer-common 4.147.2 → 4.148.1

package/utils/visitor-barrier.ts

@@ -0,0 +1,42 @@
+/**
+ * What the screen says after a visitor is added, registered or checked in
+ * (owner, 2026-10-23): the action, then whether the ANPR barrier opened -
+ * "Opening Barrier Failed." in red. Mirrors isecure365's `visitor-barrier.ts`.
+ * The server reports `barrier: "opened" | "failed"`, absent when no barrier
+ * was asked to open, and `barrierCamera`: the camera's type and gate, "Entry
+ * Gate 1" - absent from older servers and for a camera with no gate saved.
+ */
+export type TBarrierOutcome = "opened" | "failed";
+
+export const VISITOR_ACTION_SUCCESS = {
+  add: "Add Visitor Success.",
+  register: "Register Visitor Success.",
+  checkIn: "Check In Visitor Success.",
+} as const;
+
+export const BARRIER_MESSAGES: Record<TBarrierOutcome, string> = {
+  opened: "Opening Barrier Success.",
+  failed: "Opening Barrier Failed.",
+};
+
+/**
+ * The barrier line: "Opening Barrier Success at Entry Gate 1." - or the plain
+ * "Opening Barrier Success." when the camera is not named.
+ */
+export function barrierMessage(outcome: TBarrierOutcome, camera?: string): string {
+  const plain = BARRIER_MESSAGES[outcome];
+  const name = String(camera ?? "").trim();
+  return name ? `${plain.replace(/\.$/, "")} at ${name}.` : plain;
+}
+
+/** The camera named in a server reply ("Entry Gate 1"), if it has one. */
+export function barrierCameraOf(data: unknown): string | undefined {
+  const value = (data as { barrierCamera?: unknown } | null | undefined)?.barrierCamera;
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+
+/** The barrier outcome in a server reply, if it has one. */
+export function barrierOf(data: unknown): TBarrierOutcome | undefined {
+  const value = (data as { barrier?: unknown } | null | undefined)?.barrier;
+  return value === "opened" || value === "failed" ? value : undefined;
+}

package/utils/visitor-camera.ts

@@ -0,0 +1,80 @@
+/**
+ * The ANPR camera a visit is checked at for a blocked plate and whose barrier
+ * opens for it (owner, 2026-10-23). Mirrors isecure365's
+ * `visitor-camera.helpers.ts`.
+ *
+ * Only an ACTIVE camera of type Entry, Both Entry and Exit or Visitors can do
+ * that. When a site has more than one, the user may pick a default from the
+ * visitor list (a camera icon beside the pagination); it is saved per site on
+ * their user as `defaultCameraGate: [{ site, cameraGateNumber }]` and sent as
+ * `anprGate` with add, register and guest check-in. None picked, or a gate no
+ * longer there: the server uses the site's first camera.
+ */
+export const VISITOR_CAMERA_DIRECTIONS = ["entry", "both", "visitors"];
+
+const DIRECTION_LABELS: Record<string, string> = {
+  entry: "Entry",
+  both: "Both Entry and Exit",
+  visitors: "Visitors",
+};
+
+export type TVisitorCameraChoice = { value: number; title: string };
+
+type TCameraLike = { _id?: unknown; direction?: unknown; host?: unknown; gate?: unknown; status?: unknown };
+
+/** The port in a camera's address; the protocol's default when none is written. */
+export function cameraPort(host: unknown): string {
+  const text = String(host ?? "").trim();
+  if (!text) return "";
+  const withoutScheme = text.replace(/^[a-z][a-z0-9+.-]*:\/\//i, "");
+  const hostPart = withoutScheme.split(/[/?#]/)[0] ?? "";
+  const port = hostPart.match(/:(\d+)$/)?.[1];
+  if (port) return port;
+  return /^https:\/\//i.test(text) ? "443" : "80";
+}
+
+function gateOf(camera: { gate?: unknown } | null | undefined): number | null {
+  const gate = Number(camera?.gate);
+  return Number.isInteger(gate) && gate >= 1 ? gate : null;
+}
+
+/** "Entry Gate 1"; a camera with no gate saved yet: "Entry:8001". */
+export function visitorCameraLabel(camera: TCameraLike): string {
+  const direction = String(camera?.direction ?? "").toLowerCase();
+  const type = DIRECTION_LABELS[direction] ?? direction;
+  const gate = gateOf(camera);
+  if (gate) return `${type} Gate ${gate}`;
+  const port = cameraPort(camera?.host);
+  return port ? `${type}:${port}` : type;
+}
+
+/** The site's active Entry, Both and Visitors ANPR cameras. */
+export function visitorCameras(cameras: unknown): TCameraLike[] {
+  const list = Array.isArray(cameras) ? (cameras as TCameraLike[]) : [];
+  return list.filter(
+    (camera) =>
+      Boolean(camera?._id) &&
+      String(camera?.status ?? "active") === "active" &&
+      VISITOR_CAMERA_DIRECTIONS.includes(String(camera?.direction ?? "").toLowerCase()),
+  );
+}
+
+/** The gates that can be picked as the default ("Entry Gate 1"); a camera with no gate cannot. */
+export function visitorGateChoices(cameras: unknown): TVisitorCameraChoice[] {
+  return visitorCameras(cameras)
+    .filter((camera) => gateOf(camera) !== null)
+    .map((camera) => ({ value: gateOf(camera) as number, title: visitorCameraLabel(camera) }))
+    .sort((a, b) => a.value - b.value);
+}
+
+/** The user's default gate at this site, or undefined. */
+export function defaultGateForSite(saved: unknown, siteId: unknown): number | undefined {
+  if (!siteId || !Array.isArray(saved)) return undefined;
+  const entry = (saved as Array<{ site?: unknown; cameraGateNumber?: unknown }>).find(
+    (item) => String(item?.site ?? "") === String(siteId),
+  );
+  const gate = Number(entry?.cameraGateNumber);
+  return Number.isInteger(gate) && gate >= 1 ? gate : undefined;
+}
+
+export const VISITOR_CAMERA_LABEL = "Default ANPR Camera";