@xiara/core and @xiara/web is a framework for building efficient, scalable Node.js server-side applications. It uses modern JavaScript, is built with TypeScript (preserves compatibility with pure JavaScript) and combines elements of OOP (Object Oriented Programming), FP (Functional Programming), and FRP (Functional Reactive Programming).
Under the hood, Xiara makes use of Express, allowing for easy use of the third-party plugins.
Xiara also features mongodb support out of the box via @xiara/mongo package
I have been continuing adding new features and extending the functionalities of the framework, heres a short summary:
@ xiara/web:
@ xiara/mongo:
@ xiara/core
Responses are an interesting part of the framework. They just make life easier!
Let's see how they work.
First let's create a simple response:
import { Response, IResponseType } from "@xiara/core";
@Response({ name: "error" })
export class ErrorResponse
{
constructor(public logging: LogService) {}
send(req, res, errorType: string = "UnkownError", errorMessage: string = "Something went wrong")
{
this.logging.logError(errorType, errorMessage);
res.status(500);
res.json({
error: true,
type: errorType,
message: errorMessage,
});
}
}
The above response object simply binds to the res property as function and can be called anywhere in the framework res.error(errorType:string, errorMessage: string).
All we have left is to add it to our module.
import { WebModule } from "@xiara/web";
import { ErrorResponse } from "./ErrorResponse";
@WebModule({
responses: [
ErrorResponse,
]
})
export class AppModule
{
}
And that would be it, no magic needed here. Now we can use the predefined response in our app anywhere, in controllers, in routes or in policies.
Using a responses in a controller
import { Controller, GET } from "@xiara/web";
@Controller({
path: "/"
})
export class TodoController
{
@GET("/error")
testError(req, res)
{
res.error("SomethingIsWrong", "This error message just work!");
}
}
Sadly this is not the way i originally imagined as there are no typing informations available about the responses yet. I am still researching a better way of doing this in typescript. Probably interface merging or similar features would allow typings and IDE autocomplete. But for now it provides the functionality so stay tuned :)
The project is split into multiple repositories as i am to create reusable packages and it's also easier to manage updates for me. I've also created an organization to easier keep track of this project.
@ xiara/web
https://github.com/xiara-io/xiara-web/commit/8e698fd4db90dad95ec2b39190b9666771999a9f
https://github.com/xiara-io/xiara-web/commit/ed8ef4fdfe742340326cab38b1a99f057d447026
https://github.com/xiara-io/xiara-web/commit/d3b6f4ed87470b4cf4aa004a638f77408f988171
https://github.com/xiara-io/xiara-web/commit/6c8b3b8f79e02e1bc82f1500793ee51505170c97
@ xiara/mongo
https://github.com/xiara-io/xiara-mongo/commit/0b7b903ede2ab74c310350c340e2ad07617c5118
https://github.com/xiara-io/xiara-mongo/commit/ce93adda83b335124f1142f9848647224467d9eb
https://github.com/xiara-io/xiara-mongo/commit/b33a76bf07c2e6d29b47874172673f0c2843606e
https://github.com/xiara-io/xiara-mongo/commit/f34d58ddd1a3e0a824edc60cec4994cf4ca0b043
@ xiara/core
https://github.com/xiara-io/xiara-core/commit/51a3f86bc5a39b79bfdc62d43718dfd09bf59249
https://github.com/xiara-io/xiara-core/commit/e58755812d5d6fa6ee969ae820b6503795a28f47
https://github.com/xiara-io/xiara-core/commit/5184d5372bcc3d9cb6a4b80eec110e753c01cc88
My vision on the project is that theres still a long way to go to implement all the funcitonalities a modern backend framework would require. But even then i am pretty happy with the progress and the framework turns out to be very useful in my projects.
For the next weeks i put the following on the road-map:
If you found any bugs, have suggestions, or just a question please open an issue on github.
https://github.com/xiara-io/xiara-web/issues
https://github.com/xiara-io/xiara-core/wiki (for future readers as api reference & documentation)
MIT
