@mmapp/react 0.1.0-alpha.1 → 0.1.0-alpha.3

package/src/grammar/index.ts

@@ -1,173 +0,0 @@
-/**
- * Grammar Islands — tagged template functions for domain-specific languages.
- *
- * These tagged templates allow embedding DSL snippets inside React workflow
- * files and model files. The compiler extracts them as IRGrammarIsland entries,
- * preserving the raw source for backend evaluation.
- *
- * Supported grammars:
- * - cedar: Authorization policies (Cedar policy language)
- * - sql: Computed fields and queries
- * - cron: Scheduled task expressions
- * - dmn: Decision tables (DMN-like markdown syntax)
- * - graphql: GraphQL query fragments
- * - jsonpath: JSONPath expressions
- *
- * Usage in model files:
- *   import { cedar, sql, cron } from '@mindmatrix/react';
- *
- *   export const access = cedar`
- *     permit (principal, action == Action::"read", resource)
- *     when { principal.role == "member" };
- *   `;
- *
- *   export const computed = {
- *     messageCount: sql`SELECT COUNT(*) FROM messages WHERE channel_id = $instance_id`,
- *   };
- *
- *   export const schedule = {
- *     cleanup: cron`0 3 * * *`,
- *   };
- */
-
-// =============================================================================
-// Types
-// =============================================================================
-
-/**
- * Runtime marker for a grammar island.
- * The compiler extracts these at build time.
- * At runtime, they're inert marker objects.
- */
-export interface GrammarIsland {
-  __grammarIsland: true;
-  contextTag: string;
-  rawSource: string;
-}
-
-/**
- * Cedar policy island with parsed policy structures.
- */
-export interface CedarPolicy {
-  effect: 'permit' | 'forbid';
-  principal?: string;
-  action?: string;
-  resource?: string;
-  conditions: string[];
-}
-
-/**
- * Cron expression fields.
- */
-export interface CronFields {
-  minute: string;
-  hour: string;
-  dayOfMonth: string;
-  month: string;
-  dayOfWeek: string;
-}
-
-/**
- * DMN decision rule.
- */
-export interface DmnRule {
-  inputs: Record<string, string>;
-  output: Record<string, string>;
-  annotation?: string;
-}
-
-// =============================================================================
-// Tagged Template Functions
-// =============================================================================
-
-/**
- * Creates a grammar island from a tagged template.
- */
-function createIsland(contextTag: string, strings: TemplateStringsArray, values: unknown[]): GrammarIsland {
-  // Reconstruct the template with interpolated values
-  let rawSource = '';
-  for (let i = 0; i < strings.length; i++) {
-    rawSource += strings[i];
-    if (i < values.length) {
-      rawSource += String(values[i]);
-    }
-  }
-  return {
-    __grammarIsland: true,
-    contextTag,
-    rawSource: rawSource.trim(),
-  };
-}
-
-/**
- * Cedar authorization policy.
- *
- * Usage:
- *   const policy = cedar`
- *     permit (principal, action == Action::"read", resource)
- *     when { principal.role == "member" };
- *   `;
- */
-export function cedar(strings: TemplateStringsArray, ...values: unknown[]): GrammarIsland {
-  return createIsland('cedar', strings, values);
-}
-
-/**
- * SQL computed field or query.
- *
- * Usage:
- *   const query = sql`SELECT COUNT(*) FROM messages WHERE channel_id = $instance_id`;
- */
-export function sql(strings: TemplateStringsArray, ...values: unknown[]): GrammarIsland {
-  return createIsland('sql', strings, values);
-}
-
-/**
- * Cron schedule expression (5-field format).
- *
- * Usage:
- *   const schedule = cron`0 3 * * *`;  // Every day at 3 AM
- */
-export function cron(strings: TemplateStringsArray, ...values: unknown[]): GrammarIsland {
-  return createIsland('cron', strings, values);
-}
-
-/**
- * DMN decision table (markdown-like syntax).
- *
- * Usage:
- *   const rules = dmn`
- *     | age | income | risk   |
- *     |-----|--------|--------|
- *     | <18 | *      | reject |
- *     | >=18| >50000 | low    |
- *     | >=18| <=50000| medium |
- *   `;
- */
-export function dmn(strings: TemplateStringsArray, ...values: unknown[]): GrammarIsland {
-  return createIsland('dmn', strings, values);
-}
-
-/**
- * GraphQL query fragment.
- *
- * Usage:
- *   const query = graphql`
- *     query GetChannel($id: ID!) {
- *       channel(id: $id) { name members { id } }
- *     }
- *   `;
- */
-export function graphql(strings: TemplateStringsArray, ...values: unknown[]): GrammarIsland {
-  return createIsland('graphql', strings, values);
-}
-
-/**
- * JSONPath expression.
- *
- * Usage:
- *   const path = jsonpath`$.store.book[?(@.price < 10)]`;
- */
-export function jsonpath(strings: TemplateStringsArray, ...values: unknown[]): GrammarIsland {
-  return createIsland('jsonpath', strings, values);
-}

package/src/hooks/index.ts

@@ -1,106 +0,0 @@
-export { usePlayer } from './usePlayer';
-export { useDomainSubscription } from './useDomainSubscription';
-export type { DomainSubscriptionTransport } from './useDomainSubscription';
-export { useExperienceState, useStateField } from './useExperienceState';
-export { useRole, setRoleHierarchy } from './useRole';
-export type { RoleResult, RoleOptions } from './useRole';
-export { useView, setViewResolver } from './useView';
-export type { ViewDefinitionResult, ViewRecord, ViewResolver } from './useView';
-export { useParams } from './useParams';
-export { useExpressionLibrary, setExpressionLibraryResolver } from './useExpressionLibrary';
-export type { ExpressionLibraryResult, LibraryParam, ExpressionLibraryRecord, ExpressionLibraryResolver } from './useExpressionLibrary';
-export { useDuringAction } from './useDuringAction';
-export type { DuringActionConfig } from './useDuringAction';
-export { usePackage } from './usePackage';
-export type { PackageManifest, PackageChild, PackageResult } from './usePackage';
-
-// === New Scale-App Hooks ===
-
-// Routing
-export { useRouter } from './useRouter';
-export type {
-  RouterHandle,
-  RouterOptions,
-  RouteDefinition,
-  RouteGuard,
-  RouteLocation,
-} from './useRouter';
-export { useRouteParams } from './useRouteParams';
-export type { RouteParamsOptions } from './useRouteParams';
-
-// Real-Time
-export { useRealtimeQuery, setRealtimeQueryResolver } from './useRealtimeQuery';
-export type { RealtimeQueryParams, RealtimeQueryResult } from './useRealtimeQuery';
-export { useChannel, setChannelTransport } from './useChannel';
-export type {
-  ChannelMessage,
-  ChannelOptions,
-  ChannelHandle,
-  ChannelTransport,
-} from './useChannel';
-
-// Geolocation
-export { useGeolocation } from './useGeolocation';
-export type {
-  GeoPosition,
-  GeolocationOptions,
-  GeolocationResult,
-  GeolocationError,
-} from './useGeolocation';
-export { useMapView } from './useMapView';
-export type {
-  LatLng,
-  LatLngBounds,
-  MapMarker,
-  MapViewOptions,
-  MapViewHandle,
-} from './useMapView';
-
-// Auth
-export { useAuth, setAuthResolver } from './useAuth';
-export type {
-  AuthUser,
-  LoginCredentials,
-  AuthOptions,
-  AuthResult,
-  AuthResolver,
-} from './useAuth';
-
-// Forms
-export { useForm } from './useForm';
-export type {
-  FormValidator,
-  FieldValidator,
-  FormConfig,
-  FieldRegistration,
-  FormHandle,
-} from './useForm';
-
-// Notifications
-export { useNotification } from './useNotification';
-export type { NotifyOptions, NotificationResult } from './useNotification';
-export { useToast } from './useToast';
-export type {
-  ToastVariant,
-  ToastConfig,
-  ToastInstance,
-  ToastHandle,
-} from './useToast';
-
-// Middleware
-export { useMiddleware, requireAuth, requireRole, prefetchData } from './useMiddleware';
-export type {
-  MiddlewareResult,
-  MiddlewareContext,
-  MiddlewareFn,
-  MiddlewareOptions,
-  MiddlewareHandle,
-} from './useMiddleware';
-
-// Computed Fields
-export { useComputed, useComputedWithMeta } from './useComputed';
-export type {
-  ComputedFieldMode,
-  UseComputedOptions,
-  ComputedFieldResult,
-} from './useComputed';

package/src/hooks/useAuth.ts

@@ -1,288 +0,0 @@
-/**
- * useAuth — Authentication hook for workflow applications.
- *
- * Provides login/logout/currentUser functionality with JWT token management.
- * Integrates with the MindMatrix auth API and stores tokens in localStorage.
- *
- * Usage in .workflow.tsx:
- *   const { user, isAuthenticated, login, logout, loading } = useAuth();
- *
- *   if (!isAuthenticated) {
- *     return <LoginForm onSubmit={login} />;
- *   }
- */
-
-import { useState, useEffect, useCallback, useMemo, useRef } from 'react';
-
-// =============================================================================
-// Types
-// =============================================================================
-
-/** User profile from the auth system. */
-export interface AuthUser {
-  /** User ID. */
-  id: string;
-  /** Email address. */
-  email: string;
-  /** Display name. */
-  name: string;
-  /** User roles. */
-  roles: string[];
-  /** Tenant/organization ID. */
-  tenantId?: string;
-  /** Additional user metadata. */
-  metadata?: Record<string, unknown>;
-}
-
-/** Login credentials. */
-export interface LoginCredentials {
-  email: string;
-  password: string;
-}
-
-/** Options for configuring auth. */
-export interface AuthOptions {
-  /** Auth API base URL (defaults to /api/v1/auth). */
-  apiUrl?: string;
-  /** Storage key for the JWT token (default: 'auth_token'). */
-  tokenKey?: string;
-  /** Auto-fetch user on mount (default: true). */
-  autoFetch?: boolean;
-  /** Called on successful login. */
-  onLogin?: (user: AuthUser) => void;
-  /** Called on logout. */
-  onLogout?: () => void;
-  /** Called on auth error. */
-  onError?: (error: Error) => void;
-}
-
-/** Auth result returned by useAuth. */
-export interface AuthResult {
-  /** Current user (null if not authenticated). */
-  user: AuthUser | null;
-  /** Whether a user is authenticated. */
-  isAuthenticated: boolean;
-  /** Loading state during auth operations. */
-  loading: boolean;
-  /** Auth error. */
-  error: Error | null;
-  /** JWT token (null if not authenticated). */
-  token: string | null;
-  /** Log in with credentials. */
-  login: (credentials: LoginCredentials) => Promise<AuthUser>;
-  /** Log out and clear token. */
-  logout: () => Promise<void>;
-  /** Refresh the current user's profile. */
-  refreshUser: () => Promise<void>;
-  /** Check if the current user has a specific role. */
-  hasRole: (role: string) => boolean;
-}
-
-/** Auth resolver — pluggable auth backend. */
-export interface AuthResolver {
-  login: (credentials: LoginCredentials) => Promise<{ token: string; user: AuthUser }>;
-  logout: (token: string) => Promise<void>;
-  getUser: (token: string) => Promise<AuthUser>;
-}
-
-// Global resolver (set by provider)
-let _globalAuthResolver: AuthResolver | null = null;
-
-export function setAuthResolver(resolver: AuthResolver | null): void {
-  _globalAuthResolver = resolver;
-}
-
-// =============================================================================
-// Internal — default API-based resolver
-// =============================================================================
-
-function createDefaultResolver(apiUrl: string): AuthResolver {
-  return {
-    login: async (credentials) => {
-      const res = await fetch(`${apiUrl}/login`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify(credentials),
-      });
-      if (!res.ok) {
-        const body = await res.json().catch(() => ({}));
-        throw new Error(body.message || `Login failed: ${res.status}`);
-      }
-      return res.json();
-    },
-    logout: async (token) => {
-      await fetch(`${apiUrl}/logout`, {
-        method: 'POST',
-        headers: { Authorization: `Bearer ${token}` },
-      }).catch(() => {
-        // Logout is best-effort
-      });
-    },
-    getUser: async (token) => {
-      const res = await fetch(`${apiUrl}/me`, {
-        headers: { Authorization: `Bearer ${token}` },
-      });
-      if (!res.ok) {
-        throw new Error(`Failed to fetch user: ${res.status}`);
-      }
-      return res.json();
-    },
-  };
-}
-
-// =============================================================================
-// Hook
-// =============================================================================
-
-/**
- * Authentication hook with login/logout and user management.
- *
- * @param options - Auth configuration.
- * @returns Auth result with user, token, and auth methods.
- */
-export function useAuth(options: AuthOptions = {}): AuthResult {
-  const {
-    apiUrl = '/api/v1/auth',
-    tokenKey = 'auth_token',
-    autoFetch = true,
-    onLogin,
-    onLogout,
-    onError,
-  } = options;
-
-  const [user, setUser] = useState<AuthUser | null>(null);
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState<Error | null>(null);
-  const [token, setToken] = useState<string | null>(() => {
-    return typeof localStorage !== 'undefined' ? localStorage.getItem(tokenKey) : null;
-  });
-
-  const onLoginRef = useRef(onLogin);
-  onLoginRef.current = onLogin;
-  const onLogoutRef = useRef(onLogout);
-  onLogoutRef.current = onLogout;
-  const onErrorRef = useRef(onError);
-  onErrorRef.current = onError;
-
-  const getResolver = useCallback(
-    () => _globalAuthResolver ?? createDefaultResolver(apiUrl),
-    [apiUrl],
-  );
-
-  // Auto-fetch user on mount if we have a token
-  useEffect(() => {
-    if (!autoFetch || !token) {
-      setLoading(false);
-      return;
-    }
-
-    let cancelled = false;
-    const resolver = getResolver();
-
-    resolver
-      .getUser(token)
-      .then((userData) => {
-        if (!cancelled) {
-          setUser(userData);
-          setError(null);
-          setLoading(false);
-        }
-      })
-      .catch((err) => {
-        if (!cancelled) {
-          const authError = err instanceof Error ? err : new Error(String(err));
-          setError(authError);
-          // Token is invalid — clear it
-          setToken(null);
-          setUser(null);
-          localStorage.removeItem(tokenKey);
-          setLoading(false);
-          onErrorRef.current?.(authError);
-        }
-      });
-
-    return () => {
-      cancelled = true;
-    };
-  }, [token, autoFetch, getResolver, tokenKey]);
-
-  const login = useCallback(
-    async (credentials: LoginCredentials): Promise<AuthUser> => {
-      setLoading(true);
-      setError(null);
-
-      try {
-        const resolver = getResolver();
-        const result = await resolver.login(credentials);
-
-        localStorage.setItem(tokenKey, result.token);
-        setToken(result.token);
-        setUser(result.user);
-        setLoading(false);
-        onLoginRef.current?.(result.user);
-        return result.user;
-      } catch (err) {
-        const authError = err instanceof Error ? err : new Error(String(err));
-        setError(authError);
-        setLoading(false);
-        onErrorRef.current?.(authError);
-        throw authError;
-      }
-    },
-    [getResolver, tokenKey],
-  );
-
-  const logout = useCallback(async () => {
-    try {
-      if (token) {
-        const resolver = getResolver();
-        await resolver.logout(token);
-      }
-    } finally {
-      localStorage.removeItem(tokenKey);
-      setToken(null);
-      setUser(null);
-      setError(null);
-      onLogoutRef.current?.();
-    }
-  }, [token, getResolver, tokenKey]);
-
-  const refreshUser = useCallback(async () => {
-    if (!token) return;
-
-    try {
-      const resolver = getResolver();
-      const userData = await resolver.getUser(token);
-      setUser(userData);
-      setError(null);
-    } catch (err) {
-      const authError = err instanceof Error ? err : new Error(String(err));
-      setError(authError);
-      onErrorRef.current?.(authError);
-    }
-  }, [token, getResolver]);
-
-  const hasRole = useCallback(
-    (role: string): boolean => {
-      return user?.roles.includes(role) ?? false;
-    },
-    [user],
-  );
-
-  const isAuthenticated = token !== null && user !== null;
-
-  return useMemo(
-    (): AuthResult => ({
-      user,
-      isAuthenticated,
-      loading,
-      error,
-      token,
-      login,
-      logout,
-      refreshUser,
-      hasRole,
-    }),
-    [user, isAuthenticated, loading, error, token, login, logout, refreshUser, hasRole],
-  );
-}