@praxisui/core 1.0.0-beta.10 → 1.0.0-beta.11

package/README.md

@@ -2,6 +2,13 @@
 
 > Biblioteca central com interfaces e serviços fundamentais para o Praxis UI Workspace
 
+## 🔰 Exemplos / Quickstart
+
+Para ver esta biblioteca em funcionamento em uma aplicação completa, utilize o projeto de exemplo (Quickstart):
+
+- Repositório: https://github.com/codexrodrigues/praxis-ui-quickstart
+- O Quickstart demonstra a integração das bibliotecas `@praxisui/*` em um app Angular, incluindo instalação, configuração e uso em telas reais.
+
 ## 🌟 Visão Geral
 
 A biblioteca `@praxisui/core` é o núcleo do Praxis UI Workspace, fornecendo interfaces robustas, serviços base e utilitários essenciais para todas as outras bibliotecas do ecossistema. Com a arquitetura unificada, oferece uma experiência de desenvolvimento consistente e type-safe.
@@ -35,6 +42,9 @@ A biblioteca `@praxisui/core` é o núcleo do Praxis UI Workspace, fornecendo in
 npm install @praxisui/core
 ```
 
+Exemplo completo (app de referência)
+- Quickstart: https://github.com/codexrodrigues/praxis-ui-quickstart
+
 ### Peer dependencies (Angular v20)
 
 - `@angular/core` `^20.0.0`

package/fesm2022/praxisui-core.mjs

@@ -1954,10 +1954,19 @@ class GenericCrudService {
         const baseUrl = buildApiUrl(entry);
         try {
             const origin = new URL(baseUrl).origin;
-            return `${origin}/schemas/filtered`;
+            return `${origin.replace(/\/+$/, '')}/schemas/filtered`;
         }
         catch {
-            return '/schemas/filtered';
+            // Tolerate relative baseUrl (e.g., '/api') by resolving against app origin when available
+            try {
+                const appOrigin = globalThis?.location?.origin;
+                if (appOrigin && typeof appOrigin === 'string' && appOrigin.startsWith('http')) {
+                    return `${appOrigin.replace(/\/+$/, '')}/schemas/filtered`;
+                }
+            }
+            catch { }
+            // Last resort: localhost origin to build an absolute URL (document SSR guidance in docs)
+            return 'http://localhost/schemas/filtered';
         }
     }
     /**
@@ -6483,11 +6492,41 @@ class SchemaMetadataClient {
         try {
             apiOrigin = new URL(params.baseUrl).origin;
         }
-        catch { }
+        catch {
+            try {
+                apiOrigin = globalThis?.location?.origin || '';
+            }
+            catch { }
+        }
         const schemaId = buildSchemaId({ ...params, apiOrigin });
         const cached = await this.cache.get(schemaId);
         // Build URL with query params
-        const u = new URL(params.baseUrl);
+        let u;
+        try {
+            u = new URL(params.baseUrl);
+        }
+        catch (err) {
+            // Accept relative baseUrl by resolving against the app origin when available
+            const origin = (() => {
+                try {
+                    return globalThis?.location?.origin;
+                }
+                catch {
+                    return undefined;
+                }
+            })();
+            if (origin && origin.startsWith('http')) {
+                u = new URL(params.baseUrl, origin);
+            }
+            else {
+                // Friendly error for hosts: instruct to set absolute baseUrl or provide runtime origin
+                const e = new Error(`Failed to construct schema URL. API_URL.baseUrl appears relative and no runtime origin is available. ` +
+                    `Set API_URL.baseUrl to an absolute URL (e.g., http://localhost:4200/api) or run in a browser context. ` +
+                    `Received baseUrl="${params.baseUrl}".`);
+                e.cause = err;
+                throw e;
+            }
+        }
         u.searchParams.set('path', params.path);
         u.searchParams.set('operation', (params.operation || 'get').toLowerCase());
         u.searchParams.set('schemaType', (params.schemaType || 'response').toLowerCase());