@laserdata/laser-sdk 0.0.1-rc.2 → 0.0.1-rc.21

package/README.md

@@ -4,7 +4,7 @@ The native TypeScript client for LaserData over Apache Iggy. It provides typed s
 
 This prerelease targets Node 22.14 or later. Bun, Deno, and browsers are not supported because the Apache Iggy transport uses Node TCP and TLS APIs.
 
-> **Prerelease (`0.0.1-rc.2`).** Pin an exact version while the public API and wire contract are still in release-candidate development.
+> **Prerelease (`0.0.1-rc.21`).** Pin an exact version while the public API and wire contract are still in release-candidate development.
 
 ## Install
 
@@ -32,9 +32,9 @@ console.log(`read ${records.length} order(s)`)
 
 Use the bare `user:password@host:port` connection string. The SDK supplies the Apache Iggy TCP scheme internally. One connection addresses every stream on the server. Select a stream explicitly with `laser.stream(name)`, then a topic with `.topic(name)`. `Laser.connectWithStream()` only pins a default stream so `laser.topic(name)` can be used as a shortcut. It does not limit the connection to that stream. `Laser.connectEnv()` reads `LASER_CONNECTION_STRING` and the optional `LASER_STREAM`. `Laser.local()` targets the default local server. `Laser.builder()` accepts a connection string, an address and credentials, or an injected Apache Iggy client with explicit owned or borrowed lifetime.
 
-Owned connections retry the initial handshake and reconnect after a dropped socket, with unlimited retries at one-second intervals by default. Set `reconnection_retries` to a non-negative integer and `reconnection_interval` to `250ms`, `1s`, or `1m` in the connection string to tune the policy. Laser owns this loop because the upstream Node reconnect path can leave its connect promise pending. An injected client remains under its caller's lifecycle and reconnect policy.
+Owned connections retry the initial handshake and reconnect after a dropped socket, with unlimited retries at one-second intervals by default. Set `reconnection_retries` to a non-negative integer and `reconnection_interval` to `250ms`, `1s`, or `1m` in the connection string to tune the policy. An injected client remains under its caller's lifecycle and reconnect policy.
 
-LaserData Cloud hostnames automatically use TLS with the public LaserData root CA embedded in the package. `LASER_TLS_CERT` selects another CA file and `LASER_NO_TLS` disables automatic TLS. Other hosts keep the connection string's TLS settings unchanged.
+The TypeScript SDK pins Apache Iggy `0.8.1-edge.3` and always constructs a VSR client. There is no protocol option in the Laser API. An injected Apache Iggy client must also use VSR and is rejected before use otherwise.
 
 ## Streaming model
 
@@ -81,14 +81,14 @@ Registered Avro, Protobuf, and JSON Schema topics compile the writer schema once
 
 ## Managed data surfaces
 
-LaserData Cloud announces its capabilities during connection setup. Stock Apache Iggy serves streaming and returns `UnsupportedError` for managed calls. The same client code can feature-detect through `laser.capabilities()`.
+LaserData Cloud and Laser Stack announce their capabilities during connection setup. Apache Iggy without a managed backend serves streaming and returns `UnsupportedError` for managed calls. The same client code can feature-detect through `laser.capabilities()`.
 
 The root client exposes query, projections, bindings, schemas, key-value and CAS, forks, graph traversal, RBAC, runs, watch feeds, and independent managed command batches. Query uses the managed command path, not a request topic. Every command is encoded through the same Rust-owned AGDX fixtures consumed by the other SDKs.
 
 ```ts
 import { graphNodeEntity } from "@laserdata/laser-sdk"
 
-const paid = await laser.query("orders_v1").filterEq("status", "paid").limit(20).fetch()
+const paid = await laser.query("orders_v1").whereEq("status", "paid").limit(20).fetch()
 
 const key = new TextEncoder().encode("user:42")
 const session = { cart: ["sku-1"] }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laserdata/laser-sdk",
-  "version": "0.0.1-rc.2",
+  "version": "0.0.1-rc.21",
   "description": "LaserData SDK for TypeScript: an open data-platform SDK over Apache Iggy (typed streaming, declared projections and a query DSL, a key-value store, copy-on-write forks, and an optional agent runtime with AGDX)",
   "type": "module",
   "main": "./dist/index.js",
@@ -64,7 +64,8 @@
     "test:unit": "node ./scripts/run-tests.mjs unit",
     "test:wire": "node ./scripts/run-tests.mjs wire",
     "test:robustness": "node ./scripts/run-tests.mjs robustness",
-    "test:integration": "node ./scripts/run-tests.mjs integration",
+    "test:integration": "npm run build:test && node ../../scripts/run-with-test-iggy.mjs npm run test:integration:run",
+    "test:integration:run": "node ./scripts/run-tests.mjs integration",
     "test": "npm run test:unit && npm run test:wire && npm run test:robustness",
     "coverage": "c8 --all --src src --check-coverage --lines 70 --functions 70 --branches 60 --statements 70 node ./scripts/run-tests.mjs unit wire robustness",
     "pack:check": "node ./scripts/pack-check.mjs",
@@ -82,9 +83,9 @@
     "@noble/hashes": "2.2.0",
     "@types/node": "22.20.1",
     "ajv": "8.20.0",
-    "apache-iggy": "0.8.1-edge.2",
+    "apache-iggy": "0.8.1-edge.3",
     "avsc": "5.7.9",
-    "cborg": "^5.1.8",
+    "cborg": "^6.1.1",
     "protobufjs": "8.7.1"
   },
   "devDependencies": {
@@ -92,8 +93,8 @@
     "@microsoft/api-extractor": "^7.58.12",
     "@typescript/native": "npm:typescript@7.0.2",
     "c8": "^12.0.0",
-    "eslint": "10.7.0",
-    "globals": "17.7.0",
+    "eslint": "10.8.0",
+    "globals": "17.8.0",
     "prettier": "3.9.6",
     "typescript": "npm:@typescript/typescript6@6.0.3",
     "typescript-eslint": "8.65.0"