@zea.cl/auth 0.1.6

package/bin/zea-auth-init.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+/**
+ * zea-auth-init — ZEA Auth Setup CLI
+ *
+ * Scaffolds the environment variables needed for a frontend application 
+ * to perform OAuth2 PKCE login against the ZEA Identity Provider.
+ *
+ * Usage: npx zea-auth-init
+ */
+
+import { randomBytes } from 'crypto'
+import { writeFileSync, existsSync, readFileSync, appendFileSync } from 'fs'
+
+const THALAMUS_URL = process.env.THALAMUS_URL || 'http://auth.zea.localhost'
+
+function base64url(b) {
+  return b.toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '')
+}
+
+async function main() {
+  console.log('')
+  console.log('🧠  ZEA Auth — Frontend Setup')
+  console.log('')
+
+  // Generate a unique client_id for this app
+  const CLIENT_ID = 'app_' + base64url(randomBytes(8))
+  
+  const envContent = `VITE_ZEA_AUTH_URL=${THALAMUS_URL}\nVITE_ZEA_CLIENT_ID=${CLIENT_ID}\n`
+  
+  if (existsSync('.env.local')) {
+    const current = readFileSync('.env.local', 'utf8')
+    if (!current.includes('VITE_ZEA_CLIENT_ID')) {
+      appendFileSync('.env.local', `\n${envContent}`)
+    }
+  } else {
+    writeFileSync('.env.local', envContent)
+  }
+
+  console.log('✅  Setup complete!')
+  console.log('   Variables appended to .env.local:')
+  console.log(`   - VITE_ZEA_AUTH_URL=${THALAMUS_URL}`)
+  console.log(`   - VITE_ZEA_CLIENT_ID=${CLIENT_ID}`)
+  console.log('')
+  console.log('   Your React components (e.g. <LoginButton />) are now ready to perform PKCE login.')
+  console.log('   (Note: If you are building a backend/agent, do NOT use this script. Use `zea token create` to get a PAT instead).')
+  console.log('')
+}
+
+main().catch((err) => {
+  console.error('Fatal error:', err)
+  process.exit(1)
+})

package/dist/components/index.d.mts

@@ -0,0 +1,150 @@
+import React from 'react';
+import { T as ThalamusConfig, U as UserInfo, a as User } from '../index-BnHWPrKX.mjs';
+
+interface LoginButtonProps {
+    /** Thalamus config (same as ThalamusClient constructor) */
+    config: ThalamusConfig;
+    /** Storage key (default: 'thalamus_auth') */
+    storageKey?: string;
+    /** Button label */
+    label?: string;
+    /** Scopes to request */
+    scopes?: string[];
+    /** CSS class */
+    className?: string;
+    /** Button style overrides */
+    style?: React.CSSProperties;
+}
+/**
+ * Drop-in login button with full OAuth2 PKCE flow.
+ *
+ * @example
+ * ```tsx
+ * <LoginButton
+ *   config={{
+ *     clientId: 'my_app',
+ *     redirectUri: 'http://localhost:5173/callback',
+ *     baseUrl: 'http://auth.zea.localhost',
+ *   }}
+ * />
+ * ```
+ */
+declare function LoginButton({ config, storageKey, label, scopes, className, style, }: LoginButtonProps): React.JSX.Element | null;
+
+interface RegisterButtonProps {
+    config: ThalamusConfig;
+    /** Organization name — Thalamus creates it automatically on registration */
+    orgName?: string;
+    /** App origin for auto-CORS + OAuth client registration */
+    appOrigin?: string;
+    label?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Drop-in register button. Redirects to Thalamus /register page.
+ * Passes orgName + appOrigin so Thalamus can auto-create org, OAuth client, and CORS.
+ *
+ * @example
+ * ```tsx
+ * // New developer — creates org + app config at the same time
+ * <RegisterButton
+ *   config={{ clientId:'my_app', redirectUri:'http://localhost:5173/callback', baseUrl:'http://auth.zea.localhost' }}
+ *   orgName="My Startup"
+ *   appOrigin="http://localhost:5173"
+ * />
+ *
+ * // Returning developer — just login, Thalamus asks if they want to register a new app
+ * <RegisterButton
+ *   config={{ clientId:'my_app2', redirectUri:'http://localhost:5299/callback', baseUrl:'http://auth.zea.localhost' }}
+ * />
+ * ```
+ */
+declare function RegisterButton({ config, orgName, appOrigin, label, className, style }: RegisterButtonProps): React.JSX.Element;
+
+interface UserMenuProps {
+    config: ThalamusConfig;
+    storageKey?: string;
+    /** Render custom user info */
+    renderUser?: (user: UserInfo) => React.ReactNode;
+    className?: string;
+}
+/**
+ * User badge with logout. Shows nothing if not authenticated.
+ *
+ * @example
+ * ```tsx
+ * <UserMenu
+ *   config={{
+ *     clientId: 'my_app',
+ *     redirectUri: 'http://localhost:5173/callback',
+ *     baseUrl: 'http://auth.zea.localhost',
+ *   }}
+ * />
+ * ```
+ */
+declare function UserMenu({ config, storageKey, renderUser, className }: UserMenuProps): React.JSX.Element | null;
+
+interface APIKeyManagerProps {
+    /** Base URL of the service that manages API keys (e.g. Soma, or Thalamus itself) */
+    baseUrl: string;
+    /** Storage key for the auth token (default: 'thalamus_auth') */
+    authStorageKey?: string;
+    /** Label for the create button */
+    label?: string;
+    className?: string;
+}
+/**
+ * Drop-in API Key generator and manager.
+ *
+ * @example
+ * ```tsx
+ * <APIKeyManager baseUrl="http://soma.zea.localhost" />
+ * ```
+ */
+declare function APIKeyManager({ baseUrl, authStorageKey, label, className }: APIKeyManagerProps): React.JSX.Element;
+
+interface OrgSwitcherProps {
+    config: ThalamusConfig;
+    /** Called when user switches org */
+    onSwitch?: (orgId: string) => void;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Organization switcher dropdown.
+ *
+ * @example
+ * ```tsx
+ * <OrgSwitcher
+ *   config={{ clientId: 'my_app', redirectUri: '/callback', baseUrl: 'http://auth.zea.localhost' }}
+ *   onSwitch={(orgId) => console.log('Switched to', orgId)}
+ * />
+ * ```
+ */
+declare function OrgSwitcher({ config, onSwitch, className, style }: OrgSwitcherProps): React.JSX.Element | null;
+
+interface OrgManagerProps {
+    config: ThalamusConfig;
+    className?: string;
+}
+declare function OrgManager({ config, className }: OrgManagerProps): React.JSX.Element;
+
+interface UserCreateFormProps {
+    config: ThalamusConfig;
+    onCreated?: (user: User) => void;
+    className?: string;
+}
+declare function UserCreateForm({ config, onCreated, className }: UserCreateFormProps): React.JSX.Element;
+interface UserTableProps {
+    users: User[];
+    loading?: boolean;
+    error?: string | null;
+    className?: string;
+}
+declare function UserTable({ users, loading, error, className }: UserTableProps): React.JSX.Element;
+declare function StatusBadge({ status }: {
+    status: string;
+}): React.JSX.Element;
+
+export { APIKeyManager, type APIKeyManagerProps, LoginButton, type LoginButtonProps, OrgManager, type OrgManagerProps, OrgSwitcher, type OrgSwitcherProps, RegisterButton, type RegisterButtonProps, StatusBadge, UserCreateForm, type UserCreateFormProps, UserMenu, type UserMenuProps, UserTable, type UserTableProps };

package/dist/components/index.d.ts

@@ -0,0 +1,150 @@
+import React from 'react';
+import { T as ThalamusConfig, U as UserInfo, a as User } from '../index-BnHWPrKX.js';
+
+interface LoginButtonProps {
+    /** Thalamus config (same as ThalamusClient constructor) */
+    config: ThalamusConfig;
+    /** Storage key (default: 'thalamus_auth') */
+    storageKey?: string;
+    /** Button label */
+    label?: string;
+    /** Scopes to request */
+    scopes?: string[];
+    /** CSS class */
+    className?: string;
+    /** Button style overrides */
+    style?: React.CSSProperties;
+}
+/**
+ * Drop-in login button with full OAuth2 PKCE flow.
+ *
+ * @example
+ * ```tsx
+ * <LoginButton
+ *   config={{
+ *     clientId: 'my_app',
+ *     redirectUri: 'http://localhost:5173/callback',
+ *     baseUrl: 'http://auth.zea.localhost',
+ *   }}
+ * />
+ * ```
+ */
+declare function LoginButton({ config, storageKey, label, scopes, className, style, }: LoginButtonProps): React.JSX.Element | null;
+
+interface RegisterButtonProps {
+    config: ThalamusConfig;
+    /** Organization name — Thalamus creates it automatically on registration */
+    orgName?: string;
+    /** App origin for auto-CORS + OAuth client registration */
+    appOrigin?: string;
+    label?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Drop-in register button. Redirects to Thalamus /register page.
+ * Passes orgName + appOrigin so Thalamus can auto-create org, OAuth client, and CORS.
+ *
+ * @example
+ * ```tsx
+ * // New developer — creates org + app config at the same time
+ * <RegisterButton
+ *   config={{ clientId:'my_app', redirectUri:'http://localhost:5173/callback', baseUrl:'http://auth.zea.localhost' }}
+ *   orgName="My Startup"
+ *   appOrigin="http://localhost:5173"
+ * />
+ *
+ * // Returning developer — just login, Thalamus asks if they want to register a new app
+ * <RegisterButton
+ *   config={{ clientId:'my_app2', redirectUri:'http://localhost:5299/callback', baseUrl:'http://auth.zea.localhost' }}
+ * />
+ * ```
+ */
+declare function RegisterButton({ config, orgName, appOrigin, label, className, style }: RegisterButtonProps): React.JSX.Element;
+
+interface UserMenuProps {
+    config: ThalamusConfig;
+    storageKey?: string;
+    /** Render custom user info */
+    renderUser?: (user: UserInfo) => React.ReactNode;
+    className?: string;
+}
+/**
+ * User badge with logout. Shows nothing if not authenticated.
+ *
+ * @example
+ * ```tsx
+ * <UserMenu
+ *   config={{
+ *     clientId: 'my_app',
+ *     redirectUri: 'http://localhost:5173/callback',
+ *     baseUrl: 'http://auth.zea.localhost',
+ *   }}
+ * />
+ * ```
+ */
+declare function UserMenu({ config, storageKey, renderUser, className }: UserMenuProps): React.JSX.Element | null;
+
+interface APIKeyManagerProps {
+    /** Base URL of the service that manages API keys (e.g. Soma, or Thalamus itself) */
+    baseUrl: string;
+    /** Storage key for the auth token (default: 'thalamus_auth') */
+    authStorageKey?: string;
+    /** Label for the create button */
+    label?: string;
+    className?: string;
+}
+/**
+ * Drop-in API Key generator and manager.
+ *
+ * @example
+ * ```tsx
+ * <APIKeyManager baseUrl="http://soma.zea.localhost" />
+ * ```
+ */
+declare function APIKeyManager({ baseUrl, authStorageKey, label, className }: APIKeyManagerProps): React.JSX.Element;
+
+interface OrgSwitcherProps {
+    config: ThalamusConfig;
+    /** Called when user switches org */
+    onSwitch?: (orgId: string) => void;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Organization switcher dropdown.
+ *
+ * @example
+ * ```tsx
+ * <OrgSwitcher
+ *   config={{ clientId: 'my_app', redirectUri: '/callback', baseUrl: 'http://auth.zea.localhost' }}
+ *   onSwitch={(orgId) => console.log('Switched to', orgId)}
+ * />
+ * ```
+ */
+declare function OrgSwitcher({ config, onSwitch, className, style }: OrgSwitcherProps): React.JSX.Element | null;
+
+interface OrgManagerProps {
+    config: ThalamusConfig;
+    className?: string;
+}
+declare function OrgManager({ config, className }: OrgManagerProps): React.JSX.Element;
+
+interface UserCreateFormProps {
+    config: ThalamusConfig;
+    onCreated?: (user: User) => void;
+    className?: string;
+}
+declare function UserCreateForm({ config, onCreated, className }: UserCreateFormProps): React.JSX.Element;
+interface UserTableProps {
+    users: User[];
+    loading?: boolean;
+    error?: string | null;
+    className?: string;
+}
+declare function UserTable({ users, loading, error, className }: UserTableProps): React.JSX.Element;
+declare function StatusBadge({ status }: {
+    status: string;
+}): React.JSX.Element;
+
+export { APIKeyManager, type APIKeyManagerProps, LoginButton, type LoginButtonProps, OrgManager, type OrgManagerProps, OrgSwitcher, type OrgSwitcherProps, RegisterButton, type RegisterButtonProps, StatusBadge, UserCreateForm, type UserCreateFormProps, UserMenu, type UserMenuProps, UserTable, type UserTableProps };