coakka-v2-connector-node 1.3.6 → 1.3.7

package/README.md

@@ -27,13 +27,17 @@ bash run.sh runtime node basic
 No-checkout npm smoke:
 https://github.com/phuong-tran/coakka-samples/blob/main/docs/first-npm-smoke.md
 
-Try the npm package without cloning any CoAkka repo:
+Samples docs directory:
+https://github.com/phuong-tran/coakka-samples/tree/main/docs
+
+Try the npm package without cloning any CoAkka repo. The example uses the same
+customer command that often becomes fake backend HTTP in a growing app:
 
 ```sh
 mkdir coakka-runtime-first-run
 cd coakka-runtime-first-run
 npm init -y
-npm install coakka-v2-connector-node@1.3.6
+npm install coakka-v2-connector-node@1.3.7
 ```
 
 ```js
@@ -46,10 +50,12 @@ import {
   RuntimeHost,
 } from "coakka-v2-connector-node";
 
-const target = "first.user.echo";
+const target = "samples.customer.store.create";
+const store = new Map();
+
 const runtime = RuntimeHost.start({
-  systemName: "first-user-runtime",
-  nodeId: "first-user-runtime-node",
+  systemName: "customer-app",
+  nodeId: "customer-app-node-1",
   queueCapacity: 64,
   strictNoDrop: true,
   generation: 1,
@@ -57,16 +63,25 @@ const runtime = RuntimeHost.start({
 });
 
 try {
-  runtime.registerHandler(target, (request) =>
-    NodeRuntimeClient.makeJsonReplyFromRequestIdentity(request, target, { ok: true }),
-  );
+  runtime.registerHandler(target, (request) => {
+    const draft = JSON.parse(Buffer.from(request.payload).toString("utf8"));
+    const customer = { id: draft.id, name: draft.name, createdBy: request.source };
+    store.set(customer.id, customer);
+
+    return NodeRuntimeClient.makeJsonReplyFromRequestIdentity(request, target, {
+      status: "created",
+      customer,
+      storedCount: store.size,
+    });
+  });
+
   const response = await runtime.askJson(
-    "first-user-client",
+    "customer-api",
     target,
-    { hello: "coakka" },
-    new PayloadIdentity("first.user.echo.request.v1", 1, PayloadFormat.JSON),
+    { id: "cust-001", name: "Ada Lovelace" },
+    new PayloadIdentity("samples.customer.create.request.v1", 1, PayloadFormat.JSON),
     2000,
-    "echo",
+    "create_customer",
     DeliveryHint.ROUTER_DEFAULT,
   );
   console.log(response);
@@ -101,75 +116,53 @@ Request/reply lane in Node.js now has two host API shapes over the same runtime
 
 ## Before / After
 
-Before, local application code had to start from the connector-internal
-orchestration name:
-
-```ts
-import {
-  ConnectorOrchestrator,
-  PayloadFormat,
-  PayloadIdentity,
-} from "coakka-v2-connector-node";
+Before, the browser/API edge can be real HTTP, but teams often add a second
+private backend HTTP endpoint only so work owned by the same app or team has
+an address:
 
-const connector = ConnectorOrchestrator.start({
-  systemName: "customer-local",
-  nodeId: "customer-local-node",
-  routes: [],
+```js
+app.post("/backend/customers", async (req, res) => {
+  const customer = await store.create(req.body);
+  res.json({ status: "created", customer });
 });
-const requestIdentity = new PayloadIdentity(
-  "customer.create.request.v1",
-  1,
-  PayloadFormat.JSON,
-);
-
-try {
-  const response = await connector.askJson(
-    "customer-api",
-    "customer.create",
-    { name: "Ada" },
-    requestIdentity,
-  );
-} finally {
-  connector.close();
-}
-```
 
-After, the same single-process runtime is named as the application-owned host:
+app.post("/api/customers", async (req, res) => {
+  const reply = await fetch("http://customer-store/backend/customers", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(req.body),
+  });
 
-```ts
-import {
-  PayloadFormat,
-  PayloadIdentity,
-  RuntimeHost,
-} from "coakka-v2-connector-node";
-
-const runtime = RuntimeHost.start({
-  systemName: "customer-local",
-  nodeId: "customer-local-node",
-  routes: [],
+  res.json(await reply.json());
 });
-const requestIdentity = new PayloadIdentity(
-  "customer.create.request.v1",
-  1,
-  PayloadFormat.JSON,
-);
+```
 
-try {
+After, the public API can stay HTTP, but the fake backend URL becomes a CoAkka
+target:
+
+```js
+app.post("/api/customers", async (req, res) => {
   const response = await runtime.askJson(
     "customer-api",
-    "customer.create",
-    { name: "Ada" },
-    requestIdentity,
+    "samples.customer.store.create",
+    req.body,
+    new PayloadIdentity("samples.customer.create.request.v1", 1, PayloadFormat.JSON),
+    5000,
+    "create_customer",
+    DeliveryHint.ROUTER_DEFAULT,
   );
-} finally {
-  runtime.close();
-}
+
+  res.json(response);
+});
 ```
 
-`ConnectorOrchestrator` remains available for existing code. New local-first
-Spring Boot, Quarkus, CRUD, and script-style examples should prefer
-`RuntimeHost` so the first screen reads as one embedded runtime owner, not a
-remote connector setup.
+The change is not "replace HTTP." HTTP still belongs at real browser/API or
+legacy edges. CoAkka removes backend HTTP that exists only to call capabilities
+owned by the same app or team by URL.
+
+`ConnectorOrchestrator` remains available for existing code. New examples
+prefer `RuntimeHost` so the first screen reads as one embedded runtime owner,
+not a remote connector setup.
 
 `separateDeliveredRequestLane` defaults to `true`. Most request/reply services
 should leave it alone so inbound handler work stays separate from

package/package.json

@@ -1,16 +1,15 @@
 {
   "name": "coakka-v2-connector-node",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "description": "Node.js connector package for the CoAkka runtime v2",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/phuong-tran/coakkaJVMConnector.git",
-    "directory": "node"
+    "url": "git+https://github.com/phuong-tran/coakka-publish.git"
   },
   "homepage": "https://github.com/phuong-tran/coakka-samples/blob/main/docs/first-npm-smoke.md",
   "bugs": {
-    "url": "https://github.com/phuong-tran/coakkaJVMConnector/issues"
+    "url": "https://github.com/phuong-tran/coakka-samples/issues"
   },
   "keywords": [
     "coakka",