@camstack/types 1.2.34 → 1.2.35

package/dist/utils/vector-codec.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Vector wire codec — base64 of little-endian Float32.
+ *
+ * The `vector-store` capability carries vectors as base64 rather than
+ * `number[]` or a typed array, and both rejected alternatives have a scar here:
+ *
+ *  - a `Float32Array` does NOT survive msgpack across the UDS transport (it
+ *    arrived as an empty object and froze audio dBFS until the payload was
+ *    changed to carry bytes);
+ *  - `number[]` is the ~5x-larger encoding the capability exists to stop paying
+ *    — a 512-dim vector is 2,048 bytes raw and 2,732 as base64, against roughly
+ *    10-12 KB rendered as JSON text.
+ *
+ * Endianness is pinned to little-endian explicitly instead of inheriting the
+ * platform's, so a vector written on one node decodes correctly on another.
+ */
+/** Encode a vector as base64 of little-endian Float32. */
+export declare function encodeVectorBase64(vector: Float32Array | readonly number[]): string;
+/**
+ * Decode base64 little-endian Float32 back into a vector.
+ *
+ * Throws on a byte length that is not a multiple of 4 — a truncated vector
+ * would otherwise silently rank against a shorter one and produce a plausible
+ * score, which is worse than an error.
+ */
+export declare function decodeVectorBase64(encoded: string): Float32Array;
+/** Vector length implied by a base64 payload, without decoding it. */
+export declare function vectorDimFromBase64(encoded: string): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.34",
+  "version": "1.2.35",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",