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

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
@@ -466,96 +299,6 @@ declare function extractTimestamp(filename: string): string | null;
  */
 declare function getRollbackFilename(migrationFilename: string): string;
 
-/**
- * Marketplace utilities for migration packaging
- *
- * Provides tools to generate migration manifests for marketplace distribution.
- * This is used at build time to prepare apps for submission.
- */
-
-/**
- * Migration entry in the marketplace manifest
- */
-interface MigrationManifestEntry {
-    /** Migration ID (timestamp) */
-    id: string;
-    /** Full filename */
-    file: string;
-    /** SHA-256 checksum with prefix */
-    checksum: string;
-}
-/**
- * Marketplace migration manifest format
- */
-interface MigrationManifest {
-    /** Logical database name (used for table prefixing) */
-    database: string;
-    /** List of migrations in order */
-    migrations: MigrationManifestEntry[];
-}
-/**
- * Options for generating migration manifest
- */
-interface GenerateMigrationManifestOptions {
-    /** Directory containing migration SQL files */
-    migrationsDir: string;
-    /** Logical database name for the app */
-    database: string;
-}
-/**
- * Result of migration manifest generation
- */
-interface GenerateMigrationManifestResult {
-    /** The generated manifest */
-    manifest: MigrationManifest;
-    /** Migration files with content (for copying to output) */
-    files: MigrationFile[];
-}
-/**
- * Generate a marketplace migration manifest from migration files
- *
- * Reads migration files from the specified directory and generates
- * a manifest with checksums suitable for marketplace distribution.
- *
- * @param options - Generation options
- * @returns Manifest and file contents
- *
- * @example
- * ```typescript
- * import { generateMigrationManifest } from '@eldrin-project/eldrin-app-core';
- *
- * const result = await generateMigrationManifest({
- *   migrationsDir: './migrations',
- *   database: 'invoicing',
- * });
- *
- * // Write manifest to output directory
- * await writeFile(
- *   'dist/migrations/index.json',
- *   JSON.stringify(result.manifest, null, 2)
- * );
- *
- * // Copy migration files
- * for (const file of result.files) {
- *   await writeFile(`dist/migrations/${file.name}`, file.content);
- * }
- * ```
- */
-declare function generateMigrationManifest(options: GenerateMigrationManifestOptions): Promise<GenerateMigrationManifestResult>;
-/**
- * Validate a migration manifest against actual files
- *
- * Useful for CI/CD validation in the marketplace-dist repository.
- *
- * @param manifest - The manifest to validate
- * @param files - The actual migration files
- * @returns Validation result with any errors
- */
-declare function validateMigrationManifest(manifest: MigrationManifest, files: MigrationFile[]): Promise<{
-    valid: boolean;
-    errors: string[];
-}>;
-
 /**
  * Event System Types
  * Types for server-side inter-app event communication
@@ -1304,4 +1047,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 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 MigrationOptions, type MigrationRecord, type MigrationResult, type PermissionMiddleware, type PollOptions, type PollResult, type RegisteredEventType, type RollbackResult, type SubscriptionInfo, calculateChecksum, calculatePrefixedChecksum, compileRoutes, createEventClient, createPermissionMiddleware, extractTimestamp, getAuthContext, getAuthContextFromJWT, getMigrationStatus, getRollbackFilename, hasPermission, hasPlatformRole, isPlatformAdmin, isPublicRoute, isValidMigrationFilename, isValidRollbackFilename, matchRoute, parseSQLStatements, requireAllPermissions, requireAnyPermission, requireAuth, requireJWTAuth, requireJWTPermission, requirePermission, rollbackMigrations, runMigrations, 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
@@ -466,96 +299,6 @@ declare function extractTimestamp(filename: string): string | null;
  */
 declare function getRollbackFilename(migrationFilename: string): string;
 
-/**
- * Marketplace utilities for migration packaging
- *
- * Provides tools to generate migration manifests for marketplace distribution.
- * This is used at build time to prepare apps for submission.
- */
-
-/**
- * Migration entry in the marketplace manifest
- */
-interface MigrationManifestEntry {
-    /** Migration ID (timestamp) */
-    id: string;
-    /** Full filename */
-    file: string;
-    /** SHA-256 checksum with prefix */
-    checksum: string;
-}
-/**
- * Marketplace migration manifest format
- */
-interface MigrationManifest {
-    /** Logical database name (used for table prefixing) */
-    database: string;
-    /** List of migrations in order */
-    migrations: MigrationManifestEntry[];
-}
-/**
- * Options for generating migration manifest
- */
-interface GenerateMigrationManifestOptions {
-    /** Directory containing migration SQL files */
-    migrationsDir: string;
-    /** Logical database name for the app */
-    database: string;
-}
-/**
- * Result of migration manifest generation
- */
-interface GenerateMigrationManifestResult {
-    /** The generated manifest */
-    manifest: MigrationManifest;
-    /** Migration files with content (for copying to output) */
-    files: MigrationFile[];
-}
-/**
- * Generate a marketplace migration manifest from migration files
- *
- * Reads migration files from the specified directory and generates
- * a manifest with checksums suitable for marketplace distribution.
- *
- * @param options - Generation options
- * @returns Manifest and file contents
- *
- * @example
- * ```typescript
- * import { generateMigrationManifest } from '@eldrin-project/eldrin-app-core';
- *
- * const result = await generateMigrationManifest({
- *   migrationsDir: './migrations',
- *   database: 'invoicing',
- * });
- *
- * // Write manifest to output directory
- * await writeFile(
- *   'dist/migrations/index.json',
- *   JSON.stringify(result.manifest, null, 2)
- * );
- *
- * // Copy migration files
- * for (const file of result.files) {
- *   await writeFile(`dist/migrations/${file.name}`, file.content);
- * }
- * ```
- */
-declare function generateMigrationManifest(options: GenerateMigrationManifestOptions): Promise<GenerateMigrationManifestResult>;
-/**
- * Validate a migration manifest against actual files
- *
- * Useful for CI/CD validation in the marketplace-dist repository.
- *
- * @param manifest - The manifest to validate
- * @param files - The actual migration files
- * @returns Validation result with any errors
- */
-declare function validateMigrationManifest(manifest: MigrationManifest, files: MigrationFile[]): Promise<{
-    valid: boolean;
-    errors: string[];
-}>;
-
 /**
  * Event System Types
  * Types for server-side inter-app event communication
@@ -1304,4 +1047,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 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 MigrationOptions, type MigrationRecord, type MigrationResult, type PermissionMiddleware, type PollOptions, type PollResult, type RegisteredEventType, type RollbackResult, type SubscriptionInfo, calculateChecksum, calculatePrefixedChecksum, compileRoutes, createEventClient, createPermissionMiddleware, extractTimestamp, getAuthContext, getAuthContextFromJWT, getMigrationStatus, getRollbackFilename, hasPermission, hasPlatformRole, isPlatformAdmin, isPublicRoute, isValidMigrationFilename, isValidRollbackFilename, matchRoute, parseSQLStatements, requireAllPermissions, requireAnyPermission, requireAuth, requireJWTAuth, requireJWTPermission, requirePermission, rollbackMigrations, runMigrations, verifyChecksum, verifyJWT };