openchs-models 1.33.45 → 1.33.47

package/dist/AttendanceRecord.js

@@ -0,0 +1,127 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _BaseEntity = _interopRequireDefault(require("./BaseEntity"));
+var _SchemaNames = _interopRequireDefault(require("./SchemaNames"));
+var _AuditUtil = require("./utility/AuditUtil");
+var _lodash = _interopRequireDefault(require("lodash"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+class AttendanceRecord extends _BaseEntity.default {
+  constructor(that = null) {
+    super(that);
+  }
+  get sessionUUID() {
+    return this.that.sessionUUID;
+  }
+  set sessionUUID(x) {
+    this.that.sessionUUID = x;
+  }
+  get subjectUUID() {
+    return this.that.subjectUUID;
+  }
+  set subjectUUID(x) {
+    this.that.subjectUUID = x;
+  }
+  get status() {
+    return this.that.status;
+  }
+  set status(x) {
+    this.that.status = x;
+  }
+  get reasonConceptUUID() {
+    return this.that.reasonConceptUUID;
+  }
+  set reasonConceptUUID(x) {
+    this.that.reasonConceptUUID = x;
+  }
+  get followUpEncounterUUID() {
+    return this.that.followUpEncounterUUID;
+  }
+  set followUpEncounterUUID(x) {
+    this.that.followUpEncounterUUID = x;
+  }
+  get createdBy() {
+    return this.that.createdBy;
+  }
+  set createdBy(x) {
+    this.that.createdBy = x;
+  }
+  get lastModifiedBy() {
+    return this.that.lastModifiedBy;
+  }
+  set lastModifiedBy(x) {
+    this.that.lastModifiedBy = x;
+  }
+  get createdByUUID() {
+    return this.that.createdByUUID;
+  }
+  set createdByUUID(x) {
+    this.that.createdByUUID = x;
+  }
+  get lastModifiedByUUID() {
+    return this.that.lastModifiedByUUID;
+  }
+  set lastModifiedByUUID(x) {
+    this.that.lastModifiedByUUID = x;
+  }
+  isPresent() {
+    return this.status === AttendanceRecord.status.PRESENT;
+  }
+  isAbsent() {
+    return this.status === AttendanceRecord.status.ABSENT;
+  }
+  static fromResource(resource) {
+    const record = new AttendanceRecord();
+    record.uuid = resource.uuid;
+    record.sessionUUID = resource.sessionUUID;
+    record.subjectUUID = resource.subjectUUID;
+    record.status = resource.status;
+    record.reasonConceptUUID = resource.reasonConceptUUID || null;
+    record.followUpEncounterUUID = resource.followUpEncounterUUID || null;
+    record.voided = !!resource.voided;
+    (0, _AuditUtil.mapAuditFields)(record, resource);
+    return record;
+  }
+  get toResource() {
+    const resource = _lodash.default.pick(this, ["uuid", "sessionUUID", "subjectUUID", "status", "voided"]);
+    resource.reasonConceptUUID = this.reasonConceptUUID || null;
+    resource.followUpEncounterUUID = this.followUpEncounterUUID || null;
+    return resource;
+  }
+}
+_defineProperty(AttendanceRecord, "schema", {
+  name: _SchemaNames.default.AttendanceRecord,
+  primaryKey: "uuid",
+  properties: _objectSpread({
+    uuid: "string",
+    sessionUUID: "string",
+    subjectUUID: "string",
+    status: "string",
+    reasonConceptUUID: {
+      type: "string",
+      optional: true
+    },
+    followUpEncounterUUID: {
+      type: "string",
+      optional: true
+    },
+    voided: {
+      type: "bool",
+      default: false
+    }
+  }, _AuditUtil.AuditFields)
+});
+_defineProperty(AttendanceRecord, "status", {
+  PRESENT: "Present",
+  ABSENT: "Absent"
+});
+var _default = AttendanceRecord;
+exports.default = _default;

package/dist/AttendanceType.js

@@ -0,0 +1,147 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _BaseEntity = _interopRequireDefault(require("./BaseEntity"));
+var _SchemaNames = _interopRequireDefault(require("./SchemaNames"));
+var _AuditUtil = require("./utility/AuditUtil");
+var _lodash = _interopRequireDefault(require("lodash"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+const CONFIG_KEYS = {
+  SESSION_OUTCOME_REASON_CONCEPT_UUID: "session_outcome_reason_concept_uuid",
+  ABSENCE_REASON_CONCEPT_UUID: "absence_reason_concept_uuid",
+  FOLLOW_UP_ENCOUNTER_TYPE_UUID: "follow_up_encounter_type_uuid",
+  SHARE_RULE: "share_rule",
+  AUTO_SHARE_ON_SAVE: "auto_share_on_save"
+};
+class AttendanceType extends _BaseEntity.default {
+  constructor(that = null) {
+    super(that);
+  }
+  get subjectTypeUUID() {
+    return this.that.subjectTypeUUID;
+  }
+  set subjectTypeUUID(x) {
+    this.that.subjectTypeUUID = x;
+  }
+  get name() {
+    return this.that.name;
+  }
+  set name(x) {
+    this.that.name = x;
+  }
+  get sortOrder() {
+    return this.that.sortOrder;
+  }
+  set sortOrder(x) {
+    this.that.sortOrder = x;
+  }
+  get config() {
+    return this.that.config;
+  }
+  set config(x) {
+    this.that.config = x;
+  }
+  get createdBy() {
+    return this.that.createdBy;
+  }
+  set createdBy(x) {
+    this.that.createdBy = x;
+  }
+  get lastModifiedBy() {
+    return this.that.lastModifiedBy;
+  }
+  set lastModifiedBy(x) {
+    this.that.lastModifiedBy = x;
+  }
+  get createdByUUID() {
+    return this.that.createdByUUID;
+  }
+  set createdByUUID(x) {
+    this.that.createdByUUID = x;
+  }
+  get lastModifiedByUUID() {
+    return this.that.lastModifiedByUUID;
+  }
+  set lastModifiedByUUID(x) {
+    this.that.lastModifiedByUUID = x;
+  }
+  getConfig() {
+    if (_lodash.default.isEmpty(this.config)) return {};
+    try {
+      return JSON.parse(this.config);
+    } catch (_e) {
+      return {};
+    }
+  }
+  setConfig(obj) {
+    this.config = JSON.stringify(obj || {});
+  }
+  getSessionOutcomeReasonConceptUUID() {
+    return this.getConfig()[CONFIG_KEYS.SESSION_OUTCOME_REASON_CONCEPT_UUID] || null;
+  }
+  getAbsenceReasonConceptUUID() {
+    return this.getConfig()[CONFIG_KEYS.ABSENCE_REASON_CONCEPT_UUID] || null;
+  }
+  getFollowUpEncounterTypeUUID() {
+    return this.getConfig()[CONFIG_KEYS.FOLLOW_UP_ENCOUNTER_TYPE_UUID] || null;
+  }
+  getShareRule() {
+    return this.getConfig()[CONFIG_KEYS.SHARE_RULE] || null;
+  }
+  isAutoShareOnSave() {
+    return !!this.getConfig()[CONFIG_KEYS.AUTO_SHARE_ON_SAVE];
+  }
+  static fromResource(resource) {
+    const at = new AttendanceType();
+    at.uuid = resource.uuid;
+    at.subjectTypeUUID = resource.subjectTypeUUID;
+    at.name = resource.name;
+    at.sortOrder = _lodash.default.isNil(resource.sortOrder) ? 0 : resource.sortOrder;
+    const config = resource.config;
+    if (_lodash.default.isNil(config)) {
+      at.config = "{}";
+    } else if (_lodash.default.isString(config)) {
+      at.config = config;
+    } else {
+      at.config = JSON.stringify(config);
+    }
+    at.voided = !!resource.voided;
+    (0, _AuditUtil.mapAuditFields)(at, resource);
+    return at;
+  }
+  get toResource() {
+    return _lodash.default.pick(this, ["uuid", "subjectTypeUUID", "name", "sortOrder", "config", "voided"]);
+  }
+}
+_defineProperty(AttendanceType, "schema", {
+  name: _SchemaNames.default.AttendanceType,
+  primaryKey: "uuid",
+  properties: _objectSpread({
+    uuid: "string",
+    subjectTypeUUID: "string",
+    name: "string",
+    sortOrder: {
+      type: "int",
+      default: 0
+    },
+    config: {
+      type: "string",
+      default: "{}"
+    },
+    voided: {
+      type: "bool",
+      default: false
+    }
+  }, _AuditUtil.AuditFields)
+});
+_defineProperty(AttendanceType, "configKeys", CONFIG_KEYS);
+var _default = AttendanceType;
+exports.default = _default;

package/dist/Calendar.js

@@ -0,0 +1,225 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _BaseEntity = _interopRequireDefault(require("./BaseEntity"));
+var _General = _interopRequireDefault(require("./utility/General"));
+var _SchemaNames = _interopRequireDefault(require("./SchemaNames"));
+var _AuditUtil = require("./utility/AuditUtil");
+var _DateTimeUtil = _interopRequireDefault(require("./utility/DateTimeUtil"));
+var _lodash = _interopRequireDefault(require("lodash"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+const DAY_KEYS = ["sun", "mon", "tue", "wed", "thu", "fri", "sat"];
+const DEFAULT_WORKING_PATTERN = {
+  mon: "all",
+  tue: "all",
+  wed: "all",
+  thu: "all",
+  fri: "all",
+  sat: "none",
+  sun: "none"
+};
+class Calendar extends _BaseEntity.default {
+  constructor(that = null) {
+    super(that);
+  }
+  get name() {
+    return this.that.name;
+  }
+  set name(x) {
+    this.that.name = x;
+  }
+  get workingPattern() {
+    return this.that.workingPattern;
+  }
+  set workingPattern(x) {
+    this.that.workingPattern = x;
+  }
+  get addressLevelUUID() {
+    return this.that.addressLevelUUID;
+  }
+  set addressLevelUUID(x) {
+    this.that.addressLevelUUID = x;
+  }
+  get isDefault() {
+    return this.that.isDefault;
+  }
+  set isDefault(x) {
+    this.that.isDefault = x;
+  }
+  get createdBy() {
+    return this.that.createdBy;
+  }
+  set createdBy(x) {
+    this.that.createdBy = x;
+  }
+  get lastModifiedBy() {
+    return this.that.lastModifiedBy;
+  }
+  set lastModifiedBy(x) {
+    this.that.lastModifiedBy = x;
+  }
+  get createdByUUID() {
+    return this.that.createdByUUID;
+  }
+  set createdByUUID(x) {
+    this.that.createdByUUID = x;
+  }
+  get lastModifiedByUUID() {
+    return this.that.lastModifiedByUUID;
+  }
+  set lastModifiedByUUID(x) {
+    this.that.lastModifiedByUUID = x;
+  }
+  getWorkingPatternObject() {
+    if (_lodash.default.isEmpty(this.workingPattern)) return DEFAULT_WORKING_PATTERN;
+    try {
+      return JSON.parse(this.workingPattern);
+    } catch (_e) {
+      return DEFAULT_WORKING_PATTERN;
+    }
+  }
+
+  // Domain methods accept a calendar-date input as either a "YYYY-MM-DD" string
+  // or a JS Date. All comparisons happen on canonical "YYYY-MM-DD" strings;
+  // arithmetic uses moment.utc internally. Methods that return a calendar-date
+  // value return a "YYYY-MM-DD" string — never a Date — so consumers can't
+  // accidentally drift via locale-aware formatting.
+
+  _findActiveMarker(dateKey, markers) {
+    if (_lodash.default.isEmpty(markers) || _lodash.default.isNil(dateKey)) return null;
+    return _lodash.default.find(markers, m => {
+      if (!m || m.voided) return false;
+      if (m.calendarUUID !== this.uuid) return false;
+      return _DateTimeUtil.default.toCalendarDateString(m.markerDate) === dateKey;
+    }) || null;
+  }
+  dayType(date, markers = []) {
+    const dateKey = _DateTimeUtil.default.toCalendarDateString(date);
+    if (_lodash.default.isNil(dateKey)) return Calendar.dayType.WEEKLY_OFF;
+    const marker = this._findActiveMarker(dateKey, markers);
+    if (marker) {
+      return marker.isWorking ? Calendar.dayType.WORKING_OVERRIDE : Calendar.dayType.PUBLIC_HOLIDAY;
+    }
+    const d = _DateTimeUtil.default.calendarMoment(dateKey);
+    const dayKey = DAY_KEYS[d.day()];
+    const dayOfMonth = d.date();
+    const occurrence = Math.floor((dayOfMonth - 1) / 7) + 1;
+    const pattern = this.getWorkingPatternObject();
+    const slot = pattern[dayKey];
+    if (slot === "all") return Calendar.dayType.WORKING_DAY;
+    if (slot === "none") return Calendar.dayType.WEEKLY_OFF;
+    if (_lodash.default.isArray(slot)) {
+      return _lodash.default.includes(slot, occurrence) ? Calendar.dayType.WORKING_DAY : Calendar.dayType.WEEKLY_OFF;
+    }
+    return Calendar.dayType.WEEKLY_OFF;
+  }
+  isHoliday(date, markers = []) {
+    const t = this.dayType(date, markers);
+    return t === Calendar.dayType.WEEKLY_OFF || t === Calendar.dayType.PUBLIC_HOLIDAY;
+  }
+  isWorkingDay(date, markers = []) {
+    return !this.isHoliday(date, markers);
+  }
+
+  // Returns [{date: "YYYY-MM-DD", name}] sorted by date.
+  getHolidays(startDate, endDate, markers = []) {
+    if (_lodash.default.isEmpty(markers)) return [];
+    const startKey = _DateTimeUtil.default.toCalendarDateString(startDate);
+    const endKey = _DateTimeUtil.default.toCalendarDateString(endDate);
+    if (_lodash.default.isNil(startKey) || _lodash.default.isNil(endKey)) return [];
+    return _lodash.default.chain(markers).filter(m => m && !m.voided && m.calendarUUID === this.uuid && m.isWorking === false).map(m => ({
+      date: _DateTimeUtil.default.toCalendarDateString(m.markerDate),
+      name: m.name
+    })).filter(h => !_lodash.default.isNil(h.date) && h.date >= startKey && h.date <= endKey).sortBy("date").value();
+  }
+
+  // Returns "YYYY-MM-DD" (string), bounded scan ≤365 days, throws on exceed.
+  nextWorkingDay(date, markers = []) {
+    const startKey = _DateTimeUtil.default.toCalendarDateString(date);
+    if (_lodash.default.isNil(startKey)) throw new Error("Calendar.nextWorkingDay: invalid date");
+    let cursor = _DateTimeUtil.default.calendarMoment(startKey).add(1, "day");
+    for (let i = 0; i < 365; i++) {
+      const key = cursor.format("YYYY-MM-DD");
+      if (this.isWorkingDay(key, markers)) return key;
+      cursor.add(1, "day");
+    }
+    throw new Error(`Calendar '${this.name}': no working day found within 365 days after ${startKey}`);
+  }
+
+  // Returns "YYYY-MM-DD" (string), symmetric bounded scan.
+  previousWorkingDay(date, markers = []) {
+    const startKey = _DateTimeUtil.default.toCalendarDateString(date);
+    if (_lodash.default.isNil(startKey)) throw new Error("Calendar.previousWorkingDay: invalid date");
+    let cursor = _DateTimeUtil.default.calendarMoment(startKey).subtract(1, "day");
+    for (let i = 0; i < 365; i++) {
+      const key = cursor.format("YYYY-MM-DD");
+      if (this.isWorkingDay(key, markers)) return key;
+      cursor.subtract(1, "day");
+    }
+    throw new Error(`Calendar '${this.name}': no working day found within 365 days before ${startKey}`);
+  }
+  static fromResource(resource) {
+    const calendar = new Calendar();
+    calendar.uuid = resource.uuid;
+    calendar.name = resource.name;
+    const pattern = resource.workingPattern;
+    if (_lodash.default.isNil(pattern)) {
+      calendar.workingPattern = JSON.stringify(DEFAULT_WORKING_PATTERN);
+    } else if (_lodash.default.isString(pattern)) {
+      calendar.workingPattern = pattern;
+    } else {
+      calendar.workingPattern = JSON.stringify(pattern);
+    }
+    calendar.addressLevelUUID = resource.addressLevelUUID || null;
+    calendar.isDefault = !!resource.isDefault;
+    calendar.voided = !!resource.voided;
+    (0, _AuditUtil.mapAuditFields)(calendar, resource);
+    return calendar;
+  }
+  get toResource() {
+    const resource = _lodash.default.pick(this, ["uuid", "name", "workingPattern", "isDefault", "voided"]);
+    resource.addressLevelUUID = this.addressLevelUUID || null;
+    return resource;
+  }
+}
+_defineProperty(Calendar, "schema", {
+  name: _SchemaNames.default.Calendar,
+  primaryKey: "uuid",
+  properties: _objectSpread({
+    uuid: "string",
+    name: "string",
+    workingPattern: {
+      type: "string",
+      default: JSON.stringify(DEFAULT_WORKING_PATTERN)
+    },
+    addressLevelUUID: {
+      type: "string",
+      optional: true
+    },
+    isDefault: {
+      type: "bool",
+      default: false
+    },
+    voided: {
+      type: "bool",
+      default: false
+    }
+  }, _AuditUtil.AuditFields)
+});
+_defineProperty(Calendar, "dayType", {
+  WORKING_DAY: "working_day",
+  WEEKLY_OFF: "weekly_off",
+  PUBLIC_HOLIDAY: "public_holiday",
+  WORKING_OVERRIDE: "working_override"
+});
+_defineProperty(Calendar, "defaultWorkingPattern", DEFAULT_WORKING_PATTERN);
+var _default = Calendar;
+exports.default = _default;

package/dist/CalendarDateMarker.js

@@ -0,0 +1,110 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _BaseEntity = _interopRequireDefault(require("./BaseEntity"));
+var _General = _interopRequireDefault(require("./utility/General"));
+var _SchemaNames = _interopRequireDefault(require("./SchemaNames"));
+var _AuditUtil = require("./utility/AuditUtil");
+var _DateTimeUtil = _interopRequireDefault(require("./utility/DateTimeUtil"));
+var _lodash = _interopRequireDefault(require("lodash"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+class CalendarDateMarker extends _BaseEntity.default {
+  constructor(that = null) {
+    super(that);
+  }
+  get calendarUUID() {
+    return this.that.calendarUUID;
+  }
+  set calendarUUID(x) {
+    this.that.calendarUUID = x;
+  }
+  get markerDate() {
+    return this.that.markerDate;
+  }
+
+  // Accepts either a "YYYY-MM-DD" string or a JS Date; persists as a canonical
+  // "YYYY-MM-DD" string so storage carries zero TZ semantics.
+  set markerDate(x) {
+    this.that.markerDate = _DateTimeUtil.default.toCalendarDateString(x);
+  }
+  get name() {
+    return this.that.name;
+  }
+  set name(x) {
+    this.that.name = x;
+  }
+  get isWorking() {
+    return this.that.isWorking;
+  }
+  set isWorking(x) {
+    this.that.isWorking = x;
+  }
+  get createdBy() {
+    return this.that.createdBy;
+  }
+  set createdBy(x) {
+    this.that.createdBy = x;
+  }
+  get lastModifiedBy() {
+    return this.that.lastModifiedBy;
+  }
+  set lastModifiedBy(x) {
+    this.that.lastModifiedBy = x;
+  }
+  get createdByUUID() {
+    return this.that.createdByUUID;
+  }
+  set createdByUUID(x) {
+    this.that.createdByUUID = x;
+  }
+  get lastModifiedByUUID() {
+    return this.that.lastModifiedByUUID;
+  }
+  set lastModifiedByUUID(x) {
+    this.that.lastModifiedByUUID = x;
+  }
+  static fromResource(resource) {
+    const marker = new CalendarDateMarker();
+    marker.uuid = resource.uuid;
+    marker.calendarUUID = resource.calendarUUID;
+    marker.markerDate = _DateTimeUtil.default.toCalendarDateString(resource.markerDate);
+    marker.name = resource.name;
+    marker.isWorking = !!resource.isWorking;
+    marker.voided = !!resource.voided;
+    (0, _AuditUtil.mapAuditFields)(marker, resource);
+    return marker;
+  }
+  get toResource() {
+    return _lodash.default.pick(this, ["uuid", "calendarUUID", "markerDate", "name", "isWorking", "voided"]);
+  }
+}
+_defineProperty(CalendarDateMarker, "schema", {
+  name: _SchemaNames.default.CalendarDateMarker,
+  primaryKey: "uuid",
+  properties: _objectSpread({
+    uuid: "string",
+    calendarUUID: "string",
+    // markerDate is stored as a "YYYY-MM-DD" string so it carries zero TZ
+    // semantics. Mirrors the Postgres `date` type on the server side.
+    markerDate: "string",
+    name: "string",
+    isWorking: {
+      type: "bool",
+      default: false
+    },
+    voided: {
+      type: "bool",
+      default: false
+    }
+  }, _AuditUtil.AuditFields)
+});
+var _default = CalendarDateMarker;
+exports.default = _default;

package/dist/EntityMetaData.js

@@ -75,6 +75,11 @@ var _SubjectProgramEligibility = _interopRequireDefault(require("./program/Subje
 var _MenuItem = _interopRequireDefault(require("./application/MenuItem"));
 var _UserSubjectAssignment = _interopRequireDefault(require("./assignment/UserSubjectAssignment"));
 var _DashboardFilter = _interopRequireDefault(require("./reports/DashboardFilter"));
+var _Calendar = _interopRequireDefault(require("./Calendar"));
+var _CalendarDateMarker = _interopRequireDefault(require("./CalendarDateMarker"));
+var _AttendanceType = _interopRequireDefault(require("./AttendanceType"));
+var _Session = _interopRequireDefault(require("./Session"));
+var _AttendanceRecord = _interopRequireDefault(require("./AttendanceRecord"));
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
@@ -537,6 +542,34 @@ const subjectProgramEligibility = txData(_SubjectProgramEligibility.default, {
 const userSubjectAssignment = txData(_UserSubjectAssignment.default, {
   syncWeight: 0
 });
+
+// Calendars + Attendance (issue #63). Resource names default to the camelCase of the
+// schema name; if avni-server publishes different REST roots they can be passed via {res, resUrl}.
+const calendar = refData(_Calendar.default, {
+  syncWeight: 1
+});
+const calendarDateMarker = refData(_CalendarDateMarker.default, {
+  parent: calendar,
+  syncWeight: 1
+});
+const attendanceType = refData(_AttendanceType.default, {
+  parent: subjectType,
+  syncWeight: 1
+});
+const session = txData(_Session.default, {
+  parent: individual,
+  syncWeight: 7,
+  privilegeParam: "subjectTypeUuid",
+  privilegeEntity: _Privilege.default.privilegeEntityType.subject,
+  privilegeName: _Privilege.default.privilegeName.editSubject
+});
+const attendanceRecord = txData(_AttendanceRecord.default, {
+  parent: session,
+  syncWeight: 8,
+  privilegeParam: "subjectTypeUuid",
+  privilegeEntity: _Privilege.default.privilegeEntityType.subject,
+  privilegeName: _Privilege.default.privilegeName.editSubject
+});
 class EntityMetaData {
   constructor() {
     _defineProperty(this, "schemaName", void 0);
@@ -552,7 +585,7 @@ class EntityMetaData {
   }
   //order is important. last entity in each (tx and ref) with be executed first. parent should be synced before the child.
   static model() {
-    return [groupDashboard, approvalStatus, dashboardSectionCardMapping, dashboardSection, dashboardFilter, dashboard, reportCard, customCardConfig, standardReportCardType, menuItem, locationHierarchy, video, checklistItemDetail, checklistDetail, rule, ruleDependency, individualRelationshipType, individualRelationGenderMapping, individualRelation, formMapping, formElement, formElementGroup, form, documentationItem, documentation, identifierSource, organisationConfig, platformTranslation, translation, locationMapping, addressLevel, taskStatus, taskType, encounterType, program, gender, groupRole, subjectType, conceptAnswer, concept, myGroups, groupPrivileges, groups, privilege, resetSync, subjectMigration, userSubjectAssignment, task, taskUnAssigment, subjectProgramEligibility, news, videoTelemetric, groupSubject, comment, commentThread, entityApprovalStatus, subjectEntityApprovalStatus, encounterEntityApprovalStatus, programEncounterEntityApprovalStatus, programEnrolmentEntityApprovalStatus, checklistItemEntityApprovalStatus, individualRelationship, checklistItem, checklist, encounter, identifierAssignment, programEncounter, programEnrolment, individual, extension, userInfo, ruleFailureTelemetry, syncTelemetry];
+    return [groupDashboard, approvalStatus, dashboardSectionCardMapping, dashboardSection, dashboardFilter, dashboard, reportCard, customCardConfig, standardReportCardType, menuItem, locationHierarchy, video, checklistItemDetail, checklistDetail, rule, ruleDependency, individualRelationshipType, individualRelationGenderMapping, individualRelation, formMapping, formElement, formElementGroup, form, documentationItem, documentation, identifierSource, organisationConfig, platformTranslation, translation, locationMapping, addressLevel, taskStatus, taskType, encounterType, program, gender, groupRole, calendarDateMarker, calendar, attendanceType, subjectType, conceptAnswer, concept, myGroups, groupPrivileges, groups, privilege, resetSync, subjectMigration, userSubjectAssignment, task, taskUnAssigment, subjectProgramEligibility, news, videoTelemetric, groupSubject, comment, commentThread, entityApprovalStatus, subjectEntityApprovalStatus, encounterEntityApprovalStatus, programEncounterEntityApprovalStatus, programEnrolmentEntityApprovalStatus, checklistItemEntityApprovalStatus, individualRelationship, checklistItem, checklist, attendanceRecord, session, encounter, identifierAssignment, programEncounter, programEnrolment, individual, extension, userInfo, ruleFailureTelemetry, syncTelemetry];
   }
   static entitiesLoadedFromServer() {
     return _lodash.default.differenceBy(_Schema.default.getInstance().getEntities(), [_Settings.default, _LocaleMapping.default].concat(EntityMetaData.embeddedEntities()), "schema.name");

package/dist/Schema.js

@@ -100,9 +100,14 @@ var _MetaDataService = _interopRequireDefault(require("./service/MetaDataService
 var _ReportCardResult = _interopRequireDefault(require("./reports/ReportCardResult"));
 var _NestedReportCardResult = _interopRequireDefault(require("./reports/NestedReportCardResult"));
 var _SubjectLocation = _interopRequireDefault(require("./SubjectLocation"));
+var _Calendar = _interopRequireDefault(require("./Calendar"));
+var _CalendarDateMarker = _interopRequireDefault(require("./CalendarDateMarker"));
+var _AttendanceType = _interopRequireDefault(require("./AttendanceType"));
+var _Session = _interopRequireDefault(require("./Session"));
+var _AttendanceRecord = _interopRequireDefault(require("./AttendanceRecord"));
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-const entities = [_ReportCardResult.default, _NestedReportCardResult.default, _SubjectLocation.default, _DashboardFilter.default, _LocaleMapping.default, _Settings.default, _ConceptAnswer.default, _ConceptMedia.default, _Concept.default, _EncounterType.default, _Gender.default, _AddressLevel.LocationMapping, _AddressLevel.default, _KeyValue.default, _Form.default, _FormMapping.default, _FormElementGroup.default, _FormElement.default, _SubjectType.default, _Individual.default, _Program.default, _ProgramEnrolment.default, _Observation.default, _ProgramEncounter.default, _Encounter.default, _EntitySyncStatus.default, _EntityQueue.default, _Checklist.default, _ChecklistItem.default, _Format.default, _UserInfo.default, _StringKeyNumericValue.default, _Family.default, _IndividualRelation.default, _IndividualRelationGenderMapping.default, _IndividualRelationshipType.default, _IndividualRelationship.default, _RuleDependency.default, _Rule.default, _ChecklistItemStatus.default, _ChecklistDetail.default, _ChecklistItemDetail.default, _VideoTelemetric.default, _Video.default, _MediaQueue.default, _Point.default, _SyncTelemetry.default, _IdentifierSource.default, _IdentifierAssignment.default, _RuleFailureTelemetry.default, _BeneficiaryModePin.default, _OrganisationConfig.default, _PlatformTranslation.default, _Translation.default, _Groups.default, _MyGroups.default, _GroupPrivileges.default, _Privilege.default, _GroupRole.default, _GroupSubject.default, _DashboardCache.default, _CustomDashboardCache.default, _LocationHierarchy.default, _CustomCardConfig.default, _ReportCard.default, _Dashboard.default, _DashboardSectionCardMapping.default, _DraftSubject.default, _StandardReportCardType.default, _ApprovalStatus.default, _EntityApprovalStatus.default, _GroupDashboard.default, _DashboardSection.default, _News.default, _Comment.default, _CommentThread.default, _Extension.default, _SubjectMigration.default, _ResetSync.default, _Documentation.default, _DocumentationItem.default, _TaskType.default, _TaskStatus.default, _Task.default, _TaskUnAssignment.default, _DraftEncounter.default, _DraftEnrolment.default, _DraftProgramEncounter.default, _SubjectProgramEligibility.default, _MenuItem.default, _UserSubjectAssignment.default];
+const entities = [_ReportCardResult.default, _NestedReportCardResult.default, _SubjectLocation.default, _DashboardFilter.default, _LocaleMapping.default, _Settings.default, _ConceptAnswer.default, _ConceptMedia.default, _Concept.default, _EncounterType.default, _Gender.default, _AddressLevel.LocationMapping, _AddressLevel.default, _KeyValue.default, _Form.default, _FormMapping.default, _FormElementGroup.default, _FormElement.default, _SubjectType.default, _Individual.default, _Program.default, _ProgramEnrolment.default, _Observation.default, _ProgramEncounter.default, _Encounter.default, _EntitySyncStatus.default, _EntityQueue.default, _Checklist.default, _ChecklistItem.default, _Format.default, _UserInfo.default, _StringKeyNumericValue.default, _Family.default, _IndividualRelation.default, _IndividualRelationGenderMapping.default, _IndividualRelationshipType.default, _IndividualRelationship.default, _RuleDependency.default, _Rule.default, _ChecklistItemStatus.default, _ChecklistDetail.default, _ChecklistItemDetail.default, _VideoTelemetric.default, _Video.default, _MediaQueue.default, _Point.default, _SyncTelemetry.default, _IdentifierSource.default, _IdentifierAssignment.default, _RuleFailureTelemetry.default, _BeneficiaryModePin.default, _OrganisationConfig.default, _PlatformTranslation.default, _Translation.default, _Groups.default, _MyGroups.default, _GroupPrivileges.default, _Privilege.default, _GroupRole.default, _GroupSubject.default, _DashboardCache.default, _CustomDashboardCache.default, _LocationHierarchy.default, _CustomCardConfig.default, _ReportCard.default, _Dashboard.default, _DashboardSectionCardMapping.default, _DraftSubject.default, _StandardReportCardType.default, _ApprovalStatus.default, _EntityApprovalStatus.default, _GroupDashboard.default, _DashboardSection.default, _News.default, _Comment.default, _CommentThread.default, _Extension.default, _SubjectMigration.default, _ResetSync.default, _Documentation.default, _DocumentationItem.default, _TaskType.default, _TaskStatus.default, _Task.default, _TaskUnAssignment.default, _DraftEncounter.default, _DraftEnrolment.default, _DraftProgramEncounter.default, _SubjectProgramEligibility.default, _MenuItem.default, _UserSubjectAssignment.default, _Calendar.default, _CalendarDateMarker.default, _AttendanceType.default, _Session.default, _AttendanceRecord.default];
 function migrateObjectTypeFieldToEmbedded(newDB, oldDB, schemaName, field, creatorFn) {
   console.log(`schema: ${schemaName}, field: ${field}`);
   newDB.objects(schemaName).forEach(newDbParentEntity => {
@@ -181,7 +186,7 @@ function createRealmConfig() {
       return doCompact;
     },
     //order is important, should be arranged according to the dependency
-    schemaVersion: 211,
+    schemaVersion: 212,
     onMigration: function (oldDB, newDB) {
       console.log("[AvniModels.Schema]", `Running migration with old schema version: ${oldDB.schemaVersion} and new schema version: ${newDB.schemaVersion}`);
       if (oldDB.schemaVersion === VersionWithEmbeddedMigrationProblem) throw new Error(`Update from schema version ${VersionWithEmbeddedMigrationProblem} is not allowed. Please uninstall and install app.`);
@@ -812,6 +817,12 @@ function createRealmConfig() {
           config.translations = null;
         });
       }
+      if (oldDB.schemaVersion < 212) {
+        // Additive: introduces Calendar, CalendarDateMarker, AttendanceType,
+        // Session, AttendanceRecord schemas and SubjectType.attendanceEnabled
+        // (bool default false). Realm backfills the new boolean and the new
+        // schemas have no pre-existing rows.
+      }
     }
   };
 }

package/dist/SchemaNames.js

@@ -53,5 +53,10 @@ _defineProperty(SchemaNames, "Concept", "Concept");
 _defineProperty(SchemaNames, "ConceptMedia", "ConceptMedia");
 _defineProperty(SchemaNames, "EntityApprovalStatus", "EntityApprovalStatus");
 _defineProperty(SchemaNames, "Point", "Point");
+_defineProperty(SchemaNames, "Calendar", "Calendar");
+_defineProperty(SchemaNames, "CalendarDateMarker", "CalendarDateMarker");
+_defineProperty(SchemaNames, "AttendanceType", "AttendanceType");
+_defineProperty(SchemaNames, "Session", "Session");
+_defineProperty(SchemaNames, "AttendanceRecord", "AttendanceRecord");
 var _default = SchemaNames;
 exports.default = _default;

package/dist/Session.js

@@ -0,0 +1,291 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _BaseEntity = _interopRequireDefault(require("./BaseEntity"));
+var _General = _interopRequireDefault(require("./utility/General"));
+var _SchemaNames = _interopRequireDefault(require("./SchemaNames"));
+var _AuditUtil = require("./utility/AuditUtil");
+var _DateTimeUtil = _interopRequireDefault(require("./utility/DateTimeUtil"));
+var _AttendanceRecord = _interopRequireDefault(require("./AttendanceRecord"));
+var _Encounter = _interopRequireDefault(require("./Encounter"));
+var _ProgramEncounter = _interopRequireDefault(require("./ProgramEncounter"));
+var _moment = _interopRequireDefault(require("moment"));
+var _lodash = _interopRequireDefault(require("lodash"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+class Session extends _BaseEntity.default {
+  constructor(that = null) {
+    super(that);
+  }
+  get groupSubjectUUID() {
+    return this.that.groupSubjectUUID;
+  }
+  set groupSubjectUUID(x) {
+    this.that.groupSubjectUUID = x;
+  }
+  get scheduledDate() {
+    return this.that.scheduledDate;
+  }
+
+  // Accepts a "YYYY-MM-DD" string or a JS Date; normalizes to a canonical string.
+  set scheduledDate(x) {
+    this.that.scheduledDate = _DateTimeUtil.default.toCalendarDateString(x);
+  }
+  get attendanceTypeUUID() {
+    return this.that.attendanceTypeUUID;
+  }
+  set attendanceTypeUUID(x) {
+    this.that.attendanceTypeUUID = x;
+  }
+  get status() {
+    return this.that.status;
+  }
+  set status(x) {
+    this.that.status = x;
+  }
+  get reasonConceptUUID() {
+    return this.that.reasonConceptUUID;
+  }
+  set reasonConceptUUID(x) {
+    this.that.reasonConceptUUID = x;
+  }
+  get notes() {
+    return this.that.notes;
+  }
+  set notes(x) {
+    this.that.notes = x;
+  }
+  get markedByUserName() {
+    return this.that.markedByUserName;
+  }
+  set markedByUserName(x) {
+    this.that.markedByUserName = x;
+  }
+  get markedAt() {
+    return this.that.markedAt;
+  }
+  set markedAt(x) {
+    this.that.markedAt = x;
+  }
+  get createdBy() {
+    return this.that.createdBy;
+  }
+  set createdBy(x) {
+    this.that.createdBy = x;
+  }
+  get lastModifiedBy() {
+    return this.that.lastModifiedBy;
+  }
+  set lastModifiedBy(x) {
+    this.that.lastModifiedBy = x;
+  }
+  get createdByUUID() {
+    return this.that.createdByUUID;
+  }
+  set createdByUUID(x) {
+    this.that.createdByUUID = x;
+  }
+  get lastModifiedByUUID() {
+    return this.that.lastModifiedByUUID;
+  }
+  set lastModifiedByUUID(x) {
+    this.that.lastModifiedByUUID = x;
+  }
+  isHeld() {
+    return this.status === Session.status.HELD;
+  }
+  isDidntHappen() {
+    return this.status === Session.status.DIDNT_HAPPEN;
+  }
+
+  // Caller iterates the returned records and persists them in the same realm.write.
+  // rosterByStudentUUID: { [studentUUID]: { status: 'Present'|'Absent', reasonConceptUUID?: string } }
+  markHeld(rosterByStudentUUID) {
+    this.status = Session.status.HELD;
+    this.reasonConceptUUID = null;
+    this.markedAt = new Date();
+    const records = [];
+    _lodash.default.forOwn(rosterByStudentUUID || {}, (entry, studentUUID) => {
+      const record = new _AttendanceRecord.default();
+      record.uuid = _General.default.randomUUID();
+      record.sessionUUID = this.uuid;
+      record.subjectUUID = studentUUID;
+      record.status = entry.status;
+      record.reasonConceptUUID = entry.reasonConceptUUID || null;
+      record.followUpEncounterUUID = null;
+      record.voided = false;
+      records.push(record);
+    });
+    return records;
+  }
+  markDidntHappen(reasonConcept, notes) {
+    if (_lodash.default.isNil(reasonConcept) || _lodash.default.isNil(reasonConcept.uuid)) {
+      throw new Error("Session.markDidntHappen requires a reason concept");
+    }
+    this.status = Session.status.DIDNT_HAPPEN;
+    this.reasonConceptUUID = reasonConcept.uuid;
+    this.notes = notes || null;
+    this.markedAt = new Date();
+  }
+
+  // Returns a list of newly built Encounter or ProgramEncounter instances; mutates
+  // each triggering record's followUpEncounterUUID. Caller persists in same realm.write.
+  //
+  // Options:
+  //   attendanceRecords  — the AttendanceRecords created for this session
+  //   attendanceType     — the AttendanceType driving this session (config carries follow-up type)
+  //   encounterType      — resolved EncounterType matching attendanceType.getFollowUpEncounterTypeUUID()
+  //   programUUID        — if set, the encounterType is a program-encounter type; caller resolved this
+  //                        via FormMapping. If null/undef, a general Encounter is created.
+  //   studentLookup      — (subjectUUID) => Individual | null
+  //   enrolmentLookup    — (student, programUUID) => ProgramEnrolment | null
+  //                        only consulted when programUUID is set.
+  autoCreateFollowUps({
+    attendanceRecords,
+    attendanceType,
+    encounterType,
+    programUUID,
+    studentLookup,
+    enrolmentLookup
+  } = {}) {
+    if (!attendanceType) return [];
+    const followUpEncounterTypeUUID = attendanceType.getFollowUpEncounterTypeUUID();
+    if (!followUpEncounterTypeUUID) return [];
+    if (!encounterType) return [];
+    const startOfToday = (0, _moment.default)().startOf("day").toDate();
+    const maxVisit = (0, _moment.default)().startOf("day").add(2, "days").toDate();
+    const created = [];
+    _lodash.default.forEach(attendanceRecords || [], record => {
+      if (!record) return;
+      if (record.status !== _AttendanceRecord.default.status.ABSENT) return;
+      if (!_lodash.default.isNil(record.reasonConceptUUID)) return;
+      const student = studentLookup ? studentLookup(record.subjectUUID) : null;
+      if (!student) return;
+      let encounter;
+      if (programUUID) {
+        const enrolment = enrolmentLookup ? enrolmentLookup(student, programUUID) : null;
+        if (!enrolment) return;
+        encounter = new _ProgramEncounter.default();
+        encounter.uuid = _General.default.randomUUID();
+        encounter.encounterType = encounterType;
+        encounter.programEnrolment = enrolment;
+        encounter.earliestVisitDateTime = startOfToday;
+        encounter.maxVisitDateTime = maxVisit;
+        encounter.observations = [];
+        encounter.cancelObservations = [];
+        encounter.voided = false;
+      } else {
+        encounter = new _Encounter.default();
+        encounter.uuid = _General.default.randomUUID();
+        encounter.encounterType = encounterType;
+        encounter.individual = student;
+        encounter.earliestVisitDateTime = startOfToday;
+        encounter.maxVisitDateTime = maxVisit;
+        encounter.observations = [];
+        encounter.cancelObservations = [];
+        encounter.voided = false;
+      }
+      record.followUpEncounterUUID = encounter.uuid;
+      created.push(encounter);
+    });
+    return created;
+  }
+
+  // Void previously-auto-created follow-up encounters that are no longer warranted,
+  // skipping any encounter that has been started (has observations) or completed.
+  // Returns { voided: [...], skipped: [...] }.
+  voidStaleFollowUps(previousRecords, newRecords, encounterLookup) {
+    const result = {
+      voided: [],
+      skipped: []
+    };
+    const prevByStudent = _lodash.default.keyBy(previousRecords || [], "subjectUUID");
+    const newByStudent = _lodash.default.keyBy(newRecords || [], "subjectUUID");
+    _lodash.default.forOwn(prevByStudent, (prev, studentUUID) => {
+      if (!prev || !prev.followUpEncounterUUID) return;
+      const next = newByStudent[studentUUID];
+      const stillNeedsFollowUp = next && next.status === _AttendanceRecord.default.status.ABSENT && _lodash.default.isNil(next.reasonConceptUUID);
+      if (stillNeedsFollowUp) return;
+      const encounter = encounterLookup ? encounterLookup(prev.followUpEncounterUUID) : null;
+      if (!encounter) return;
+      const isScheduledNoObs = (_lodash.default.isFunction(encounter.isScheduled) ? encounter.isScheduled() : _lodash.default.isNil(encounter.encounterDateTime)) && _lodash.default.isEmpty(encounter.observations);
+      if (isScheduledNoObs) {
+        encounter.voided = true;
+        result.voided.push(encounter);
+      } else {
+        result.skipped.push(encounter);
+      }
+    });
+    return result;
+  }
+  static fromResource(resource) {
+    const session = new Session();
+    session.uuid = resource.uuid;
+    session.groupSubjectUUID = resource.groupSubjectUUID;
+    session.scheduledDate = resource.scheduledDate; // setter normalizes
+    session.attendanceTypeUUID = resource.attendanceTypeUUID;
+    session.status = resource.status;
+    session.reasonConceptUUID = resource.reasonConceptUUID || null;
+    session.notes = resource.notes || null;
+    session.markedByUserName = resource.markedByUserName || null;
+    // markedAt is a true timestamp (not a calendar date) — preserve the instant.
+    session.markedAt = _lodash.default.isNil(resource.markedAt) ? null : new Date(resource.markedAt);
+    session.voided = !!resource.voided;
+    (0, _AuditUtil.mapAuditFields)(session, resource);
+    return session;
+  }
+  get toResource() {
+    const resource = _lodash.default.pick(this, ["uuid", "groupSubjectUUID", "scheduledDate", "attendanceTypeUUID", "status", "markedByUserName", "voided"]);
+    resource.markedAt = _lodash.default.isNil(this.markedAt) ? null : (0, _moment.default)(this.markedAt).format();
+    resource.reasonConceptUUID = this.reasonConceptUUID || null;
+    resource.notes = this.notes || null;
+    return resource;
+  }
+}
+_defineProperty(Session, "schema", {
+  name: _SchemaNames.default.Session,
+  primaryKey: "uuid",
+  properties: _objectSpread({
+    uuid: "string",
+    groupSubjectUUID: "string",
+    // scheduledDate is a Postgres `date` (no time, no zone); stored as
+    // "YYYY-MM-DD" so the client carries zero TZ semantics at rest.
+    scheduledDate: "string",
+    attendanceTypeUUID: "string",
+    status: "string",
+    reasonConceptUUID: {
+      type: "string",
+      optional: true
+    },
+    notes: {
+      type: "string",
+      optional: true
+    },
+    markedByUserName: {
+      type: "string",
+      optional: true
+    },
+    // markedAt is a true timestamp (when the user saved) — Realm `date` is fine.
+    markedAt: {
+      type: "date",
+      optional: true
+    },
+    voided: {
+      type: "bool",
+      default: false
+    }
+  }, _AuditUtil.AuditFields)
+});
+_defineProperty(Session, "status", {
+  HELD: "Held",
+  DIDNT_HAPPEN: "DidntHappen"
+});
+var _default = Session;
+exports.default = _default;

package/dist/SubjectType.js

@@ -144,6 +144,12 @@ class SubjectType extends _ReferenceEntity.default {
   set settings(x) {
     this.that.settings = x;
   }
+  get attendanceEnabled() {
+    return this.that.attendanceEnabled;
+  }
+  set attendanceEnabled(x) {
+    this.that.attendanceEnabled = x;
+  }
   static create(name, group = false, household = false, type) {
     let subjectType = new SubjectType();
     subjectType.uuid = _General.default.randomUUID();
@@ -179,6 +185,7 @@ class SubjectType extends _ReferenceEntity.default {
     subjectType.syncRegistrationConcept2 = _ResourceUtil.default.getUUIDFor(operationalSubjectType, 'syncRegistrationConcept2');
     subjectType.nameHelpText = _ResourceUtil.default.getUUIDFor(operationalSubjectType, 'nameHelpText');
     subjectType.settings = !_lodash.default.isNil(operationalSubjectType.settings) ? JSON.stringify(operationalSubjectType.settings) : '{}';
+    subjectType.attendanceEnabled = !!operationalSubjectType.attendanceEnabled;
     return subjectType;
   }
   clone() {
@@ -207,6 +214,7 @@ class SubjectType extends _ReferenceEntity.default {
     cloned.syncRegistrationConcept2 = this.syncRegistrationConcept2;
     cloned.nameHelpText = this.nameHelpText;
     cloned.settings = this.settings;
+    cloned.attendanceEnabled = this.attendanceEnabled;
     return cloned;
   }
   isPerson() {
@@ -236,6 +244,10 @@ class SubjectType extends _ReferenceEntity.default {
   getSetting(settingName) {
     return this.getSettings()[settingName];
   }
+  getAttendanceTypes(allAttendanceTypes) {
+    if (_lodash.default.isEmpty(allAttendanceTypes)) return [];
+    return _lodash.default.chain(allAttendanceTypes).filter(at => at && !at.voided && at.subjectTypeUUID === this.uuid).sortBy(at => _lodash.default.isNil(at.sortOrder) ? 0 : at.sortOrder).value();
+  }
 }
 _defineProperty(SubjectType, "schema", {
   name: 'SubjectType',
@@ -326,6 +338,10 @@ _defineProperty(SubjectType, "schema", {
     settings: {
       type: "string",
       default: '{}'
+    },
+    attendanceEnabled: {
+      type: 'bool',
+      default: false
     }
   }
 });

package/dist/application/WorkItem.js

@@ -23,7 +23,7 @@ class WorkItem {
   }
   validate() {
     assertTrue(WorkItem.type[this.type], "Work item must be one of WorkItem.type");
-    if (!_lodash.default.includes([WorkItem.type.REGISTRATION, WorkItem.type.ADD_MEMBER, WorkItem.type.HOUSEHOLD], this.type)) {
+    if (!_lodash.default.includes([WorkItem.type.REGISTRATION, WorkItem.type.ADD_MEMBER, WorkItem.type.HOUSEHOLD, WorkItem.type.SHARE_SESSION], this.type)) {
       this.ensureFieldExists("subjectUUID");
     }
     if (this.type === WorkItem.type.PROGRAM_ENROLMENT) {
@@ -42,6 +42,17 @@ class WorkItem {
     if (this.type === WorkItem.type.REMOVE_MEMBER) {
       this.ensureFieldExists("groupSubjectUUID");
     }
+    if (this.type === WorkItem.type.SHARE) {
+      this.validateShareFormat();
+    }
+    if (this.type === WorkItem.type.SHARE_SESSION) {
+      this.ensureFieldExists("sessionUUID");
+      this.validateShareFormat();
+    }
+  }
+  validateShareFormat() {
+    const format = _lodash.default.get(this.parameters, "format");
+    assertTrue(format === WorkItem.shareFormat.PDF || format === WorkItem.shareFormat.TEXT, `Work Item id: ${this.id}, type: ${this.type}, format must be 'pdf' or 'text', got '${format}'`);
   }
   fieldMissingError(field) {
     return `Work Item id: ${this.id}, type: ${this.type}, ` + `parameters: {${Object.keys(this.parameters)}}, ` + `'${field}: ${this.parameters[field]}', ` + `errorMessage: '${field} is mandatory'`;
@@ -63,5 +74,11 @@ _defineProperty(WorkItem, "type", {
   CANCELLED_ENCOUNTER: "CANCELLED_ENCOUNTER",
   ADD_MEMBER: "ADD_MEMBER",
   HOUSEHOLD: "HOUSEHOLD",
-  REMOVE_MEMBER: "REMOVE_MEMBER"
+  REMOVE_MEMBER: "REMOVE_MEMBER",
+  SHARE: "SHARE",
+  SHARE_SESSION: "SHARE_SESSION"
+});
+_defineProperty(WorkItem, "shareFormat", {
+  PDF: "pdf",
+  TEXT: "text"
 });

package/dist/index.js

@@ -855,6 +855,42 @@ Object.defineProperty(exports, "SubjectLocation", {
     return _SubjectLocation.default;
   }
 });
+Object.defineProperty(exports, "Calendar", {
+  enumerable: true,
+  get: function () {
+    return _Calendar.default;
+  }
+});
+Object.defineProperty(exports, "CalendarDateMarker", {
+  enumerable: true,
+  get: function () {
+    return _CalendarDateMarker.default;
+  }
+});
+Object.defineProperty(exports, "AttendanceType", {
+  enumerable: true,
+  get: function () {
+    return _AttendanceType.default;
+  }
+});
+Object.defineProperty(exports, "Session", {
+  enumerable: true,
+  get: function () {
+    return _Session.default;
+  }
+});
+Object.defineProperty(exports, "AttendanceRecord", {
+  enumerable: true,
+  get: function () {
+    return _AttendanceRecord.default;
+  }
+});
+Object.defineProperty(exports, "Calendars", {
+  enumerable: true,
+  get: function () {
+    return _Calendars.default;
+  }
+});
 var _AbstractEncounter = _interopRequireDefault(require("./AbstractEncounter"));
 var _AddressLevel = _interopRequireWildcard(require("./AddressLevel"));
 var _BaseEntity = _interopRequireDefault(require("./BaseEntity"));
@@ -992,5 +1028,11 @@ var _Range = _interopRequireDefault(require("./reports/Range"));
 var _ReportCardResult = _interopRequireDefault(require("./reports/ReportCardResult"));
 var _NestedReportCardResult = _interopRequireDefault(require("./reports/NestedReportCardResult"));
 var _SubjectLocation = _interopRequireDefault(require("./SubjectLocation"));
+var _Calendar = _interopRequireDefault(require("./Calendar"));
+var _CalendarDateMarker = _interopRequireDefault(require("./CalendarDateMarker"));
+var _AttendanceType = _interopRequireDefault(require("./AttendanceType"));
+var _Session = _interopRequireDefault(require("./Session"));
+var _AttendanceRecord = _interopRequireDefault(require("./AttendanceRecord"));
+var _Calendars = _interopRequireDefault(require("./location/Calendars"));
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }

package/dist/location/Calendars.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _lodash = _interopRequireDefault(require("lodash"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+class Calendars {
+  // Walk the subject's address-level chain leaf -> root; return the first non-voided
+  // calendar attached at any level. Falls back to the org's global default calendar
+  // (addressLevelUUID == null). Returns null if neither resolves. Never throws.
+  static forSubject(subject, calendars) {
+    if (_lodash.default.isNil(subject) || _lodash.default.isEmpty(calendars)) return Calendars._globalDefault(calendars);
+    const addressLevel = subject.lowestAddressLevel;
+    if (_lodash.default.isNil(addressLevel) || !_lodash.default.isFunction(addressLevel.getLineage)) {
+      return Calendars._globalDefault(calendars);
+    }
+    const lineage = addressLevel.getLineage();
+    for (const level of lineage) {
+      if (_lodash.default.isNil(level)) continue;
+      const match = _lodash.default.find(calendars, c => c && !c.voided && c.addressLevelUUID === level.uuid);
+      if (match) return match;
+    }
+    return Calendars._globalDefault(calendars);
+  }
+  static _globalDefault(calendars) {
+    if (_lodash.default.isEmpty(calendars)) return null;
+    return _lodash.default.find(calendars, c => c && !c.voided && _lodash.default.isNil(c.addressLevelUUID)) || null;
+  }
+}
+var _default = Calendars;
+exports.default = _default;

package/dist/utility/DateTimeUtil.js

@@ -7,6 +7,7 @@ exports.default = void 0;
 var _lodash = _interopRequireDefault(require("lodash"));
 var _moment = _interopRequireDefault(require("moment"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const CALENDAR_DATE_FORMAT = "YYYY-MM-DD";
 class DateTimeUtil {
   static validateDateRange(fromDate, toDate) {
     if (_lodash.default.isNil(toDate) && _lodash.default.isNil(fromDate)) return [true];
@@ -20,6 +21,49 @@ class DateTimeUtil {
     if (!(0, _moment.default)(fromTime, 'HH:mm').isSameOrBefore((0, _moment.default)(toTime, 'HH:mm'))) return [false, 'startTimeGreaterThanEndError'];
     return [true];
   }
+
+  // Calendar-date helpers.
+  //
+  // Calendar dates are Postgres `date` values on the server — no time, no zone.
+  // We mirror that exactly on the client by storing them as plain `"YYYY-MM-DD"`
+  // strings in Realm and returning them as strings from accessors. This makes
+  // it impossible to introduce timezone bugs at the storage layer.
+  //
+  // These helpers also accept JS `Date` inputs for convenience — they're
+  // normalised via UTC components so a caller who built a Date with
+  // `moment.utc(...)` or `DateTimeUtil.calendarDateToDate(string)` gets the
+  // day they wrote; a caller who hands in a local-midnight Date or a
+  // `new Date()` will see the UTC calendar day at that instant, which is
+  // the closest TZ-stable reading we can compute.
+  static toCalendarDateString(value) {
+    if (_lodash.default.isNil(value)) return null;
+    if (_lodash.default.isString(value)) {
+      // Canonicalise via moment.utc round-trip so "2026-05-9" → "2026-05-09",
+      // and any unsupported shape returns null rather than corrupt storage.
+      const m = _moment.default.utc(value, CALENDAR_DATE_FORMAT, true);
+      return m.isValid() ? m.format(CALENDAR_DATE_FORMAT) : null;
+    }
+    return _moment.default.utc(value).format(CALENDAR_DATE_FORMAT);
+  }
+
+  // For arithmetic on calendar dates (next/previous day, day-of-week extraction).
+  // Returns a moment in UTC mode anchored at start-of-day.
+  static calendarMoment(value) {
+    if (_lodash.default.isNil(value)) return null;
+    if (_lodash.default.isString(value)) return _moment.default.utc(value, CALENDAR_DATE_FORMAT).startOf("day");
+    return _moment.default.utc(value).startOf("day");
+  }
+
+  // Optional: turn a stored "YYYY-MM-DD" back into a JS Date at UTC midnight,
+  // for callers (e.g. UI components) that need a Date object. Display code that
+  // uses this MUST format via `moment.utc(...)` or risk a TZ shift.
+  static calendarDateToDate(value) {
+    if (_lodash.default.isNil(value)) return null;
+    if (_lodash.default.isString(value)) {
+      return _moment.default.utc(value, CALENDAR_DATE_FORMAT).startOf("day").toDate();
+    }
+    return _moment.default.utc(value).startOf("day").toDate();
+  }
 }
 var _default = DateTimeUtil;
 exports.default = _default;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "openchs-models",
     "description": "OpenCHS data model to be used by front end clients",
-    "version": "1.33.45",
+    "version": "1.33.47",
     "private": false,
     "repository": {
         "type": "git",