valtech-components 4.0.938 → 4.0.939

package/lib/components/molecules/group-picker/group-picker.component.d.ts

@@ -0,0 +1,28 @@
+import { EventEmitter, OnInit } from '@angular/core';
+import { ValGroup } from '../../../services/groups/types';
+import * as i0 from "@angular/core";
+/**
+ * val-group-picker — elegir el grupo dueño de un recurso (ADR-083).
+ *
+ * Se auto-carga: pide sus propios grupos a `GroupsService` en vez de esperar
+ * que el consumer se los pase. Es la razón por la que existe como componente y
+ * no como un `<select>` armado a mano en cada app — "una línea, una etiqueta
+ * i18n" (ver ADR-083 §"Qué se construye una sola vez").
+ *
+ * Sin texto hardcodeado: los labels llegan por `@Input` (lib i18n-agnostic).
+ * Cada app pone su palabra ("Equipo", "Sucursal", "Refugio").
+ */
+export declare class GroupPickerComponent implements OnInit {
+    label: string;
+    placeholder: string;
+    noGroupLabel: string;
+    value: string | null;
+    disabled: boolean;
+    valueChange: EventEmitter<string>;
+    private readonly groupsSvc;
+    groups: ValGroup[];
+    ngOnInit(): void;
+    onChange(v: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GroupPickerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GroupPickerComponent, "val-group-picker", never, { "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "noGroupLabel": { "alias": "noGroupLabel"; "required": false; }; "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}

package/lib/components/organisms/group-members/group-members.component.d.ts

@@ -0,0 +1,43 @@
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { ButtonMetadata } from '../../types';
+import { ValGroupMember } from '../../../services/groups/types';
+import * as i0 from "@angular/core";
+/** Persona elegible para agregar al grupo (típicamente un `OrgMember`). */
+export interface GroupMemberCandidate {
+    userId: string;
+    name?: string;
+    email?: string;
+}
+/**
+ * val-group-members — administrar la membresía de UN grupo (ADR-083).
+ *
+ * Deliberadamente NO trae su propio selector de personas: la fuente de
+ * "quiénes son los miembros elegibles de la organización" varía por app (org
+ * members, invitados, etc.), así que se recibe por `@Input candidates` en vez
+ * de que este organismo importe un servicio de organización que no le
+ * corresponde. Sin candidatos, igual funciona: solo lista y quita.
+ *
+ * Sin texto hardcodeado (lib i18n-agnostic): los labels llegan por `@Input`.
+ */
+export declare class GroupMembersComponent implements OnChanges {
+    groupId: string;
+    /** Personas elegibles para agregar. Vacío = el organismo solo lista/quita. */
+    candidates: GroupMemberCandidate[];
+    addPlaceholder: string;
+    emptyLabel: string;
+    removeLabel: string;
+    membersChange: EventEmitter<ValGroupMember[]>;
+    private readonly groupsSvc;
+    members: ValGroupMember[];
+    busy: boolean;
+    get removeButtonProps(): ButtonMetadata;
+    ngOnChanges(changes: SimpleChanges): void;
+    private reload;
+    /** Candidatos que todavía no están en el grupo — evita ofrecer un alta duplicada. */
+    eligible(): GroupMemberCandidate[];
+    nameFor(userId: string): string;
+    add(userId: string): void;
+    remove(userId: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GroupMembersComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GroupMembersComponent, "val-group-members", never, { "groupId": { "alias": "groupId"; "required": true; }; "candidates": { "alias": "candidates"; "required": false; }; "addPlaceholder": { "alias": "addPlaceholder"; "required": false; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; }; "removeLabel": { "alias": "removeLabel"; "required": false; }; }, { "membersChange": "membersChange"; }, never, never, true, never>;
+}

package/lib/services/groups/groups.service.d.ts

@@ -0,0 +1,39 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { ValtechAuthConfig } from '../auth/types';
+import { ValGroup, ValGroupMember, CreateGroupRequest, UpdateGroupRequest, AddGroupMemberRequest, MyGroupsResponse } from './types';
+import * as i0 from "@angular/core";
+/**
+ * Cliente de `/v2/groups/*` (ADR-083). Servicio de PLATAFORMA: no sabe qué es
+ * un blueprint ni un refugio, solo agrupa recursos y personas. Cada app lo
+ * consume igual — es lo que evita reescribir esta capa por producto.
+ */
+export declare class GroupsService {
+    private config;
+    private http;
+    constructor(config: ValtechAuthConfig, http: HttpClient);
+    private get baseUrl();
+    /** Grupos activos de la organización (filtrados por app en el backend). */
+    listGroups(): Observable<ValGroup[]>;
+    /** Incluye archivados: para la pantalla de administración. */
+    listAllGroups(): Observable<ValGroup[]>;
+    getGroup(id: string): Observable<ValGroup>;
+    createGroup(req: CreateGroupRequest): Observable<ValGroup>;
+    updateGroup(id: string, req: UpdateGroupRequest): Observable<ValGroup>;
+    /**
+     * No hay `deleteGroup`: el ADR-083 decidió que un servicio de plataforma no
+     * puede saber si un vertical todavía apunta al grupo, y como "sin grupo"
+     * significa visible para toda la organización, borrarlo publicaría sus
+     * recursos a la planta entera. `archiveGroup`/`restoreGroup` cubren la
+     * necesidad real sin ese riesgo.
+     */
+    archiveGroup(id: string): Observable<ValGroup>;
+    restoreGroup(id: string): Observable<ValGroup>;
+    listMembers(groupId: string): Observable<ValGroupMember[]>;
+    addMember(groupId: string, req: AddGroupMemberRequest): Observable<ValGroupMember[]>;
+    removeMember(groupId: string, userId: string): Observable<ValGroupMember[]>;
+    /** Los grupos del usuario actual. Referencial: el filtrado real corre en el backend. */
+    myGroups(): Observable<MyGroupsResponse>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<GroupsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<GroupsService>;
+}

package/lib/services/groups/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Grupos (ADR-083) — subdivisión de una organización que agrupa RECURSOS y
+ * PERSONAS a la vez. Servicio de plataforma, agnóstico de dominio: el mismo
+ * contrato sirve a la línea de producción de Merotz, al refugio de Chesed o al
+ * evento de Bingo. Cada app le pone su etiqueta ("Equipo", "Sucursal") vía i18n
+ * — el modelo no la sabe.
+ */
+export interface ValGroup {
+    id: string;
+    orgId: string;
+    appId: string;
+    /** Etiqueta de dominio que declara la app: "machine", "shelter", "event". */
+    kind?: string;
+    /** Texto del CLIENTE ("Línea 3"): no se traduce. */
+    name: string;
+    parentId?: string;
+    archived: boolean;
+    createdAt: string;
+    createdBy?: string;
+    updatedAt: string;
+}
+export interface ValGroupMember {
+    groupId: string;
+    orgId: string;
+    userId: string;
+    groupName?: string;
+    addedAt: string;
+    addedBy?: string;
+}
+export interface CreateGroupRequest {
+    name: string;
+    kind?: string;
+}
+export interface UpdateGroupRequest {
+    name: string;
+}
+export interface AddGroupMemberRequest {
+    userId: string;
+}
+export interface GroupResponse {
+    operationId: string;
+    group: ValGroup;
+}
+export interface ListGroupsResponse {
+    operationId: string;
+    groups: ValGroup[];
+    count: number;
+}
+export interface ListGroupMembersResponse {
+    operationId: string;
+    members: ValGroupMember[];
+    count: number;
+}
+/**
+ * Respuesta de "mis grupos": lo que alimenta el filtrado del lado del cliente
+ * cuando hace falta mostrar contexto (p.ej. qué grupo eligió el usuario por
+ * default), aunque el filtrado real siempre corre en el backend.
+ */
+export interface MyGroupsResponse {
+    operationId: string;
+    groupIds: string[];
+    /**
+     * El usuario ve TODOS los grupos sin importar membresía (permiso
+     * `groups:all`). Sin `omitempty` del lado del backend a propósito: un
+     * `false` ausente sería indistinguible de una respuesta vieja.
+     */
+    allGroups: boolean;
+    groups: ValGroupMember[];
+}

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "4.0.938";
+export declare const VERSION = "4.0.939";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "4.0.938",
+  "version": "4.0.939",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -448,6 +448,10 @@ export * from './lib/services/legal-link/legal-link.service';
 export * from './lib/services/firebase';
 export * from './lib/services/auth';
 export { OrgService } from './lib/services/org/org.service';
+export { GroupPickerComponent, } from './lib/components/molecules/group-picker/group-picker.component';
+export { GroupMembersComponent, GroupMemberCandidate, } from './lib/components/organisms/group-members/group-members.component';
+export { GroupsService } from './lib/services/groups/groups.service';
+export { ValGroup, ValGroupMember, CreateGroupRequest as CreateValGroupRequest, UpdateGroupRequest as UpdateValGroupRequest, AddGroupMemberRequest, GroupResponse as ValGroupResponse, ListGroupsResponse as ListValGroupsResponse, ListGroupMembersResponse as ListValGroupMembersResponse, MyGroupsResponse, } from './lib/services/groups/types';
 export { PersonaService, PersonaConfig, PERSONA_CONFIG, providePersona, } from './lib/services/persona/persona.service';
 export { HandleService } from './lib/services/handles/handles.service';
 export type { HandleOwnerType, HandleResolveResult, HandleSearchResult, ResolveHandleResponse, SearchHandlesResponse, } from './lib/services/handles/handles.service';