@jaws-developers-customers/consulca-types 1.1.15 → 1.1.23

package/README.md

@@ -1,86 +1,99 @@
-# @jaws-developers-customers/consulca-types
-
-Pacchetto NPM con tipi del dominio Consulca e helper pronti all'uso per date, valuta e oggetti principali derivati dallo schema MariaDB.
-
-## Installazione
-
-```bash
-npm install @jaws-developers-customers/consulca-types
-```
-
-## Pubblicazione automatica
-
-Ogni push su `master` esegue i test e pubblica automaticamente il pacchetto su npm tramite GitHub Actions.
-
-Prerequisito:
-
-- npm Trusted Publisher configurato nelle impostazioni del pacchetto su npm per l'organizzazione `JAWS-Developers-Customers`, il repository `15-NPMPackage` e il workflow `publish.yml` (senza environment).
-
-Il trusted publishing richiede npm 11.5.1 o successivo: il workflow installa npm 11.21.0 prima della pubblicazione, senza usare `NPM_TOKEN`. La versione npm 10 inclusa in Node.js 22 non supporta questa autenticazione, anche se può generare la provenance.
-
-Il workflow genera una versione unica per ogni run su `master`, così la pubblicazione non fallisce per versioni duplicate.
-
-## Cosa esporta
-
-- tipi TypeScript per le entità principali (`User`, `Property`, `Lease`, `Inspection`, `Claim`, `Work`, ...)
-- cataloghi `ENUM` dello schema (`USER_ROLES`, `ACCESS_CHANNELS`, `PROPERTY_TYPES`, ...)
-- helper:
-  - `formatDate`
-  - `formatDateTime`
-  - `formatCurrency`
-  - `getUserFullName`
-  - `formatAddress`
-  - `hasUserRole`
-  - `hasAccessChannel`
-  - `Query.isSuccess`
-
-## Esempio
-
-```js
-const {
-  formatCurrency,
-  formatDate,
-  getUserFullName,
-  hasUserRole,
-} = require('@jaws-developers-customers/consulca-types');
-
-console.log(formatDate('2026-09-16T10:30:00Z'));
-console.log(formatCurrency(1250.5));
-console.log(getUserFullName({ first_name: 'Mario', last_name: 'Rossi' }));
-console.log(hasUserRole([{ role: 'manager' }], 'manager'));
-```
-
-`Query.isSuccess(error_code)` restituisce `true` per i codici nel formato `xx.xx.xxx` il cui ultimo gruppo inizia con `0`.
-
-### Esempio TypeScript
-
-```ts
-import {
-  formatDateTime,
-  type Inspection,
-  type User,
-} from '@jaws-developers-customers/consulca-types';
-
-const user: User = {
-  id: 'uuid',
-  email: 'mario.rossi@example.com',
-  password_hash: 'hashed',
-  first_name: 'Mario',
-  last_name: 'Rossi',
-  status: 'active',
-  created_at: new Date(),
-  updated_at: new Date(),
-};
-
-const inspection: Inspection = {
-  id: 'uuid',
-  lease_id: 'lease-id',
-  inspector_id: user.id,
-  inspection_type: 'move_in',
-  status: 'draft',
-  created_at: new Date(),
-  updated_at: new Date(),
-};
-
-console.log(formatDateTime(inspection.created_at, 'it-CH'));
-```
+# @jaws-developers-customers/consulca-types
+
+Pacchetto NPM con tipi del dominio Consulca e helper pronti all'uso per date, valuta e oggetti principali derivati dallo schema MariaDB.
+
+## Installazione
+
+```bash
+npm install @jaws-developers-customers/consulca-types
+```
+
+## Pubblicazione automatica
+
+Ogni push su `master` esegue i test e pubblica automaticamente il pacchetto su npm tramite GitHub Actions.
+
+Prerequisito:
+
+- npm Trusted Publisher configurato nelle impostazioni del pacchetto su npm per l'organizzazione `JAWS-Developers-Customers`, il repository `15-NPMPackage` e il workflow `publish.yml` (senza environment).
+
+Il trusted publishing richiede npm 11.5.1 o successivo: il workflow installa npm 11.21.0 prima della pubblicazione, senza usare `NPM_TOKEN`. La versione npm 10 inclusa in Node.js 22 non supporta questa autenticazione, anche se può generare la provenance.
+
+Il pacchetto viene sempre pubblicato con accesso pubblico. La visibilità del pacchetto npm è distinta da quella del repository GitHub: npm abilita automaticamente la provenance quando il token OIDC identifica un repository sorgente pubblico e il pacchetto è pubblico. Il workflow non forza `--provenance`, perché npm rifiuta la provenance di un repository identificato come privato con errore `E422`, anche se il pacchetto è pubblico. L'autenticazione OIDC rimane attiva anche senza provenance.
+
+Il workflow genera una versione unica per ogni run su `master`, così la pubblicazione non fallisce per versioni duplicate.
+
+## Cosa esporta
+
+- tipi TypeScript per le entità principali (`User`, `Property`, `Lease`, `Inspection`, `Claim`, `Work`, ...)
+- cataloghi `ENUM` dello schema (`USER_ROLES`, `ACCESS_CHANNELS`, `ACCESS_ROLES`, `DEVICE_TYPES`, ...)
+- helper:
+  - `formatDate`
+  - `formatDateTime`
+  - `formatCurrency`
+  - `getUserFullName`
+  - `formatAddress`
+  - `hasUserRole`
+  - `hasAccessChannel`
+  - `Query.isSuccess`
+
+## Esempio
+
+```js
+const {
+  formatCurrency,
+  formatDate,
+  getUserFullName,
+  hasUserRole,
+} = require('@jaws-developers-customers/consulca-types');
+
+console.log(formatDate('2026-09-16T10:30:00Z'));
+console.log(formatCurrency(1250.5));
+console.log(getUserFullName({ first_name: 'Mario', last_name: 'Rossi' }));
+console.log(hasUserRole([{ role: 'manager' }], 'manager'));
+```
+
+`Query.isSuccess(error_code)` restituisce `true` per i codici nel formato `xx.xx.xxx` il cui ultimo gruppo inizia con `0`.
+
+### Esempio TypeScript
+
+```ts
+import {
+  formatDateTime,
+  type Inspection,
+  type User,
+} from '@jaws-developers-customers/consulca-types';
+
+const user: User = {
+  id: 'uuid',
+  email: 'mario.rossi@example.com',
+  first_name: 'Mario',
+  last_name: 'Rossi',
+  status: 'active',
+  country_code: 'CH',
+  access_channels: [{
+    channel: 'intranet_dashboard',
+    role: 'employee',
+    status: 'active',
+    created_at: '2026-10-05 18:29:50',
+    revoked_at: null,
+  }],
+};
+
+const inspection: Inspection = {
+  id: 'uuid',
+  lease_id: 'lease-id',
+  inspector_id: user.id,
+  inspection_type: 'move_in',
+  status: 'draft',
+  created_at: new Date(),
+  updated_at: new Date(),
+};
+
+console.log(formatDateTime(inspection.created_at, 'it-CH'));
+```
+
+`User` accetta direttamente i dati di `/user/get/me`: `password_hash`, `created_at` e `updated_at` non sono obbligatori. Non salvare la password o il suo hash nello stato client. I canali sono contenuti in `user.access_channels`, senza richiedere `user_id` per ogni elemento; `AccessChannelAssignment` rappresenta invece una riga della tabella con `user_id` obbligatorio.
+
+`ACCESS_ROLES` descrive i ruoli di `access_channels` e `user_invites`, mentre `USER_ROLES` descrive quelli della tabella `user_roles`. Per verificare l'accesso usa `hasAccessChannel(user.access_channels, 'intranet_dashboard')`: i canali revocati vengono esclusi.
+
+I riferimenti agli appartamenti usano `apartment_id`, `Property` usa `apartment_number` e gli allegati delle ispezioni usano `inspection_item_id`. Sono disponibili anche `Device`, `UserInvite`, `Room`, `ApartmentRoom`, `ApartmentLessor` e `ApartmentManager`. I campi SQL nullable accettano `null`; i decimali accettano numeri o stringhe restituiti dal driver MariaDB.

package/index.d.ts

@@ -1,268 +1,311 @@
-export type UserStatus = 'active' | 'invited' | 'suspended' | 'disabled';
-export type UserRole = 'lessor' | 'manager' | 'website_manager' | 'inspector';
-export type AccessChannel = 'intranet_dashboard' | 'mobile_app' | 'website_admin';
-export type AccessStatus = 'active' | 'revoked';
-export type PropertyStatus = 'active' | 'inactive' | 'archived';
-export type ManagementRole = 'primary' | 'secondary' | 'accounting' | 'technical' | 'other';
-export type LeaseStatus = 'planned' | 'active' | 'ended' | 'cancelled';
-export type InspectionType = 'move_in' | 'move_out';
-export type InspectionStatus = 'draft' | 'in_progress' | 'submitted' | 'approved' | 'rejected';
-export type ConditionStatus = 'good' | 'minor_damage' | 'major_damage' | 'not_checked';
-export type ClaimStatus = 'draft' | 'submitted' | 'in_review' | 'approved' | 'rejected' | 'closed';
-export type WorkStatus = 'planned' | 'assigned' | 'in_progress' | 'completed' | 'cancelled';
-
-export interface ColorPalette {
-  primary: string;
-  secondary: string;
-  accent: string;
-  background: string;
-  text: string;
-}
-
-export interface Constants {
-  API_DEV: string;
-  API: string;
-  ICON: string;
-}
-
-export interface QueryHelpers {
-  isSuccess(errorCode: string): boolean;
-}
-
-export interface Addressable {
-  address_line1?: string | null;
-  address_line2?: string | null;
-  postal_code?: string | null;
-  city?: string | null;
-  country_code?: string | null;
-}
-
-export interface User extends Addressable {
-  id: string;
-  email: string;
-  password_hash: string;
-  first_name: string;
-  last_name: string;
-  phone?: string | null;
-  status: UserStatus;
-  email_verified_at?: string | Date | null;
-  last_login_at?: string | Date | null;
-  created_at: string | Date;
-  updated_at: string | Date;
-}
-
-export interface UserRoleAssignment {
-  user_id: string;
-  role: UserRole;
-  created_at: string | Date;
-}
-
-export interface UserAccessChannel {
-  user_id: string;
-  channel: AccessChannel;
-  status: AccessStatus;
-  created_at: string | Date;
-  revoked_at?: string | Date | null;
-}
-
-export interface Session {
-  id: string;
-  user_id: string;
-  channel: AccessChannel;
-  access_token_hash: string;
-  refresh_token_hash?: string | null;
-  expires_at: string | Date;
-  refresh_expires_at?: string | Date | null;
-  user_agent?: string | null;
-  ip_address?: Uint8Array | string | null;
-  created_at: string | Date;
-  revoked_at?: string | Date | null;
-}
-
-export interface Building extends Addressable {
-  id: string;
-  name: string;
-  created_at: string | Date;
-  updated_at: string | Date;
-}
-
-export interface Property {
-  id: string;
-  building_id: string;
-  property_number: string;
-  floor?: string | null;
-  area_m2?: number | null;
-  status: PropertyStatus;
-  created_at: string | Date;
-  updated_at: string | Date;
-}
-
-export interface PropertyLessor {
-  property_id: string;
-  user_id: string;
-  ownership_share?: number | null;
-  is_primary: boolean | number;
-  created_at: string | Date;
-}
-
-export interface PropertyManager {
-  property_id: string;
-  user_id: string;
-  management_role: ManagementRole;
-  valid_from?: string | Date | null;
-  valid_until?: string | Date | null;
-  created_at: string | Date;
-}
-
-export interface Lease {
-  id: string;
-  property_id: string;
-  tenant_name?: string | null;
-  tenant_email?: string | null;
-  tenant_phone?: string | null;
-  start_date: string | Date;
-  end_date?: string | Date | null;
-  status: LeaseStatus;
-  created_at: string | Date;
-  updated_at: string | Date;
-}
-
-export interface Inspection {
-  id: string;
-  lease_id: string;
-  inspector_id: string;
-  inspection_type: InspectionType;
-  status: InspectionStatus;
-  scheduled_at?: string | Date | null;
-  started_at?: string | Date | null;
-  submitted_at?: string | Date | null;
-  notes?: string | null;
-  created_at: string | Date;
-  updated_at: string | Date;
-}
-
-export interface InspectionItem {
-  id: string;
-  inspection_id: string;
-  room?: string | null;
-  item_name: string;
-  condition_status: ConditionStatus;
-  comment?: string | null;
-  created_at: string | Date;
-}
-
-export interface InspectionAttachment {
-  id: string;
-  inspection_id: string;
-  item_id?: string | null;
-  file_name: string;
-  storage_key: string;
-  mime_type?: string | null;
-  file_size?: number | null;
-  created_at: string | Date;
-}
-
-export interface Claim {
-  id: string;
-  property_id: string;
-  submitted_by: string;
-  status: ClaimStatus;
-  incident_date?: string | Date | null;
-  title: string;
-  description: string;
-  amount_estimate?: number | null;
-  submitted_at?: string | Date | null;
-  created_at: string | Date;
-  updated_at: string | Date;
-}
-
-export interface ClaimAttachment {
-  id: string;
-  claim_id: string;
-  file_name: string;
-  storage_key: string;
-  mime_type?: string | null;
-  file_size?: number | null;
-  created_at: string | Date;
-}
-
-export interface Manufacturer extends Addressable {
-  id: string;
-  name: string;
-  country_code: string;
-  email?: string | null;
-  phone?: string | null;
-  created_at: string | Date;
-  updated_at: string | Date;
-}
-
-export interface Work {
-  id: string;
-  property_id: string;
-  manufacturer_id?: string | null;
-  created_by: string;
-  title: string;
-  description?: string | null;
-  status: WorkStatus;
-  scheduled_at?: string | Date | null;
-  completed_at?: string | Date | null;
-  created_at: string | Date;
-  updated_at: string | Date;
-}
-
-export interface AuditLog {
-  id: number;
-  user_id?: string | null;
-  channel?: AccessChannel | null;
-  action: string;
-  entity_type?: string | null;
-  entity_id?: string | null;
-  metadata?: Record<string, unknown> | null;
-  created_at: string | Date;
-}
-
-export declare const USER_STATUSES: readonly UserStatus[];
-export declare const USER_ROLES: readonly UserRole[];
-export declare const ACCESS_CHANNELS: readonly AccessChannel[];
-export declare const ACCESS_STATUSES: readonly AccessStatus[];
-export declare const PROPERTY_STATUSES: readonly PropertyStatus[];
-export declare const MANAGEMENT_ROLES: readonly ManagementRole[];
-export declare const LEASE_STATUSES: readonly LeaseStatus[];
-export declare const INSPECTION_TYPES: readonly InspectionType[];
-export declare const INSPECTION_STATUSES: readonly InspectionStatus[];
-export declare const CONDITION_STATUSES: readonly ConditionStatus[];
-export declare const CLAIM_STATUSES: readonly ClaimStatus[];
-export declare const WORK_STATUSES: readonly WorkStatus[];
-export declare const COLOR_PALETTE: Readonly<ColorPalette>;
-export declare const CONSTANTS: Readonly<Constants>;
-export declare const Query: Readonly<QueryHelpers>;
-
-export declare function toDate(value: string | number | Date | null | undefined): Date | null;
-export declare function formatDate(
-  value: string | number | Date | null | undefined,
-  locales?: string | string[],
-  options?: Intl.DateTimeFormatOptions
-): string;
-export declare function formatDateTime(
-  value: string | number | Date | null | undefined,
-  locales?: string | string[],
-  options?: Intl.DateTimeFormatOptions
-): string;
-export declare function formatCurrency(
-  amount: string | number | null | undefined,
-  currency?: string,
-  locales?: string | string[],
-  options?: Intl.NumberFormatOptions
-): string;
-export declare function getUserFullName(
-  user: Pick<User, 'first_name' | 'last_name'> | Partial<Pick<User, 'first_name' | 'last_name'>> | null | undefined
-): string;
-export declare function formatAddress(entity: Addressable | null | undefined): string;
-export declare function hasUserRole(
-  userRoles: Array<UserRoleAssignment | UserRole> | null | undefined,
-  role: UserRole
-): boolean;
-export declare function hasAccessChannel(
-  accessChannels: Array<UserAccessChannel | AccessChannel> | null | undefined,
-  channel: AccessChannel
-): boolean;
+export type UserStatus = 'active' | 'invited' | 'suspended' | 'disabled';
+export type UserRole = 'lessor' | 'manager' | 'website_manager' | 'inspector';
+export type AccessChannel = 'intranet_dashboard' | 'mobile_app' | 'website_admin';
+export type AccessRole = 'admin' | 'manager' | 'employee' | 'lessor' | 'inspector' | 'editor';
+export type AccessStatus = 'active' | 'revoked';
+export type DeviceType = 'web' | 'mobile';
+export type PropertyStatus = 'active' | 'inactive' | 'archived';
+export type ManagementRole = 'primary' | 'secondary' | 'accounting' | 'technical' | 'other';
+export type LeaseStatus = 'planned' | 'active' | 'ended' | 'cancelled';
+export type InspectionType = 'move_in' | 'move_out';
+export type InspectionStatus = 'draft' | 'in_progress' | 'submitted' | 'approved' | 'rejected';
+export type ConditionStatus = 'good' | 'minor_damage' | 'major_damage' | 'not_checked';
+export type ClaimStatus = 'draft' | 'submitted' | 'in_review' | 'approved' | 'rejected' | 'closed';
+export type WorkStatus = 'planned' | 'assigned' | 'in_progress' | 'completed' | 'cancelled';
+
+export interface ColorPalette {
+  primary: string;
+  secondary: string;
+  accent: string;
+  background: string;
+  text: string;
+}
+
+export interface Constants {
+  API_DEV: string;
+  API: string;
+  ICON: string;
+}
+
+export interface QueryHelpers {
+  isSuccess(errorCode: string): boolean;
+}
+
+export interface Addressable {
+  address_line1?: string | null;
+  address_line2?: string | null;
+  postal_code?: string | null;
+  city?: string | null;
+  country_code?: string | null;
+}
+
+export interface User extends Addressable {
+  id: string;
+  email: string;
+  password_hash?: string;
+  first_name: string;
+  last_name: string;
+  phone?: string | null;
+  country_code: string;
+  status: UserStatus;
+  email_verified_at?: string | Date | null;
+  last_login_at?: string | Date | null;
+  created_at?: string | Date;
+  updated_at?: string | Date;
+  access_channels?: UserAccessChannel[];
+}
+
+export interface UserRoleAssignment {
+  user_id: string;
+  role: UserRole;
+  created_at: string | Date;
+}
+
+export interface UserAccessChannel {
+  user_id?: string;
+  channel: AccessChannel;
+  role: AccessRole;
+  status: AccessStatus;
+  created_at: string | Date;
+  revoked_at?: string | Date | null;
+}
+
+export interface AccessChannelAssignment extends UserAccessChannel {
+  user_id: string;
+}
+
+export interface UserInvite {
+  email: string;
+  token_hash: string;
+  channel: AccessChannel;
+  role: AccessRole;
+  inviter_id: string;
+  expires_at: string | Date;
+  used_at?: string | Date | null;
+  created_at: string | Date;
+}
+
+export interface Device {
+  uuid: string;
+  user_id?: string | null;
+  type: DeviceType;
+  allowed: boolean | number;
+  os: string;
+}
+
+export interface Session {
+  token: string;
+  type: string;
+  expire: string | Date;
+  refresh_token: string;
+  refresh_expire: string | Date;
+  code?: string | null;
+  code_expire: string | Date;
+  user_id: string;
+  device_uuid: string;
+  ip: string;
+}
+
+export interface Building extends Addressable {
+  id: string;
+  name: string;
+  address_line1: string;
+  postal_code: string;
+  city: string;
+  created_at: string | Date;
+  updated_at: string | Date;
+}
+
+export interface Property {
+  id: string;
+  building_id: string;
+  apartment_number: string;
+  floor?: string | null;
+  area_m2?: number | string | null;
+  status: PropertyStatus;
+  created_at: string | Date;
+  updated_at: string | Date;
+}
+
+export interface PropertyLessor {
+  apartment_id: string;
+  user_id: string;
+  ownership_share?: number | string | null;
+  is_primary: boolean | number;
+  created_at: string | Date;
+}
+
+export interface PropertyManager {
+  apartment_id: string;
+  user_id: string;
+  management_role: ManagementRole;
+  valid_from?: string | Date | null;
+  valid_until?: string | Date | null;
+  created_at: string | Date;
+}
+
+export interface Lease {
+  id: string;
+  apartment_id: string;
+  tenant_name?: string | null;
+  tenant_email?: string | null;
+  tenant_phone?: string | null;
+  start_date: string | Date;
+  end_date?: string | Date | null;
+  status: LeaseStatus;
+  created_at: string | Date;
+  updated_at: string | Date;
+}
+
+export interface Inspection {
+  id: string;
+  lease_id: string;
+  inspector_id: string;
+  inspection_type: InspectionType;
+  status: InspectionStatus;
+  scheduled_at?: string | Date | null;
+  started_at?: string | Date | null;
+  submitted_at?: string | Date | null;
+  notes?: string | null;
+  created_at: string | Date;
+  updated_at: string | Date;
+}
+
+export interface InspectionItem {
+  id: string;
+  inspection_id: string;
+  room_id?: string | null;
+  item_name: string;
+  condition_status: ConditionStatus;
+  comment?: string | null;
+  created_at: string | Date;
+}
+
+export interface InspectionAttachment {
+  id: string;
+  inspection_item_id: string;
+  file_name: string;
+  storage_key: string;
+  mime_type?: string | null;
+  file_size?: number | null;
+  created_at: string | Date;
+}
+
+export interface Claim {
+  id: string;
+  apartment_id: string;
+  submitted_by: string;
+  status: ClaimStatus;
+  incident_date?: string | Date | null;
+  title: string;
+  description: string;
+  amount_estimate?: number | string | null;
+  submitted_at?: string | Date | null;
+  created_at: string | Date;
+  updated_at: string | Date;
+}
+
+export interface ClaimAttachment {
+  id: string;
+  claim_id: string;
+  file_name: string;
+  storage_key: string;
+  mime_type?: string | null;
+  file_size?: number | null;
+  created_at: string | Date;
+}
+
+export interface Manufacturer extends Pick<Addressable, 'address_line1' | 'postal_code' | 'city'> {
+  id: string;
+  name: string;
+  country_code: string;
+  email?: string | null;
+  phone?: string | null;
+  created_at: string | Date;
+  updated_at: string | Date;
+}
+
+export interface Work {
+  id: string;
+  apartment_id: string;
+  manufacturer_id?: string | null;
+  created_by: string;
+  title: string;
+  description?: string | null;
+  status: WorkStatus;
+  scheduled_at?: string | Date | null;
+  completed_at?: string | Date | null;
+  created_at: string | Date;
+  updated_at: string | Date;
+}
+
+export interface AuditLog {
+  action_id: string;
+  timestamp: string | Date;
+  user_id: string;
+  action: string;
+  other_data?: string | null;
+  ip: string;
+}
+
+export type ApartmentLessor = PropertyLessor;
+export type ApartmentManager = PropertyManager;
+
+export interface Room {
+  id: string;
+  name: string;
+  weight: number;
+}
+
+export interface ApartmentRoom {
+  apartment_id: string;
+  room_id: string;
+}
+
+export declare const USER_STATUSES: readonly UserStatus[];
+export declare const USER_ROLES: readonly UserRole[];
+export declare const ACCESS_CHANNELS: readonly AccessChannel[];
+export declare const ACCESS_ROLES: readonly AccessRole[];
+export declare const ACCESS_STATUSES: readonly AccessStatus[];
+export declare const DEVICE_TYPES: readonly DeviceType[];
+export declare const PROPERTY_STATUSES: readonly PropertyStatus[];
+export declare const MANAGEMENT_ROLES: readonly ManagementRole[];
+export declare const LEASE_STATUSES: readonly LeaseStatus[];
+export declare const INSPECTION_TYPES: readonly InspectionType[];
+export declare const INSPECTION_STATUSES: readonly InspectionStatus[];
+export declare const CONDITION_STATUSES: readonly ConditionStatus[];
+export declare const CLAIM_STATUSES: readonly ClaimStatus[];
+export declare const WORK_STATUSES: readonly WorkStatus[];
+export declare const COLOR_PALETTE: Readonly<ColorPalette>;
+export declare const CONSTANTS: Readonly<Constants>;
+export declare const Query: Readonly<QueryHelpers>;
+
+export declare function toDate(value: string | number | Date | null | undefined): Date | null;
+export declare function formatDate(
+  value: string | number | Date | null | undefined,
+  locales?: string | string[],
+  options?: Intl.DateTimeFormatOptions
+): string;
+export declare function formatDateTime(
+  value: string | number | Date | null | undefined,
+  locales?: string | string[],
+  options?: Intl.DateTimeFormatOptions
+): string;
+export declare function formatCurrency(
+  amount: string | number | null | undefined,
+  currency?: string,
+  locales?: string | string[],
+  options?: Intl.NumberFormatOptions
+): string;
+export declare function getUserFullName(
+  user: Pick<User, 'first_name' | 'last_name'> | Partial<Pick<User, 'first_name' | 'last_name'>> | null | undefined
+): string;
+export declare function formatAddress(entity: Addressable | null | undefined): string;
+export declare function hasUserRole(
+  userRoles: ReadonlyArray<Pick<UserRoleAssignment, 'role'> | UserRole> | null | undefined,
+  role: UserRole
+): boolean;
+export declare function hasAccessChannel(
+  accessChannels: ReadonlyArray<Pick<UserAccessChannel, 'channel'> & Partial<Pick<UserAccessChannel, 'status'>> | AccessChannel> | null | undefined,
+  channel: AccessChannel
+): boolean;

package/index.js

@@ -1,149 +1,153 @@
-'use strict';
-
-const USER_STATUSES = Object.freeze(['active', 'invited', 'suspended', 'disabled']);
-const USER_ROLES = Object.freeze(['lessor', 'manager', 'website_manager', 'inspector']);
-const ACCESS_CHANNELS = Object.freeze(['intranet_dashboard', 'mobile_app', 'website_admin']);
-const ACCESS_STATUSES = Object.freeze(['active', 'revoked']);
-const PROPERTY_STATUSES = Object.freeze(['active', 'inactive', 'archived']);
-const MANAGEMENT_ROLES = Object.freeze(['primary', 'secondary', 'accounting', 'technical', 'other']);
-const LEASE_STATUSES = Object.freeze(['planned', 'active', 'ended', 'cancelled']);
-const INSPECTION_TYPES = Object.freeze(['move_in', 'move_out']);
-const INSPECTION_STATUSES = Object.freeze(['draft', 'in_progress', 'submitted', 'approved', 'rejected']);
-const CONDITION_STATUSES = Object.freeze(['good', 'minor_damage', 'major_damage', 'not_checked']);
-const CLAIM_STATUSES = Object.freeze(['draft', 'submitted', 'in_review', 'approved', 'rejected', 'closed']);
-const WORK_STATUSES = Object.freeze(['planned', 'assigned', 'in_progress', 'completed', 'cancelled']);
-const COLOR_PALETTE = Object.freeze({
-  primary: '#334E68',
-  secondary: '#829AB1',
-  accent: '#D64545',
-  background: '#F7F9FB',
-  text: '#102A43', 
-});
-const CONSTANTS = Object.freeze({
-  API_DEV: 'https://test.jawsdevelopers.ch',
-  API: 'https://api.consulca.ch',
-  ICON: 'https://www.consulca.ch/wp-content/themes/consulca_theme2020/img/default_user.png'
-});
-const Query = Object.freeze({
-  isSuccess(errorCode) {
-    return typeof errorCode === 'string' && /^\d{2}\.\d{2}\.0\d{2}$/.test(errorCode);
-  },
-});
-
-function toDate(value) {
-  if (value === null || value === undefined || value === '') {
-    return null;
-  }
-
-  const date = value instanceof Date ? value : new Date(value);
-  return Number.isNaN(date.getTime()) ? null : date;
-}
-
-function formatDate(value, locales = 'it-CH', options = {}) {
-  const date = toDate(value);
-  if (!date) {
-    return '';
-  }
-
-  return new Intl.DateTimeFormat(locales, {
-    year: 'numeric',
-    month: '2-digit',
-    day: '2-digit',
-    ...options,
-  }).format(date);
-}
-
-function formatDateTime(value, locales = 'it-CH', options = {}) {
-  const date = toDate(value);
-  if (!date) {
-    return '';
-  }
-
-  return new Intl.DateTimeFormat(locales, {
-    year: 'numeric',
-    month: '2-digit',
-    day: '2-digit',
-    hour: '2-digit',
-    minute: '2-digit',
-    ...options,
-  }).format(date);
-}
-
-function formatCurrency(amount, currency = 'CHF', locales = 'it-CH', options = {}) {
-  if (amount === null || amount === undefined || amount === '') {
-    return '';
-  }
-
-  const numericAmount = Number(amount);
-  if (Number.isNaN(numericAmount)) {
-    return '';
-  }
-
-  return new Intl.NumberFormat(locales, {
-    style: 'currency',
-    currency,
-    ...options,
-  }).format(numericAmount);
-}
-
-function getUserFullName(user) {
-  return [user?.first_name, user?.last_name].filter(Boolean).join(' ').trim();
-}
-
-function formatAddress(entity) {
-  if (!entity) {
-    return '';
-  }
-
-  const line1 = [entity.address_line1, entity.address_line2].filter(Boolean).join(', ');
-  const line2 = [entity.postal_code, entity.city].filter(Boolean).join(' ');
-
-  return [line1, line2, entity.country_code].filter(Boolean).join(', ');
-}
-
-function hasUserRole(userRoles, role) {
-  return (userRoles ?? []).some((userRole) => {
-    if (typeof userRole === 'string') {
-      return userRole === role;
-    }
-
-    return userRole?.role === role;
-  });
-}
-
-function hasAccessChannel(accessChannels, channel) {
-  return (accessChannels ?? []).some((accessChannel) => {
-    if (typeof accessChannel === 'string') {
-      return accessChannel === channel;
-    }
-
-    return accessChannel?.channel === channel && accessChannel?.status !== 'revoked';
-  });
-}
-
-
-module.exports = {
-  ACCESS_CHANNELS,
-  ACCESS_STATUSES,
-  CLAIM_STATUSES,
-  COLOR_PALETTE,
-  CONDITION_STATUSES,
-  INSPECTION_STATUSES,
-  INSPECTION_TYPES,
-  LEASE_STATUSES,
-  MANAGEMENT_ROLES,
-  PROPERTY_STATUSES,
-  USER_ROLES,
-  USER_STATUSES,
-  WORK_STATUSES,
-  CONSTANTS,
-  formatAddress,
-  formatCurrency,
-  formatDate,
-  formatDateTime,
-  getUserFullName,
-  hasAccessChannel,
-  hasUserRole,
-  Query,
-  toDate,
-};
+'use strict';
+
+const USER_STATUSES = Object.freeze(['active', 'invited', 'suspended', 'disabled']);
+const USER_ROLES = Object.freeze(['lessor', 'manager', 'website_manager', 'inspector']);
+const ACCESS_CHANNELS = Object.freeze(['intranet_dashboard', 'mobile_app', 'website_admin']);
+const ACCESS_ROLES = Object.freeze(['admin', 'manager', 'employee', 'lessor', 'inspector', 'editor']);
+const ACCESS_STATUSES = Object.freeze(['active', 'revoked']);
+const DEVICE_TYPES = Object.freeze(['web', 'mobile']);
+const PROPERTY_STATUSES = Object.freeze(['active', 'inactive', 'archived']);
+const MANAGEMENT_ROLES = Object.freeze(['primary', 'secondary', 'accounting', 'technical', 'other']);
+const LEASE_STATUSES = Object.freeze(['planned', 'active', 'ended', 'cancelled']);
+const INSPECTION_TYPES = Object.freeze(['move_in', 'move_out']);
+const INSPECTION_STATUSES = Object.freeze(['draft', 'in_progress', 'submitted', 'approved', 'rejected']);
+const CONDITION_STATUSES = Object.freeze(['good', 'minor_damage', 'major_damage', 'not_checked']);
+const CLAIM_STATUSES = Object.freeze(['draft', 'submitted', 'in_review', 'approved', 'rejected', 'closed']);
+const WORK_STATUSES = Object.freeze(['planned', 'assigned', 'in_progress', 'completed', 'cancelled']);
+const COLOR_PALETTE = Object.freeze({
+  primary: '#334E68',
+  secondary: '#829AB1',
+  accent: '#D64545',
+  background: '#F7F9FB',
+  text: '#102A43', 
+});
+const CONSTANTS = Object.freeze({
+  API_DEV: 'https://test.jawsdevelopers.ch',
+  API: 'https://api.consulca.ch',
+  ICON: 'https://www.consulca.ch/wp-content/themes/consulca_theme2020/img/default_user.png'
+});
+const Query = Object.freeze({
+  isSuccess(errorCode) {
+    return typeof errorCode === 'string' && /^\d{2}\.\d{2}\.0\d{2}$/.test(errorCode);
+  },
+});
+
+function toDate(value) {
+  if (value === null || value === undefined || value === '') {
+    return null;
+  }
+
+  const date = value instanceof Date ? value : new Date(value);
+  return Number.isNaN(date.getTime()) ? null : date;
+}
+
+function formatDate(value, locales = 'it-CH', options = {}) {
+  const date = toDate(value);
+  if (!date) {
+    return '';
+  }
+
+  return new Intl.DateTimeFormat(locales, {
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    ...options,
+  }).format(date);
+}
+
+function formatDateTime(value, locales = 'it-CH', options = {}) {
+  const date = toDate(value);
+  if (!date) {
+    return '';
+  }
+
+  return new Intl.DateTimeFormat(locales, {
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    ...options,
+  }).format(date);
+}
+
+function formatCurrency(amount, currency = 'CHF', locales = 'it-CH', options = {}) {
+  if (amount === null || amount === undefined || amount === '') {
+    return '';
+  }
+
+  const numericAmount = Number(amount);
+  if (Number.isNaN(numericAmount)) {
+    return '';
+  }
+
+  return new Intl.NumberFormat(locales, {
+    style: 'currency',
+    currency,
+    ...options,
+  }).format(numericAmount);
+}
+
+function getUserFullName(user) {
+  return [user?.first_name, user?.last_name].filter(Boolean).join(' ').trim();
+}
+
+function formatAddress(entity) {
+  if (!entity) {
+    return '';
+  }
+
+  const line1 = [entity.address_line1, entity.address_line2].filter(Boolean).join(', ');
+  const line2 = [entity.postal_code, entity.city].filter(Boolean).join(' ');
+
+  return [line1, line2, entity.country_code].filter(Boolean).join(', ');
+}
+
+function hasUserRole(userRoles, role) {
+  return (userRoles ?? []).some((userRole) => {
+    if (typeof userRole === 'string') {
+      return userRole === role;
+    }
+
+    return userRole?.role === role;
+  });
+}
+
+function hasAccessChannel(accessChannels, channel) {
+  return (accessChannels ?? []).some((accessChannel) => {
+    if (typeof accessChannel === 'string') {
+      return accessChannel === channel;
+    }
+
+    return accessChannel?.channel === channel && accessChannel?.status !== 'revoked';
+  });
+}
+
+
+module.exports = {
+  ACCESS_CHANNELS,
+  ACCESS_ROLES,
+  ACCESS_STATUSES,
+  CLAIM_STATUSES,
+  COLOR_PALETTE,
+  CONDITION_STATUSES,
+  DEVICE_TYPES,
+  INSPECTION_STATUSES,
+  INSPECTION_TYPES,
+  LEASE_STATUSES,
+  MANAGEMENT_ROLES,
+  PROPERTY_STATUSES,
+  USER_ROLES,
+  USER_STATUSES,
+  WORK_STATUSES,
+  CONSTANTS,
+  formatAddress,
+  formatCurrency,
+  formatDate,
+  formatDateTime,
+  getUserFullName,
+  hasAccessChannel,
+  hasUserRole,
+  Query,
+  toDate,
+};

package/index.mjs

@@ -1,30 +1,31 @@
-import pkg from './index.js';
-
-export const {
-  ACCESS_CHANNELS,
-  ACCESS_STATUSES,
-  CLAIM_STATUSES,
-  COLOR_PALETTE,
-  CONDITION_STATUSES,
-  INSPECTION_STATUSES,
-  INSPECTION_TYPES,
-  LEASE_STATUSES,
-  MANAGEMENT_ROLES,
-  PROPERTY_STATUSES,
-  PROPERTY_TYPES,
-  USER_ROLES,
-  USER_STATUSES,
-  WORK_STATUSES,
-  CONSTANTS,
-  formatAddress,
-  formatCurrency,
-  formatDate,
-  formatDateTime,
-  getUserFullName,
-  hasAccessChannel,
-  hasUserRole,
-  Query,
-  toDate,
-} = pkg;
-
-export default pkg;
+import pkg from './index.js';
+
+export const {
+  ACCESS_CHANNELS,
+  ACCESS_ROLES,
+  ACCESS_STATUSES,
+  CLAIM_STATUSES,
+  COLOR_PALETTE,
+  CONDITION_STATUSES,
+  DEVICE_TYPES,
+  INSPECTION_STATUSES,
+  INSPECTION_TYPES,
+  LEASE_STATUSES,
+  MANAGEMENT_ROLES,
+  PROPERTY_STATUSES,
+  USER_ROLES,
+  USER_STATUSES,
+  WORK_STATUSES,
+  CONSTANTS,
+  formatAddress,
+  formatCurrency,
+  formatDate,
+  formatDateTime,
+  getUserFullName,
+  hasAccessChannel,
+  hasUserRole,
+  Query,
+  toDate,
+} = pkg;
+
+export default pkg;

package/package.json

@@ -1,51 +1,51 @@
-{
-  "name": "@jaws-developers-customers/consulca-types",
-  "version": "1.1.15",
-  "description": "Tipi e helper per il dominio Consulca.",
-  "keywords": [
-    "consulca",
-    "mariadb",
-    "types",
-    "helpers",
-    "formatter"
-  ],
-  "homepage": "https://github.com/JAWS-Developers-Customers/15-NPMPackage#readme",
-  "bugs": {
-    "url": "https://github.com/JAWS-Developers-Customers/15-NPMPackage/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/JAWS-Developers-Customers/15-NPMPackage.git"
-  },
-  "license": "UNLICENSED",
-  "author": "JAWS-Developers-Customers",
-  "type": "commonjs",
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "require": "./index.js",
-      "import": "./index.mjs",
-      "default": "./index.js"
-    }
-  },
-  "main": "index.js",
-  "types": "index.d.ts",
-  "directories": {
-    "test": "test"
-  },
-  "files": [
-    "index.js",
-    "index.mjs",
-    "index.d.ts",
-    "README.md"
-  ],
-  "scripts": {
-    "test": "node --test"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "jaws-helper": "^3.2.3"
-  }
-}
+{
+  "name": "@jaws-developers-customers/consulca-types",
+  "version": "1.1.23",
+  "description": "Tipi e helper per il dominio Consulca.",
+  "keywords": [
+    "consulca",
+    "mariadb",
+    "types",
+    "helpers",
+    "formatter"
+  ],
+  "homepage": "https://github.com/JAWS-Developers-Customers/15-NPMPackage#readme",
+  "bugs": {
+    "url": "https://github.com/JAWS-Developers-Customers/15-NPMPackage/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JAWS-Developers-Customers/15-NPMPackage.git"
+  },
+  "license": "UNLICENSED",
+  "author": "JAWS-Developers-Customers",
+  "type": "commonjs",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "import": "./index.mjs",
+      "default": "./index.js"
+    }
+  },
+  "main": "index.js",
+  "types": "index.d.ts",
+  "directories": {
+    "test": "test"
+  },
+  "files": [
+    "index.js",
+    "index.mjs",
+    "index.d.ts",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "jaws-helper": "^3.2.3"
+  }
+}