sovrium 0.0.2

package/src/application/ports/repositories/comment-repository.ts

@@ -0,0 +1,150 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+
+import { Context } from 'effect'
+import type { UserMetadataWithOptionalImage } from '@/application/ports/models/user-metadata'
+import type { UserSession } from '@/application/ports/models/user-session'
+import type { SessionContextError } from '@/domain/errors'
+import type { Effect } from 'effect'
+
+/**
+ * Comment with user metadata
+ */
+export interface CommentWithUser {
+  readonly id: string
+  readonly tableId: string
+  readonly recordId: string
+  readonly userId: string
+  readonly content: string
+  readonly createdAt: Date
+  readonly updatedAt: Date
+  readonly user: UserMetadataWithOptionalImage | undefined
+}
+
+/**
+ * Comment for authorization check (minimal fields)
+ */
+export interface CommentForAuth {
+  readonly id: string
+  readonly userId: string
+  readonly recordId: string
+  readonly tableId: string
+}
+
+/**
+ * User record for authorization
+ */
+export interface CommentUser {
+  readonly id: string
+  readonly role: string | undefined
+}
+
+/**
+ * Listed comment with required updatedAt
+ */
+export interface ListedComment {
+  readonly id: string
+  readonly tableId: string
+  readonly recordId: string
+  readonly userId: string
+  readonly content: string
+  readonly createdAt: Date
+  readonly updatedAt: Date
+  readonly user?: UserMetadataWithOptionalImage | undefined
+}
+
+/**
+ * Comment Repository port for comment CRUD operations
+ *
+ * Defines the contract for comment creation, retrieval, deletion, and listing.
+ *
+ * @example
+ * ```typescript
+ * const program = Effect.gen(function* () {
+ *   const comments = yield* CommentRepository
+ *   const comment = yield* comments.create({ session, tableId, recordId, content })
+ * })
+ * ```
+ */
+export class CommentRepository extends Context.Tag('CommentRepository')<
+  CommentRepository,
+  {
+    readonly create: (config: {
+      readonly session: Readonly<UserSession>
+      readonly tableId: string
+      readonly recordId: string
+      readonly content: string
+    }) => Effect.Effect<
+      {
+        readonly id: string
+        readonly tableId: string
+        readonly recordId: string
+        readonly userId: string
+        readonly content: string
+        readonly createdAt: Date
+      },
+      SessionContextError
+    >
+
+    readonly getWithUser: (config: {
+      readonly session: Readonly<UserSession>
+      readonly commentId: string
+    }) => Effect.Effect<CommentWithUser | undefined, SessionContextError>
+
+    readonly checkRecordExists: (config: {
+      readonly session: Readonly<UserSession>
+      readonly tableName: string
+      readonly recordId: string
+      readonly isAdmin?: boolean
+    }) => Effect.Effect<boolean, SessionContextError>
+
+    readonly getForAuth: (config: {
+      readonly session: Readonly<UserSession>
+      readonly commentId: string
+    }) => Effect.Effect<CommentForAuth | undefined, SessionContextError>
+
+    readonly getUserById: (config: {
+      readonly session: Readonly<UserSession>
+      readonly userId: string
+    }) => Effect.Effect<CommentUser | undefined, SessionContextError>
+
+    readonly remove: (config: {
+      readonly session: Readonly<UserSession>
+      readonly commentId: string
+    }) => Effect.Effect<void, SessionContextError>
+
+    readonly list: (config: {
+      readonly session: Readonly<UserSession>
+      readonly recordId: string
+      readonly limit?: number
+      readonly offset?: number
+      readonly sortOrder?: 'asc' | 'desc'
+    }) => Effect.Effect<readonly ListedComment[], SessionContextError>
+
+    readonly getCount: (config: {
+      readonly session: Readonly<UserSession>
+      readonly recordId: string
+    }) => Effect.Effect<number, SessionContextError>
+
+    readonly update: (config: {
+      readonly session: Readonly<UserSession>
+      readonly commentId: string
+      readonly content: string
+    }) => Effect.Effect<
+      {
+        readonly id: string
+        readonly tableId: string
+        readonly recordId: string
+        readonly userId: string
+        readonly content: string
+        readonly createdAt: Date
+        readonly updatedAt: Date
+      },
+      SessionContextError
+    >
+  }
+>() {}

package/src/application/ports/repositories/index.ts

@@ -0,0 +1,41 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+
+export {
+  ActivityLogRepository,
+  ActivityLogDatabaseError,
+  type ActivityLog,
+} from './activity-log-repository'
+export {
+  AnalyticsRepository,
+  AnalyticsDatabaseError,
+  type PageViewInput,
+  type AnalyticsQueryParams,
+  type TimeSeriesPoint,
+  type AnalyticsSummary,
+  type TopPage,
+  type TopReferrer,
+  type BreakdownEntry,
+  type DeviceBreakdown,
+  type CampaignEntry,
+} from './analytics-repository'
+export { ActivityRepository, type ActivityHistoryEntry } from './activity-repository'
+export { AuthRepository, AuthDatabaseError } from './auth-repository'
+export { BatchRepository, type BatchValidationError, type UpsertResult } from './batch-repository'
+export {
+  CommentRepository,
+  type CommentWithUser,
+  type CommentForAuth,
+  type CommentUser,
+  type ListedComment,
+} from './comment-repository'
+export {
+  TableRepository,
+  type QueryFilter,
+  type AggregateQuery,
+  type AggregationResult,
+} from './table-repository'

package/src/application/ports/repositories/table-repository.ts

@@ -0,0 +1,139 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+
+import { Context } from 'effect'
+import type { UserSession } from '@/application/ports/models/user-session'
+import type { SessionContextError, UniqueConstraintViolationError } from '@/domain/errors'
+import type { App } from '@/domain/models/app'
+import type { Effect } from 'effect'
+
+/**
+ * Query filter for record listing
+ */
+export interface QueryFilter {
+  readonly and?: readonly {
+    readonly field: string
+    readonly operator: string
+    readonly value: unknown
+  }[]
+}
+
+/**
+ * Aggregation query configuration
+ */
+export interface AggregateQuery {
+  readonly count?: boolean
+  readonly sum?: readonly string[]
+  readonly avg?: readonly string[]
+  readonly min?: readonly string[]
+  readonly max?: readonly string[]
+}
+
+/**
+ * Aggregation result from database
+ */
+export interface AggregationResult {
+  readonly count?: string
+  readonly sum?: Record<string, number>
+  readonly avg?: Record<string, number>
+  readonly min?: Record<string, number>
+  readonly max?: Record<string, number>
+}
+
+/**
+ * Table Repository port for CRUD operations
+ *
+ * Defines the contract between the Application layer and database infrastructure.
+ * Live implementation delegates to table-queries infrastructure functions.
+ *
+ * @example
+ * ```typescript
+ * const program = Effect.gen(function* () {
+ *   const repo = yield* TableRepository
+ *   const records = yield* repo.listRecords({ session, tableName: 'users' })
+ * })
+ * ```
+ */
+export class TableRepository extends Context.Tag('TableRepository')<
+  TableRepository,
+  {
+    readonly listRecords: (config: {
+      readonly session: Readonly<UserSession>
+      readonly tableName: string
+      readonly table?: { readonly permissions?: { readonly organizationScoped?: boolean } }
+      readonly filter?: QueryFilter
+      readonly includeDeleted?: boolean
+      readonly sort?: string
+      readonly app?: {
+        readonly tables?: readonly {
+          readonly name: string
+          readonly fields: readonly unknown[]
+        }[]
+      }
+    }) => Effect.Effect<readonly Record<string, unknown>[], SessionContextError>
+
+    readonly listTrash: (config: {
+      readonly session: Readonly<UserSession>
+      readonly tableName: string
+      readonly filter?: QueryFilter
+      readonly sort?: string
+    }) => Effect.Effect<readonly Record<string, unknown>[], SessionContextError>
+
+    readonly getRecord: (
+      session: Readonly<UserSession>,
+      tableName: string,
+      recordId: string,
+      includeDeleted?: boolean
+    ) => Effect.Effect<Record<string, unknown> | null, SessionContextError>
+
+    readonly createRecord: (
+      session: Readonly<UserSession>,
+      tableName: string,
+      fields: Readonly<Record<string, unknown>>
+    ) => Effect.Effect<
+      Record<string, unknown>,
+      SessionContextError | UniqueConstraintViolationError
+    >
+
+    readonly updateRecord: (
+      session: Readonly<UserSession>,
+      tableName: string,
+      recordId: string,
+      params: {
+        readonly fields: Readonly<Record<string, unknown>>
+        readonly app?: App
+      }
+    ) => Effect.Effect<Record<string, unknown>, SessionContextError>
+
+    readonly deleteRecord: (
+      session: Readonly<UserSession>,
+      tableName: string,
+      recordId: string,
+      app?: App
+    ) => Effect.Effect<boolean, SessionContextError>
+
+    readonly permanentlyDeleteRecord: (
+      session: Readonly<UserSession>,
+      tableName: string,
+      recordId: string
+    ) => Effect.Effect<boolean, SessionContextError>
+
+    readonly restoreRecord: (
+      session: Readonly<UserSession>,
+      tableName: string,
+      recordId: string
+    ) => Effect.Effect<Record<string, unknown> | null, SessionContextError>
+
+    readonly computeAggregations: (config: {
+      readonly session: Readonly<UserSession>
+      readonly tableName: string
+      readonly filter?: QueryFilter
+      readonly includeDeleted?: boolean
+      readonly aggregate: AggregateQuery
+    }) => Effect.Effect<AggregationResult, SessionContextError>
+  }
+>() {}

package/src/application/ports/services/css-compiler.ts

@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+
+import { Context } from 'effect'
+import type { App } from '@/domain/models/app'
+import type { Effect } from 'effect'
+
+/**
+ * Compiled CSS result
+ */
+export interface CompiledCSS {
+  readonly css: string
+  readonly timestamp: number
+}
+
+/**
+ * CSS compilation error
+ */
+export interface CSSCompilationError {
+  readonly _tag: 'CSSCompilationError'
+  readonly cause: unknown
+}
+
+/**
+ * CSS Compiler port for compiling Tailwind CSS
+ *
+ * This interface defines the contract for CSS compilation,
+ * allowing the Application layer to remain decoupled from
+ * Infrastructure implementations (PostCSS, Tailwind, etc.).
+ *
+ * @example
+ * ```typescript
+ * const program = Effect.gen(function* () {
+ *   const cssCompiler = yield* CSSCompiler
+ *   const result = yield* cssCompiler.compile(app)
+ *   console.log(`Compiled ${result.css.length} bytes of CSS`)
+ * })
+ * ```
+ */
+export class CSSCompiler extends Context.Tag('CSSCompiler')<
+  CSSCompiler,
+  {
+    /**
+     * Compiles CSS from app theme configuration
+     *
+     * @param app - Optional app configuration containing theme
+     * @returns Effect that yields compiled CSS string or CSSCompilationError
+     */
+    readonly compile: (app?: App) => Effect.Effect<CompiledCSS, CSSCompilationError>
+  }
+>() {}

package/src/application/ports/services/index.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+
+export { CSSCompiler, type CompiledCSS, type CSSCompilationError } from './css-compiler'
+export { PageRenderer } from './page-renderer'
+export { ServerFactory, type ServerFactoryConfig } from './server-factory'
+export {
+  StaticSiteGenerator,
+  type SSGOptions,
+  type SSGResult,
+  type SSGGenerationError,
+} from './static-site-generator'

package/src/application/ports/services/page-renderer.ts

@@ -0,0 +1,79 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+
+import { Context } from 'effect'
+import type { App } from '@/domain/models/app'
+
+/**
+ * Page renderer port for server-side rendering
+ *
+ * This interface defines the contract for rendering pages to HTML,
+ * allowing the Application layer to remain decoupled from
+ * Presentation layer implementations.
+ *
+ * All rendering functions are synchronous and return complete HTML documents.
+ *
+ * @example
+ * ```typescript
+ * const program = Effect.gen(function* () {
+ *   const pageRenderer = yield* PageRenderer
+ *
+ *   // Render homepage with app data
+ *   const homeHtml = pageRenderer.renderHome(app)
+ *
+ *   // Render error pages
+ *   const notFoundHtml = pageRenderer.renderNotFound()
+ *   const errorHtml = pageRenderer.renderError()
+ *
+ *   return { homeHtml, notFoundHtml, errorHtml }
+ * })
+ * ```
+ */
+
+/**
+ * PageRenderer service for server-side HTML rendering
+ *
+ * Use this service via Effect Context to render React components
+ * to HTML strings with type-safe dependency injection.
+ */
+export class PageRenderer extends Context.Tag('PageRenderer')<
+  PageRenderer,
+  {
+    /**
+     * Renders the application home page
+     *
+     * @param app - Validated application data from AppSchema
+     * @param detectedLanguage - Optional detected language from Accept-Language header or URL
+     * @returns Complete HTML document as string with embedded app data
+     */
+    readonly renderHome: (app: App, detectedLanguage?: string) => string
+
+    /**
+     * Renders any page by path
+     *
+     * @param app - Validated application data from AppSchema
+     * @param path - Page path to render (e.g., '/', '/about')
+     * @param detectedLanguage - Optional detected language from Accept-Language header or URL
+     * @returns Complete HTML document as string, or undefined if page not found
+     */
+    readonly renderPage: (app: App, path: string, detectedLanguage?: string) => string | undefined
+
+    /**
+     * Renders the 404 Not Found page
+     *
+     * @returns Complete HTML document as string with 404 error message
+     */
+    readonly renderNotFound: () => string
+
+    /**
+     * Renders the 500 Internal Server Error page
+     *
+     * @returns Complete HTML document as string with error message
+     */
+    readonly renderError: () => string
+  }
+>() {}

package/src/application/ports/services/server-factory.ts

@@ -0,0 +1,80 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+
+import { Context } from 'effect'
+import type { ServerInstance } from '@/application/models/server'
+import type { App } from '@/domain/models/app'
+import type { AuthConfigRequiredForUserFields } from '@/infrastructure/errors/auth-config-required-error'
+import type { CSSCompilationError } from '@/infrastructure/errors/css-compilation-error'
+import type { SchemaInitializationError } from '@/infrastructure/errors/schema-initialization-error'
+import type { ServerCreationError } from '@/infrastructure/errors/server-creation-error'
+import type { Effect } from 'effect'
+
+/**
+ * Server factory port for creating web servers
+ *
+ * This interface defines the contract for server creation,
+ * allowing the Application layer to remain decoupled from
+ * Infrastructure implementations.
+ *
+ * @example
+ * ```typescript
+ * const program = Effect.gen(function* () {
+ *   const serverFactory = yield* ServerFactory
+ *   const server = yield* serverFactory.create({
+ *     app: validatedApp,
+ *     port: 3000,
+ *     renderHomePage: (app) => '<html>...</html>',
+ *     renderNotFoundPage: () => '<html>404</html>',
+ *     renderErrorPage: () => '<html>Error</html>',
+ *   })
+ *   return server
+ * })
+ * ```
+ */
+
+/**
+ * Configuration for server creation
+ */
+export interface ServerFactoryConfig {
+  readonly app: App
+  readonly port?: number
+  readonly hostname?: string
+  readonly publicDir?: string
+  readonly renderHomePage: (app: App) => string
+  readonly renderPage: (app: App, path: string) => string | undefined
+  readonly renderNotFoundPage: () => string
+  readonly renderErrorPage: () => string
+}
+
+/**
+ * ServerFactory service for creating and starting web servers
+ *
+ * Use this service via Effect Context to create server instances
+ * with type-safe dependency injection.
+ */
+export class ServerFactory extends Context.Tag('ServerFactory')<
+  ServerFactory,
+  {
+    /**
+     * Creates and starts a server instance
+     *
+     * @param config - Server configuration with app data and rendering functions
+     * @returns Effect that yields ServerInstance or creation/compilation/auth config/migration errors
+     */
+    readonly create: (
+      config: ServerFactoryConfig
+    ) => Effect.Effect<
+      ServerInstance,
+      | ServerCreationError
+      | CSSCompilationError
+      | AuthConfigRequiredForUserFields
+      | SchemaInitializationError
+      | Error
+    >
+  }
+>() {}

package/src/application/ports/services/static-site-generator.ts

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+
+import { Context } from 'effect'
+import type { Effect } from 'effect'
+import type { Hono } from 'hono'
+
+/**
+ * Options for static site generation
+ */
+export interface SSGOptions {
+  readonly outputDir?: string
+  readonly baseUrl?: string
+  readonly basePath?: string
+  readonly deployment?: 'github-pages' | 'generic'
+  readonly languages?: readonly string[]
+  readonly defaultLanguage?: string
+  readonly generateSitemap?: boolean
+  readonly generateRobotsTxt?: boolean
+  readonly hydration?: boolean
+  readonly generateManifest?: boolean
+  readonly bundleOptimization?: 'split' | 'none'
+  readonly pagePaths?: readonly string[]
+  readonly publicDir?: string
+}
+
+/**
+ * Result of static site generation
+ */
+export interface SSGResult {
+  readonly outputDir: string
+  readonly files: readonly string[]
+}
+
+/**
+ * SSG generation error
+ */
+export interface SSGGenerationError {
+  readonly _tag: 'SSGGenerationError'
+  readonly message: string
+  readonly cause?: unknown
+}
+
+/**
+ * Static Site Generator port for generating static HTML files
+ *
+ * This interface defines the contract for static site generation,
+ * allowing the Application layer to remain decoupled from
+ * Infrastructure implementations (Hono SSG, file system, etc.).
+ *
+ * @example
+ * ```typescript
+ * const program = Effect.gen(function* () {
+ *   const ssg = yield* StaticSiteGenerator
+ *   const result = yield* ssg.generate(honoApp, {
+ *     outputDir: './static',
+ *     pagePaths: ['/', '/about'],
+ *   })
+ *   console.log(`Generated ${result.files.length} files`)
+ * })
+ * ```
+ */
+export class StaticSiteGenerator extends Context.Tag('StaticSiteGenerator')<
+  StaticSiteGenerator,
+  {
+    /**
+     * Generates static HTML files from a Hono application
+     *
+     * @param app - Hono application instance
+     * @param options - Static generation options
+     * @returns Effect that yields SSG result or generation error
+     */
+    readonly generate: (
+      app: Hono | Readonly<Hono>,
+      options: Readonly<SSGOptions>
+    ) => Effect.Effect<SSGResult, SSGGenerationError>
+  }
+>() {}