1601660160
wolkenkit is a CQRS and event-sourcing framework based on Node.js. It empowers you to build and run scalable distributed web and cloud services that process and store streams of domain events. It supports JavaScript and TypeScript, and is available under an open-source license. Additionally, there are also enterprise add-ons. Since it works especially well in conjunction with domain-driven design (DDD), wolkenkit is the perfect backend framework to shape, build, and run web and cloud APIs.
BEWARE: This README.md refers to the wolkenkit 4.0 community technology preview (CTP) 6. If you are looking for the latest stable release of wolkenkit, see the wolkenkit documentation.
Category | Status |
---|---|
Version | |
Dependencies | |
Dev dependencies | |
Build | |
License |
First you have to initialize a new application. For this, execute the following command and select a template and a language. The application is then created in a new subdirectory:
$ npx wolkenkit@4.0.0-ctp.6 init <name>
Next, you need to install the application dependencies. To do this, change to the application directory and run the following command:
$ npm install
Finally, from within the application directory, run the application in local development mode by executing the following command:
$ npx wolkenkit dev
Please note that the local development mode processes all data in-memory only, so any data will be lost when the application is closed.
To send commands or receive domain events, the current version offers an HTTP and a GraphQL interface.
wolkenkit provides two primary endpoints in local development mode:
http://localhost:3000/command/v2/:contextName/:aggregateName/:commandName
submits commands for new aggregateshttp://localhost:3000/command/v2/:contextName/:aggregateName/:aggregateId/:commandName
submits commands for existing aggregateshttp://localhost:3000/views/v2/:viewName/:queryName
queries viewshttp://localhost:3000/domain-events/v2
subscribes to domain eventshttp://localhost:3000/notifications/v2
subscribes to notificationsAdditionally, the following secondary endpoints are available as well:
http://localhost:3000/command/v2/cancel
cancels a submitted, but not yet handled commandhttp://localhost:3000/command/v2/description
fetches a JSON description of all available commandshttp://localhost:3000/domain-events/v2/description
fetches a JSON description of all available domain eventshttp://localhost:3000/open-api/v2
provides an OpenAPI description of the HTTP interfacehttp://localhost:3001/health/v2
fetches health dataTo send a command, send a POST
request with the following JSON data structure in the body to the command endpoint of the runtime. Of course, the specific names of the context, the aggregate and the command itself, as well as the aggregate id and the command’s data depend on the domain you have modeled:
{
"text": "Hello, world!"
}
A sample call to curl
might look like this:
$ curl \
-i \
-X POST \
-H 'content-type: application/json' \
-d '{"text":"Hello, world!"}' \
http://localhost:3000/command/v2/communication/message/send
If you want to address an existing aggregate, you also have to provide the aggregate’s id:
$ curl \
-i \
-X POST \
-H 'content-type: application/json' \
-d '{}' \
http://localhost:3000/command/v2/communication/message/d2edbbf7-a515-4b66-9567-dd931f1690d3/like
####### Cancelling a command
To cancel a command, send a POST
request with the following JSON data structure in the body to the cancel endpoint of the runtime. Of course, the specific names of the context, the aggregate and the command itself, as well as the aggregate id and the command’s data depend on the domain you have modeled:
{
"contentIdentifier": { "name": "communication" },
"aggregateIdentifier": { "name": "message", "id": "d2edbbf7-a515-4b66-9567-dd931f1690d3" },
"name": "send",
"id": "<command-id>"
}
A sample call to curl
might look like this:
$ curl \
-i \
-X POST \
-H 'content-type: application/json' \
-d '<json>' \
http://localhost:3000/command/v2/cancel
Please note that you can cancel commands only as long as they are not yet being processed by the domain.
To query a view, send a GET
request to the views endpoint of the runtime. The response is a stream of newline separated JSON objects, using application/x-ndjson
as its content-type. This response stream does not contain heartbeats and ends as soon as the last item is streamed.
A sample call to curl
might look like this:
$ curl \
-i \
http://localhost:3000/views/v2/messages/all
To receive notifications, send a GET
request to the notifications endpoint of the runtime. The response is a stream of newline-separated JSON objects, using application/x-ndjson
as its content-type. From time to time, a heartbeat
will be sent by the server as well, which you may want to filter.
A sample call to curl
might look like this:
$ curl \
-i \
http://localhost:3000/notifications/v2
wolkenkit provides a GraphQL endpoint under the following address:
http://localhost:3000/graphql/v2
You can use it to submit commands and subscribe to domain events, however cancelling commands is currently not supported. If you point your browser to this endpoint, you will get an interactive GraphQL playground.
To send a command, send a mutation with the following data structure to the GraphQL endpoint of the runtime. Of course, the specific names of the context, the aggregate and the command itself, as well as the aggregate id and the command’s data depend on the domain you have modeled:
mutation {
command {
communication_message_send(aggregateIdentifier: { id: "d2edbbf7-a515-4b66-9567-dd931f1690d3" }, data: { text: "Hello, world!" }) {
id,
aggregateIdentifier {
id
}
}
}
}
####### Cancelling a command
To cancel a command, send a mutation with the following data structure to the GraphQL endpoint of the runtime. Of course, the specific names of the context, the aggregate and the command itself, as well as the aggregate id and the command’s data depend on the domain you have modeled:
mutation {
cancel(commandIdentifier: {
contextIdentifier: { name: "communication" },
aggregateIdentifier: { name: "message", id: "d2edbbf7-a515-4b66-9567-dd931f1690d3" },
name: "send",
id: "0a2d394c-2873-4643-84fd-dbcc43d80c5b"
}) {
success
}
}
Please note that you can cancel commands only as long as they are not yet being processed by the domain.
####### Qerying a view
To query a view, send a query to the GraphQL endpoint of the runtime:
query {
messages {
all {
id
timestamp
text
likes
}
}
}
To receive domain events, send a subscription to the GraphQL endpoint of the runtime. The response is a stream of objects, where the domain events’ data
has been stringified:
subscription {
domainEvents {
contextIdentifier { name },
aggregateIdentifier { name, id },
name,
id,
data
}
}
To receive notifications, send a subscription to the GraphQL endpoint of the runtime. The response is a stream of objects, where the domain events’ data
has been stringified:
subscription {
notifications {
name,
data
}
}
wolkenkit provides a file storage service that acts as a facade to a storage backend such as S3 or the local file system. It can be addressed using an HTTP API.
wolkenkit provides three primary endpoints in local development mode:
http://localhost:3000/files/v2/add-file
adds a filehttp://localhost:3000/files/v2/file/:id
gets a filehttp://localhost:3000/files/v2/remove-file
removes a fileTo add a file, send a POST
request with the file to be stored in its body to the add-file endpoint of the runtime. Send the file’s id, its name and its content type using the x-id
, x-name
and content-type
headers.
A sample call to curl
might look like this:
$ curl \
-i \
-X POST \
-H 'x-id: 03edebb0-7a36-4902-a082-ef979982a12c' \
-H 'x-name: hello.txt' \
-H 'content-type: text/plain' \
-d 'Hello, world!' \
http://localhost:3000/files/v2/add-file
To get a file, send a GET
request with the file id as part of the URL to the file endpoint of the runtime.
A sample call to curl
might look like this:
$ curl \
-i \
http://localhost:3000/files/v2/file/03edebb0-7a36-4902-a082-ef979982a12c
You will get the file’s id, name and its content-type in the x-id
, x-name
and content-type
headers.
To remove a file, send a POST
request with the following JSON structure to the remove-file endpoint of the runtime:
{
"id": "03edebb0-7a36-4902-a082-ef979982a12c"
}
A sample call to curl
might look like this:
$ curl \
-i \
-X POST \
-H 'content-type: application/json' \
-d '{"id":"03edebb0-7a36-4902-a082-ef979982a12c"}' \
http://localhost:3000/files/v2/remove-file
For authentication wolkenkit relies on OpenID Connect, so to use authentication you have to set up an external identity provider such as Auth0 or Keycloak.
Configure it to use the implicit flow, copy its certificate to your application directory, and set the --identity-provider-issuer
and --identity-provider-certificate
flags when running npx wolkenkit dev
. For details, see the CLI’s integrated help. Please make sure that your identity provider issues token using the RS256
algorithm, otherwise wolkenkit won’t be able to decode and verify the token.
If a user tries to authenticate with an invalid or expired token, they will receive a 401
. If the user doesn’t send a token at all, they will be given a token that identifies them as anonymous
. By default, you can not differentiate between multiple anonymous users. If you need this, set the x-anonymous-id
header in the client accordingly.
To package the application into a Docker image, change to the application directory and run the following command. Assign a custom tag to name the Docker image:
$ docker build -t <tag> .
Then you can push the created Docker image into a registry of your choice, for example to use it in Kubernetes.
docker-compose
Once you have built the Docker image, you can use docker-compose
to run the application. The application directory contains a subdirectory named deployment/docker-compose
, which contains ready-made scripts for various scenarios.
Basically, you can choose between the single-process runtime and the microservice runtime. While the former runs the entire application in a single process, the latter splits the different parts of the application into different processes, each of which you can then run on a separate machine.
Using docker-compose
also allows you to connect your own databases and infrastructure components. For details see the respective scripts.
wolkenkit uses a number of stores to run your application. In the local development mode, these stores are all run in-memory, but if you run the application using Docker, you will probably want to use persistent data stores. The following databases are supported for the domain event store, the lock store, and the priority queue store:
Please note that MongoDB must be at least version 4.2, and that you need to run it as a replica set (a single node cluster is fine).
For details on how to configure the databases, please have a look at the source code. This will be explained in more detail in the final version of the documentation.
Also note that before the first use any database has to be set up using the wolkenkit CLI’s wolkenkit setup store ...
commands. Pleas look at the CLI’s documentation and the source code for this.
Please remember that this version is a community technology preview (CTP) of the upcoming wolkenkit 4.0. Therefore it is possible that not all provided features work as expected or that some features are missing completely.
BEWARE: Do not use the CTP for production use, it’s for getting a first impression of and evaluating the upcoming wolkenkit 4.0.
If you experience any difficulties, please create an issue and provide any steps required to reproduce the issue, as well as the expected and the actual result. Additionally provide the versions of wolkenkit and Docker, and the type and architecture of the operating system you are using.
Ideally you can also include a short but complete code sample to reproduce the issue. Anyway, depending on the issue, this may not always be possible.
To build this module use roboter:
$ npx roboter
While working on wolkenkit itself, it is sometimes necessary to publish an internal version to npm, e.g. to be able to install wolkenkit from the registry. To publish an internal version run the following commands:
$ npx roboter build && npm version 4.0.0-internal.<id> && npm publish --tag internal && git push && git push --tags
Author: thenativeweb
Demo: https://www.thenativeweb.io/wolkenkit/framework
Source Code: https://github.com/thenativeweb/wolkenkit
#nodejs #node #javascript
1632537859
Not babashka. Node.js babashka!?
Ad-hoc CLJS scripting on Node.js.
Experimental. Please report issues here.
Nbb's main goal is to make it easy to get started with ad hoc CLJS scripting on Node.js.
Additional goals and features are:
Nbb requires Node.js v12 or newer.
CLJS code is evaluated through SCI, the same interpreter that powers babashka. Because SCI works with advanced compilation, the bundle size, especially when combined with other dependencies, is smaller than what you get with self-hosted CLJS. That makes startup faster. The trade-off is that execution is less performant and that only a subset of CLJS is available (e.g. no deftype, yet).
Install nbb
from NPM:
$ npm install nbb -g
Omit -g
for a local install.
Try out an expression:
$ nbb -e '(+ 1 2 3)'
6
And then install some other NPM libraries to use in the script. E.g.:
$ npm install csv-parse shelljs zx
Create a script which uses the NPM libraries:
(ns script
(:require ["csv-parse/lib/sync$default" :as csv-parse]
["fs" :as fs]
["path" :as path]
["shelljs$default" :as sh]
["term-size$default" :as term-size]
["zx$default" :as zx]
["zx$fs" :as zxfs]
[nbb.core :refer [*file*]]))
(prn (path/resolve "."))
(prn (term-size))
(println (count (str (fs/readFileSync *file*))))
(prn (sh/ls "."))
(prn (csv-parse "foo,bar"))
(prn (zxfs/existsSync *file*))
(zx/$ #js ["ls"])
Call the script:
$ nbb script.cljs
"/private/tmp/test-script"
#js {:columns 216, :rows 47}
510
#js ["node_modules" "package-lock.json" "package.json" "script.cljs"]
#js [#js ["foo" "bar"]]
true
$ ls
node_modules
package-lock.json
package.json
script.cljs
Nbb has first class support for macros: you can define them right inside your .cljs
file, like you are used to from JVM Clojure. Consider the plet
macro to make working with promises more palatable:
(defmacro plet
[bindings & body]
(let [binding-pairs (reverse (partition 2 bindings))
body (cons 'do body)]
(reduce (fn [body [sym expr]]
(let [expr (list '.resolve 'js/Promise expr)]
(list '.then expr (list 'clojure.core/fn (vector sym)
body))))
body
binding-pairs)))
Using this macro we can look async code more like sync code. Consider this puppeteer example:
(-> (.launch puppeteer)
(.then (fn [browser]
(-> (.newPage browser)
(.then (fn [page]
(-> (.goto page "https://clojure.org")
(.then #(.screenshot page #js{:path "screenshot.png"}))
(.catch #(js/console.log %))
(.then #(.close browser)))))))))
Using plet
this becomes:
(plet [browser (.launch puppeteer)
page (.newPage browser)
_ (.goto page "https://clojure.org")
_ (-> (.screenshot page #js{:path "screenshot.png"})
(.catch #(js/console.log %)))]
(.close browser))
See the puppeteer example for the full code.
Since v0.0.36, nbb includes promesa which is a library to deal with promises. The above plet
macro is similar to promesa.core/let
.
$ time nbb -e '(+ 1 2 3)'
6
nbb -e '(+ 1 2 3)' 0.17s user 0.02s system 109% cpu 0.168 total
The baseline startup time for a script is about 170ms seconds on my laptop. When invoked via npx
this adds another 300ms or so, so for faster startup, either use a globally installed nbb
or use $(npm bin)/nbb script.cljs
to bypass npx
.
Nbb does not depend on any NPM dependencies. All NPM libraries loaded by a script are resolved relative to that script. When using the Reagent module, React is resolved in the same way as any other NPM library.
To load .cljs
files from local paths or dependencies, you can use the --classpath
argument. The current dir is added to the classpath automatically. So if there is a file foo/bar.cljs
relative to your current dir, then you can load it via (:require [foo.bar :as fb])
. Note that nbb
uses the same naming conventions for namespaces and directories as other Clojure tools: foo-bar
in the namespace name becomes foo_bar
in the directory name.
To load dependencies from the Clojure ecosystem, you can use the Clojure CLI or babashka to download them and produce a classpath:
$ classpath="$(clojure -A:nbb -Spath -Sdeps '{:aliases {:nbb {:replace-deps {com.github.seancorfield/honeysql {:git/tag "v2.0.0-rc5" :git/sha "01c3a55"}}}}}')"
and then feed it to the --classpath
argument:
$ nbb --classpath "$classpath" -e "(require '[honey.sql :as sql]) (sql/format {:select :foo :from :bar :where [:= :baz 2]})"
["SELECT foo FROM bar WHERE baz = ?" 2]
Currently nbb
only reads from directories, not jar files, so you are encouraged to use git libs. Support for .jar
files will be added later.
The name of the file that is currently being executed is available via nbb.core/*file*
or on the metadata of vars:
(ns foo
(:require [nbb.core :refer [*file*]]))
(prn *file*) ;; "/private/tmp/foo.cljs"
(defn f [])
(prn (:file (meta #'f))) ;; "/private/tmp/foo.cljs"
Nbb includes reagent.core
which will be lazily loaded when required. You can use this together with ink to create a TUI application:
$ npm install ink
ink-demo.cljs
:
(ns ink-demo
(:require ["ink" :refer [render Text]]
[reagent.core :as r]))
(defonce state (r/atom 0))
(doseq [n (range 1 11)]
(js/setTimeout #(swap! state inc) (* n 500)))
(defn hello []
[:> Text {:color "green"} "Hello, world! " @state])
(render (r/as-element [hello]))
Working with callbacks and promises can become tedious. Since nbb v0.0.36 the promesa.core
namespace is included with the let
and do!
macros. An example:
(ns prom
(:require [promesa.core :as p]))
(defn sleep [ms]
(js/Promise.
(fn [resolve _]
(js/setTimeout resolve ms))))
(defn do-stuff
[]
(p/do!
(println "Doing stuff which takes a while")
(sleep 1000)
1))
(p/let [a (do-stuff)
b (inc a)
c (do-stuff)
d (+ b c)]
(prn d))
$ nbb prom.cljs
Doing stuff which takes a while
Doing stuff which takes a while
3
Also see API docs.
Since nbb v0.0.75 applied-science/js-interop is available:
(ns example
(:require [applied-science.js-interop :as j]))
(def o (j/lit {:a 1 :b 2 :c {:d 1}}))
(prn (j/select-keys o [:a :b])) ;; #js {:a 1, :b 2}
(prn (j/get-in o [:c :d])) ;; 1
Most of this library is supported in nbb, except the following:
:syms
.-x
notation. In nbb, you must use keywords.See the example of what is currently supported.
See the examples directory for small examples.
Also check out these projects built with nbb:
See API documentation.
See this gist on how to convert an nbb script or project to shadow-cljs.
Prequisites:
To build:
bb release
Run bb tasks
for more project-related tasks.
Download Details:
Author: borkdude
Download Link: Download The Source Code
Official Website: https://github.com/borkdude/nbb
License: EPL-1.0
#node #javascript
1616671994
If you look at the backend technology used by today’s most popular apps there is one thing you would find common among them and that is the use of NodeJS Framework. Yes, the NodeJS framework is that effective and successful.
If you wish to have a strong backend for efficient app performance then have NodeJS at the backend.
WebClues Infotech offers different levels of experienced and expert professionals for your app development needs. So hire a dedicated NodeJS developer from WebClues Infotech with your experience requirement and expertise.
So what are you waiting for? Get your app developed with strong performance parameters from WebClues Infotech
For inquiry click here: https://www.webcluesinfotech.com/hire-nodejs-developer/
Book Free Interview: https://bit.ly/3dDShFg
#hire dedicated node.js developers #hire node.js developers #hire top dedicated node.js developers #hire node.js developers in usa & india #hire node js development company #hire the best node.js developers & programmers
1622719015
Front-end web development has been overwhelmed by JavaScript highlights for quite a long time. Google, Facebook, Wikipedia, and most of all online pages use JS for customer side activities. As of late, it additionally made a shift to cross-platform mobile development as a main technology in React Native, Nativescript, Apache Cordova, and other crossover devices.
Throughout the most recent couple of years, Node.js moved to backend development as well. Designers need to utilize a similar tech stack for the whole web project without learning another language for server-side development. Node.js is a device that adjusts JS usefulness and syntax to the backend.
Node.js isn’t a language, or library, or system. It’s a runtime situation: commonly JavaScript needs a program to work, however Node.js makes appropriate settings for JS to run outside of the program. It’s based on a JavaScript V8 motor that can run in Chrome, different programs, or independently.
The extent of V8 is to change JS program situated code into machine code — so JS turns into a broadly useful language and can be perceived by servers. This is one of the advantages of utilizing Node.js in web application development: it expands the usefulness of JavaScript, permitting designers to coordinate the language with APIs, different languages, and outside libraries.
Of late, organizations have been effectively changing from their backend tech stacks to Node.js. LinkedIn picked Node.js over Ruby on Rails since it took care of expanding responsibility better and decreased the quantity of servers by multiple times. PayPal and Netflix did something comparative, just they had a goal to change their design to microservices. We should investigate the motivations to pick Node.JS for web application development and when we are planning to hire node js developers.
The principal thing that makes Node.js a go-to environment for web development is its JavaScript legacy. It’s the most well known language right now with a great many free devices and a functioning local area. Node.js, because of its association with JS, immediately rose in ubiquity — presently it has in excess of 368 million downloads and a great many free tools in the bundle module.
Alongside prevalence, Node.js additionally acquired the fundamental JS benefits:
In addition, it’s a piece of a well known MEAN tech stack (the blend of MongoDB, Express.js, Angular, and Node.js — four tools that handle all vital parts of web application development).
This is perhaps the most clear advantage of Node.js web application development. JavaScript is an unquestionable requirement for web development. Regardless of whether you construct a multi-page or single-page application, you need to know JS well. On the off chance that you are now OK with JavaScript, learning Node.js won’t be an issue. Grammar, fundamental usefulness, primary standards — every one of these things are comparable.
In the event that you have JS designers in your group, it will be simpler for them to learn JS-based Node than a totally new dialect. What’s more, the front-end and back-end codebase will be basically the same, simple to peruse, and keep up — in light of the fact that they are both JS-based.
There’s another motivation behind why Node.js got famous so rapidly. The environment suits well the idea of microservice development (spilling stone monument usefulness into handfuls or many more modest administrations).
Microservices need to speak with one another rapidly — and Node.js is probably the quickest device in information handling. Among the fundamental Node.js benefits for programming development are its non-obstructing algorithms.
Node.js measures a few demands all at once without trusting that the first will be concluded. Many microservices can send messages to one another, and they will be gotten and addressed all the while.
Node.js was worked in view of adaptability — its name really says it. The environment permits numerous hubs to run all the while and speak with one another. Here’s the reason Node.js adaptability is better than other web backend development arrangements.
Node.js has a module that is liable for load adjusting for each running CPU center. This is one of numerous Node.js module benefits: you can run various hubs all at once, and the environment will naturally adjust the responsibility.
Node.js permits even apportioning: you can part your application into various situations. You show various forms of the application to different clients, in light of their age, interests, area, language, and so on. This builds personalization and diminishes responsibility. Hub accomplishes this with kid measures — tasks that rapidly speak with one another and share a similar root.
What’s more, Node’s non-hindering solicitation handling framework adds to fast, letting applications measure a great many solicitations.
Numerous designers consider nonconcurrent to be one of the two impediments and benefits of Node.js web application development. In Node, at whatever point the capacity is executed, the code consequently sends a callback. As the quantity of capacities develops, so does the number of callbacks — and you end up in a circumstance known as the callback damnation.
In any case, Node.js offers an exit plan. You can utilize systems that will plan capacities and sort through callbacks. Systems will associate comparable capacities consequently — so you can track down an essential component via search or in an envelope. At that point, there’s no compelling reason to look through callbacks.
So, these are some of the top benefits of Nodejs in web application development. This is how Nodejs is contributing a lot to the field of web application development.
I hope now you are totally aware of the whole process of how Nodejs is really important for your web project. If you are looking to hire a node js development company in India then I would suggest that you take a little consultancy too whenever you call.
Good Luck!
#node.js development company in india #node js development company #hire node js developers #hire node.js developers in india #node.js development services #node.js development
1616839211
Top organizations and start-ups hire Node.js developers from SISGAIN for their strategic software development projects in Illinois, USA. On the off chance that you are searching for a first rate innovation to assemble a constant Node.js web application development or a module, Node.js applications are the most appropriate alternative to pick. As Leading Node.js development company, we leverage our profound information on its segments and convey solutions that bring noteworthy business results. For more information email us at hello@sisgain.com
#node.js development services #hire node.js developers #node.js web application development #node.js development company #node js application
1624450037
Web development has been controlling the JavaScript system features for many years. Many big online sites use Java Script for their everyday operations. And recently there has been a change and a shift towards cross-platform mobile application development. The main software frameworks in work these days are React native, apache Cordova, native script and hybrid tools. In the last ten years, Node.JS has been used as a backend development framework. Developers nowadays want to learn and use the same technologies for one entire website. They do not want to learn an entire language for server development. And Node.JS is able to adapt all the functions and syntaxes to the backend services from JavaScript. If you do not know the languages or syntaxes for Node JS development, you can look for an online guide. These guides have a detailed overview of the additional functions and basic systems. You will also find simple tasks in these guides. To read more click on the link.
#node js development services #node js development #node js development company #hire node js developers #node js mobile app developmen #website developer