@stigmer/sdk 3.16.1-dev.20260917224426 → 3.17.0

package/src/gen/subscription.ts

@@ -0,0 +1,84 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors.js";
+import { stripUndefined } from "./proto-utils.js";
+import { create } from "@bufbuild/protobuf";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { SubscriptionSchema, type Subscription } from "@stigmer/protos/ai/stigmer/billing/subscription/v1/api_pb";
+import { SubscriptionCommandController } from "@stigmer/protos/ai/stigmer/billing/subscription/v1/command_pb";
+import { ChangePlanInputSchema, CancelSubscriptionInputSchema, GetSubscriptionForOrganizationInputSchema, GetEntitlementsInputSchema, GetEntitlementsOutputSchema, type ChangePlanInput, type CancelSubscriptionInput, type GetSubscriptionForOrganizationInput, type GetEntitlementsInput, type GetEntitlementsOutput } from "@stigmer/protos/ai/stigmer/billing/subscription/v1/io_pb";
+import { SubscriptionQueryController } from "@stigmer/protos/ai/stigmer/billing/subscription/v1/query_pb";
+import { SubscriptionSpecSchema } from "@stigmer/protos/ai/stigmer/billing/subscription/v1/spec_pb";
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+
+/** Provides operations on subscription resources. */
+export class SubscriptionClient {
+  private readonly command: Client<typeof SubscriptionCommandController>;
+  private readonly query: Client<typeof SubscriptionQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(SubscriptionCommandController, transport);
+    this.query = createClient(SubscriptionQueryController, transport);
+  }
+
+  async changePlan(input: ChangePlanInput): Promise<Subscription> {
+    try {
+      return await this.command.changePlan(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async cancel(input: CancelSubscriptionInput): Promise<Subscription> {
+    try {
+      return await this.command.cancel(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getForOrganization(input: GetSubscriptionForOrganizationInput): Promise<Subscription> {
+    try {
+      return await this.query.getForOrganization(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getEntitlements(input: GetEntitlementsInput): Promise<GetEntitlementsOutput> {
+    try {
+      return await this.query.getEntitlements(input);
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a Subscription. */
+export interface SubscriptionInput {
+  /**
+   * The resource's `metadata.id`, for exact update addressing when set
+   * from a loaded resource. Required for updates to platform-scoped
+   * (org-less) kinds, where the org+slug fallback cannot match. On
+   * create, the cloud server stamps its own id regardless; the OSS
+   * server honors a caller-supplied id (existing apply semantics).
+   */
+  id?: string;
+  name: string;
+  slug?: string;
+  org: string;
+  labels?: Record<string, string>;
+  visibility?: ApiResourceVisibility;
+  planId: string;
+}
+
+export function buildSubscriptionProto(input: SubscriptionInput): Subscription {
+  return Object.assign(create(SubscriptionSchema), {
+    apiVersion: "billing.stigmer.ai/v1",
+    kind: "Subscription",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      ...(input.id && { id: input.id }),
+      name: input.name,
+      org: input.org,
+      ...(input.slug && { slug: input.slug }),
+      ...(input.labels && { labels: input.labels }),
+      ...(input.visibility && { visibility: input.visibility }),
+    }),
+    spec: Object.assign(create(SubscriptionSpecSchema), stripUndefined({
+      planId: input.planId,
+    })),
+  }) as Subscription;
+}

package/src/index.ts

@@ -283,6 +283,24 @@ export {
   toPlatformClientUpdateInput,
   type PlatformClientInput,
 } from "./gen/platformclient.js";
+// The billing kinds (cloud_only): the plan catalog, an organization's
+// subscription, and issued licenses. The entitlement input types are
+// emitted once per module that uses them, identical in shape; this barrel
+// exports the plan's copy. A subscription is created by the payment system,
+// never by a client, so no input type is exported for it.
+export {
+  PlanClient,
+  type PlanInput,
+  type PlanTermsInput,
+  type EntitlementsInput,
+  type EntitlementLimitsInput,
+} from "./gen/plan.js";
+export { SubscriptionClient } from "./gen/subscription.js";
+export {
+  LicenseClient,
+  type LicenseInput,
+  type LicenseCustomerInput,
+} from "./gen/license.js";
 export {
   ProjectClient,
   toProjectUpdateInput,

package/src/platform.ts

@@ -1,10 +1,12 @@
 import { createClient, type Client, type Transport } from "@connectrpc/connect";
 import { create } from "@bufbuild/protobuf";
 import {
+  GetLicenseStatusInputSchema,
   GetServerInfoInputSchema,
   PlatformQueryController,
 } from "@stigmer/protos/ai/stigmer/platform/v1/server_info_pb";
 import type {
+  GetLicenseStatusOutput,
   GetServerInfoOutput,
   ServerEdition,
 } from "@stigmer/protos/ai/stigmer/platform/v1/server_info_pb";
@@ -25,11 +27,12 @@ export interface ServerInfo {
 }
 
 /**
- * Client for platform-level queries (server info, capabilities).
+ * Client for platform-level queries (server info, capabilities, license).
  *
  * The {@link getServerInfo} method is the authoritative source for
  * deployment mode detection. It replaces URL-based hostname guessing
- * with a server-reported value.
+ * with a server-reported value. {@link getLicenseStatus} is its sibling
+ * for the license the server holds; every edition answers it.
  */
 export class PlatformClient {
   private readonly platform: Client<typeof PlatformQueryController>;
@@ -62,4 +65,24 @@ export class PlatformClient {
       throw wrapError(e);
     }
   }
+
+  /**
+   * Retrieve the state of the license the connected server holds.
+   *
+   * Every edition answers: open source and Stigmer Cloud report `absent`
+   * (neither holds a key); a Stigmer Enterprise deployment reports the
+   * state of its configured ticket with the verified claims. Requires a
+   * signed-in caller. The generated output is returned as it is, so the
+   * presence contract it documents (claims exactly when a ticket verified,
+   * key id whenever one was presented) reaches the caller unchanged.
+   */
+  async getLicenseStatus(): Promise<GetLicenseStatusOutput> {
+    try {
+      return await this.platform.getLicenseStatus(
+        create(GetLicenseStatusInputSchema, {}),
+      );
+    } catch (e) {
+      throw wrapError(e);
+    }
+  }
 }