@adonis-agora/authkit-server 0.80.1 → 0.81.0

package/README.md

@@ -1,5 +1,7 @@
 # @adonis-agora/authkit-server
 
+[![npm version](https://img.shields.io/npm/v/@adonis-agora/authkit-server)](https://www.npmjs.com/package/@adonis-agora/authkit-server) [![npm downloads](https://img.shields.io/npm/dm/@adonis-agora/authkit-server)](https://www.npmjs.com/package/@adonis-agora/authkit-server) [![CI](https://github.com/DavideCarvalho/adonis-agora-authkit/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/DavideCarvalho/adonis-agora-authkit/actions/workflows/ci.yml) [![license](https://img.shields.io/npm/l/@adonis-agora/authkit-server)](https://www.npmjs.com/package/@adonis-agora/authkit-server)
+
 OpenID Connect / OAuth2 Authorization Server (Identity Provider) for AdonisJS — an idiomatic
 wrapper around [`oidc-provider`](https://github.com/panva/node-oidc-provider).
 

package/build/commands/configure.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { stubsRoot } from '../stubs/main.js';
-import { resolveUiPreset, uiStubPaths } from './ui_preset.js';
+import { resolveUiPreset, uiStubDestination, uiStubPaths } from './ui_preset.js';
 function assertPresetPrereqs(preset, appRoot) {
     if (preset !== 'react')
         return;
@@ -40,8 +40,11 @@ export async function configure(command) {
         },
     });
     await codemods.makeUsingStub(stubsRoot, 'models/auth_user.stub', {});
+    // As páginas React vão byte a byte: o `page.stub` só define o destino e o
+    // conteúdo vem do `.tsx` via `contentsFromFile`, sem passar pelo template
+    // engine (que quebraria nas crases das template literals — bug #194).
     for (const path of uiStubPaths(preset)) {
-        await codemods.makeUsingStub(stubsRoot, path, {});
+        await codemods.makeUsingStub(stubsRoot, 'ui/react/page.stub', { destination: uiStubDestination(path) }, { contentsFromFile: join(stubsRoot, path) });
     }
     await codemods.updateRcFile((rcFile) => {
         rcFile.addProvider('@adonis-agora/authkit-server/authkit_server_provider');

package/build/commands/ui_preset.d.ts

@@ -1,4 +1,19 @@
 export type UiPreset = 'headless' | 'edge' | 'react';
 export declare function resolveUiPreset(value: string | undefined): UiPreset;
-/** Caminhos de stub (relativos ao stubsRoot) que o preset publica. */
+/**
+ * Arquivos (relativos ao stubsRoot) que o preset publica.
+ *
+ * As páginas React são TSX puro, SEM frontmatter `{{{ exports() }}}`: o
+ * `configure` as publica via `ui/react/page.stub` + `contentsFromFile` (ver
+ * `uiStubDestination`). Elas não podem passar pelo template engine dos stubs —
+ * crases e `${...}` de template literal quebram a compilação (bug #194) —, e
+ * como são `.tsx` o formatter reescrevia o frontmatter para `{ exports() }`,
+ * que o gerador nem reconhece.
+ */
 export declare function uiStubPaths(preset: UiPreset): string[];
+/**
+ * Destino, relativo à raiz do app, de um arquivo de `uiStubPaths('react')`:
+ * `ui/react/components/*` vai para `inertia/components/*` e `ui/react/pages/*`
+ * para `inertia/pages/authkit/*` (o `prefix` do `inertiaRenderer`).
+ */
+export declare function uiStubDestination(path: string): string;

package/build/commands/ui_preset.js

@@ -7,7 +7,16 @@ export function resolveUiPreset(value) {
     }
     return value;
 }
-/** Caminhos de stub (relativos ao stubsRoot) que o preset publica. */
+/**
+ * Arquivos (relativos ao stubsRoot) que o preset publica.
+ *
+ * As páginas React são TSX puro, SEM frontmatter `{{{ exports() }}}`: o
+ * `configure` as publica via `ui/react/page.stub` + `contentsFromFile` (ver
+ * `uiStubDestination`). Elas não podem passar pelo template engine dos stubs —
+ * crases e `${...}` de template literal quebram a compilação (bug #194) —, e
+ * como são `.tsx` o formatter reescrevia o frontmatter para `{ exports() }`,
+ * que o gerador nem reconhece.
+ */
 export function uiStubPaths(preset) {
     switch (preset) {
         case 'headless':
@@ -44,3 +53,17 @@ export function uiStubPaths(preset) {
             ];
     }
 }
+/**
+ * Destino, relativo à raiz do app, de um arquivo de `uiStubPaths('react')`:
+ * `ui/react/components/*` vai para `inertia/components/*` e `ui/react/pages/*`
+ * para `inertia/pages/authkit/*` (o `prefix` do `inertiaRenderer`).
+ */
+export function uiStubDestination(path) {
+    if (path.startsWith('ui/react/components/')) {
+        return `inertia/components/${path.slice('ui/react/components/'.length)}`;
+    }
+    if (path.startsWith('ui/react/pages/')) {
+        return `inertia/pages/authkit/${path.slice('ui/react/pages/'.length)}`;
+    }
+    throw new Error(`authkit: stub de UI sem destino conhecido: ${path}`);
+}