@ferscloud/fers-calculation-web 0.2.61 → 0.2.62

package/README.md

@@ -202,6 +202,10 @@ const credit = fersAttributionHtml(res);
 exported. All of them accept the envelope, the parsed model or the results
 bundle, and all return nothing for a Pro result or an error envelope.
 
+On 0.2.61 this subpath resolved only under a bundler; plain Node ESM needed
+`/badge.js`. From 0.2.62 the package ships an `exports` map and both forms work
+everywhere.
+
 Using the free tier in an application? Please display the credit. It is the
 only thing the free tier asks of you.
 

package/fers-models.d.ts

@@ -211,6 +211,50 @@ export interface components {
          * @enum {string}
          */
         AnalysisOrder: "LINEAR" | "NONLINEAR";
+        /**
+         * @description Free-tier provenance stamp, attached to every result the free solver
+         *     produces and absent from Premium results.
+         *
+         *     Why it lives in the engine rather than in a JS wrapper: the tier is decided
+         *     inside the WASM module, by Ed25519-verifying a solve token against a public
+         *     key compiled into the binary (`wasm_bindings::verify_solve_token`). Anything
+         *     downstream of that boundary — a bundler config, a React component, a JSON
+         *     post-processing step — can be edited by whoever ships the page. Minting the
+         *     attribution here means the branded path is the default one, and removing it
+         *     means either holding the server's private key or patching and rebuilding a
+         *     WebAssembly binary.
+         *
+         *     It is not, and cannot be, an absolute guarantee: anything shipped to a
+         *     browser can ultimately be modified. It raises the cost of stripping
+         *     attribution from "delete a div" to "rebuild the engine", and the licence
+         *     carries the rest.
+         *
+         *     `html` and `text` are pre-rendered so a consumer can display the credit
+         *     without knowing anything about our brand. `fersAttributionHtml()` in
+         *     `@ferscloud/fers-calculation-web/badge` simply returns `attribution.html`,
+         *     and returns "" when the field is absent — so upgrading to Pro white-labels
+         *     with no code change.
+         */
+        Attribution: {
+            /**
+             * @description Engine version that produced the results. Mirrors
+             *     [`ResultsBundle::engine_version`].
+             */
+            engine_version: string;
+            /** @description Always "FERS". */
+            generated_by: string;
+            /** @description Ready-to-inject HTML anchor, for web UIs. */
+            html: string;
+            /** @description Plain-text credit, for console output, PDFs and text reports. */
+            text: string;
+            /**
+             * @description The tier this solve ran under. Only ever "free" — Premium results carry
+             *     no `attribution` object at all.
+             */
+            tier: string;
+            /** @description Canonical product URL. */
+            url: string;
+        };
         /**
          * @description A global coordinate axis.
          * @enum {string}
@@ -2355,6 +2399,7 @@ export interface components {
         };
         /** @description All analysis results: per load case, per load combination, unity-check results and the optional HTML report. */
         ResultsBundle: {
+            attribution?: null | components["schemas"]["Attribution"];
             buckling?: null | components["schemas"]["BucklingResults"];
             /**
              * @description Per-reference buckling runs, present only when `analysis.buckling`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ferscloud/fers-calculation-web",
   "type": "module",
-  "version": "0.2.61",
+  "version": "0.2.62",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",
@@ -55,5 +55,20 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./fers_calculations.d.ts",
+      "default": "./fers_calculations.js"
+    },
+    "./badge": {
+      "types": "./badge.d.ts",
+      "default": "./badge.js"
+    },
+    "./fers-models": {
+      "types": "./fers-models.d.ts"
+    },
+    "./package.json": "./package.json",
+    "./*": "./*"
   }
 }