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

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

@@ -1,258 +0,0 @@
-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

@@ -1,195 +0,0 @@
-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

@@ -1,21 +0,0 @@
-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

@@ -1,112 +0,0 @@
-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

@@ -1,55 +0,0 @@
-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');
-  });
-});