@stackables/bridge-stdlib 0.0.1 → 1.5.0

package/README.md

@@ -0,0 +1,38 @@
+[![github](https://img.shields.io/badge/github-stackables/bridge-blue?logo=github)](https://github.com/stackables/bridge)
+
+# The Bridge standard library
+
+The standard library for [The Bridge](https://github.com/stackables/bridge) — a collection of built-in tools: HTTP calls, string manipulation, array operations, audit logging, and input validation.
+
+You usually won't install this directly. It comes bundled with both [`@stackables/bridge`](https://www.npmjs.com/package/@stackables/bridge) and [`@stackables/bridge-core`](https://www.npmjs.com/package/@stackables/bridge-core).
+
+# Installing
+
+You might need to install this separately if you want to use different versions of standard library in your `.bridge` files or customise the http client cache handling.
+
+```bash
+npm install @stackables/bridge-stdlib
+```
+
+## Customizing httpCall
+
+The default `httpCall` uses `globalThis.fetch` and an in-memory LRU cache. If you need to swap in a custom fetch or plug in Redis for caching:
+
+```ts
+import { createHttpCall } from "@stackables/bridge-stdlib";
+
+// Use a custom fetch and a Redis-backed cache store
+const httpCall = createHttpCall(myCustomFetch, myRedisCacheStore);
+```
+
+Then pass it to the engine via the `tools` option.
+
+## Part of the Bridge Ecosystem
+
+| Package                                                                                    | What it does                                             |
+| ------------------------------------------------------------------------------------------ | -------------------------------------------------------- |
+| [`@stackables/bridge`](https://www.npmjs.com/package/@stackables/bridge)                   | **The All-in-One** — everything in a single install      |
+| [`@stackables/bridge-core`](https://www.npmjs.com/package/@stackables/bridge-core)         | **The Engine** — runs pre-compiled bridge instructions   |
+| [`@stackables/bridge-compiler`](https://www.npmjs.com/package/@stackables/bridge-compiler) | **The Parser** — turns `.bridge` text into instructions  |
+| [`@stackables/bridge-graphql`](https://www.npmjs.com/package/@stackables/bridge-graphql)   | **The Adapter** — wires bridges into a GraphQL schema    |
+| [`@stackables/bridge-types`](https://www.npmjs.com/package/@stackables/bridge-types)       | **Shared Types** — `ToolCallFn`, `ToolMap`, `CacheStore` |

package/build/index.d.ts

@@ -2,7 +2,7 @@
  * @stackables/bridge-stdlib — Bridge standard library tools.
  *
  * Contains the `std` namespace tools (httpCall, string helpers, array helpers,
- * audit, assert) that ship with Bridge.  Referenced in `.bridge` files as
+ * audit) that ship with Bridge.  Referenced in `.bridge` files as
  * `std.httpCall`, `std.str.toUpperCase`, etc.
  *
  * Separated from core so it can be versioned independently.
@@ -10,13 +10,19 @@
 import { audit } from "./tools/audit.ts";
 import * as arrays from "./tools/arrays.ts";
 import * as strings from "./tools/strings.ts";
-import { assert } from "./tools/assert.ts";
+/**
+ * Standard library version.
+ *
+ * The bridge `version X.Y` header declares the minimum compatible std version.
+ * At runtime the engine compares this constant against the bridge's declared
+ * version to verify compatibility (same major, equal-or-higher minor).
+ */
+export declare const STD_VERSION = "1.5.0";
 export declare const std: {
     readonly str: typeof strings;
     readonly arr: typeof arrays;
     readonly audit: typeof audit;
     readonly httpCall: import("@stackables/bridge-types").ToolCallFn;
-    readonly assert: typeof assert;
 };
 /**
  * All known built-in tool names as "namespace.tool" strings.

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAS3C,eAAO,MAAM,GAAG;;;;;;CAMN,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAE7C,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC;AASnC,eAAO,MAAM,GAAG;;;;;CAKN,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAE7C,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/build/index.js

@@ -2,7 +2,7 @@
  * @stackables/bridge-stdlib — Bridge standard library tools.
  *
  * Contains the `std` namespace tools (httpCall, string helpers, array helpers,
- * audit, assert) that ship with Bridge.  Referenced in `.bridge` files as
+ * audit) that ship with Bridge.  Referenced in `.bridge` files as
  * `std.httpCall`, `std.str.toUpperCase`, etc.
  *
  * Separated from core so it can be versioned independently.
@@ -11,7 +11,14 @@ import { audit } from "./tools/audit.js";
 import { createHttpCall } from "./tools/http-call.js";
 import * as arrays from "./tools/arrays.js";
 import * as strings from "./tools/strings.js";
-import { assert } from "./tools/assert.js";
+/**
+ * Standard library version.
+ *
+ * The bridge `version X.Y` header declares the minimum compatible std version.
+ * At runtime the engine compares this constant against the bridge's declared
+ * version to verify compatibility (same major, equal-or-higher minor).
+ */
+export const STD_VERSION = "1.5.0";
 /**
  * Standard built-in tools — available under the `std` namespace.
  *
@@ -23,7 +30,6 @@ export const std = {
     arr: arrays,
     audit,
     httpCall: httpCallFn,
-    assert,
 };
 /**
  * All known built-in tool names as "namespace.tool" strings.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackables/bridge-stdlib",
-  "version": "0.0.1",
-  "description": "Bridge standard library — httpCall, string, array, audit, and assert tools",
+  "version": "1.5.0",
+  "description": "Bridge standard library — httpCall, string, array, and audit tools",
   "main": "./build/index.js",
   "type": "module",
   "types": "./build/index.d.ts",
@@ -23,7 +23,7 @@
   "license": "MIT",
   "dependencies": {
     "lru-cache": "^11.2.6",
-    "@stackables/bridge-types": "0.0.1"
+    "@stackables/bridge-types": "1.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.3.2",
@@ -34,6 +34,8 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "node --experimental-transform-types --conditions source --test test/*.test.ts"
+    "lint:types": "tsc -p tsconfig.check.json",
+    "test": "node --experimental-transform-types --conditions source --test test/*.test.ts",
+    "test:coverage": "node --experimental-test-coverage --test-reporter=spec --test-reporter-destination=stdout --test-reporter=lcov --test-reporter-destination=lcov.info --experimental-transform-types --conditions source --test test/*.test.ts"
   }
 }

package/build/tools/assert.d.ts

@@ -1,5 +0,0 @@
-import type { ToolContext } from "@stackables/bridge-types";
-export declare function assert(input: {
-    in: any;
-}, _context?: ToolContext): any;
-//# sourceMappingURL=assert.d.ts.map

package/build/tools/assert.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/tools/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,wBAAgB,MAAM,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,GAAG,CAAA;CAAE,EAAE,QAAQ,CAAC,EAAE,WAAW,OAKhE"}

package/build/tools/assert.js

@@ -1,6 +0,0 @@
-export function assert(input, _context) {
-    if (!input.in) {
-        throw new Error("Assertion failed: input is falsy");
-    }
-    return input.in;
-}