@eldrin-project/eldrin-app-core 0.0.3 → 0.0.4

package/dist/index.d.cts

@@ -1,6 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-
 /**
  * Core types for @eldrin-project/eldrin-app-core
  */
@@ -145,170 +142,6 @@ interface AppManifest {
      */
     groups?: ManifestGroup[];
 }
-/**
- * Options for createApp factory
- */
-interface CreateAppOptions {
-    /** Unique app identifier */
-    name: string;
-    /** Root React component */
-    root: React.ComponentType<unknown>;
-    /** App manifest (optional, can be loaded from file) */
-    manifest?: AppManifest;
-    /** Migration files (loaded at build time via Vite plugin) */
-    migrations?: MigrationFile[];
-    /** Called when migrations complete successfully */
-    onMigrationsComplete?: (result: MigrationResult) => void;
-    /** Called when migrations fail */
-    onMigrationError?: (error: Error) => void;
-}
-/**
- * Database context passed to app components
- */
-interface DatabaseContext {
-    /** D1 database instance (null if app has no database) */
-    db: D1Database | null;
-    /** Whether migrations have completed */
-    migrationsComplete: boolean;
-    /** Migration result (if migrations were run) */
-    migrationResult?: MigrationResult;
-}
-/**
- * Eldrin context provided to apps
- */
-interface EldrinContext {
-    /** App ID */
-    appId: string;
-    /** Database context */
-    database: DatabaseContext;
-    /** Environment variables */
-    env: Record<string, string>;
-}
-
-/**
- * App factory for creating Eldrin apps
- *
- * Returns single-spa compatible lifecycle functions with:
- * - Automatic migration execution on bootstrap
- * - Database provider wrapping
- * - Error boundary integration
- */
-
-/**
- * Single-spa lifecycle props passed to lifecycle functions
- */
-interface LifecycleProps {
-    /** DOM element to mount the app into */
-    domElement?: HTMLElement;
-    /** App name */
-    name?: string;
-    /** D1 Database instance (provided by shell) */
-    db?: D1Database;
-    /** Custom props from shell */
-    customProps?: Record<string, unknown>;
-}
-/**
- * Single-spa compatible lifecycle object
- */
-interface AppLifecycle {
-    bootstrap: (props: LifecycleProps) => Promise<void>;
-    mount: (props: LifecycleProps) => Promise<void>;
-    unmount: (props: LifecycleProps) => Promise<void>;
-}
-/**
- * Create an Eldrin app with single-spa compatible lifecycle
- *
- * @param options - App configuration
- * @returns Object with bootstrap, mount, and unmount lifecycle functions
- *
- * @example
- * ```tsx
- * // src/index.tsx
- * import { createApp } from '@eldrin-project/eldrin-app-core';
- * import App from './App';
- *
- * export const { bootstrap, mount, unmount } = createApp({
- *   name: 'invoicing',
- *   root: App,
- *   // Migrations loaded via Vite plugin
- * });
- * ```
- */
-declare function createApp(options: CreateAppOptions): AppLifecycle;
-/**
- * Type helper for migration files loaded via Vite plugin
- *
- * @example
- * ```tsx
- * // With Vite plugin
- * import { createApp, type MigrationFiles } from '@eldrin-project/eldrin-app-core';
- * import migrations from 'virtual:eldrin/migrations';
- *
- * export const { bootstrap, mount, unmount } = createApp({
- *   name: 'invoicing',
- *   root: App,
- *   migrations: migrations as MigrationFiles,
- * });
- * ```
- */
-type MigrationFiles = MigrationFile[];
-
-/**
- * Props for DatabaseProvider
- */
-interface DatabaseProviderProps {
-    /** D1 database instance (null if app has no database) */
-    db: D1Database | null;
-    /** Whether migrations have completed */
-    migrationsComplete: boolean;
-    /** Migration result */
-    migrationResult?: MigrationResult;
-    /** Child components */
-    children: ReactNode;
-}
-/**
- * Provider component for database context
- */
-declare function DatabaseProvider({ db, migrationsComplete, migrationResult, children, }: DatabaseProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access the app's D1 database
- *
- * @returns D1Database instance or null if app has no database
- * @throws Error if used outside of DatabaseProvider
- *
- * @example
- * ```tsx
- * function InvoiceList() {
- *   const db = useDatabase();
- *
- *   if (!db) {
- *     return <div>No database configured</div>;
- *   }
- *
- *   const { results } = await db.prepare(
- *     'SELECT * FROM invoices ORDER BY created_at DESC'
- *   ).all();
- *
- *   return <div>{results.map(invoice => ...)}</div>;
- * }
- * ```
- */
-declare function useDatabase(): D1Database | null;
-/**
- * Hook to access full database context including migration status
- *
- * @returns DatabaseContext object
- * @throws Error if used outside of DatabaseProvider
- */
-declare function useDatabaseContext(): DatabaseContext;
-/**
- * Hook to check if migrations have completed
- *
- * Useful for showing loading states while migrations run
- *
- * @returns true if migrations are complete
- */
-declare function useMigrationsComplete(): boolean;
 
 /**
  * Migration runner for Eldrin apps
@@ -1304,4 +1137,4 @@ declare function isPublicRoute(pathname: string, publicRoutes: string[], apiPref
  */
 declare function createPermissionMiddleware<TEnv = unknown>(config: MiddlewareConfig<TEnv>): PermissionMiddleware<TEnv>;
 
-export { AUTH_HEADERS, type AppAuthContext, type AppLifecycle, type AppManifest, CHECKSUM_PREFIX, type CompiledRoute, type CorsConfig, type CreateAppOptions, type DatabaseContext, DatabaseProvider, type DatabaseProviderProps, type EldrinContext, type EldrinEnv, type EldrinEvent, EldrinEventClient, type EmitOptions, type EmitResult, type EventClientConfig, type EventDelivery, type EventHandler, type GenerateMigrationManifestOptions, type GenerateMigrationManifestResult, type JWTPayload, type JWTVerifyOptions, type LifecycleProps, type ManifestApi, type ManifestForMiddleware, type ManifestGroup, type ManifestPermission, type ManifestRoute, type MiddlewareAuthResult, type MiddlewareConfig, type MiddlewareError, type MiddlewareErrorType, type MiddlewareResponseResult, type MiddlewareResult, type MigrationFile, type MigrationFiles, type MigrationManifest, type MigrationManifestEntry, type MigrationOptions, type MigrationRecord, type MigrationResult, type PermissionMiddleware, type PollOptions, type PollResult, type RegisteredEventType, type RollbackResult, type SubscriptionInfo, calculateChecksum, calculatePrefixedChecksum, compileRoutes, createApp, createEventClient, createPermissionMiddleware, extractTimestamp, generateMigrationManifest, getAuthContext, getAuthContextFromJWT, getMigrationStatus, getRollbackFilename, hasPermission, hasPlatformRole, isPlatformAdmin, isPublicRoute, isValidMigrationFilename, isValidRollbackFilename, matchRoute, parseSQLStatements, requireAllPermissions, requireAnyPermission, requireAuth, requireJWTAuth, requireJWTPermission, requirePermission, rollbackMigrations, runMigrations, useDatabase, useDatabaseContext, useMigrationsComplete, validateMigrationManifest, verifyChecksum, verifyJWT };
+export { AUTH_HEADERS, type AppAuthContext, type AppManifest, CHECKSUM_PREFIX, type CompiledRoute, type CorsConfig, type EldrinEnv, type EldrinEvent, EldrinEventClient, type EmitOptions, type EmitResult, type EventClientConfig, type EventDelivery, type EventHandler, type GenerateMigrationManifestOptions, type GenerateMigrationManifestResult, type JWTPayload, type JWTVerifyOptions, type ManifestApi, type ManifestForMiddleware, type ManifestGroup, type ManifestPermission, type ManifestRoute, type MiddlewareAuthResult, type MiddlewareConfig, type MiddlewareError, type MiddlewareErrorType, type MiddlewareResponseResult, type MiddlewareResult, type MigrationFile, type MigrationManifest, type MigrationManifestEntry, type MigrationOptions, type MigrationRecord, type MigrationResult, type PermissionMiddleware, type PollOptions, type PollResult, type RegisteredEventType, type RollbackResult, type SubscriptionInfo, calculateChecksum, calculatePrefixedChecksum, compileRoutes, createEventClient, createPermissionMiddleware, extractTimestamp, generateMigrationManifest, getAuthContext, getAuthContextFromJWT, getMigrationStatus, getRollbackFilename, hasPermission, hasPlatformRole, isPlatformAdmin, isPublicRoute, isValidMigrationFilename, isValidRollbackFilename, matchRoute, parseSQLStatements, requireAllPermissions, requireAnyPermission, requireAuth, requireJWTAuth, requireJWTPermission, requirePermission, rollbackMigrations, runMigrations, validateMigrationManifest, verifyChecksum, verifyJWT };

package/dist/index.d.ts

@@ -1,6 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-
 /**
  * Core types for @eldrin-project/eldrin-app-core
  */
@@ -145,170 +142,6 @@ interface AppManifest {
      */
     groups?: ManifestGroup[];
 }
-/**
- * Options for createApp factory
- */
-interface CreateAppOptions {
-    /** Unique app identifier */
-    name: string;
-    /** Root React component */
-    root: React.ComponentType<unknown>;
-    /** App manifest (optional, can be loaded from file) */
-    manifest?: AppManifest;
-    /** Migration files (loaded at build time via Vite plugin) */
-    migrations?: MigrationFile[];
-    /** Called when migrations complete successfully */
-    onMigrationsComplete?: (result: MigrationResult) => void;
-    /** Called when migrations fail */
-    onMigrationError?: (error: Error) => void;
-}
-/**
- * Database context passed to app components
- */
-interface DatabaseContext {
-    /** D1 database instance (null if app has no database) */
-    db: D1Database | null;
-    /** Whether migrations have completed */
-    migrationsComplete: boolean;
-    /** Migration result (if migrations were run) */
-    migrationResult?: MigrationResult;
-}
-/**
- * Eldrin context provided to apps
- */
-interface EldrinContext {
-    /** App ID */
-    appId: string;
-    /** Database context */
-    database: DatabaseContext;
-    /** Environment variables */
-    env: Record<string, string>;
-}
-
-/**
- * App factory for creating Eldrin apps
- *
- * Returns single-spa compatible lifecycle functions with:
- * - Automatic migration execution on bootstrap
- * - Database provider wrapping
- * - Error boundary integration
- */
-
-/**
- * Single-spa lifecycle props passed to lifecycle functions
- */
-interface LifecycleProps {
-    /** DOM element to mount the app into */
-    domElement?: HTMLElement;
-    /** App name */
-    name?: string;
-    /** D1 Database instance (provided by shell) */
-    db?: D1Database;
-    /** Custom props from shell */
-    customProps?: Record<string, unknown>;
-}
-/**
- * Single-spa compatible lifecycle object
- */
-interface AppLifecycle {
-    bootstrap: (props: LifecycleProps) => Promise<void>;
-    mount: (props: LifecycleProps) => Promise<void>;
-    unmount: (props: LifecycleProps) => Promise<void>;
-}
-/**
- * Create an Eldrin app with single-spa compatible lifecycle
- *
- * @param options - App configuration
- * @returns Object with bootstrap, mount, and unmount lifecycle functions
- *
- * @example
- * ```tsx
- * // src/index.tsx
- * import { createApp } from '@eldrin-project/eldrin-app-core';
- * import App from './App';
- *
- * export const { bootstrap, mount, unmount } = createApp({
- *   name: 'invoicing',
- *   root: App,
- *   // Migrations loaded via Vite plugin
- * });
- * ```
- */
-declare function createApp(options: CreateAppOptions): AppLifecycle;
-/**
- * Type helper for migration files loaded via Vite plugin
- *
- * @example
- * ```tsx
- * // With Vite plugin
- * import { createApp, type MigrationFiles } from '@eldrin-project/eldrin-app-core';
- * import migrations from 'virtual:eldrin/migrations';
- *
- * export const { bootstrap, mount, unmount } = createApp({
- *   name: 'invoicing',
- *   root: App,
- *   migrations: migrations as MigrationFiles,
- * });
- * ```
- */
-type MigrationFiles = MigrationFile[];
-
-/**
- * Props for DatabaseProvider
- */
-interface DatabaseProviderProps {
-    /** D1 database instance (null if app has no database) */
-    db: D1Database | null;
-    /** Whether migrations have completed */
-    migrationsComplete: boolean;
-    /** Migration result */
-    migrationResult?: MigrationResult;
-    /** Child components */
-    children: ReactNode;
-}
-/**
- * Provider component for database context
- */
-declare function DatabaseProvider({ db, migrationsComplete, migrationResult, children, }: DatabaseProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access the app's D1 database
- *
- * @returns D1Database instance or null if app has no database
- * @throws Error if used outside of DatabaseProvider
- *
- * @example
- * ```tsx
- * function InvoiceList() {
- *   const db = useDatabase();
- *
- *   if (!db) {
- *     return <div>No database configured</div>;
- *   }
- *
- *   const { results } = await db.prepare(
- *     'SELECT * FROM invoices ORDER BY created_at DESC'
- *   ).all();
- *
- *   return <div>{results.map(invoice => ...)}</div>;
- * }
- * ```
- */
-declare function useDatabase(): D1Database | null;
-/**
- * Hook to access full database context including migration status
- *
- * @returns DatabaseContext object
- * @throws Error if used outside of DatabaseProvider
- */
-declare function useDatabaseContext(): DatabaseContext;
-/**
- * Hook to check if migrations have completed
- *
- * Useful for showing loading states while migrations run
- *
- * @returns true if migrations are complete
- */
-declare function useMigrationsComplete(): boolean;
 
 /**
  * Migration runner for Eldrin apps
@@ -1304,4 +1137,4 @@ declare function isPublicRoute(pathname: string, publicRoutes: string[], apiPref
  */
 declare function createPermissionMiddleware<TEnv = unknown>(config: MiddlewareConfig<TEnv>): PermissionMiddleware<TEnv>;
 
-export { AUTH_HEADERS, type AppAuthContext, type AppLifecycle, type AppManifest, CHECKSUM_PREFIX, type CompiledRoute, type CorsConfig, type CreateAppOptions, type DatabaseContext, DatabaseProvider, type DatabaseProviderProps, type EldrinContext, type EldrinEnv, type EldrinEvent, EldrinEventClient, type EmitOptions, type EmitResult, type EventClientConfig, type EventDelivery, type EventHandler, type GenerateMigrationManifestOptions, type GenerateMigrationManifestResult, type JWTPayload, type JWTVerifyOptions, type LifecycleProps, type ManifestApi, type ManifestForMiddleware, type ManifestGroup, type ManifestPermission, type ManifestRoute, type MiddlewareAuthResult, type MiddlewareConfig, type MiddlewareError, type MiddlewareErrorType, type MiddlewareResponseResult, type MiddlewareResult, type MigrationFile, type MigrationFiles, type MigrationManifest, type MigrationManifestEntry, type MigrationOptions, type MigrationRecord, type MigrationResult, type PermissionMiddleware, type PollOptions, type PollResult, type RegisteredEventType, type RollbackResult, type SubscriptionInfo, calculateChecksum, calculatePrefixedChecksum, compileRoutes, createApp, createEventClient, createPermissionMiddleware, extractTimestamp, generateMigrationManifest, getAuthContext, getAuthContextFromJWT, getMigrationStatus, getRollbackFilename, hasPermission, hasPlatformRole, isPlatformAdmin, isPublicRoute, isValidMigrationFilename, isValidRollbackFilename, matchRoute, parseSQLStatements, requireAllPermissions, requireAnyPermission, requireAuth, requireJWTAuth, requireJWTPermission, requirePermission, rollbackMigrations, runMigrations, useDatabase, useDatabaseContext, useMigrationsComplete, validateMigrationManifest, verifyChecksum, verifyJWT };
+export { AUTH_HEADERS, type AppAuthContext, type AppManifest, CHECKSUM_PREFIX, type CompiledRoute, type CorsConfig, type EldrinEnv, type EldrinEvent, EldrinEventClient, type EmitOptions, type EmitResult, type EventClientConfig, type EventDelivery, type EventHandler, type GenerateMigrationManifestOptions, type GenerateMigrationManifestResult, type JWTPayload, type JWTVerifyOptions, type ManifestApi, type ManifestForMiddleware, type ManifestGroup, type ManifestPermission, type ManifestRoute, type MiddlewareAuthResult, type MiddlewareConfig, type MiddlewareError, type MiddlewareErrorType, type MiddlewareResponseResult, type MiddlewareResult, type MigrationFile, type MigrationManifest, type MigrationManifestEntry, type MigrationOptions, type MigrationRecord, type MigrationResult, type PermissionMiddleware, type PollOptions, type PollResult, type RegisteredEventType, type RollbackResult, type SubscriptionInfo, calculateChecksum, calculatePrefixedChecksum, compileRoutes, createEventClient, createPermissionMiddleware, extractTimestamp, generateMigrationManifest, getAuthContext, getAuthContextFromJWT, getMigrationStatus, getRollbackFilename, hasPermission, hasPlatformRole, isPlatformAdmin, isPublicRoute, isValidMigrationFilename, isValidRollbackFilename, matchRoute, parseSQLStatements, requireAllPermissions, requireAnyPermission, requireAuth, requireJWTAuth, requireJWTPermission, requirePermission, rollbackMigrations, runMigrations, validateMigrationManifest, verifyChecksum, verifyJWT };

package/dist/index.js

@@ -1,10 +1,6 @@
-import { createContext, useContext, createElement } from 'react';
 import { readdir, readFile } from 'fs/promises';
 import { existsSync } from 'fs';
 import { resolve, basename } from 'path';
-import { jsx } from 'react/jsx-runtime';
-
-// src/app/createApp.tsx
 
 // src/migrations/checksum.ts
 var CHECKSUM_PREFIX = "sha256:";
@@ -442,120 +438,6 @@ async function validateMigrationManifest(manifest, files) {
     errors
   };
 }
-var EldrinDatabaseContext = createContext(null);
-function DatabaseProvider({
-  db,
-  migrationsComplete,
-  migrationResult,
-  children
-}) {
-  const value = {
-    db,
-    migrationsComplete,
-    migrationResult
-  };
-  return /* @__PURE__ */ jsx(EldrinDatabaseContext.Provider, { value, children });
-}
-function useDatabase() {
-  const context = useContext(EldrinDatabaseContext);
-  if (context === null) {
-    throw new Error("useDatabase must be used within a DatabaseProvider (via createApp)");
-  }
-  return context.db;
-}
-function useDatabaseContext() {
-  const context = useContext(EldrinDatabaseContext);
-  if (context === null) {
-    throw new Error("useDatabaseContext must be used within a DatabaseProvider (via createApp)");
-  }
-  return context;
-}
-function useMigrationsComplete() {
-  const context = useContext(EldrinDatabaseContext);
-  return context?.migrationsComplete ?? false;
-}
-
-// src/app/createApp.tsx
-function createApp(options) {
-  const { name, root: RootComponent, migrations = [], onMigrationsComplete, onMigrationError } = options;
-  const state = {
-    db: null,
-    migrationsComplete: false,
-    migrationResult: void 0,
-    mountedElement: void 0,
-    reactRoot: void 0
-  };
-  async function bootstrap(props) {
-    const db = props.db ?? null;
-    state.db = db;
-    if (db && migrations.length > 0) {
-      try {
-        const result = await runMigrations(db, {
-          migrations,
-          onLog: (message, level) => {
-            const prefix = `[${name}]`;
-            if (level === "error") {
-              console.error(prefix, message);
-            } else if (level === "warn") {
-              console.warn(prefix, message);
-            } else {
-              console.log(prefix, message);
-            }
-          }
-        });
-        state.migrationResult = result;
-        if (result.success) {
-          state.migrationsComplete = true;
-          onMigrationsComplete?.(result);
-        } else {
-          const error = new Error(result.error?.message ?? "Migration failed");
-          onMigrationError?.(error);
-          throw error;
-        }
-      } catch (error) {
-        state.migrationsComplete = false;
-        const err = error instanceof Error ? error : new Error(String(error));
-        onMigrationError?.(err);
-        throw err;
-      }
-    } else {
-      state.migrationsComplete = true;
-    }
-  }
-  async function mount(props) {
-    const domElement = props.domElement ?? document.getElementById(`app-${name}`);
-    if (!domElement) {
-      throw new Error(`No DOM element found for app "${name}". Expected element with id="app-${name}" or domElement prop.`);
-    }
-    state.mountedElement = domElement;
-    const rootElement = createElement(RootComponent, props.customProps ?? {});
-    const appElement = createElement(DatabaseProvider, {
-      db: state.db,
-      migrationsComplete: state.migrationsComplete,
-      migrationResult: state.migrationResult,
-      children: rootElement
-    });
-    const ReactDOM = await import('react-dom/client');
-    const root = ReactDOM.createRoot(domElement);
-    root.render(appElement);
-    state.reactRoot = root;
-  }
-  async function unmount(_props) {
-    if (state.reactRoot) {
-      state.reactRoot.unmount();
-      state.reactRoot = void 0;
-    }
-    if (state.mountedElement) {
-      state.mountedElement.innerHTML = "";
-      state.mountedElement = void 0;
-    }
-  }
-  return {
-    bootstrap,
-    mount,
-    unmount
-  };
-}
 
 // src/events/client.ts
 var EldrinEventClient = class {
@@ -1159,6 +1041,6 @@ function createPermissionMiddleware(config) {
   };
 }
 
-export { AUTH_HEADERS, CHECKSUM_PREFIX, DatabaseProvider, EldrinEventClient, calculateChecksum, calculatePrefixedChecksum, compileRoutes, createApp, createEventClient, createPermissionMiddleware, extractTimestamp, generateMigrationManifest, getAuthContext, getAuthContextFromJWT, getMigrationStatus, getRollbackFilename, hasPermission, hasPlatformRole, isPlatformAdmin, isPublicRoute, isValidMigrationFilename, isValidRollbackFilename, matchRoute, parseSQLStatements, requireAllPermissions, requireAnyPermission, requireAuth, requireJWTAuth, requireJWTPermission, requirePermission, rollbackMigrations, runMigrations, useDatabase, useDatabaseContext, useMigrationsComplete, validateMigrationManifest, verifyChecksum, verifyJWT };
+export { AUTH_HEADERS, CHECKSUM_PREFIX, EldrinEventClient, calculateChecksum, calculatePrefixedChecksum, compileRoutes, createEventClient, createPermissionMiddleware, extractTimestamp, generateMigrationManifest, getAuthContext, getAuthContextFromJWT, getMigrationStatus, getRollbackFilename, hasPermission, hasPlatformRole, isPlatformAdmin, isPublicRoute, isValidMigrationFilename, isValidRollbackFilename, matchRoute, parseSQLStatements, requireAllPermissions, requireAnyPermission, requireAuth, requireJWTAuth, requireJWTPermission, requirePermission, rollbackMigrations, runMigrations, validateMigrationManifest, verifyChecksum, verifyJWT };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map