@odigos/vmagent-api-apollo-client 0.9.0 → 0.11.0

package/dist/index.js

@@ -1 +1,13 @@
-export * from './generated/graphql';
+// Public entrypoint. The version-specific surface (flat latest-dialect exports +
+// per-dialect namespaces) is GENERATED into ./generated/surface by
+// scripts/gen-dialect-manifest.mjs, so this file is static and never needs
+// editing when a snapshot is added.
+//
+// - Flat imports (e.g. `import { GetWorkloadReportsV2Document } from
+//   '@odigos/vmagent-api-apollo-client'`) resolve to the latest dialect.
+// - Per-dialect namespaces (`v0_6_0`, `v0_8_0`, `next`, ...) target a specific
+//   dialect explicitly.
+export * from "./generated/surface";
+// Dialect registry: the `dialects` map, `resolveDialect`, version constants,
+// and types for picking a dialect per connected VM-agent version.
+export * from "./registry";

package/dist/registry.d.ts

@@ -0,0 +1,6 @@
+import { dialects, NEXT_DIALECT, LATEST_DIALECT_VERSION } from "./generated/dialects";
+export { dialects, NEXT_DIALECT, LATEST_DIALECT_VERSION };
+export type DialectVersion = keyof typeof dialects;
+export type Dialect = (typeof dialects)[DialectVersion];
+export declare function resolveDialectVersion(reported: string): DialectVersion;
+export declare function resolveDialect(reported: string): Dialect;

package/dist/registry.js

@@ -0,0 +1,46 @@
+// Dialect registry: resolves which frozen dialect a consumer should use for a
+// connected agent. The package ships every dialect (see codegen.ts); central-ui
+// passes the VM proxy's reported version to resolveDialect() and prints the
+// matching document, so it never selects fields the agent's schema lacks.
+//
+// The `dialects` map and version constants are GENERATED into
+// ./generated/dialects (by scripts/gen-dialect-manifest.mjs, run as part of
+// `npm run codegen`) directly from the graphql/snapshots directory. This file
+// is hand-written and holds only the resolution logic -- it never needs editing
+// when a new snapshot is added.
+import { dialects, NEXT_DIALECT, LATEST_DIALECT_VERSION, } from "./generated/dialects";
+export { dialects, NEXT_DIALECT, LATEST_DIALECT_VERSION };
+function parseVersion(version) {
+    const core = version.trim().replace(/^v/i, "").split("-")[0];
+    const [major = 0, minor = 0, patch = 0] = core
+        .split(".")
+        .map((part) => parseInt(part, 10) || 0);
+    return [major, minor, patch];
+}
+function compareVersions(a, b) {
+    const pa = parseVersion(a);
+    const pb = parseVersion(b);
+    for (let i = 0; i < 3; i += 1) {
+        if (pa[i] !== pb[i])
+            return pa[i] - pb[i];
+    }
+    return 0;
+}
+const SORTED_VERSIONS = Object.keys(dialects).sort(compareVersions);
+// Resolution: exact match if a snapshot equals the reported version; otherwise
+// the greatest snapshot <= reported (floor). Flooring is the safe choice -- the
+// schema only grows, so an older-or-equal dialect never selects fields the
+// agent is missing. A reported version newer than every snapshot floors to the
+// latest. A reported version older than every snapshot falls back to the
+// lowest known dialect (best effort; nothing safer is available).
+export function resolveDialectVersion(reported) {
+    let floor;
+    for (const version of SORTED_VERSIONS) {
+        if (compareVersions(version, reported) <= 0)
+            floor = version;
+    }
+    return floor ?? SORTED_VERSIONS[0];
+}
+export function resolveDialect(reported) {
+    return dialects[resolveDialectVersion(reported)];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@odigos/vmagent-api-apollo-client",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Generated Apollo TypeScript client for the VM-agent GraphQL API",
   "license": "Apache-2.0",
   "main": "dist/index.js",
@@ -14,13 +14,23 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "import": "./dist/registry.js",
+      "require": "./dist/registry.js"
+    },
+    "./next": {
+      "types": "./dist/generated/next/graphql.d.ts",
+      "import": "./dist/generated/next/graphql.js",
+      "require": "./dist/generated/next/graphql.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "codegen": "graphql-codegen --config codegen.ts",
+    "codegen": "graphql-codegen --config codegen.ts && node scripts/gen-dialect-manifest.mjs",
     "build": "tsc -p tsconfig.json"
   },
   "dependencies": {