@nexo-alpha/core 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,74 @@
+# @nexo-alpha/core
+
+Core application runtime for **Nexo** — a lightweight Node.js framework designed to make software projects understandable, navigable, and safely operable by both human developers and AI development tools.
+
+`@nexo/core` has **zero runtime dependencies** and never depends on an HTTP framework, a database, or an AI provider. It only defines the application model: applications, modules, services, APIs, lifecycle, and the application-level knowledge (decisions, constraints, development state) that keeps a project's intent alongside its code.
+
+## Install
+
+```bash
+npm install @nexo-alpha/core
+```
+
+## Why
+
+Most frameworks help you build an application but don't give an AI tool (or a new teammate) a structured way to understand it without reading the entire codebase. `@nexo/core` gives an application a place to declare *what it is*, not just *what it does* — module purpose, ownership of APIs/services, dependencies between modules, and the current state of development.
+
+## Usage
+
+```ts
+import { createApplication } from "@nexo-alpha/core";
+
+const app = createApplication({
+  name: "shop",
+  version: "0.1.0",
+  description: "A commerce platform"
+});
+
+app.module({
+  name: "payments",
+  purpose: "Handle customer payments",
+  status: "in-progress",
+  dependencies: ["stripe", "orders"],
+  apis: [{ name: "createPayment", method: "POST", path: "/payments" }],
+  services: [{ name: "PaymentService" }]
+});
+
+app.addDecision({
+  title: "Payment records are immutable",
+  reason: "Auditability of financial history.",
+  status: "accepted"
+});
+
+app.setDevelopmentState({
+  currentObjective: "Implement payment recovery",
+  completed: ["Retry API"],
+  inProgress: ["Retry worker"]
+});
+
+await app.start();
+
+app.getDependents("orders"); // -> ["payments"]
+```
+
+## What's here
+
+- **Application lifecycle** — `createApplication`, `start()`/`stop()`, module `initialize`/`start`/`stop` hooks
+- **Module model** — `purpose`, `status`, `dependencies`, `apis`, `services`, `events`, `jobs`
+- **Dependency graph** — `getDependencies(name)` / `getDependents(name)`
+- **Events** — a plain `NexoEventBus` (wraps `node:events`) via `app.events`
+- **Configuration** — `getConfig(key)` / `getAllConfig()`
+- **Knowledge records** — `addDecision`/`getDecisions`, `addConstraint`/`getConstraints`, `setDevelopmentState`/`getDevelopmentState`
+
+## Related packages
+
+- [`@nexo-alpha/context`](https://www.npmjs.com/package/@nexo-alpha/context) — turns a running application into a JSON manifest
+- [`@nexo-alpha/tools`](https://www.npmjs.com/package/@nexo-alpha/tools) — a structured, read-only interface for AI development tools
+
+## Status
+
+**v0.1-alpha.** No CLI, no HTTP adapter, and no write/mutation AI operations yet — read-only, declarative model first.
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -1,4 +1,11 @@
 export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+export interface NexoRequestContext {
+    readonly params: Readonly<Record<string, string>>;
+    readonly query: Readonly<Record<string, unknown>>;
+    readonly payload: unknown;
+    readonly headers: Readonly<Record<string, string>>;
+}
+export type NexoApiHandler = (context: NexoRequestContext) => unknown | Promise<unknown>;
 export interface NexoApi {
     readonly name: string;
     readonly method: HttpMethod;
@@ -6,5 +13,6 @@ export interface NexoApi {
     readonly description?: string;
     readonly purpose?: string;
     readonly dependencies?: readonly string[];
+    readonly handler?: NexoApiHandler;
 }
 //# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,GACR,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,MAAM,GACN,KAAK,GACL,OAAO,GACP,QAAQ,GACR,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,kBAAkB,KACxB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC"}

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { createApplication, NexoApplication } from "./application.js";
 export type { ApplicationOptions, ApplicationState } from "./application.js";
 export type { NexoModule } from "./module.js";
 export type { NexoService } from "./service.js";
-export type { NexoApi, HttpMethod } from "./api.js";
+export type { NexoApi, HttpMethod, NexoRequestContext, NexoApiHandler } from "./api.js";
 export type { NexoJob } from "./job.js";
 export type { NexoDecision } from "./decision.js";
 export type { NexoConstraint } from "./constraint.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,EACZ,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,OAAO,EACP,UAAU,EACX,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,OAAO,EACR,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,YAAY,EACb,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,EACZ,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,cAAc,EACf,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,OAAO,EACR,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,YAAY,EACb,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,aAAa,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAoC1B,OAAO,EACL,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAsC1B,OAAO,EACL,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "@nexo-alpha/core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Core runtime for the Nexo application framework",
+  "keywords": [
+    "nexo",
+    "framework",
+    "application-framework",
+    "ai-development",
+    "typescript",
+    "nodejs"
+  ],
+  "author": "prem1999",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",