@solid-stack/agnos 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Solid Stack Digital
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,153 @@
+# @solid-stack/agnos
+
+An agnostic, type-safe clean architecture application framework for TypeScript, powered by **[@solid-stack/di](https://www.npmjs.com/package/@solid-stack/di)**.
+
+---
+
+## ✨ Features
+
+- 🏗️ **Presentation-Agnostic Core**: Decouple your business logic from presentation layers (CLI, HTTP, Next.js, WebSockets, background workers) via `IPresentation` and `Program`.
+- 💉 **Integrated Type-Safe DI**: Seamless integration with `@solid-stack/di` supporting Stage 3 decorators (`@MakeInjectable`), multi-tokens, and compile-time dependency validation.
+- 🪵 **Pluggable Logging**: Extensible logging subsystem using `ILoggerTransport` and `LoggerTransportsToken` multi-tokens with error isolation and `SilentLogger` support.
+- 🎯 **Standardized Use Cases**: Clean `UseCase<IRequest, IResponse>` contracts for domain logic.
+- 🛡️ **Structured Error Hierarchy**: Rich, domain- and lifecycle-tailored error types with HTTP status codes, machine-readable error codes, metadata context, and formatting (`AgnosError`, `AppError`, `BootstrapError`, `FeatureLoadError`, `PresentationError`, `InputParsingError`, `InternalError`, `NotFoundError`, `ResourceConflictError`, `InvalidDependencyError`, `MissingDependencyError`).
+- ⚡ **Dual ESM + CJS Output**: Bundled via [tsup](https://tsup.egoist.dev/) with tree-shaking, sourcemaps, and full `.d.ts` declarations.
+
+---
+
+## 📦 Installation
+
+```bash
+pnpm add @solid-stack/agnos @solid-stack/di
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1. Define Domain Use Case and Presentation
+
+```typescript
+import { Container, MakeInjectable, type DepsType } from "@solid-stack/di";
+import {
+  IPresentation,
+  ILogger,
+  ILoggerTransport,
+  LoggerTransportsToken,
+  UseCase,
+  start,
+  type LogLevel,
+} from "@solid-stack/agnos";
+
+// 1. Define a Logger Transport
+@MakeInjectable
+class ConsoleTransport extends ILoggerTransport {
+  public static deps = {};
+  constructor(public deps: DepsType<typeof ConsoleTransport.deps>) {
+    super();
+  }
+
+  push = (message: any[], level: LogLevel) => {
+    console.log(`[${level.toUpperCase()}]`, ...message);
+  };
+}
+
+// 2. Define a Use Case
+interface GreetRequest {
+  name: string;
+}
+
+interface GreetResponse {
+  greeting: string;
+}
+
+@MakeInjectable
+class GreetUseCase extends UseCase<GreetRequest, GreetResponse> {
+  public static deps = {
+    logger: ILogger,
+  };
+
+  constructor(public deps: DepsType<typeof GreetUseCase.deps>) {
+    super();
+  }
+
+  async execute(request: GreetRequest): Promise<GreetResponse> {
+    this.deps.logger.info(`Greeting user: ${request.name}`);
+    return { greeting: `Hello, ${request.name}!` };
+  }
+}
+
+// 3. Define Presentation Layer
+@MakeInjectable
+class AppPresentation extends IPresentation {
+  public static deps = {
+    greetUseCase: GreetUseCase,
+    logger: ILogger,
+  };
+
+  constructor(public deps: DepsType<typeof AppPresentation.deps>) {
+    super();
+  }
+
+  async init(): Promise<void> {
+    this.deps.logger.info("Initializing presentation layer...");
+  }
+
+  async run(): Promise<void> {
+    const res = await this.deps.greetUseCase.execute({ name: "Solid Stack Developer" });
+    console.log(res.greeting);
+  }
+
+  async stop(): Promise<void> {
+    this.deps.logger.info("Stopping presentation layer...");
+  }
+}
+
+// 4. Bootstrap and Start Application
+async function main() {
+  const container = new Container();
+
+  // Register logger transport and presentation
+  container.provideMulti(LoggerTransportsToken, ConsoleTransport);
+  container.provide(IPresentation, AppPresentation);
+
+  // Start the application lifecycle (automatically loads infra and runs the presentation)
+  await start(container);
+}
+
+main().catch(console.error);
+```
+
+---
+
+## 🛠️ Available Scripts
+
+| Command | Description |
+| --- | --- |
+| `pnpm dev` | Starts `tsup` in watch mode for development |
+| `pnpm build` | Bundles ESM/CJS outputs and generates TypeScript type declarations |
+| `pnpm test` | Runs tests using Vitest |
+| `pnpm test:watch` | Runs Vitest in interactive watch mode |
+| `pnpm test:coverage` | Runs tests with code coverage reporting |
+| `pnpm typecheck` | Typechecks the project using TypeScript (`tsc --noEmit`) |
+| `pnpm check` | Runs typecheck, tests, and build in sequence |
+| `pnpm prepublishOnly` | Automatically runs tests, build, and dist validation before publishing |
+
+---
+
+## 🐳 Docker / Make Commands
+
+```bash
+make dev     # Start dev watcher container
+make test    # Run test suite in container
+make build   # Build package in container
+make prod    # Verify production container
+make clean   # Clean up containers and volumes
+```
+
+---
+
+## 📄 License
+
+MIT © [Solid Stack Digital](https://github.com/solid-stack-digital)
+

package/dist/core/Program.d.ts

@@ -0,0 +1,12 @@
+import { type DepsType } from "@solid-stack/di";
+import { IPresentation, ILogger } from "../types/index.js";
+export declare class Program {
+    deps: DepsType<typeof Program.deps>;
+    static deps: {
+        presentation: typeof IPresentation;
+        logger: typeof ILogger;
+    };
+    constructor(deps: DepsType<typeof Program.deps>);
+    start(): Promise<void>;
+}
+//# sourceMappingURL=Program.d.ts.map

package/dist/core/Program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Program.d.ts","sourceRoot":"","sources":["../../src/core/Program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE3D,qBACa,OAAO;IAMC,IAAI,EAAE,QAAQ,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC;IALtD,OAAc,IAAI;QAChB,YAAY;QACZ,MAAM;MACN;IAEF,YAAmB,IAAI,EAAE,QAAQ,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,EAAI;IAEpD,KAAK,kBAiDV;CACF"}

package/dist/core/bootstrap/index.d.ts

@@ -0,0 +1,3 @@
+export { loadFeatures } from "./loadFeatures.js";
+export { loadInfra } from "./loadInfra.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/bootstrap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/bootstrap/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/bootstrap/loadFeatures.d.ts

@@ -0,0 +1,3 @@
+import type { Container } from "@solid-stack/di";
+export declare function loadFeatures(c: Container, featuresDir: string): Promise<void>;
+//# sourceMappingURL=loadFeatures.d.ts.map

package/dist/core/bootstrap/loadFeatures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadFeatures.d.ts","sourceRoot":"","sources":["../../../src/core/bootstrap/loadFeatures.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,wBAAsB,YAAY,CAChC,CAAC,EAAE,SAAS,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/core/bootstrap/loadInfra.d.ts

@@ -0,0 +1,3 @@
+import type { Container } from "@solid-stack/di";
+export declare const loadInfra: (c: Container) => Promise<void>;
+//# sourceMappingURL=loadInfra.d.ts.map

package/dist/core/bootstrap/loadInfra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadInfra.d.ts","sourceRoot":"","sources":["../../../src/core/bootstrap/loadInfra.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,eAAO,MAAM,SAAS,MAAa,SAAS,kBAE3C,CAAC"}

package/dist/core/errors/AgnosError.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Options for constructing Agnos framework errors.
+ */
+export interface AgnosErrorOptions {
+    /** Underlying cause of the error */
+    cause?: unknown;
+    /** Machine-readable error code */
+    code?: string | undefined;
+    /** HTTP status code equivalent */
+    statusCode?: number | undefined;
+    /** Additional diagnostic metadata */
+    context?: Record<string, unknown> | undefined;
+}
+/**
+ * Base error class for all Agnos framework and application errors.
+ */
+export declare class AgnosError extends Error {
+    readonly details: string;
+    readonly code: string;
+    readonly statusCode: number;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(name?: string, details?: string, options?: AgnosErrorOptions);
+    /**
+     * Formats the error into a human-readable diagnostic string with code, context, cause, and stack trace.
+     */
+    prettyDetails(): string;
+    /**
+     * Serializes the error to a JSON-safe object.
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Type guard to verify if an unknown error is an instance of AgnosError.
+     */
+    static isAgnosError(error: unknown): error is AgnosError;
+}
+//# sourceMappingURL=AgnosError.d.ts.map

package/dist/core/errors/AgnosError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgnosError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/AgnosError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAE9D,YACE,IAAI,SAAe,EACnB,OAAO,SAAuC,EAC9C,OAAO,CAAC,EAAE,iBAAiB,EAY5B;IAED;;OAEG;IACH,aAAa,IAAI,MAAM,CAYtB;IAED;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAShC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEvD;CACF"}

package/dist/core/errors/AppError.d.ts

@@ -0,0 +1,8 @@
+import { AgnosError, type AgnosErrorOptions } from "./AgnosError.js";
+/**
+ * Base application-level error class inheriting from AgnosError.
+ */
+export declare class AppError extends AgnosError {
+    constructor(name?: string, details?: string, options?: AgnosErrorOptions);
+}
+//# sourceMappingURL=AppError.d.ts.map

package/dist/core/errors/AppError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/AppError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErE;;GAEG;AACH,qBAAa,QAAS,SAAQ,UAAU;IACtC,YACE,IAAI,SAA0B,EAC9B,OAAO,SAAsC,EAC7C,OAAO,CAAC,EAAE,iBAAiB,EAO5B;CACF"}

package/dist/core/errors/BootstrapError.d.ts

@@ -0,0 +1,8 @@
+import { AgnosError, type AgnosErrorOptions } from "./AgnosError.js";
+/**
+ * Thrown when application bootstrap or infrastructure initialization fails.
+ */
+export declare class BootstrapError extends AgnosError {
+    constructor(details: string, options?: AgnosErrorOptions);
+}
+//# sourceMappingURL=BootstrapError.d.ts.map

package/dist/core/errors/BootstrapError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BootstrapError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/BootstrapError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErE;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAMvD;CACF"}

package/dist/core/errors/FeatureLoadError.d.ts

@@ -0,0 +1,18 @@
+import { BootstrapError } from "./BootstrapError.js";
+import type { AgnosErrorOptions } from "./AgnosError.js";
+/**
+ * Options for constructing a FeatureLoadError.
+ */
+export interface FeatureLoadErrorOptions extends AgnosErrorOptions {
+    featureName?: string | undefined;
+    providerPath?: string | undefined;
+}
+/**
+ * Thrown when auto-loading a feature module or its DepsProvider fails.
+ */
+export declare class FeatureLoadError extends BootstrapError {
+    readonly featureName?: string | undefined;
+    readonly providerPath?: string | undefined;
+    constructor(featureName: string, providerPath?: string | undefined, details?: string | undefined, options?: FeatureLoadErrorOptions);
+}
+//# sourceMappingURL=FeatureLoadError.d.ts.map

package/dist/core/errors/FeatureLoadError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureLoadError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/FeatureLoadError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,SAAgB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,SAAgB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAElD,YACE,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,EACjC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,CAAC,EAAE,uBAAuB,EAsBlC;CACF"}

package/dist/core/errors/InputParsingError.d.ts

@@ -0,0 +1,24 @@
+import { AppError } from "./AppError.js";
+import type { AgnosErrorOptions } from "./AgnosError.js";
+/**
+ * Options for InputParsingError, including field-level validation errors.
+ */
+export interface InputParsingErrorOptions extends AgnosErrorOptions {
+    issues?: Array<{
+        field?: string | undefined;
+        message: string;
+        code?: string | undefined;
+    }> | undefined;
+}
+/**
+ * Thrown when request payload or user input validation fails.
+ */
+export declare class InputParsingError extends AppError {
+    readonly issues?: Array<{
+        field?: string | undefined;
+        message: string;
+        code?: string | undefined;
+    }> | undefined;
+    constructor(details: string, options?: InputParsingErrorOptions);
+}
+//# sourceMappingURL=InputParsingError.d.ts.map

package/dist/core/errors/InputParsingError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputParsingError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/InputParsingError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CACxG;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,SAAgB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IAEvH,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,EAc9D;CACF"}

package/dist/core/errors/InternalError.d.ts

@@ -0,0 +1,9 @@
+import { AppError } from "./AppError.js";
+import type { AgnosErrorOptions } from "./AgnosError.js";
+/**
+ * Thrown when an unexpected internal framework or application error occurs.
+ */
+export declare class InternalError extends AppError {
+    constructor(details?: string, options?: AgnosErrorOptions);
+}
+//# sourceMappingURL=InternalError.d.ts.map

package/dist/core/errors/InternalError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/InternalError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,YACE,OAAO,SAAsC,EAC7C,OAAO,CAAC,EAAE,iBAAiB,EAO5B;CACF"}

package/dist/core/errors/InvalidDependencyError.d.ts

@@ -0,0 +1,16 @@
+import { AppError } from "./AppError.js";
+import type { AgnosErrorOptions } from "./AgnosError.js";
+/**
+ * Options for InvalidDependencyError.
+ */
+export interface InvalidDependencyErrorOptions extends AgnosErrorOptions {
+    dependencyName?: string | undefined;
+}
+/**
+ * Thrown when an invalid or improperly configured dependency is encountered.
+ */
+export declare class InvalidDependencyError extends AppError {
+    readonly dependencyName?: string | undefined;
+    constructor(details: string, optionsOrCause?: InvalidDependencyErrorOptions | unknown);
+}
+//# sourceMappingURL=InvalidDependencyError.d.ts.map

package/dist/core/errors/InvalidDependencyError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidDependencyError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/InvalidDependencyError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,6BAA8B,SAAQ,iBAAiB;IACtE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,SAAgB,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEpD,YACE,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,6BAA6B,GAAG,OAAO,EA2BzD;CACF"}

package/dist/core/errors/MissingDependencyError.d.ts

@@ -0,0 +1,16 @@
+import { AppError } from "./AppError.js";
+import type { AgnosErrorOptions } from "./AgnosError.js";
+/**
+ * Options for MissingDependencyError.
+ */
+export interface MissingDependencyErrorOptions extends AgnosErrorOptions {
+    dependencyName?: string | undefined;
+}
+/**
+ * Thrown when a required dependency or token cannot be resolved.
+ */
+export declare class MissingDependencyError extends AppError {
+    readonly dependencyName?: string | undefined;
+    constructor(details: string, optionsOrCause?: MissingDependencyErrorOptions | unknown);
+}
+//# sourceMappingURL=MissingDependencyError.d.ts.map

package/dist/core/errors/MissingDependencyError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MissingDependencyError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/MissingDependencyError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,6BAA8B,SAAQ,iBAAiB;IACtE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,SAAgB,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEpD,YACE,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,6BAA6B,GAAG,OAAO,EA2BzD;CACF"}

package/dist/core/errors/NotFoundError.d.ts

@@ -0,0 +1,18 @@
+import { AppError } from "./AppError.js";
+import type { AgnosErrorOptions } from "./AgnosError.js";
+/**
+ * Options for NotFoundError including resource identifier metadata.
+ */
+export interface NotFoundErrorOptions extends AgnosErrorOptions {
+    resource?: string | undefined;
+    resourceId?: string | number | undefined;
+}
+/**
+ * Thrown when a requested resource or entity cannot be found.
+ */
+export declare class NotFoundError extends AppError {
+    readonly resource?: string | undefined;
+    readonly resourceId?: string | number | undefined;
+    constructor(details: string, options?: NotFoundErrorOptions);
+}
+//# sourceMappingURL=NotFoundError.d.ts.map

package/dist/core/errors/NotFoundError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotFoundError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/NotFoundError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAgB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,SAAgB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAEzD,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,EAgB1D;CACF"}

package/dist/core/errors/PresentationError.d.ts

@@ -0,0 +1,11 @@
+import { AgnosError, type AgnosErrorOptions } from "./AgnosError.js";
+/**
+ * Thrown when the presentation layer fails during init, run, or stop lifecycle hooks.
+ */
+export declare class PresentationError extends AgnosError {
+    readonly phase?: ("init" | "run" | "stop") | undefined;
+    constructor(details: string, options?: AgnosErrorOptions & {
+        phase?: ("init" | "run" | "stop") | undefined;
+    });
+}
+//# sourceMappingURL=PresentationError.d.ts.map

package/dist/core/errors/PresentationError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresentationError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/PresentationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErE;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,SAAgB,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC;IAE9D,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,GAAG;QAAE,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,GAAG,SAAS,CAAA;KAAE,EAehF;CACF"}

package/dist/core/errors/ResourceConflictError.d.ts

@@ -0,0 +1,18 @@
+import { AppError } from "./AppError.js";
+import type { AgnosErrorOptions } from "./AgnosError.js";
+/**
+ * Options for ResourceConflictError.
+ */
+export interface ResourceConflictErrorOptions extends AgnosErrorOptions {
+    conflictKey?: string | undefined;
+    conflictingValue?: unknown;
+}
+/**
+ * Thrown when an operation conflicts with existing state (e.g. duplicate key or concurrency collision).
+ */
+export declare class ResourceConflictError extends AppError {
+    readonly conflictKey?: string | undefined;
+    readonly conflictingValue?: unknown;
+    constructor(message: string, optionsOrCause?: ResourceConflictErrorOptions | unknown);
+}
+//# sourceMappingURL=ResourceConflictError.d.ts.map

package/dist/core/errors/ResourceConflictError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceConflictError.d.ts","sourceRoot":"","sources":["../../../src/core/errors/ResourceConflictError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,iBAAiB;IACrE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,SAAgB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,SAAgB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3C,YACE,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,4BAA4B,GAAG,OAAO,EA+BxD;CACF"}

package/dist/core/errors/index.d.ts

@@ -0,0 +1,12 @@
+export { AgnosError, type AgnosErrorOptions } from "./AgnosError.js";
+export { AppError } from "./AppError.js";
+export { BootstrapError } from "./BootstrapError.js";
+export { FeatureLoadError, type FeatureLoadErrorOptions, } from "./FeatureLoadError.js";
+export { PresentationError } from "./PresentationError.js";
+export { InputParsingError, type InputParsingErrorOptions, } from "./InputParsingError.js";
+export { InternalError } from "./InternalError.js";
+export { InvalidDependencyError, type InvalidDependencyErrorOptions, } from "./InvalidDependencyError.js";
+export { MissingDependencyError, type MissingDependencyErrorOptions, } from "./MissingDependencyError.js";
+export { NotFoundError, type NotFoundErrorOptions } from "./NotFoundError.js";
+export { ResourceConflictError, type ResourceConflictErrorOptions, } from "./ResourceConflictError.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export { start } from "./start.js";
+export { SilentLogger } from "./logging/index.js";
+export { AgnosError, type AgnosErrorOptions, AppError, BootstrapError, FeatureLoadError, type FeatureLoadErrorOptions, PresentationError, InputParsingError, type InputParsingErrorOptions, InternalError, InvalidDependencyError, type InvalidDependencyErrorOptions, MissingDependencyError, type MissingDependencyErrorOptions, NotFoundError, type NotFoundErrorOptions, ResourceConflictError, type ResourceConflictErrorOptions, } from "./errors/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,aAAa,EACb,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,aAAa,EACb,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,mBAAmB,CAAC"}

package/dist/core/logging/Logger.d.ts

@@ -0,0 +1,16 @@
+import { type DepsType } from "@solid-stack/di";
+import { ILogger, LoggerTransportsToken } from "../../types/index.js";
+export declare class Logger implements ILogger {
+    deps: DepsType<typeof Logger.deps>;
+    static deps: {
+        transports: typeof LoggerTransportsToken;
+    };
+    constructor(deps: DepsType<typeof Logger.deps>);
+    private broadcast;
+    log(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    debug(...args: any[]): void;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/core/logging/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/core/logging/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,OAAO,EACP,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAE9B,qBACa,MAAO,YAAW,OAAO;IAKjB,IAAI,EAAE,QAAQ,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC;IAJrD,OAAc,IAAI;QAChB,UAAU;MACV;IAEF,YAAmB,IAAI,EAAE,QAAQ,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAI;IAEzD,OAAO,CAAC,SAAS;IAcjB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAExB;IACD,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAEzB;IACD,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAEzB;IACD,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAE1B;IACD,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAE1B;CACF"}

package/dist/core/logging/SilentLogger.d.ts

@@ -0,0 +1,13 @@
+import { type DepsType } from "@solid-stack/di";
+import type { ILogger } from "../../types/index.js";
+export declare class SilentLogger implements ILogger {
+    deps: DepsType<typeof SilentLogger.deps>;
+    static deps: {};
+    constructor(deps: DepsType<typeof SilentLogger.deps>);
+    log(..._args: any[]): void;
+    info(..._args: any[]): void;
+    warn(..._args: any[]): void;
+    error(..._args: any[]): void;
+    debug(..._args: any[]): void;
+}
+//# sourceMappingURL=SilentLogger.d.ts.map

package/dist/core/logging/SilentLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SilentLogger.d.ts","sourceRoot":"","sources":["../../../src/core/logging/SilentLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,qBACa,YAAa,YAAW,OAAO;IAEvB,IAAI,EAAE,QAAQ,CAAC,OAAO,YAAY,CAAC,IAAI,CAAC;IAD3D,OAAc,IAAI,KAAM;IACxB,YAAmB,IAAI,EAAE,QAAQ,CAAC,OAAO,YAAY,CAAC,IAAI,CAAC,EAAI;IAC/D,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAG;IAC7B,IAAI,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAG;IAC9B,IAAI,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAG;IAC9B,KAAK,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAG;IAC/B,KAAK,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAG;CAChC"}

package/dist/core/logging/index.d.ts

@@ -0,0 +1,3 @@
+export { Logger } from "./Logger.js";
+export { SilentLogger } from "./SilentLogger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/start.d.ts

@@ -0,0 +1,15 @@
+import type { Container } from "@solid-stack/di";
+import { type StartOptions } from "../types/index.js";
+/**
+ * Boots up and executes the Agnos application lifecycle.
+ *
+ * Automatically:
+ * 1. Initializes core infrastructure (ILogger, etc.).
+ * 2. Auto-discovers and loads feature modules if a features directory is specified.
+ * 3. Resolves the Program lifecycle coordinator and runs the presentation layer.
+ *
+ * @param container - The @solid-stack/di Container instance.
+ * @param options - Optional configuration including feature directory path.
+ */
+export declare const start: (container: Container, options?: StartOptions) => Promise<void>;
+//# sourceMappingURL=start.d.ts.map

package/dist/core/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/core/start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,cACL,SAAS,YACV,YAAY,KACrB,OAAO,CAAC,IAAI,CAsBd,CAAC"}