@celerity-sdk/runtime 0.2.0

package/.env.test

@@ -0,0 +1,4 @@
+CELERITY_VARIABLE_secretStoreId=test-secret-store
+CELERITY_VARIABLE_certificateId=test-certificate
+CELERITY_VARIABLE_logLevel=DEBUG
+CELERITY_VARIABLE_paymentApiSecret=test-payment-api-secret

package/.vscode/settings.json

@@ -0,0 +1,4 @@
+{
+  "editor.formatOnSave": true,
+  "rust-analyzer.procMacro.ignored": { "napi-derive": ["napi"] }
+}

package/.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## [0.2.0](https://github.com/newstack-cloud/celerity/compare/runtime-sdk-node/v0.1.0...runtime-sdk-node/v0.2.0) (2026-02-08)
+
+
+### Features
+
+* **lib-rt-sdk-node:** add full support for http features ([6536d24](https://github.com/newstack-cloud/celerity/commit/6536d2495ba614178b661578a9f1f0fd15e899e2))
+
+## 1.0.0 (2026-02-08)
+
+
+### Features
+
+* **lib-rt-sdk-node:** add full support for http features ([6536d24](https://github.com/newstack-cloud/celerity/commit/6536d2495ba614178b661578a9f1f0fd15e899e2))

package/CONTRIBUTING.md

@@ -0,0 +1,121 @@
+# Contributing to Celerity Runtime SDK for Node.js
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org/) >=22.0.0
+- [Rust](https://www.rust-lang.org/tools/install) >=1.76.0
+- [Yarn](https://yarnpkg.com/) (will be installed via corepack)
+- [Git](https://git-scm.com/)
+
+## Installation
+
+1. **Enable corepack (if not already enabled):**
+   ```bash
+   corepack enable
+   ```
+
+2. **Install dependencies:**
+   ```bash
+   yarn install
+   ```
+
+## Development
+
+### Building
+
+Build the native module for all platforms:
+
+```bash
+yarn build
+```
+
+Build for a specific target:
+
+```bash
+yarn build --target x86_64-apple-darwin
+yarn build --target aarch64-unknown-linux-gnu
+yarn build --target x86_64-pc-windows-msvc
+```
+
+### Running Tests
+
+```bash
+yarn test
+```
+
+### Development Build
+
+For faster iteration during development:
+
+```bash
+yarn build:debug
+```
+
+## Releasing
+
+To release a new version of the Node.js Runtime SDK, follow these steps:
+
+### Pre-Release Checklist:
+
+1. **Update Version in package.json**
+   ```bash
+   # Edit libs/runtime/sdk/node/package.json
+   # Change the version field to match your release
+   "version": "1.2.3"
+   ```
+
+2. **Update Version in Cargo.toml**
+   ```bash
+   # Edit libs/runtime/sdk/node/Cargo.toml
+   # Change the version field to match your release
+   version = "1.2.3"
+   ```
+
+3. **Commit the Version Changes**
+   ```bash
+   git add libs/runtime/sdk/node/package.json libs/runtime/sdk/node/Cargo.toml
+   git commit -m "chore(lib-rt-sdk-node): bump version to 1.2.3"
+   git push origin main
+   ```
+
+4. **Create and Push Release Tag**
+   ```bash
+   # Note: Use 'v' prefix in the tag name
+   git tag -a libs/runtime/sdk/node-v1.2.3 -m "Release Celerity Runtime SDK for Node.js v1.2.3"
+   git push origin libs/runtime/sdk/node-v1.2.3
+   ```
+
+### Version Format Guidelines:
+
+- **package.json**: Use `"1.2.3"` (no 'v' prefix)
+- **Cargo.toml**: Use `1.2.3` (no 'v' prefix)
+- **Git Tags**: Use `libs/runtime/sdk/node-v1.2.3` (with 'v' prefix)
+- **NPM Package**: Will be published as `@celerity-sdk/runtime 1.2.3`
+
+### What Happens After Tagging:
+
+1. **CI/CD Pipeline**: The GitHub Actions workflow will automatically:
+   - Build native modules for all supported platforms
+   - Run tests across multiple Node.js versions and platforms
+   - Extract version from tag (e.g., `v1.2.3` from `libs/runtime/sdk/node-v1.2.3`)
+   - Publish to NPM as `@celerity-sdk/runtime 1.2.3`
+
+2. **Verification**: Check that the package is available on NPM:
+   ```bash
+   npm install @celerity-sdk/runtime@1.2.3
+   ```
+
+### Supported Platforms:
+
+The SDK is built and tested for the following platforms:
+
+- **macOS**: x86_64, aarch64 (Apple Silicon)
+- **Linux**: x86_64 (GNU), x86_64 (musl), aarch64 (GNU), aarch64 (musl)
+- **Windows**: x86_64, aarch64
+- **FreeBSD**: x86_64
+
+### Important Notes:
+
+- All tests must pass before the package is published
+- Cross-platform compatibility is verified automatically
+- The published package version will be clean (no monorepo prefixes)

package/Cargo.toml

@@ -0,0 +1,38 @@
+[package]
+edition = "2021"
+name = "celerityjs-runtime-sdk"
+version = "0.0.0"
+license.workspace = true
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+# Default enable napi4 feature, see https://nodejs.org/api/n-api.html#node-api-version-matrix
+napi = { version = "3.8", default-features = false, features = [
+    "napi4",
+    "async",
+    "serde-json",
+] }
+napi-derive = "3"
+tokio = "1.39.2"
+axum = "0.8.4"
+serde = "1.0.204"
+serde_json = "1.0.122"
+chrono = "0.4"
+tracing = "0.1.40"
+tracing-core = "0.1.32"
+tracing-subscriber = { version = "0.3.20", features = ["chrono", "json"] }
+
+[dependencies.celerity_runtime_core]
+path = "../../core"
+
+[dependencies.celerity_helpers]
+path = "../../helpers"
+
+[build-dependencies]
+napi-build = "2"
+
+[profile.release]
+lto = true
+strip = "symbols"

package/README.md

@@ -0,0 +1,7 @@
+# Celerity Runtime SDK for Node.js
+
+This is the Celerity Runtime SDK for Node.js. It provides a set of APIs to launch
+and interact with a Celerity Runtime application.
+
+This is a low-level library that in most cases does not need to be used directly. Instead,
+you should use the higher-level SDKs such as `@celerity-sdk/handlers`.

package/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+  napi_build::setup();
+}

package/index.d.ts

@@ -0,0 +1,96 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+export declare class CoreRuntimeApplication {
+  constructor(runtimeConfig: CoreRuntimeConfig)
+  setup(): CoreRuntimeAppConfig
+  registerHttpHandler(path: string, method: string, timeoutSeconds: number | undefined | null, handler: (err: Error | null, request: Request) => Promise<Response>): void
+  run(block: boolean): Promise<void>
+  shutdown(): void
+}
+
+export declare class Request {
+  /**
+   * Allows the creation of requests, primarily for test purposes.
+   * In normal circumstances, the request will be created by
+   * the runtime and passed to the handler.
+   */
+  constructor(method: string, uri: string, headers: Record<string, string>)
+  /** The HTTP version used for the request. */
+  get httpVersion(): string
+  /** The HTTP method of the request. */
+  get method(): string
+  /** The URI of the request. */
+  get uri(): string
+  /** The headers of the request as a map of header name to list of values. */
+  get headers(): Record<string, Array<string>>
+  /** The path of the request (e.g. "/orders/123"). */
+  get path(): string
+  /** Path parameters extracted from the URL (e.g. { "orderId": "123" }). */
+  get pathParams(): Record<string, string>
+  /** Query parameters, supporting multiple values per key. */
+  get query(): Record<string, Array<string>>
+  /** Cookies from the request. */
+  get cookies(): Record<string, string>
+  /** The content type of the request body. */
+  get contentType(): string
+  /** The request ID (from x-request-id header or auto-generated). */
+  get requestId(): string
+  /** The request time as an ISO 8601 string. */
+  get requestTime(): string
+  /** Authentication claims from the auth middleware, or null if no auth. */
+  get auth(): any | null
+  /** The client IP address resolved by the runtime. */
+  get clientIp(): string
+  /**
+   * The trace context for distributed tracing propagation.
+   * Contains "traceparent" (W3C) and optionally "xray_trace_id" (AWS).
+   */
+  get traceContext(): Record<string, string> | null
+  /** The user-agent string from the request. */
+  get userAgent(): string
+  /** The matched route pattern (e.g. "/orders/{orderId}"), or null if unavailable. */
+  get matchedRoute(): string | null
+  /** The text body of the request, or null if the body is empty or binary. */
+  get textBody(): string | null
+  /** The binary body of the request as a Buffer, or null if the body is empty or text. */
+  get binaryBody(): Buffer | null
+}
+export type JsRequestWrapper = Request
+
+export interface CoreApiConfig {
+  http?: CoreHttpConfig
+  websocket?: CoreWebsocketConfig
+}
+
+export interface CoreHttpConfig {
+  handlers: Array<CoreHttpHandlerDefinition>
+}
+
+export interface CoreHttpHandlerDefinition {
+  path: string
+  method: string
+  location: string
+  handler: string
+  timeout: number
+}
+
+export interface CoreRuntimeAppConfig {
+  api?: CoreApiConfig
+}
+
+export interface CoreRuntimeConfig {
+  blueprintConfigPath: string
+  serverPort: number
+  serverLoopbackOnly?: boolean
+}
+
+export interface CoreWebsocketConfig {
+
+}
+
+export interface Response {
+  status: number
+  headers?: Record<string, string>
+  body?: string
+  binaryBody?: Buffer
+}