@stigmer/sdk 0.5.0 → 1.0.0

package/src/platform.ts

@@ -0,0 +1,58 @@
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import {
+  GetServerInfoInputSchema,
+  PlatformQueryController,
+  ServerEdition,
+} from "@stigmer/protos/ai/stigmer/platform/v1/server_info_pb";
+import type { GetServerInfoOutput } from "@stigmer/protos/ai/stigmer/platform/v1/server_info_pb";
+import { wrapError } from "./gen/errors";
+import type { DeploymentMode } from "./resource-availability";
+
+/** Server identity information returned by {@link PlatformClient.getServerInfo}. */
+export interface ServerInfo {
+  /** Server edition mapped to a {@link DeploymentMode}. */
+  readonly deploymentMode: DeploymentMode;
+  /** Raw server edition enum value. */
+  readonly edition: ServerEdition;
+  /** Semantic version of the server binary. */
+  readonly version: string;
+}
+
+/**
+ * Client for platform-level queries (server info, capabilities).
+ *
+ * The {@link getServerInfo} method is the authoritative source for
+ * deployment mode detection. It replaces URL-based hostname guessing
+ * with a server-reported value.
+ */
+export class PlatformClient {
+  private readonly platform: Client<typeof PlatformQueryController>;
+
+  constructor(transport: Transport) {
+    this.platform = createClient(PlatformQueryController, transport);
+  }
+
+  /**
+   * Retrieve the connected server's edition and version.
+   *
+   * Maps the proto {@link ServerEdition} to a {@link DeploymentMode}:
+   * - `oss` -> `"local"`
+   * - `cloud` -> `"cloud"`
+   * - unspecified/unknown -> `"cloud"` (safe default)
+   */
+  async getServerInfo(): Promise<ServerInfo> {
+    try {
+      const resp: GetServerInfoOutput = await this.platform.getServerInfo(
+        create(GetServerInfoInputSchema, {}),
+      );
+      return {
+        deploymentMode: resp.edition === ServerEdition.oss ? "local" : "cloud",
+        edition: resp.edition,
+        version: resp.version,
+      };
+    } catch (e) {
+      throw wrapError(e);
+    }
+  }
+}

package/src/stigmer.ts

@@ -1,6 +1,7 @@
 import { BillingClient } from "./billing";
 import { GeneratedClient } from "./gen/client";
 import { GitHubClient } from "./github";
+import { PlatformClient } from "./platform";
 import { SearchClient } from "./search";
 import { createStigmerTransport } from "./transport";
 import {
@@ -55,6 +56,7 @@ export class Stigmer extends GeneratedClient {
   readonly fetch: typeof globalThis.fetch | undefined;
 
   readonly billing: BillingClient;
+  readonly platform: PlatformClient;
   readonly search: SearchClient;
   readonly github: GitHubClient;
 
@@ -73,6 +75,7 @@ export class Stigmer extends GeneratedClient {
       : config.getAccessToken ?? (() => null);
 
     this.billing = new BillingClient(transport);
+    this.platform = new PlatformClient(transport);
     this.search = new SearchClient(transport);
     this.github = new GitHubClient(transport);
   }

package/stigmer.d.ts

@@ -1,6 +1,7 @@
 import { BillingClient } from "./billing";
 import { GeneratedClient } from "./gen/client";
 import { GitHubClient } from "./github";
+import { PlatformClient } from "./platform";
 import { SearchClient } from "./search";
 import { type StigmerConfig } from "./config";
 /**
@@ -47,6 +48,7 @@ export declare class Stigmer extends GeneratedClient {
      */
     readonly fetch: typeof globalThis.fetch | undefined;
     readonly billing: BillingClient;
+    readonly platform: PlatformClient;
     readonly search: SearchClient;
     readonly github: GitHubClient;
     private readonly _tokenProvider;

package/stigmer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stigmer.d.ts","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,OAAQ,SAAQ,eAAe;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAEpD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;gBAEnC,MAAM,EAAE,aAAa;IAiBjC;;;;;;;;;OASG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGlD"}
+{"version":3,"file":"stigmer.d.ts","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,OAAQ,SAAQ,eAAe;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAEpD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;gBAEnC,MAAM,EAAE,aAAa;IAkBjC;;;;;;;;;OASG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGlD"}

package/stigmer.js

@@ -1,6 +1,7 @@
 import { BillingClient } from "./billing";
 import { GeneratedClient } from "./gen/client";
 import { GitHubClient } from "./github";
+import { PlatformClient } from "./platform";
 import { SearchClient } from "./search";
 import { createStigmerTransport } from "./transport";
 import { validateConfig, } from "./config";
@@ -48,6 +49,7 @@ export class Stigmer extends GeneratedClient {
      */
     fetch;
     billing;
+    platform;
     search;
     github;
     _tokenProvider;
@@ -61,6 +63,7 @@ export class Stigmer extends GeneratedClient {
             ? () => config.apiKey
             : config.getAccessToken ?? (() => null);
         this.billing = new BillingClient(transport);
+        this.platform = new PlatformClient(transport);
         this.search = new SearchClient(transport);
         this.github = new GitHubClient(transport);
     }

package/stigmer.js.map

@@ -1 +1 @@
-{"version":3,"file":"stigmer.js","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,cAAc,GAGf,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,OAAQ,SAAQ,eAAe;IAC1C;;;;;;OAMG;IACM,OAAO,CAAS;IAEzB;;;;;;;;OAQG;IACM,KAAK,CAAsC;IAE3C,OAAO,CAAgB;IACvB,MAAM,CAAe;IACrB,MAAM,CAAe;IAEb,cAAc,CAAgB;IAE/C,YAAY,MAAqB;QAC/B,cAAc,CAAC,MAAM,CAAC,CAAC;QAEvB,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC3E,KAAK,CAAC,SAAS,CAAC,CAAC;QAEjB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM;YACjC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAO;YACtB,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,iBAAiB;QACrB,OAAO,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;IACrC,CAAC;CACF"}
+{"version":3,"file":"stigmer.js","sourceRoot":"","sources":["../src/stigmer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,cAAc,GAGf,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,OAAQ,SAAQ,eAAe;IAC1C;;;;;;OAMG;IACM,OAAO,CAAS;IAEzB;;;;;;;;OAQG;IACM,KAAK,CAAsC;IAE3C,OAAO,CAAgB;IACvB,QAAQ,CAAiB;IACzB,MAAM,CAAe;IACrB,MAAM,CAAe;IAEb,cAAc,CAAgB;IAE/C,YAAY,MAAqB;QAC/B,cAAc,CAAC,MAAM,CAAC,CAAC;QAEvB,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC3E,KAAK,CAAC,SAAS,CAAC,CAAC;QAEjB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM;YACjC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAO;YACtB,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,iBAAiB;QACrB,OAAO,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;IACrC,CAAC;CACF"}