@tinya-code/gas-admin-ui 0.2.0-alpha.13 → 0.2.0-alpha.15

package/src/lib/core/testing/products.schema.ts

@@ -0,0 +1,258 @@
+import type { ResourceSchema } from '../models/schema.model';
+
+/**
+ * Colección con pestañas — base.md §11, api.md §3.2–§3.5.
+ * Imágenes, specs y FAQ viven en hojas hijas; la API los ensambla.
+ */
+export const productsSchema: ResourceSchema = {
+  id: 'products',
+  label: 'Producto',
+  labelPlural: 'Productos',
+  kind: 'collection',
+  uiViews: {
+    list: { type: 'list' },
+    create: { type: 'form', path: 'new' },
+    edit: { type: 'form', path: ':key/edit' },
+  },
+  endpoint: {
+    list: '/admin/products',
+    get: '/admin/products/{key}',
+    create: '/admin/products',
+    update: '/admin/products/{key}',
+    remove: '/admin/products/{key}',
+  },
+  keyField: 'slug',
+  titleField: 'name',
+  search: ['name', 'sku'],
+  filters: [
+    {
+      key: 'availability',
+      label: 'Disponibilidad',
+      type: 'select',
+      options: [
+        { value: 'InStock', label: 'En stock' },
+        { value: 'PreOrder', label: 'Preventa' },
+        { value: 'OutOfStock', label: 'Agotado' },
+      ],
+    },
+    { key: 'active', label: 'Activo', type: 'boolean' },
+  ],
+  listColumns: [
+    { key: 'images', label: 'Imagen', format: 'thumbnail' },
+    { key: 'name', label: 'Nombre' },
+    { key: 'category_slug', label: 'Categoría' },
+    { key: 'price', label: 'Precio', format: 'currency' },
+    { key: 'availability', label: 'Disponibilidad' },
+    { key: 'registro_sanitario', label: 'Sanitario', format: 'badge' },
+    { key: 'active', label: 'Activo', format: 'boolean' },
+  ],
+  layout: {
+    mode: 'tabs',
+    sections: [
+      { id: 'general', label: 'General' },
+      { id: 'contenido', label: 'Contenido' },
+      { id: 'imagenes', label: 'Imágenes' },
+      { id: 'sanitario', label: 'Sanitario' },
+      { id: 'ficha', label: 'Ficha técnica' },
+      { id: 'faq', label: 'FAQ' },
+    ],
+  },
+  fields: [
+    // ── General ──
+    {
+      type: 'text',
+      key: 'name',
+      label: 'Nombre',
+      required: true,
+      section: 'general',
+      width: 6,
+    },
+    {
+      type: 'slug',
+      key: 'slug',
+      label: 'Slug',
+      from: 'name',
+      lockAfterCreate: true,
+      required: true,
+      validators: { unique: true },
+      help: 'Inmutable tras publicar.',
+      section: 'general',
+      width: 6,
+    },
+    {
+      type: 'relation',
+      key: 'category_slug',
+      label: 'Categoría',
+      required: true,
+      // F8 · R6.5 (D62): UN objeto `source` para todas las fuentes.
+      source: { resource: 'categories', valueField: 'slug', labelField: 'name' },
+      onlyActive: true,
+      section: 'general',
+      width: 6,
+    },
+    {
+      type: 'text',
+      key: 'sku',
+      label: 'SKU',
+      required: true,
+      validators: { unique: true },
+      section: 'general',
+      width: 6,
+    },
+    {
+      type: 'text',
+      key: 'brand',
+      label: 'Marca',
+      section: 'general',
+      width: 6,
+    },
+    {
+      type: 'currency',
+      key: 'price',
+      label: 'Precio',
+      required: true,
+      section: 'general',
+      width: 6,
+    },
+    {
+      type: 'select',
+      key: 'availability',
+      label: 'Disponibilidad',
+      required: true,
+      options: [
+        { value: 'InStock', label: 'En stock' },
+        { value: 'PreOrder', label: 'Preventa' },
+        { value: 'OutOfStock', label: 'Agotado' },
+      ],
+      section: 'general',
+      width: 6,
+    },
+    {
+      type: 'boolean',
+      key: 'featured',
+      label: 'Destacado',
+      required: true,
+      default: false,
+      trueLabel: 'Sí',
+      falseLabel: 'No',
+      section: 'general',
+      width: 6,
+    },
+    {
+      type: 'boolean',
+      key: 'active',
+      label: 'Activo',
+      required: true,
+      default: true,
+      trueLabel: 'Activo',
+      falseLabel: 'Inactivo',
+      section: 'general',
+      width: 6,
+    },
+    // ── Contenido ──
+    {
+      type: 'textarea',
+      key: 'description',
+      label: 'Descripción',
+      required: true,
+      rows: 8,
+      help: 'Entre 100 y 2000 caracteres.',
+      validators: { minLength: 100, maxLength: 2000 },
+      section: 'contenido',
+      width: 12,
+    },
+    {
+      type: 'text',
+      key: 'seo_title',
+      label: 'Título SEO',
+      section: 'contenido',
+      width: 12,
+    },
+    {
+      type: 'textarea',
+      key: 'seo_description',
+      label: 'Descripción SEO',
+      required: true,
+      rows: 3,
+      section: 'contenido',
+      width: 12,
+    },
+    // ── Imágenes (mín 1; la primera es la principal) ──
+    {
+      type: 'list',
+      key: 'images',
+      label: 'Imágenes',
+      required: true,
+      min: 1,
+      primaryFirst: true,
+      positionField: 'position',
+      addLabel: 'Agregar imagen',
+      emptyText: 'Sin imágenes. La primera será la imagen principal.',
+      itemDisplay: 'card',
+      itemTitle: 'image_alt',
+      itemFields: [
+        { type: 'image', key: 'image_url', label: 'Imagen', required: true },
+        { type: 'text', key: 'image_alt', label: 'Texto alternativo', required: true },
+      ],
+      section: 'imagenes',
+      width: 12,
+    },
+    // ── Sanitario ──
+    {
+      type: 'text',
+      key: 'registro_sanitario',
+      label: 'Registro sanitario',
+      help: 'Sin esto el producto no se publica.',
+      section: 'sanitario',
+      width: 4,
+    },
+    {
+      type: 'select',
+      key: 'clase_riesgo',
+      label: 'Clase de riesgo',
+      options: [
+        { value: 'I', label: 'I' },
+        { value: 'IIa', label: 'IIa' },
+        { value: 'IIb', label: 'IIb' },
+        { value: 'III', label: 'III' },
+      ],
+      section: 'sanitario',
+      width: 4,
+    },
+    {
+      type: 'text',
+      key: 'titular_registro',
+      label: 'Titular del registro',
+      section: 'sanitario',
+      width: 4,
+    },
+    // ── Ficha técnica ──
+    {
+      type: 'key-value',
+      key: 'specs',
+      label: 'Especificaciones',
+      positionField: 'position',
+      addLabel: 'Agregar especificación',
+      emptyText: 'Sin especificaciones.',
+      section: 'ficha',
+      width: 12,
+    },
+    // ── FAQ ──
+    {
+      type: 'list',
+      key: 'faq',
+      label: 'Preguntas frecuentes',
+      positionField: 'position',
+      addLabel: 'Agregar pregunta',
+      emptyText: 'Sin preguntas frecuentes.',
+      itemDisplay: 'card',
+      itemTitle: 'question',
+      itemFields: [
+        { type: 'text', key: 'question', label: 'Pregunta', required: true },
+        { type: 'textarea', key: 'answer', label: 'Respuesta', required: true, rows: 4 },
+      ],
+      section: 'faq',
+      width: 12,
+    },
+  ],
+};

package/src/lib/core/testing/site.schema.ts

@@ -0,0 +1,195 @@
+import type { ResourceSchema } from '../models/schema.model';
+
+/**
+ * Singleton de configuración del sitio — base.md §11, api.md §3.6–§3.8.
+ * La API aplana `address_street` etc. a objetos anidados al responder.
+ */
+export const siteSchema: ResourceSchema = {
+  id: 'site',
+  label: 'Sitio',
+  labelPlural: 'Sitio',
+  kind: 'singleton',
+  uiViews: {
+    settings: { type: 'form' },
+  },
+  endpoint: {
+    get: '/admin/site',
+    update: '/admin/site',
+  },
+  // Los singleton no tienen clave de registro; `get`/`update` no la usan.
+  keyField: 'key',
+  titleField: 'name',
+  // Sin listado: `listColumns` queda vacío por tipo.
+  listColumns: [],
+  layout: {
+    mode: 'sections',
+    sections: [
+      { id: 'negocio', label: 'Negocio' },
+      { id: 'contacto', label: 'Contacto' },
+      { id: 'direccion', label: 'Dirección' },
+      { id: 'horarios', label: 'Horarios' },
+      { id: 'redes', label: 'Redes' },
+    ],
+  },
+  fields: [
+    // ── Negocio ──
+    {
+      type: 'text',
+      key: 'name',
+      label: 'Nombre del negocio',
+      required: true,
+      section: 'negocio',
+      width: 6,
+    },
+    {
+      type: 'url',
+      key: 'url',
+      label: 'Sitio web',
+      required: true,
+      section: 'negocio',
+      width: 6,
+    },
+    {
+      type: 'textarea',
+      key: 'description',
+      label: 'Descripción',
+      required: true,
+      rows: 4,
+      section: 'negocio',
+      width: 12,
+    },
+    {
+      type: 'text',
+      key: 'currency',
+      label: 'Moneda',
+      required: true,
+      default: 'PEN',
+      help: 'Código ISO 4217 (ej. PEN).',
+      validators: { pattern: '^[A-Z]{3}$' },
+      section: 'negocio',
+      width: 6,
+    },
+    // ── Contacto ──
+    {
+      type: 'phone',
+      key: 'phone',
+      label: 'Teléfono',
+      required: true,
+      format: 'e164',
+      section: 'contacto',
+      width: 6,
+    },
+    {
+      type: 'phone',
+      key: 'whatsapp',
+      label: 'WhatsApp',
+      required: true,
+      format: 'digits',
+      help: 'Solo dígitos, sin +.',
+      section: 'contacto',
+      width: 6,
+    },
+    {
+      type: 'email',
+      key: 'email',
+      label: 'Correo',
+      required: true,
+      section: 'contacto',
+      width: 6,
+    },
+    // ── Dirección (grupos address y geo) ──
+    {
+      type: 'group',
+      key: 'address',
+      label: 'Dirección',
+      required: true,
+      display: 'card',
+      section: 'direccion',
+      width: 12,
+      fields: [
+        { type: 'text', key: 'street', label: 'Calle', required: true },
+        { type: 'text', key: 'city', label: 'Ciudad', required: true },
+        { type: 'text', key: 'region', label: 'Región', required: true },
+        { type: 'text', key: 'postal_code', label: 'Código postal', required: true },
+        {
+          type: 'text',
+          key: 'country',
+          label: 'País',
+          required: true,
+          help: 'ISO alpha-2 (ej. PE).',
+          validators: { pattern: '^[A-Z]{2}$' },
+        },
+      ],
+    },
+    {
+      type: 'group',
+      key: 'geo',
+      label: 'Coordenadas',
+      required: true,
+      display: 'card',
+      section: 'direccion',
+      width: 12,
+      fields: [
+        {
+          type: 'number',
+          key: 'lat',
+          label: 'Latitud',
+          required: true,
+          min: -90,
+          max: 90,
+          decimals: 6,
+        },
+        {
+          type: 'number',
+          key: 'lng',
+          label: 'Longitud',
+          required: true,
+          min: -180,
+          max: 180,
+          decimals: 6,
+        },
+      ],
+    },
+    // ── Horarios ──
+    {
+      type: 'list',
+      key: 'hours',
+      label: 'Horarios',
+      positionField: 'position',
+      addLabel: 'Agregar tramo',
+      emptyText: 'Sin horarios definidos.',
+      itemFields: [
+        {
+          type: 'multiselect',
+          key: 'days',
+          label: 'Días',
+          required: true,
+          options: [
+            { value: 'mon', label: 'Lunes' },
+            { value: 'tue', label: 'Martes' },
+            { value: 'wed', label: 'Miércoles' },
+            { value: 'thu', label: 'Jueves' },
+            { value: 'fri', label: 'Viernes' },
+            { value: 'sat', label: 'Sábado' },
+            { value: 'sun', label: 'Domingo' },
+          ],
+        },
+        { type: 'time', key: 'opens', label: 'Abre', required: true },
+        { type: 'time', key: 'closes', label: 'Cierra', required: true },
+      ],
+      section: 'horarios',
+      width: 12,
+    },
+    // ── Redes ──
+    {
+      type: 'string-list',
+      key: 'social',
+      label: 'Redes sociales',
+      itemType: 'url',
+      addLabel: 'Agregar red',
+      emptyText: 'Sin redes sociales.',
+      section: 'redes',
+      width: 12,
+    },
+  ],
+};

package/src/lib/core/testing/test-catalog.ts

@@ -0,0 +1,21 @@
+import type { ResourceSchema } from '../models/schema.model';
+
+import { categoriesSchema } from './categories.schema';
+import { ordersSchema } from './orders.schema';
+import { productsSchema } from './products.schema';
+import { siteSchema } from './site.schema';
+
+/**
+ * Catálogo de pruebas de la librería: copia CONGELADA de los schemas
+ * reales de `admin-schema` (orders, categories, products), del mismo modo
+ * que el motor backend congela fixtures de endpoints en sus tests. Los
+ * specs del motor prueban comportamiento (navegación, params, caché,
+ * composición) contra declaraciones con esa forma; los specs contra los
+ * schemas VIVOS del consumidor viven en el repo del consumidor.
+ */
+export const testCatalog: readonly ResourceSchema[] = [
+  ordersSchema,
+  categoriesSchema,
+  productsSchema,
+  siteSchema,
+];

package/src/lib/core/tokens.ts

@@ -0,0 +1,112 @@
+import { InjectionToken } from '@angular/core';
+
+import type { ResponseUnwrap } from './models/schema.model';
+
+/**
+ * URL base de la API (baseapi §2.3): es la URL directa del Web App de Apps
+ * Script; ahí se hace el `POST` del envelope `{ token, method, path, payload }`.
+ * OBLIGATORIO proporcionarlo en `app.config.ts`:
+ * `{ provide: API_URL, useValue: 'https://…' }` (Fase 3). Vacío = mismo origen.
+ */
+export const API_URL = new InjectionToken<string>('API_URL');
+
+/**
+ * Superficie mínima que `gas-admin-ui` usa de Firebase Auth.
+ * Implementada por la aplicación consumidora; inyectada vía `FIREBASE_AUTH_ADAPTER`.
+ * Mantener la interfaz fina evita acoplar la librería a una versión específica de Firebase.
+ */
+export interface FirebaseAuthAdapter {
+  /**
+   * Abre un popup de Google sign-in y resuelve al ID token de Firebase.
+   * Rechaza si el usuario cancela o hay error.
+   */
+  signInWithGoogle(): Promise<string>;
+
+  /**
+   * Inicia sesión con email y contraseña vía Firebase y resuelve al ID token.
+   * Se usa cuando provider === 'password' Y firebase está configurado (Firebase email auth).
+   */
+  signInWithEmailAndPassword(email: string, password: string): Promise<string>;
+
+  /**
+   * Cierra sesión en Firebase (llamado junto al clear de la sesión de la app).
+   */
+  signOut(): Promise<void>;
+
+  /**
+   * Obtiene un ID token de Firebase FRESCO para usarlo en la cabecera
+   * `Authorization: Bearer <token>` de las peticiones REST.
+   *
+   * OPCIONAL: si el adaptador no lo implementa, `gas-admin-ui` envía el token
+   * de sesión almacenado tal cual (comportamiento actual). Implementarlo
+   * permite refrescar el ID token antes de cada petición REST, evitando
+   * errores "ID token inválido" tras la expiración de Firebase (1 hora).
+   *
+   * El adaptador decide cuándo refrescar (p. ej. `getIdToken(true)` de Firebase
+   * SDK fuerza la renovación; sin argumento devuelve el cacheado si aún es válido).
+   */
+  getIdToken?(): Promise<string>;
+}
+
+/**
+ * Token DI opcional para el adaptador de Firebase Auth.
+ * Proporcionado por la aplicación consumidora cuando usa proveedores federados o Firebase Auth.
+ */
+export const FIREBASE_AUTH_ADAPTER = new InjectionToken<FirebaseAuthAdapter>(
+  'gas.admin.firebaseAuthAdapter',
+);
+
+/**
+ * Driver de transporte HTTP del motor.
+ *
+ * Vive acá (capa de infraestructura) y NO en `ResourceSchema` (capa de dominio)
+ * porque es una decisión de red, no de modelo de datos. Cambiar el driver
+ * no debería requerir tocar ningún schema de recursos.
+ *
+ * - `'gas'` (default): tunnel `POST text/plain` con envelope
+ *   `{ token, method, path, payload }` — contrato de Google Apps Script.
+ * - `'rest'`: verbos HTTP reales (`GET`, `POST`, `PUT`, `DELETE`) con
+ *   `Authorization: Bearer <token>` en cabeceras y params en la URL (GET/DELETE)
+ *   o en el body JSON (POST/PUT/PATCH).
+ *
+ * Se fija en `provideGasAdmin({ driver })`. Sin declaración explícita el
+ * motor usa `'gas'` — cero impacto para consumidores existentes.
+ */
+export const API_DRIVER = new InjectionToken<'gas' | 'rest'>('gas.admin.driver');
+
+/**
+ * Registro de FUENTES DE CONTEXTO para marcadores en paths de endpoints.
+ *
+ * Cada clave es el nombre de una fuente — `{ <fuente> }` o
+ * `{ <fuente>.<ruta.anidada> }` dentro de un path declarado en
+ * `ResourceEndpoints` — y cada valor es un getter sin argumentos que devuelve
+ * el dato ACTUAL en el momento de la petición (no al registrar).
+ *
+ * El motor ya aporta dos fuentes construidas y éstas NO se declaran acá:
+ *
+ * - `auth`  → la sesión que dueña `AuthService` (usuario y token).
+ * - `config` → el mapa global que puebla `ConfigService` desde los singletons.
+ *
+ * Este registro es sólo para fuentes que aporta el consumidor, para que el
+ * motor no conozca nombres de dominio: qué campo se lee lo decide el schema,
+ * no el engine.
+ *
+ * Un marcador que apunte a una fuente no registrada, o a un valor ausente,
+ * revienta con un error que nombra el path y el marcador — jamás se manda un
+ * segmento vacío al backend.
+ */
+export type ValueSources = Readonly<Record<string, () => unknown>>;
+
+export const VALUE_SOURCES = new InjectionToken<ValueSources>('gas.admin.valueSources');
+
+/**
+ * Unwrap de respuesta global por defecto (`GasAdminConfig.defaultResponseUnwrap`).
+ *
+ * Se fusiona con la declaración `endpoint.responseUnwrap` de cada recurso:
+ * la del recurso tiene prioridad en las claves que declara. Sin token, sólo
+ * aplica lo declarado por recurso — cero impacto en schemas existentes.
+ */
+export const DEFAULT_RESPONSE_UNWRAP = new InjectionToken<ResponseUnwrap>(
+  'gas.admin.defaultResponseUnwrap',
+);
+

package/src/lib/core/utils/clipboard.spec.ts

@@ -0,0 +1,55 @@
+import { describe, expect, it } from 'vitest';
+
+import { buildShareMessage } from './clipboard';
+
+const URL = 'https://ejemplo.test/p/abc123';
+
+/**
+ * `buildShareMessage` es el único sitio que decide QUÉ se copia. Aquí vive el
+ * bug que motivó la función: `copy()` y la acción del listado escribían sólo
+ * `url`, dejando afuera el `shareTextTemplate` formateado (saludo, ref, PIN y
+ * el propio enlace) que sí viajaban por WhatsApp.
+ */
+describe('buildShareMessage', () => {
+  it('sin shareText devuelve sólo la URL', () => {
+    expect(buildShareMessage(URL)).toBe(URL);
+    expect(buildShareMessage(URL, '')).toBe(URL);
+    expect(buildShareMessage(URL, '   ')).toBe(URL);
+  });
+
+  it('con shareText que YA trae la URL no duplica el enlace', () => {
+    // Este es el caso de `orders.shareTextTemplate`: el mensaje ya incluye
+    // el link escrito dentro. Un `join` a ciegas lo pegaba DOS veces.
+    const template = `Hola Ana, puede retirar su pedido A-100 aquí: ${URL}`;
+    expect(buildShareMessage(URL, template)).toBe(template);
+  });
+
+  it('con shareText SIN la URL completa el enlace al final', () => {
+    const text = 'Hola Ana, su pedido A-100 está listo';
+    expect(buildShareMessage(URL, text)).toBe(`${text} ${URL}`);
+  });
+
+  it('un mensaje que sólo menciona la base del sitio NO recibe el enlace', () => {
+    // Caso real reportado: la plantilla interpola `{public_base_url}` (la
+    // base, sin `/p/{ref}`) y el motor le pegaba la URL con código al final
+    // aunque el mensaje YA apuntaba al sitio. El criterio es el origin,
+    // no la URL exacta.
+    const text = '🔗 Consulta tu pedido en https://ejemplo.test';
+    expect(buildShareMessage(URL, text)).toBe(text);
+  });
+
+  it('un mensaje que apunta a OTRO sitio sí recibe el enlace', () => {
+    const text = 'Sigue el pedido en https://otro-sitio.test/pedidos';
+    expect(buildShareMessage(URL, text)).toBe(`${text} ${URL}`);
+  });
+
+  it('con URL relativa sólo casa la coincidencia exacta', () => {
+    expect(buildShareMessage('/p/abc123', 'Ver en /p/abc123')).toBe('Ver en /p/abc123');
+    expect(buildShareMessage('/p/abc123', 'Ver tu pedido')).toBe('Ver tu pedido /p/abc123');
+  });
+
+  it('recorta el shareText pero nunca la URL', () => {
+    expect(buildShareMessage(URL, '  Hola Ana  ')).toBe(`Hola Ana ${URL}`);
+    expect(buildShareMessage('', 'Hola Ana')).toBe('Hola Ana');
+  });
+});