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

package/README.md

@@ -10,18 +10,22 @@ npm install @jaws-developers-customers/consulca-types
 
 ## Pubblicazione automatica
 
-Ogni push su `main` esegue i test e pubblica automaticamente il pacchetto su npm tramite GitHub Actions.
+Ogni push su `master` esegue i test e pubblica automaticamente il pacchetto su npm tramite GitHub Actions.
 
 Prerequisito:
 
-- npm Trusted Publisher configurato per questo repository/workflow su npm
+- 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 workflow genera una versione unica per ogni run su `main`, così la pubblicazione non fallisce per versioni duplicate.
+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`, `PROPERTY_TYPES`, ...)
+- cataloghi `ENUM` dello schema (`USER_ROLES`, `ACCESS_CHANNELS`, `ACCESS_ROLES`, `DEVICE_TYPES`, ...)
 - helper:
   - `formatDate`
   - `formatDateTime`
@@ -62,12 +66,17 @@ import {
 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(),
+  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 = {
@@ -81,4 +90,10 @@ const inspection: Inspection = {
 };
 
 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,7 +1,9 @@
 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';
@@ -40,15 +42,17 @@ export interface Addressable {
 export interface User extends Addressable {
   id: string;
   email: string;
-  password_hash: 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;
+  created_at?: string | Date;
+  updated_at?: string | Date;
+  access_channels?: UserAccessChannel[];
 }
 
 export interface UserRoleAssignment {
@@ -58,30 +62,56 @@ export interface UserRoleAssignment {
 }
 
 export interface UserAccessChannel {
-  user_id: string;
+  user_id?: string;
   channel: AccessChannel;
+  role: AccessRole;
   status: AccessStatus;
   created_at: string | Date;
   revoked_at?: string | Date | null;
 }
 
-export interface Session {
-  id: string;
+export interface AccessChannelAssignment extends UserAccessChannel {
   user_id: string;
+}
+
+export interface UserInvite {
+  email: string;
+  token_hash: string;
   channel: AccessChannel;
-  access_token_hash: string;
-  refresh_token_hash?: string | null;
+  role: AccessRole;
+  inviter_id: string;
   expires_at: string | Date;
-  refresh_expires_at?: string | Date | null;
-  user_agent?: string | null;
-  ip_address?: Uint8Array | string | null;
+  used_at?: string | Date | null;
   created_at: string | Date;
-  revoked_at?: string | Date | null;
+}
+
+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;
 }
@@ -89,24 +119,24 @@ export interface Building extends Addressable {
 export interface Property {
   id: string;
   building_id: string;
-  property_number: string;
+  apartment_number: string;
   floor?: string | null;
-  area_m2?: number | null;
+  area_m2?: number | string | null;
   status: PropertyStatus;
   created_at: string | Date;
   updated_at: string | Date;
 }
 
 export interface PropertyLessor {
-  property_id: string;
+  apartment_id: string;
   user_id: string;
-  ownership_share?: number | null;
+  ownership_share?: number | string | null;
   is_primary: boolean | number;
   created_at: string | Date;
 }
 
 export interface PropertyManager {
-  property_id: string;
+  apartment_id: string;
   user_id: string;
   management_role: ManagementRole;
   valid_from?: string | Date | null;
@@ -116,7 +146,7 @@ export interface PropertyManager {
 
 export interface Lease {
   id: string;
-  property_id: string;
+  apartment_id: string;
   tenant_name?: string | null;
   tenant_email?: string | null;
   tenant_phone?: string | null;
@@ -144,7 +174,7 @@ export interface Inspection {
 export interface InspectionItem {
   id: string;
   inspection_id: string;
-  room?: string | null;
+  room_id?: string | null;
   item_name: string;
   condition_status: ConditionStatus;
   comment?: string | null;
@@ -153,8 +183,7 @@ export interface InspectionItem {
 
 export interface InspectionAttachment {
   id: string;
-  inspection_id: string;
-  item_id?: string | null;
+  inspection_item_id: string;
   file_name: string;
   storage_key: string;
   mime_type?: string | null;
@@ -164,13 +193,13 @@ export interface InspectionAttachment {
 
 export interface Claim {
   id: string;
-  property_id: string;
+  apartment_id: string;
   submitted_by: string;
   status: ClaimStatus;
   incident_date?: string | Date | null;
   title: string;
   description: string;
-  amount_estimate?: number | null;
+  amount_estimate?: number | string | null;
   submitted_at?: string | Date | null;
   created_at: string | Date;
   updated_at: string | Date;
@@ -186,7 +215,7 @@ export interface ClaimAttachment {
   created_at: string | Date;
 }
 
-export interface Manufacturer extends Addressable {
+export interface Manufacturer extends Pick<Addressable, 'address_line1' | 'postal_code' | 'city'> {
   id: string;
   name: string;
   country_code: string;
@@ -198,7 +227,7 @@ export interface Manufacturer extends Addressable {
 
 export interface Work {
   id: string;
-  property_id: string;
+  apartment_id: string;
   manufacturer_id?: string | null;
   created_by: string;
   title: string;
@@ -211,20 +240,34 @@ export interface Work {
 }
 
 export interface AuditLog {
-  id: number;
-  user_id?: string | null;
-  channel?: AccessChannel | null;
+  action_id: string;
+  timestamp: string | Date;
+  user_id: string;
   action: string;
-  entity_type?: string | null;
-  entity_id?: string | null;
-  metadata?: Record<string, unknown> | null;
-  created_at: string | Date;
+  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[];
@@ -259,10 +302,10 @@ export declare function getUserFullName(
 ): string;
 export declare function formatAddress(entity: Addressable | null | undefined): string;
 export declare function hasUserRole(
-  userRoles: Array<UserRoleAssignment | UserRole> | null | undefined,
+  userRoles: ReadonlyArray<Pick<UserRoleAssignment, 'role'> | UserRole> | null | undefined,
   role: UserRole
 ): boolean;
 export declare function hasAccessChannel(
-  accessChannels: Array<UserAccessChannel | AccessChannel> | null | undefined,
+  accessChannels: ReadonlyArray<Pick<UserAccessChannel, 'channel'> & Partial<Pick<UserAccessChannel, 'status'>> | AccessChannel> | null | undefined,
   channel: AccessChannel
 ): boolean;

package/index.js

@@ -3,7 +3,9 @@
 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']);
@@ -20,7 +22,7 @@ const COLOR_PALETTE = Object.freeze({
   text: '#102A43', 
 });
 const CONSTANTS = Object.freeze({
-  API_DEV: 'https://api.consulca.local',
+  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'
 });
@@ -124,10 +126,12 @@ function hasAccessChannel(accessChannels, channel) {
 
 module.exports = {
   ACCESS_CHANNELS,
+  ACCESS_ROLES,
   ACCESS_STATUSES,
   CLAIM_STATUSES,
   COLOR_PALETTE,
   CONDITION_STATUSES,
+  DEVICE_TYPES,
   INSPECTION_STATUSES,
   INSPECTION_TYPES,
   LEASE_STATUSES,

package/index.mjs

@@ -2,16 +2,17 @@ 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,
-  PROPERTY_TYPES,
   USER_ROLES,
   USER_STATUSES,
   WORK_STATUSES,
@@ -20,7 +21,6 @@ export const {
   formatCurrency,
   formatDate,
   formatDateTime,
-  getColorPalette,
   getUserFullName,
   hasAccessChannel,
   hasUserRole,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaws-developers-customers/consulca-types",
-  "version": "1.1.0",
+  "version": "1.1.23",
   "description": "Tipi e helper per il dominio Consulca.",
   "keywords": [
     "consulca",