@gelabs/ovr 0.2.1 → 0.2.2

package/dist/offline.d.ts

@@ -76,24 +76,6 @@ declare function sync(): Promise<void>;
 /** Issue a ticket from the device. Returns the enriched ticket (shown inline). */
 declare function issueTicketOffline(input: NewTicketInput, rules: RulesConfig): Promise<Ticket>;
 
-/** All locally-stored tickets, newest first. `undefined` while loading. */
-declare function useTickets(): Ticket[] | undefined;
-declare function useCatalog(): ViolationCatalogItem[] | undefined;
-declare function useOfficers(): Officer[] | undefined;
-/** Cached dashboard stats (as-of last sync). `undefined` until first sync. */
-declare function useStats(): TicketStats | undefined;
-/** A single ticket by number: `undefined` while loading, `null` if not stored. */
-declare function useTicket(ovrTicketNo: string): Ticket | undefined | null;
-/** ovrTicketNos still waiting to sync (present in the outbox). Reactive. */
-declare function usePendingSync(): Set<string>;
-interface SyncState {
-    syncing: boolean;
-    online: boolean;
-    error: string | null;
-}
-/** Pull from the API on mount (if online) and whenever connectivity returns. */
-declare function useSync(): SyncState;
-
 interface AdminIdentity {
     userId: string;
     username: string;
@@ -123,4 +105,25 @@ declare function cacheCredential(username: string, password: string, identity: A
  *  sets the active identity and returns it; otherwise null. */
 declare function verifyOffline(username: string, password: string): Promise<AdminIdentity | null>;
 
-export { type AdminIdentity, type AuthState, type MetaRow, type OutboxRow, type PushResult, SessionExpired, type SyncState, cacheCredential, clearIdentity, db, ensureLease, getIdentity, getMeta, isOnline, issueTicketOffline, offlineApiBase, pullAll, pushOutbox, setMeta, setOfflineApiBase, sync, useAdminAuth, useCatalog, useOfficers, usePendingSync, useStats, useSync, useTicket, useTickets, verifyOffline };
+/** All locally-stored tickets, newest first. `undefined` while loading. */
+declare function useTickets(): Ticket[] | undefined;
+declare function useCatalog(): ViolationCatalogItem[] | undefined;
+declare function useOfficers(): Officer[] | undefined;
+/** The signed-in admin identity (cached locally), reactive. `undefined` while
+ *  loading, `null` if signed out. Used to tailor the admin UI to the role. */
+declare function useIdentity(): AdminIdentity | null | undefined;
+/** Cached dashboard stats (as-of last sync). `undefined` until first sync. */
+declare function useStats(): TicketStats | undefined;
+/** A single ticket by number: `undefined` while loading, `null` if not stored. */
+declare function useTicket(ovrTicketNo: string): Ticket | undefined | null;
+/** ovrTicketNos still waiting to sync (present in the outbox). Reactive. */
+declare function usePendingSync(): Set<string>;
+interface SyncState {
+    syncing: boolean;
+    online: boolean;
+    error: string | null;
+}
+/** Pull from the API on mount (if online) and whenever connectivity returns. */
+declare function useSync(): SyncState;
+
+export { type AdminIdentity, type AuthState, type MetaRow, type OutboxRow, type PushResult, SessionExpired, type SyncState, cacheCredential, clearIdentity, db, ensureLease, getIdentity, getMeta, isOnline, issueTicketOffline, offlineApiBase, pullAll, pushOutbox, setMeta, setOfflineApiBase, sync, useAdminAuth, useCatalog, useIdentity, useOfficers, usePendingSync, useStats, useSync, useTicket, useTickets, verifyOffline };

package/dist/offline.js

@@ -1,376 +1,3 @@
 "use client";
-import { makeOvrTicketNo, addDays, makeBillNo, makeOrderOfPaymentNo, enrich } from './chunk-B634JHKZ.js';
-import Dexie from 'dexie';
-import { useLiveQuery } from 'dexie-react-hooks';
-import { useState, useEffect } from 'react';
-
-var db = new Dexie("eovr-offline");
-db.version(1).stores({
-  tickets: "ovrTicketNo, paymentStatus, createdAt",
-  catalog: "code, category",
-  officers: "id",
-  meta: "key"
-});
-db.version(2).stores({
-  outbox: "ovrTicketNo, status, createdAt"
-});
-async function getMeta(key) {
-  const row = await db.meta.get(key);
-  return row?.value;
-}
-async function setMeta(key, value) {
-  await db.meta.put({ key, value });
-}
-
-// ../ovr-offline/src/sync.ts
-var API = "/api";
-var LEASE_MIN = 10;
-var LEASE_BATCH = 50;
-function setOfflineApiBase(base) {
-  API = base.replace(/\/$/, "");
-}
-function offlineApiBase() {
-  return API;
-}
-var SessionExpired = class extends Error {
-  constructor() {
-    super("session_expired");
-    this.name = "SessionExpired";
-  }
-};
-function isOnline() {
-  return typeof navigator !== "undefined" ? navigator.onLine : true;
-}
-async function call(path, init) {
-  let res;
-  try {
-    res = await fetch(`${API}${path}`, { credentials: "include", ...init });
-  } catch {
-    return null;
-  }
-  if (res.status === 401) throw new SessionExpired();
-  return res;
-}
-var postInit = (body) => ({
-  method: "POST",
-  headers: { "content-type": "application/json" },
-  body: JSON.stringify(body)
-});
-async function ensureLease(min = LEASE_MIN) {
-  if (!isOnline()) return;
-  const seqs = await getMeta("leaseSeqs") ?? [];
-  if (seqs.length >= min) return;
-  const res = await call("/sync/lease", postInit({ count: LEASE_BATCH }));
-  if (!res || !res.ok) return;
-  const { seqs: fresh } = await res.json();
-  await setMeta("leaseSeqs", [...seqs, ...fresh]);
-}
-async function pushOutbox() {
-  const pending = await db.outbox.toArray();
-  if (!pending.length) return;
-  const res = await call(
-    "/sync/push",
-    postInit({ tickets: pending.map((p) => p.payload) })
-  );
-  if (!res || !res.ok) return;
-  const { results } = await res.json();
-  await db.transaction("rw", db.outbox, db.tickets, async () => {
-    for (const r of results) {
-      if (r.ok) {
-        await db.outbox.delete(r.ovrTicketNo);
-        if (r.ticket) await db.tickets.put(r.ticket);
-      } else {
-        await db.outbox.update(r.ovrTicketNo, { status: "error", error: r.error });
-      }
-    }
-  });
-}
-async function pullAll() {
-  const [t, c, o, s] = await Promise.all([
-    call("/tickets"),
-    call("/violations"),
-    call("/officers"),
-    call("/tickets/stats")
-  ]);
-  if (!t || !c || !o || !s) return;
-  if (!t.ok || !c.ok || !o.ok || !s.ok) {
-    throw new Error(
-      `sync.pullAll failed: tickets=${t.status} catalog=${c.status} officers=${o.status} stats=${s.status}`
-    );
-  }
-  const tickets = await t.json();
-  const catalog = await c.json();
-  const officers = await o.json();
-  const stats = await s.json();
-  await db.transaction(
-    "rw",
-    db.tickets,
-    db.catalog,
-    db.officers,
-    db.meta,
-    async () => {
-      await db.tickets.bulkPut(tickets);
-      await db.catalog.clear();
-      await db.catalog.bulkPut(catalog);
-      await db.officers.clear();
-      await db.officers.bulkPut(officers);
-      await db.meta.put({ key: "stats", value: stats });
-    }
-  );
-  await setMeta("lastSyncedAt", (/* @__PURE__ */ new Date()).toISOString());
-}
-async function sync() {
-  if (!isOnline()) return;
-  await pushOutbox();
-  await ensureLease();
-  await pullAll();
-}
-
-// ../ovr-offline/src/issue.ts
-async function popSeq() {
-  return db.transaction("rw", db.meta, async () => {
-    const row = await db.meta.get("leaseSeqs");
-    const seqs = row?.value ?? [];
-    if (seqs.length === 0) return null;
-    await db.meta.put({ key: "leaseSeqs", value: seqs.slice(1) });
-    return seqs[0];
-  });
-}
-async function issueTicketOffline(input, rules) {
-  let seq = await popSeq();
-  if (seq === null && isOnline()) {
-    await ensureLease(50);
-    seq = await popSeq();
-  }
-  if (seq === null) {
-    throw new Error(
-      isOnline() ? "Couldn't reserve ticket numbers \u2014 please try again." : "No offline ticket numbers left. Reconnect to the internet to reserve more."
-    );
-  }
-  const now = /* @__PURE__ */ new Date();
-  const ovrTicketNo = makeOvrTicketNo(rules.idPrefix, now.getFullYear(), seq);
-  const officer = await db.officers.get(input.officerId);
-  if (!officer) {
-    const cur = await getMeta("leaseSeqs") ?? [];
-    await setMeta("leaseSeqs", [seq, ...cur]);
-    throw new Error("That officer isn't available offline. Sync and try again.");
-  }
-  const catalog = await db.catalog.toArray();
-  const byCode = new Map(catalog.map((c) => [c.code, c]));
-  const violations = input.violations.map((x) => {
-    const c = byCode.get(x.catalogCode);
-    if (!c) throw new Error(`Unknown violation: ${x.catalogCode}`);
-    const v = {
-      catalogCode: c.code,
-      title: c.title,
-      basicFine: c.basicFine
-    };
-    if (x.details?.trim()) v.details = x.details.trim();
-    return v;
-  });
-  const basicFinesTotal = violations.reduce((s, v) => s + v.basicFine, 0);
-  const record = {
-    ovrTicketNo,
-    orderOfPaymentNo: makeOrderOfPaymentNo(ovrTicketNo),
-    billNo: makeBillNo(now, officer.office, officer.badgeNo ?? "X000", seq),
-    violator: input.violator,
-    apprehendedAt: input.apprehendedAt,
-    officer,
-    violations,
-    assessedAt: now.toISOString(),
-    dueDate: addDays(now, rules.dueWindowDays).toISOString(),
-    basicFinesTotal,
-    paymentStatus: "UNPAID",
-    createdAt: now.toISOString()
-  };
-  if (input.placeOfViolation?.trim())
-    record.placeOfViolation = input.placeOfViolation.trim();
-  if (input.remarks?.trim()) record.remarks = input.remarks.trim();
-  const ticket = enrich(record, now, rules.surchargeRatePerMonth);
-  await db.transaction("rw", db.tickets, db.outbox, async () => {
-    await db.tickets.put(ticket);
-    await db.outbox.put({
-      ovrTicketNo,
-      createdAt: record.createdAt,
-      status: "pending",
-      payload: {
-        ovrTicketNo,
-        createdAt: record.createdAt,
-        violator: input.violator,
-        apprehendedAt: input.apprehendedAt,
-        ...record.placeOfViolation ? { placeOfViolation: record.placeOfViolation } : {},
-        officerId: input.officerId,
-        violations: input.violations,
-        ...record.remarks ? { remarks: record.remarks } : {}
-      }
-    });
-  });
-  if (isOnline()) void pushOutbox().catch(() => {
-  });
-  return ticket;
-}
-async function getIdentity() {
-  return await getMeta("identity") ?? void 0;
-}
-async function clearIdentity() {
-  await setMeta("identity", null);
-}
-function useAdminAuth() {
-  const [state, setState] = useState({ status: "loading" });
-  useEffect(() => {
-    let cancelled = false;
-    (async () => {
-      const cached = await getMeta("identity");
-      if (isOnline()) {
-        try {
-          const res = await fetch(`${offlineApiBase()}/auth/me`, {
-            credentials: "include"
-          });
-          if (res.ok) {
-            const { user } = await res.json();
-            await setMeta("identity", user);
-            if (!cancelled) setState({ status: "authed", user });
-            return;
-          }
-          await setMeta("identity", null);
-          if (!cancelled) setState({ status: "unauthed" });
-          return;
-        } catch {
-        }
-      }
-      if (!cancelled) {
-        setState(
-          cached ? { status: "authed", user: cached } : { status: "unauthed" }
-        );
-      }
-    })();
-    return () => {
-      cancelled = true;
-    };
-  }, []);
-  return state;
-}
-var PBKDF2_ITERATIONS = 21e4;
-function subtle() {
-  return typeof crypto !== "undefined" && crypto.subtle ? crypto.subtle : null;
-}
-var toHex = (buf) => Array.from(new Uint8Array(buf), (b) => b.toString(16).padStart(2, "0")).join(
-  ""
-);
-function fromHex(hex) {
-  const out = new Uint8Array(hex.length / 2);
-  for (let i = 0; i < out.length; i++)
-    out[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
-  return out;
-}
-async function deriveHashHex(password, salt, iterations) {
-  const s = subtle();
-  if (!s) return null;
-  const keyMaterial = await s.importKey(
-    "raw",
-    new TextEncoder().encode(password),
-    "PBKDF2",
-    false,
-    ["deriveBits"]
-  );
-  const bits = await s.deriveBits(
-    { name: "PBKDF2", salt, iterations, hash: "SHA-256" },
-    keyMaterial,
-    256
-  );
-  return toHex(bits);
-}
-async function cacheCredential(username, password, identity) {
-  if (!subtle()) return;
-  const salt = crypto.getRandomValues(new Uint8Array(16));
-  const hashHex = await deriveHashHex(password, salt, PBKDF2_ITERATIONS);
-  if (!hashHex) return;
-  const cred = {
-    username: username.trim(),
-    saltHex: toHex(salt.buffer),
-    hashHex,
-    iterations: PBKDF2_ITERATIONS,
-    identity
-  };
-  await setMeta("credential", cred);
-}
-async function verifyOffline(username, password) {
-  const cred = await getMeta("credential");
-  if (!cred || cred.username !== username.trim()) return null;
-  const hashHex = await deriveHashHex(
-    password,
-    fromHex(cred.saltHex),
-    cred.iterations
-  );
-  if (!hashHex || hashHex !== cred.hashHex) return null;
-  await setMeta("identity", cred.identity);
-  return cred.identity;
-}
-
-// ../ovr-offline/src/hooks.ts
-function useTickets() {
-  return useLiveQuery(() => db.tickets.orderBy("createdAt").reverse().toArray());
-}
-function useCatalog() {
-  return useLiveQuery(() => db.catalog.orderBy("category").toArray());
-}
-function useOfficers() {
-  return useLiveQuery(() => db.officers.toArray());
-}
-function useStats() {
-  return useLiveQuery(
-    async () => (await db.meta.get("stats"))?.value
-  );
-}
-function useTicket(ovrTicketNo) {
-  return useLiveQuery(
-    async () => await db.tickets.get(ovrTicketNo) ?? null,
-    [ovrTicketNo]
-  );
-}
-function usePendingSync() {
-  const rows = useLiveQuery(() => db.outbox.toArray());
-  return new Set((rows ?? []).map((r) => r.ovrTicketNo));
-}
-function useSync() {
-  const [syncing, setSyncing] = useState(false);
-  const [online, setOnline] = useState(true);
-  const [error, setError] = useState(null);
-  useEffect(() => {
-    let cancelled = false;
-    setOnline(isOnline());
-    async function runSyncCycle() {
-      if (!isOnline()) return;
-      setSyncing(true);
-      setError(null);
-      try {
-        await sync();
-      } catch (e) {
-        if (e instanceof SessionExpired) {
-          await clearIdentity();
-          window.location.assign("/admin/login");
-          return;
-        }
-        if (!cancelled) setError(e instanceof Error ? e.message : "sync failed");
-      } finally {
-        if (!cancelled) setSyncing(false);
-      }
-    }
-    const onOnline = () => {
-      setOnline(true);
-      void runSyncCycle();
-    };
-    const onOffline = () => setOnline(false);
-    void runSyncCycle();
-    window.addEventListener("online", onOnline);
-    window.addEventListener("offline", onOffline);
-    return () => {
-      cancelled = true;
-      window.removeEventListener("online", onOnline);
-      window.removeEventListener("offline", onOffline);
-    };
-  }, []);
-  return { syncing, online, error };
-}
-
-export { SessionExpired, cacheCredential, clearIdentity, db, ensureLease, getIdentity, getMeta, isOnline, issueTicketOffline, offlineApiBase, pullAll, pushOutbox, setMeta, setOfflineApiBase, sync, useAdminAuth, useCatalog, useOfficers, usePendingSync, useStats, useSync, useTicket, useTickets, verifyOffline };
+export { SessionExpired, cacheCredential, clearIdentity, db, ensureLease, getIdentity, getMeta, isOnline, issueTicketOffline, offlineApiBase, pullAll, pushOutbox, setMeta, setOfflineApiBase, sync, useAdminAuth, useCatalog, useIdentity, useOfficers, usePendingSync, useStats, useSync, useTicket, useTickets, verifyOffline } from './chunk-IB4JVGKJ.js';
+import './chunk-B634JHKZ.js';

package/dist/types.d.ts

@@ -64,6 +64,7 @@ interface TicketRecord {
     officer: Officer;
     violations: IssuedViolation[];
     remarks?: string;
+    issuedBy?: string;
     assessedAt: string;
     dueDate: string;
     basicFinesTotal: number;

package/dist/ui-components-admin/admin-nav.js

@@ -3,6 +3,7 @@ import { Dialog, DialogTrigger, DialogContent, DialogHeader, DialogTitle, Dialog
 import { Button } from '../chunk-I4WDVYHX.js';
 import { useCopy } from '../chunk-E2D7QT6N.js';
 import { cn } from '../chunk-77QBZC7J.js';
+import { useIdentity } from '../chunk-IB4JVGKJ.js';
 import '../chunk-B634JHKZ.js';
 import Link from 'next/link';
 import { usePathname } from 'next/navigation';
@@ -21,8 +22,10 @@ function AdminNav({
 }) {
   const pathname = usePathname();
   const copy = useCopy();
+  const identity = useIdentity();
+  const limited = identity?.role === "ENFORCER";
   const nav = [
-    { href: "/admin", label: copy.admin.dashboard, icon: LayoutDashboard },
+    ...limited ? [] : [{ href: "/admin", label: copy.admin.dashboard, icon: LayoutDashboard }],
     { href: "/admin/tickets", label: copy.admin.tickets, icon: ListChecks },
     { href: "/admin/tickets/new", label: copy.admin.issueTicket, icon: FilePlus2 }
   ];

package/dist/ui-components-admin/issuance-form.js

@@ -1,9 +1,9 @@
 "use client";
+import { Skeleton } from '../chunk-EGKFELO3.js';
 import { Textarea } from '../chunk-QCRVT2SS.js';
+import { Checkbox } from '../chunk-BBQBKQA4.js';
 import { Input } from '../chunk-K3KIBHJF.js';
 import { Label } from '../chunk-XQTVSNHC.js';
-import { Skeleton } from '../chunk-EGKFELO3.js';
-import { Checkbox } from '../chunk-BBQBKQA4.js';
 import { TicketPreview } from '../chunk-GDOCD7LT.js';
 import '../chunk-JEYT63LE.js';
 import '../chunk-BIQ2J75Y.js';
@@ -124,6 +124,7 @@ function IssuanceForm({
   const [officerId, setOfficerId] = React.useState(officers[0]?.id ?? "");
   const [selected, setSelected] = React.useState({});
   const [remarks, setRemarks] = React.useState("");
+  const [issuedBy, setIssuedBy] = React.useState("");
   const [mounted, setMounted] = React.useState(false);
   const [open, setOpen] = React.useState(false);
   const [error, setError] = React.useState(null);
@@ -175,7 +176,8 @@ function IssuanceForm({
         catalogCode,
         details: details || void 0
       })),
-      remarks: remarks || void 0
+      remarks: remarks || void 0,
+      issuedBy: issuedBy || void 0
     };
     startTransition(async () => {
       const res = await createAction(input);
@@ -284,15 +286,27 @@ function IssuanceForm({
       ] }),
       /* @__PURE__ */ jsxs(Card, { children: [
         /* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsx(CardTitle, { className: "text-base", children: "Remarks" }) }),
-        /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx(
-          Textarea,
-          {
-            value: remarks,
-            onChange: (e) => setRemarks(e.target.value),
-            placeholder: "Optional notes for this ticket.",
-            rows: 3
-          }
-        ) })
+        /* @__PURE__ */ jsxs(CardContent, { className: "space-y-3", children: [
+          /* @__PURE__ */ jsx(
+            Textarea,
+            {
+              value: remarks,
+              onChange: (e) => setRemarks(e.target.value),
+              placeholder: "Optional notes for this ticket.",
+              rows: 3
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            TextField,
+            {
+              id: "issuedBy",
+              label: "Issued by",
+              value: issuedBy,
+              onChange: setIssuedBy,
+              placeholder: "Optional \u2014 name shown on the receipt"
+            }
+          )
+        ] })
       ] })
     ] }),
     /* @__PURE__ */ jsx("div", { className: "lg:col-span-2", children: /* @__PURE__ */ jsxs("div", { className: "space-y-4 lg:sticky lg:top-6", children: [

package/dist/ui-components-shared/ticket-receipt.js

@@ -63,7 +63,8 @@ function TicketReceipt({ ticket }) {
           label: "Apprehending Officer",
           value: `${ticket.officer.name}${ticket.officer.badgeNo ? ` (${ticket.officer.badgeNo})` : ""}`
         }
-      )
+      ),
+      ticket.issuedBy ? /* @__PURE__ */ jsx(Field, { label: "Issued By", value: ticket.issuedBy }) : null
     ] }),
     /* @__PURE__ */ jsxs("div", { className: "mt-6 print:mt-3", children: [
       /* @__PURE__ */ jsx("p", { className: "mb-2 text-sm font-medium print:mb-1", children: "Violations" }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gelabs/ovr",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "The @gelabs/ovr SDK — one self-contained package over the OVR (Online Ordinance Violation Receipt) platform. A standalone per-LGU app installs ONLY this package and imports from @gelabs/ovr/{config,core,data,runtime,auth,ui,...}; the seven @gelabs/ovr-* implementation packages are bundled in at build time.",
   "type": "module",
   "license": "UNLICENSED",
@@ -161,10 +161,10 @@
     "@gelabs/ovr-types": "0.0.0",
     "@gelabs/ovr-config": "0.0.0",
     "@gelabs/ovr-data": "0.0.0",
-    "@gelabs/ovr-core": "0.0.0",
-    "@gelabs/ovr-auth": "0.0.0",
     "@gelabs/ovr-ui": "0.0.0",
     "@gelabs/ovr-offline": "0.0.0",
+    "@gelabs/ovr-core": "0.0.0",
+    "@gelabs/ovr-auth": "0.0.0",
     "@gelabs/ovr-runtime": "0.0.0"
   },
   "scripts": {

package/prisma/migrations/20260622000000_add_issued_by/migration.sql

@@ -0,0 +1,2 @@
+-- Optional "Issued by" name shown on the receipt (enforcer-entered).
+ALTER TABLE "Ticket" ADD COLUMN "issuedBy" TEXT;

package/prisma/schema.prisma

@@ -92,6 +92,7 @@ model Ticket {
   apprehendedAt    DateTime
   placeOfViolation String?
   remarks          String?
+  issuedBy         String?
 
   officerId String
   officer   Officer @relation(fields: [officerId], references: [id])