@anvailabs/proximadb-client 0.4.1 → 0.5.0

package/dist/index.d.mts

@@ -0,0 +1,3 @@
+// GENERATED by scripts/write-esm-entry.mjs -- types of the ESM entry (dist/index.mjs).
+export * from "./index.js";
+export { ProximaDBClient as default } from "./index.js";

package/dist/index.d.ts

@@ -45,7 +45,7 @@
  * Copyright 2025 ProximaDB Contributors
  * Licensed under the Apache License, Version 2.0
  */
-export declare const VERSION = "1.0.0";
+export declare const VERSION = "0.5.0";
 export { DistanceMetric, StorageEngine, IndexType, FilterOp, LogicalOp, SearchMode, TraversalDirection, ErrorCode, ProximaDBError, } from "./types";
 export type { ProximaRecord, VectorRecord, SearchResult, CollectionConfig, CollectionStats, CollectionInfo, HealthStatus, Metadata, MetadataValue, JsonValue, Filter, FilterCondition, FilterGroup, FilterNode, GraphNode, GraphEdge, TraversalResult, GraphInfo, ClientConfig, SearchOptions, InsertOptions, UpdateOptions, DeleteResult, OperationMetrics, SearchResultBatch, SearchResultIterator, ProbeResponse, ColumnDefinition, SchemaDefinition, SchemaResponse, UpdateSchemaRequest, UpdateSchemaResponse, QueryLanguage, QueryRequest, ExplainQueryRequest, QueryResponse, } from "./types";
 export { ProximaDBClient, ClientBuilder, connect, connectRest, } from "./client";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAMH,eAAO,MAAM,OAAO,UAAU,CAAC;AAO/B,OAAO,EACL,cAAc,EACd,aAAa,EACb,SAAS,EACT,QAAQ,EACR,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,SAAS,EACT,MAAM,EACN,eAAe,EACf,WAAW,EACX,UAAU,EACV,SAAS,EACT,SAAS,EACT,eAAe,EACf,SAAS,EACT,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,aAAa,GACd,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,eAAe,EACf,aAAa,EACb,OAAO,EACP,WAAW,GACZ,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,aAAa,GACd,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,aAAa,EAEb,EAAE,EACF,EAAE,EACF,EAAE,EACF,EAAE,EACF,MAAM,EACN,KAAK,EACL,UAAU,EACV,SAAS,EACT,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAEhB,UAAU,EACV,IAAI,EACJ,UAAU,EACV,IAAI,GACL,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,eAAe,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AASH,eAAO,MAAM,OAAO,UAAU,CAAC;AAO/B,OAAO,EACL,cAAc,EACd,aAAa,EACb,SAAS,EACT,QAAQ,EACR,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,SAAS,EACT,MAAM,EACN,eAAe,EACf,WAAW,EACX,UAAU,EACV,SAAS,EACT,SAAS,EACT,eAAe,EACf,SAAS,EACT,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,aAAa,GACd,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,eAAe,EACf,aAAa,EACb,OAAO,EACP,WAAW,GACZ,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,aAAa,GACd,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,aAAa,EAEb,EAAE,EACF,EAAE,EACF,EAAE,EACF,EAAE,EACF,MAAM,EACN,KAAK,EACL,UAAU,EACV,SAAS,EACT,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAMlB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB,EAEhB,UAAU,EACV,IAAI,EACJ,UAAU,EACV,IAAI,GACL,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,eAAe,eAAe,CAAC"}

package/dist/index.js

@@ -51,7 +51,10 @@ exports.edge = exports.createEdge = exports.node = exports.createNode = exports.
 // ============================================================================
 // VERSION
 // ============================================================================
-exports.VERSION = "1.0.0";
+// The package version. Kept equal to package.json `version` by
+// scripts/version-sync.sh (`set` rewrites it, `check` fails on drift) and by
+// tests/package_entry.test.ts.
+exports.VERSION = "0.5.0";
 // ============================================================================
 // TYPES
 // ============================================================================

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;;;AAEH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAElE,QAAA,OAAO,GAAG,OAAO,CAAC;AAE/B,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,yBAAyB;AACzB,iCAUiB;AATf,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,kGAAA,SAAS,OAAA;AACT,iGAAA,QAAQ,OAAA;AACR,kGAAA,SAAS,OAAA;AACT,mGAAA,UAAU,OAAA;AACV,2GAAA,kBAAkB,OAAA;AAClB,kGAAA,SAAS,OAAA;AACT,uGAAA,cAAc,OAAA;AA2ChB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,mCAKkB;AAJhB,yGAAA,eAAe,OAAA;AACf,uGAAA,aAAa,OAAA;AACb,iGAAA,OAAO,OAAA;AACP,qGAAA,WAAW,OAAA;AAGb,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,2CAMsB;AALpB,8GAAA,gBAAgB,OAAA;AAChB,+GAAA,iBAAiB,OAAA;AACjB,2GAAA,aAAa,OAAA;AACb,gHAAA,kBAAkB,OAAA;AAClB,2GAAA,aAAa,OAAA;AAGf,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,mCAGkB;AAFhB,uGAAA,aAAa,OAAA;AACb,6GAAA,mBAAmB,OAAA;AAGrB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,mCAYkB;AAXhB,uGAAA,aAAa,OAAA;AACb,wBAAwB;AACxB,4FAAA,EAAE,OAAA;AACF,4FAAA,EAAE,OAAA;AACF,4FAAA,EAAE,OAAA;AACF,4FAAA,EAAE,OAAA;AACF,gGAAA,MAAM,OAAA;AACN,+FAAA,KAAK,OAAA;AACL,oGAAA,UAAU,OAAA;AACV,mGAAA,SAAS,OAAA;AACT,4GAAA,kBAAkB,OAAA;AAGpB,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,iCAWiB;AAVf,oGAAA,WAAW,OAAA;AACX,qGAAA,YAAY,OAAA;AACZ,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,yGAAA,gBAAgB,OAAA;AAChB,wBAAwB;AACxB,mGAAA,UAAU,OAAA;AACV,6FAAA,IAAI,OAAA;AACJ,mGAAA,UAAU,OAAA;AACV,6FAAA,IAAI,OAAA;AAGN,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,qCAA2C;AAC3C,kBAAe,wBAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;;;AAEH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,+DAA+D;AAC/D,6EAA6E;AAC7E,+BAA+B;AAClB,QAAA,OAAO,GAAG,OAAO,CAAC;AAE/B,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,yBAAyB;AACzB,iCAUiB;AATf,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,kGAAA,SAAS,OAAA;AACT,iGAAA,QAAQ,OAAA;AACR,kGAAA,SAAS,OAAA;AACT,mGAAA,UAAU,OAAA;AACV,2GAAA,kBAAkB,OAAA;AAClB,kGAAA,SAAS,OAAA;AACT,uGAAA,cAAc,OAAA;AA2ChB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,mCAKkB;AAJhB,yGAAA,eAAe,OAAA;AACf,uGAAA,aAAa,OAAA;AACb,iGAAA,OAAO,OAAA;AACP,qGAAA,WAAW,OAAA;AAGb,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,2CAMsB;AALpB,8GAAA,gBAAgB,OAAA;AAChB,+GAAA,iBAAiB,OAAA;AACjB,2GAAA,aAAa,OAAA;AACb,gHAAA,kBAAkB,OAAA;AAClB,2GAAA,aAAa,OAAA;AAGf,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,mCAGkB;AAFhB,uGAAA,aAAa,OAAA;AACb,6GAAA,mBAAmB,OAAA;AAGrB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,mCAYkB;AAXhB,uGAAA,aAAa,OAAA;AACb,wBAAwB;AACxB,4FAAA,EAAE,OAAA;AACF,4FAAA,EAAE,OAAA;AACF,4FAAA,EAAE,OAAA;AACF,4FAAA,EAAE,OAAA;AACF,gGAAA,MAAM,OAAA;AACN,+FAAA,KAAK,OAAA;AACL,oGAAA,UAAU,OAAA;AACV,mGAAA,SAAS,OAAA;AACT,4GAAA,kBAAkB,OAAA;AAGpB,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,iCAWiB;AAVf,oGAAA,WAAW,OAAA;AACX,qGAAA,YAAY,OAAA;AACZ,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,yGAAA,gBAAgB,OAAA;AAChB,wBAAwB;AACxB,mGAAA,UAAU,OAAA;AACV,6FAAA,IAAI,OAAA;AACJ,mGAAA,UAAU,OAAA;AACV,6FAAA,IAAI,OAAA;AAGN,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,qCAA2C;AAC3C,kBAAe,wBAAe,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,4 @@
+// GENERATED by scripts/write-esm-entry.mjs -- ESM wrapper over the CommonJS build.
+import cjs from "./index.js";
+export const { BatchInsertBuilder, ClientBuilder, CollectionBuilder, CollectionHandle, DistanceMetric, EdgeBuilder, ErrorCode, FilterBuilder, FilterOp, GraphBuilder, GraphHandle, IndexType, InsertBuilder, LogicalOp, NodeBuilder, ProximaDBClient, ProximaDBError, SearchBuilder, SearchMode, StorageEngine, TraversalBuilder, TraversalDirection, UpdateBuilder, VERSION, andFilters, connect, connectRest, createEdge, createNode, createSearchBuilder, edge, eq, filterToExpression, gt, inList, lt, ne, node, orFilters, range } = cjs;
+export default cjs.default;

package/package.json

@@ -1,15 +1,20 @@
 {
   "name": "@anvailabs/proximadb-client",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "TypeScript/Node.js SDK for ProximaDB vector database",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "module": "dist/index.mjs",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     }
   },
   "files": [
@@ -17,7 +22,7 @@
     "src"
   ],
   "scripts": {
-    "build": "tsc && tsc -p tsconfig.esm.json",
+    "build": "tsc && node scripts/write-esm-entry.mjs",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run clean && npm run build",
     "lint": "tsc --noEmit",

package/src/collection.ts

@@ -77,6 +77,24 @@ export interface CollectionHttpClient extends SearchHttpClient {
 // COLLECTION BUILDER
 // ============================================================================
 
+const INDEX_TYPES: readonly string[] = Object.values(IndexType);
+
+/**
+ * Normalize an index type the way the server reads algorithm names (trimmed,
+ * case-insensitive), failing fast on anything that is not an `IndexType`: a
+ * plain-JS caller's `"HNSW"` used to be sent as a declared index instead of
+ * the default route, and a typo only failed as a server 400.
+ */
+export function normalizeIndexType(idx: IndexType | string): IndexType {
+  const value = String(idx).trim().toLowerCase();
+  if (!INDEX_TYPES.includes(value)) {
+    throw new TypeError(
+      `unknown index type "${String(idx)}"; expected one of ${INDEX_TYPES.join(", ")}`,
+    );
+  }
+  return value as IndexType;
+}
+
 /**
  * Builder for creating collections
  */
@@ -120,10 +138,14 @@ export class CollectionBuilder {
   }
 
   /**
-   * Set the index type
+   * Set the index type.
+   *
+   * Case-insensitive and whitespace-tolerant, like the server's algorithm
+   * names (`"HNSW"` is `IndexType.Hnsw`). An unknown value throws a
+   * `TypeError` here, at the call that is wrong, before any request is sent.
    */
   index(idx: IndexType): CollectionBuilder {
-    this.indexValue = idx;
+    this.indexValue = normalizeIndexType(idx);
     return this;
   }
 
@@ -159,11 +181,24 @@ export class CollectionBuilder {
       throw new Error("Dimension is required for collection creation");
     }
 
+    // TD-RESTGET-1: the server ignores `index_type` "hnsw" (index selection
+    // is cost-derived) and rejects any other value, which it never honoured.
+    // Send what each choice means: Hnsw keeps the default payload; Flat forces
+    // brute force through the routing policy; the others declare that index.
+    // `index()` already normalized the value, so these comparisons are exact.
+    const index = this.indexValue;
+    const indexFields =
+      index === IndexType.Hnsw
+        ? { index_type: index }
+        : index === IndexType.Flat
+          ? { index_policy: { mode: "exact" } }
+          : { index_configs: [{ algorithm: index, is_primary: true }] };
+
     const request = {
       name: this.collectionName,
       dimension: this.dimensionValue,
       engine: this.engineValue,
-      index_type: this.indexValue,
+      ...indexFields,
       distance_metric: this.metricValue,
       description: this.descriptionValue ?? undefined,
       tags: this.tagsValue.length > 0 ? this.tagsValue : undefined,

package/src/generated/schema.ts

@@ -2550,6 +2550,23 @@ export interface components {
              *     set a non-default (Unspecified/Fp32) precision.
              */
             canonical_embedding_precision?: string | null;
+            /**
+             * @description Resolved desired storage class (TD-TIER-1 SC1):
+             *     "economy" | "balanced" (default) | "performance".
+             */
+            storage_class: string;
+            /**
+             * @description Observed storage-class status — the truth about what SC1 delivers.
+             *     "balanced" ⇒ active; economy/performance persist intent and report
+             *     `not_active` with a reason naming the missing dependency (SC3/SC4).
+             */
+            storage_class_status: components["schemas"]["StorageClassStatusOutput"];
+            /**
+             * @description Desired access tier for future segment writes (TD-TIER-1 SC5):
+             *     "hot" | "cool" | "cold"; omitted when unset (the account default).
+             *     Desired, not observed: an account lifecycle rule may move objects.
+             */
+            default_access_tier?: string | null;
             schema?: null | components["schemas"]["SchemaDefinition"];
             /** @description Collection statistics */
             stats: components["schemas"]["CollectionStatsV2"];
@@ -2614,6 +2631,8 @@ export interface components {
          *         "enable_proxima_record": true
          *     }
          *     ```
+         *     Unknown fields are rejected (TD-RESTGET-1): a misspelt setting used to be
+         *     dropped, and the collection silently got the default instead.
          */
         CreateCollectionV2Request: {
             /** @description Collection name (required) */
@@ -2629,6 +2648,7 @@ export interface components {
              *     Options: "auto", "sst", "helix", "swift", "nova", "raptor", "tst"
              *     Default: "auto" (system selects optimal engine)
              *     ("viper" is no longer accepted — deprecated by ADR-093)
+             *     `storage_engine` is accepted as an alias.
              */
             engine?: string | null;
             schema?: null | components["schemas"]["SchemaDefinition"];
@@ -2648,6 +2668,7 @@ export interface components {
              *
              *     Options: "cosine", "euclidean", "dot_product"
              *     Default: "cosine"
+             *     `metric` is accepted as an alias.
              */
             distance_metric?: string | null;
             /**
@@ -2681,6 +2702,38 @@ export interface components {
             tags?: string[] | null;
             quantization?: null | components["schemas"]["QuantizationConfigInput"];
             index_policy?: null | components["schemas"]["IndexPolicyInput"];
+            /** @description Free-text description, persisted on the collection config. */
+            description?: string | null;
+            /**
+             * @deprecated
+             * @description Legacy field the released Rust and TypeScript SDKs send on every create
+             *     (default "hnsw"). Index selection is cost-derived, so "hnsw" is accepted
+             *     and has no effect; any other value is rejected — declare an index with
+             *     `index_configs` or force a route with `index_policy.mode` instead.
+             */
+            index_type?: string | null;
+            /**
+             * @description Desired storage class (TD-TIER-1 SC1).
+             *
+             *     Options: "balanced" (default) | "economy" | "performance". Omitted ⇒
+             *     balanced (pre-SC1 collections are unchanged). "performance" is admitted
+             *     only for an object-store-backed SST/PAX placement and reports
+             *     `not_active` until its residency dependency ships; economy likewise
+             *     persists intent only. Read `storage_class_status` on the GET response
+             *     for the observed truth — the class is never a claim.
+             */
+            storage_class?: string | null;
+            /**
+             * @description Provider access tier for the collection's FUTURE compacted segments
+             *     (TD-TIER-1 SC5): "hot" | "cool" | "cold". Omitted ⇒ the account/bucket
+             *     default. Requires an object-store placement (s3/az/gs); "archive" is
+             *     refused (archived objects cannot serve queries). Fresh flush (L0)
+             *     segments keep the account default — they are compacted away long
+             *     before a cool/cold tier's minimum storage duration. Existing objects
+             *     are not rewritten; control objects keep the account default. Once
+             *     set, a tier can be changed but not cleared back to the default.
+             */
+            default_access_tier?: string | null;
         };
         /** @description Response for collection creation */
         CreateCollectionV2Response: {
@@ -3448,6 +3501,51 @@ export interface components {
             execution_time_ms: number;
             request_id: string;
         };
+        /**
+         * @description REST output for the observed storage-class status (TD-TIER-1 SC1; mirrors
+         *     proto `StorageClassStatus` — a read-side projection, never an input).
+         */
+        StorageClassStatusOutput: {
+            /**
+             * @description "active" | "not_active" | "warming" | "ready" | "degraded"
+             *     ("unspecified" never leaves the server).
+             */
+            state: string;
+            /**
+             * @description Human-readable reason when `state` is not active (names the missing
+             *     dependency); empty when active.
+             */
+            reason: string;
+            /**
+             * Format: int64
+             * @description Monotonic generation of the desired policy: 0 = never set (pre-SC1
+             *     records), 1 = set at create; a policy-change surface will bump it.
+             */
+            policy_generation: number;
+            /**
+             * Format: int64
+             * @description Reserved bytes under the collection's residency admission (SC3). 0 until then.
+             */
+            reserved_bytes: number;
+            /**
+             * Format: int64
+             * @description Bytes resident in the serving cache (SC4). 0 until then.
+             */
+            resident_bytes: number;
+            /**
+             * Format: int64
+             * @description Bytes covered by the READY coverage set (SC4). 0 until then.
+             */
+            covered_bytes: number;
+            /**
+             * Format: int64
+             * @description The committed segment-set generation the coverage was proven against
+             *     (TD-TIER-1 SC4-5); absent when no proof was attempted. Optional so
+             *     old and new clients and servers interoperate in both directions.
+             *     Computed per status read (one LIST per segment root).
+             */
+            covered_generation?: number | null;
+        };
         /**
          * @description Input format for TEXT fields
          *

package/src/index.ts

@@ -50,7 +50,10 @@
 // VERSION
 // ============================================================================
 
-export const VERSION = "1.0.0";
+// The package version. Kept equal to package.json `version` by
+// scripts/version-sync.sh (`set` rewrites it, `check` fails on drift) and by
+// tests/package_entry.test.ts.
+export const VERSION = "0.5.0";
 
 // ============================================================================
 // TYPES