@stigmer/protos 3.16.0 → 3.17.0

package/ai/stigmer/billing/subscription/v1/io_pb.d.ts

@@ -0,0 +1,114 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { Entitlements } from "../../../platform/v1/entitlement_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/billing/subscription/v1/io.proto.
+ */
+export declare const file_ai_stigmer_billing_subscription_v1_io: GenFile;
+/**
+ * GetSubscriptionForOrganizationInput names the organization whose
+ * subscription is read.
+ *
+ * @generated from message ai.stigmer.billing.subscription.v1.GetSubscriptionForOrganizationInput
+ */
+export type GetSubscriptionForOrganizationInput = Message<"ai.stigmer.billing.subscription.v1.GetSubscriptionForOrganizationInput"> & {
+    /**
+     * The organization's id.
+     *
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.GetSubscriptionForOrganizationInput.
+ * Use `create(GetSubscriptionForOrganizationInputSchema)` to create a new message.
+ */
+export declare const GetSubscriptionForOrganizationInputSchema: GenMessage<GetSubscriptionForOrganizationInput>;
+/**
+ * GetEntitlementsInput names the organization whose entitlements are
+ * resolved.
+ *
+ * @generated from message ai.stigmer.billing.subscription.v1.GetEntitlementsInput
+ */
+export type GetEntitlementsInput = Message<"ai.stigmer.billing.subscription.v1.GetEntitlementsInput"> & {
+    /**
+     * The organization's id.
+     *
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.GetEntitlementsInput.
+ * Use `create(GetEntitlementsInputSchema)` to create a new message.
+ */
+export declare const GetEntitlementsInputSchema: GenMessage<GetEntitlementsInput>;
+/**
+ * GetEntitlementsOutput is what an organization is permitted right now and
+ * the plan that permits it.
+ *
+ * @generated from message ai.stigmer.billing.subscription.v1.GetEntitlementsOutput
+ */
+export type GetEntitlementsOutput = Message<"ai.stigmer.billing.subscription.v1.GetEntitlementsOutput"> & {
+    /**
+     * The entitlements in force for the organization.
+     *
+     * @generated from field: ai.stigmer.platform.v1.Entitlements entitlements = 1;
+     */
+    entitlements?: Entitlements;
+    /**
+     * The id of the Plan the entitlements were resolved from. Empty when the
+     * organization is on Free, which is not a plan row.
+     *
+     * @generated from field: string plan_id = 2;
+     */
+    planId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.GetEntitlementsOutput.
+ * Use `create(GetEntitlementsOutputSchema)` to create a new message.
+ */
+export declare const GetEntitlementsOutputSchema: GenMessage<GetEntitlementsOutput>;
+/**
+ * ChangePlanInput moves an organization onto a plan.
+ *
+ * @generated from message ai.stigmer.billing.subscription.v1.ChangePlanInput
+ */
+export type ChangePlanInput = Message<"ai.stigmer.billing.subscription.v1.ChangePlanInput"> & {
+    /**
+     * The organization's id.
+     *
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+    /**
+     * The id of the Plan to move onto. Must be an active subscription plan.
+     *
+     * @generated from field: string plan_id = 2;
+     */
+    planId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.ChangePlanInput.
+ * Use `create(ChangePlanInputSchema)` to create a new message.
+ */
+export declare const ChangePlanInputSchema: GenMessage<ChangePlanInput>;
+/**
+ * CancelSubscriptionInput names the organization whose subscription is
+ * canceled.
+ *
+ * @generated from message ai.stigmer.billing.subscription.v1.CancelSubscriptionInput
+ */
+export type CancelSubscriptionInput = Message<"ai.stigmer.billing.subscription.v1.CancelSubscriptionInput"> & {
+    /**
+     * The organization's id.
+     *
+     * @generated from field: string org_id = 1;
+     */
+    orgId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.CancelSubscriptionInput.
+ * Use `create(CancelSubscriptionInputSchema)` to create a new message.
+ */
+export declare const CancelSubscriptionInputSchema: GenMessage<CancelSubscriptionInput>;

package/ai/stigmer/billing/subscription/v1/io_pb.js

@@ -0,0 +1,36 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/billing/subscription/v1/io.proto (package ai.stigmer.billing.subscription.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_platform_v1_entitlement } from "../../../platform/v1/entitlement_pb.js";
+import { file_buf_validate_validate } from "../../../../../buf/validate/validate_pb.js";
+/**
+ * Describes the file ai/stigmer/billing/subscription/v1/io.proto.
+ */
+export const file_ai_stigmer_billing_subscription_v1_io = /*@__PURE__*/ fileDesc("CithaS9zdGlnbWVyL2JpbGxpbmcvc3Vic2NyaXB0aW9uL3YxL2lvLnByb3RvEiJhaS5zdGlnbWVyLmJpbGxpbmcuc3Vic2NyaXB0aW9uLnYxIj0KI0dldFN1YnNjcmlwdGlvbkZvck9yZ2FuaXphdGlvbklucHV0EhYKBm9yZ19pZBgBIAEoCUIGukgDyAEBIi4KFEdldEVudGl0bGVtZW50c0lucHV0EhYKBm9yZ19pZBgBIAEoCUIGukgDyAEBImQKFUdldEVudGl0bGVtZW50c091dHB1dBI6CgxlbnRpdGxlbWVudHMYASABKAsyJC5haS5zdGlnbWVyLnBsYXRmb3JtLnYxLkVudGl0bGVtZW50cxIPCgdwbGFuX2lkGAIgASgJIkIKD0NoYW5nZVBsYW5JbnB1dBIWCgZvcmdfaWQYASABKAlCBrpIA8gBARIXCgdwbGFuX2lkGAIgASgJQga6SAPIAQEiMQoXQ2FuY2VsU3Vic2NyaXB0aW9uSW5wdXQSFgoGb3JnX2lkGAEgASgJQga6SAPIAQFiBnByb3RvMw", [file_ai_stigmer_platform_v1_entitlement, file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.GetSubscriptionForOrganizationInput.
+ * Use `create(GetSubscriptionForOrganizationInputSchema)` to create a new message.
+ */
+export const GetSubscriptionForOrganizationInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_subscription_v1_io, 0);
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.GetEntitlementsInput.
+ * Use `create(GetEntitlementsInputSchema)` to create a new message.
+ */
+export const GetEntitlementsInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_subscription_v1_io, 1);
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.GetEntitlementsOutput.
+ * Use `create(GetEntitlementsOutputSchema)` to create a new message.
+ */
+export const GetEntitlementsOutputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_subscription_v1_io, 2);
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.ChangePlanInput.
+ * Use `create(ChangePlanInputSchema)` to create a new message.
+ */
+export const ChangePlanInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_subscription_v1_io, 3);
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.CancelSubscriptionInput.
+ * Use `create(CancelSubscriptionInputSchema)` to create a new message.
+ */
+export const CancelSubscriptionInputSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_subscription_v1_io, 4);
+//# sourceMappingURL=io_pb.js.map

package/ai/stigmer/billing/subscription/v1/io_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/billing/subscription/v1/io_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,+HAA+H;AAC/H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,uCAAuC,EAAE,MAAM,wCAAwC,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAGxF;;GAEG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAY,aAAa,CAC9E,QAAQ,CAAC,ojBAAojB,EAAE,CAAC,uCAAuC,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAiBxoB;;;GAGG;AACH,MAAM,CAAC,MAAM,yCAAyC,GAAoD,aAAa,CACrH,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AAiB7D;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AAyB7D;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsC,aAAa,CACzF,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AAuB7D;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AAiB7D;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwC,aAAa,CAC7F,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/billing/subscription/v1/query_connect.d.ts

@@ -0,0 +1,48 @@
+/**
+ * SubscriptionQueryController provides the read operations on an
+ * organization's subscription.
+ *
+ * Every read is keyed by the organization, because an organization has at
+ * most one active subscription, and authorizes on the organization with
+ * can_view_billing, the permission the billing account's reads use.
+ *
+ * @generated from service ai.stigmer.billing.subscription.v1.SubscriptionQueryController
+ */
+export declare const SubscriptionQueryController: {
+    readonly typeName: "ai.stigmer.billing.subscription.v1.SubscriptionQueryController";
+    readonly methods: {
+        /**
+         * Get the organization's subscription.
+         *
+         * NOT_FOUND when the organization has none: it is on the Free plan, which
+         * is not a row. Callers that only need what the organization may do
+         * should call getEntitlements, which answers for every organization.
+         *
+         * @generated from rpc ai.stigmer.billing.subscription.v1.SubscriptionQueryController.getForOrganization
+         */
+        readonly getForOrganization: {
+            readonly name: "getForOrganization";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+        /**
+         * Resolve what the organization is permitted right now.
+         *
+         * The answer is derived, never stored: the entitlements of the plan the
+         * organization's active subscription names, else the Free plan's with an
+         * empty plan_id. A platform-managed organization has no subscription of
+         * its own; its entitlements resolve through its identity provider to the
+         * integrator organization, whose plan counts the managed organization
+         * against the managed organizations it includes.
+         *
+         * @generated from rpc ai.stigmer.billing.subscription.v1.SubscriptionQueryController.getEntitlements
+         */
+        readonly getEntitlements: {
+            readonly name: "getEntitlements";
+            readonly I: any;
+            readonly O: any;
+            readonly kind: any;
+        };
+    };
+};

package/ai/stigmer/billing/subscription/v1/query_connect.js

@@ -0,0 +1,56 @@
+// @generated by protoc-gen-connect-es v1.6.1 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/billing/subscription/v1/query.proto (package ai.stigmer.billing.subscription.v1, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+import { GetEntitlementsInput, GetEntitlementsOutput, GetSubscriptionForOrganizationInput } from "./io_pbjs";
+import { Subscription } from "./api_pbjs";
+import { MethodKind } from "@bufbuild/protobuf";
+/**
+ * SubscriptionQueryController provides the read operations on an
+ * organization's subscription.
+ *
+ * Every read is keyed by the organization, because an organization has at
+ * most one active subscription, and authorizes on the organization with
+ * can_view_billing, the permission the billing account's reads use.
+ *
+ * @generated from service ai.stigmer.billing.subscription.v1.SubscriptionQueryController
+ */
+export const SubscriptionQueryController = {
+    typeName: "ai.stigmer.billing.subscription.v1.SubscriptionQueryController",
+    methods: {
+        /**
+         * Get the organization's subscription.
+         *
+         * NOT_FOUND when the organization has none: it is on the Free plan, which
+         * is not a row. Callers that only need what the organization may do
+         * should call getEntitlements, which answers for every organization.
+         *
+         * @generated from rpc ai.stigmer.billing.subscription.v1.SubscriptionQueryController.getForOrganization
+         */
+        getForOrganization: {
+            name: "getForOrganization",
+            I: GetSubscriptionForOrganizationInput,
+            O: Subscription,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * Resolve what the organization is permitted right now.
+         *
+         * The answer is derived, never stored: the entitlements of the plan the
+         * organization's active subscription names, else the Free plan's with an
+         * empty plan_id. A platform-managed organization has no subscription of
+         * its own; its entitlements resolve through its identity provider to the
+         * integrator organization, whose plan counts the managed organization
+         * against the managed organizations it includes.
+         *
+         * @generated from rpc ai.stigmer.billing.subscription.v1.SubscriptionQueryController.getEntitlements
+         */
+        getEntitlements: {
+            name: "getEntitlements",
+            I: GetEntitlementsInput,
+            O: GetEntitlementsOutput,
+            kind: MethodKind.Unary,
+        },
+    }
+};
+//# sourceMappingURL=query_connect.js.map

package/ai/stigmer/billing/subscription/v1/query_connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/billing/subscription/v1/query_connect.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,kIAAkI;AAClI,oBAAoB;AACpB,cAAc;AAEd,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,mCAAmC,EAAE,MAAM,WAAW,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,QAAQ,EAAE,gEAAgE;IAC1E,OAAO,EAAE;QACP;;;;;;;;WAQG;QACH,kBAAkB,EAAE;YAClB,IAAI,EAAE,oBAAoB;YAC1B,CAAC,EAAE,mCAAmC;YACtC,CAAC,EAAE,YAAY;YACf,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;QACD;;;;;;;;;;;WAWG;QACH,eAAe,EAAE;YACf,IAAI,EAAE,iBAAiB;YACvB,CAAC,EAAE,oBAAoB;YACvB,CAAC,EAAE,qBAAqB;YACxB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}

package/ai/stigmer/billing/subscription/v1/query_pb.d.ts

@@ -0,0 +1,50 @@
+import type { GenFile, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { SubscriptionSchema } from "./api_pb.js";
+import type { GetEntitlementsInputSchema, GetEntitlementsOutputSchema, GetSubscriptionForOrganizationInputSchema } from "./io_pb.js";
+/**
+ * Describes the file ai/stigmer/billing/subscription/v1/query.proto.
+ */
+export declare const file_ai_stigmer_billing_subscription_v1_query: GenFile;
+/**
+ * SubscriptionQueryController provides the read operations on an
+ * organization's subscription.
+ *
+ * Every read is keyed by the organization, because an organization has at
+ * most one active subscription, and authorizes on the organization with
+ * can_view_billing, the permission the billing account's reads use.
+ *
+ * @generated from service ai.stigmer.billing.subscription.v1.SubscriptionQueryController
+ */
+export declare const SubscriptionQueryController: GenService<{
+    /**
+     * Get the organization's subscription.
+     *
+     * NOT_FOUND when the organization has none: it is on the Free plan, which
+     * is not a row. Callers that only need what the organization may do
+     * should call getEntitlements, which answers for every organization.
+     *
+     * @generated from rpc ai.stigmer.billing.subscription.v1.SubscriptionQueryController.getForOrganization
+     */
+    getForOrganization: {
+        methodKind: "unary";
+        input: typeof GetSubscriptionForOrganizationInputSchema;
+        output: typeof SubscriptionSchema;
+    };
+    /**
+     * Resolve what the organization is permitted right now.
+     *
+     * The answer is derived, never stored: the entitlements of the plan the
+     * organization's active subscription names, else the Free plan's with an
+     * empty plan_id. A platform-managed organization has no subscription of
+     * its own; its entitlements resolve through its identity provider to the
+     * integrator organization, whose plan counts the managed organization
+     * against the managed organizations it includes.
+     *
+     * @generated from rpc ai.stigmer.billing.subscription.v1.SubscriptionQueryController.getEntitlements
+     */
+    getEntitlements: {
+        methodKind: "unary";
+        input: typeof GetEntitlementsInputSchema;
+        output: typeof GetEntitlementsOutputSchema;
+    };
+}>;

package/ai/stigmer/billing/subscription/v1/query_pb.js

@@ -0,0 +1,24 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/billing/subscription/v1/query.proto (package ai.stigmer.billing.subscription.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, serviceDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_billing_subscription_v1_api } from "./api_pb.js";
+import { file_ai_stigmer_billing_subscription_v1_io } from "./io_pb.js";
+import { file_ai_stigmer_commons_apiresource_rpc_service_options } from "../../../commons/apiresource/rpc_service_options_pb.js";
+import { file_ai_stigmer_commons_rpc_method_options } from "../../../commons/rpc/method_options_pb.js";
+/**
+ * Describes the file ai/stigmer/billing/subscription/v1/query.proto.
+ */
+export const file_ai_stigmer_billing_subscription_v1_query = /*@__PURE__*/ fileDesc("Ci5haS9zdGlnbWVyL2JpbGxpbmcvc3Vic2NyaXB0aW9uL3YxL3F1ZXJ5LnByb3RvEiJhaS5zdGlnbWVyLmJpbGxpbmcuc3Vic2NyaXB0aW9uLnYxMtADChtTdWJzY3JpcHRpb25RdWVyeUNvbnRyb2xsZXIS2AEKEmdldEZvck9yZ2FuaXphdGlvbhJHLmFpLnN0aWdtZXIuYmlsbGluZy5zdWJzY3JpcHRpb24udjEuR2V0U3Vic2NyaXB0aW9uRm9yT3JnYW5pemF0aW9uSW5wdXQaMC5haS5zdGlnbWVyLmJpbGxpbmcuc3Vic2NyaXB0aW9uLnYxLlN1YnNjcmlwdGlvbiJHwrgYQwgbEB4iBm9yZ19pZCo1dW5hdXRob3JpemVkIHRvIHZpZXcgdGhpcyBvcmdhbml6YXRpb24ncyBzdWJzY3JpcHRpb24SzwEKD2dldEVudGl0bGVtZW50cxI4LmFpLnN0aWdtZXIuYmlsbGluZy5zdWJzY3JpcHRpb24udjEuR2V0RW50aXRsZW1lbnRzSW5wdXQaOS5haS5zdGlnbWVyLmJpbGxpbmcuc3Vic2NyaXB0aW9uLnYxLkdldEVudGl0bGVtZW50c091dHB1dCJHwrgYQwgbEB4iBm9yZ19pZCo1dW5hdXRob3JpemVkIHRvIHZpZXcgdGhpcyBvcmdhbml6YXRpb24ncyBlbnRpdGxlbWVudHMaBKD/K0diBnByb3RvMw", [file_ai_stigmer_billing_subscription_v1_api, file_ai_stigmer_billing_subscription_v1_io, file_ai_stigmer_commons_apiresource_rpc_service_options, file_ai_stigmer_commons_rpc_method_options]);
+/**
+ * SubscriptionQueryController provides the read operations on an
+ * organization's subscription.
+ *
+ * Every read is keyed by the organization, because an organization has at
+ * most one active subscription, and authorizes on the organization with
+ * can_view_billing, the permission the billing account's reads use.
+ *
+ * @generated from service ai.stigmer.billing.subscription.v1.SubscriptionQueryController
+ */
+export const SubscriptionQueryController = /*@__PURE__*/ serviceDesc(file_ai_stigmer_billing_subscription_v1_query, 0);
+//# sourceMappingURL=query_pb.js.map

package/ai/stigmer/billing/subscription/v1/query_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/billing/subscription/v1/query_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,kIAAkI;AAClI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,2CAA2C,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,0CAA0C,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,uDAAuD,EAAE,MAAM,wDAAwD,CAAC;AACjI,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAEvG;;GAEG;AACH,MAAM,CAAC,MAAM,6CAA6C,GAAY,aAAa,CACjF,QAAQ,CAAC,4uBAA4uB,EAAE,CAAC,2CAA2C,EAAE,0CAA0C,EAAE,uDAAuD,EAAE,0CAA0C,CAAC,CAAC,CAAC;AAEz7B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAgCnC,aAAa,CAChB,WAAW,CAAC,6CAA6C,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/billing/subscription/v1/spec_pb.d.ts

@@ -0,0 +1,30 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/billing/subscription/v1/spec.proto.
+ */
+export declare const file_ai_stigmer_billing_subscription_v1_spec: GenFile;
+/**
+ * SubscriptionSpec names the plan an organization is bound to.
+ *
+ * The plan is referenced by its id, not by an organization-scoped reference:
+ * a Plan belongs to no organization, and the id is exact and immutable,
+ * which is what "a change of terms is a new Plan" needs. Everything else
+ * about a subscription is state the payment system reports, and lives in
+ * the status.
+ *
+ * @generated from message ai.stigmer.billing.subscription.v1.SubscriptionSpec
+ */
+export type SubscriptionSpec = Message<"ai.stigmer.billing.subscription.v1.SubscriptionSpec"> & {
+    /**
+     * The id of the Plan the organization is bound to.
+     *
+     * @generated from field: string plan_id = 1;
+     */
+    planId: string;
+};
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.SubscriptionSpec.
+ * Use `create(SubscriptionSpecSchema)` to create a new message.
+ */
+export declare const SubscriptionSpecSchema: GenMessage<SubscriptionSpec>;

package/ai/stigmer/billing/subscription/v1/spec_pb.js

@@ -0,0 +1,15 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/billing/subscription/v1/spec.proto (package ai.stigmer.billing.subscription.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_buf_validate_validate } from "../../../../../buf/validate/validate_pb.js";
+/**
+ * Describes the file ai/stigmer/billing/subscription/v1/spec.proto.
+ */
+export const file_ai_stigmer_billing_subscription_v1_spec = /*@__PURE__*/ fileDesc("Ci1haS9zdGlnbWVyL2JpbGxpbmcvc3Vic2NyaXB0aW9uL3YxL3NwZWMucHJvdG8SImFpLnN0aWdtZXIuYmlsbGluZy5zdWJzY3JpcHRpb24udjEiKwoQU3Vic2NyaXB0aW9uU3BlYxIXCgdwbGFuX2lkGAEgASgJQga6SAPIAQFiBnByb3RvMw", [file_buf_validate_validate]);
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.SubscriptionSpec.
+ * Use `create(SubscriptionSpecSchema)` to create a new message.
+ */
+export const SubscriptionSpecSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_subscription_v1_spec, 0);
+//# sourceMappingURL=spec_pb.js.map

package/ai/stigmer/billing/subscription/v1/spec_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/billing/subscription/v1/spec_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,iIAAiI;AACjI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAGxF;;GAEG;AACH,MAAM,CAAC,MAAM,4CAA4C,GAAY,aAAa,CAChF,QAAQ,CAAC,wLAAwL,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC;AAsBnO;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAiC,aAAa,CAC/E,WAAW,CAAC,4CAA4C,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/billing/subscription/v1/status_pb.d.ts

@@ -0,0 +1,94 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { ApiResourceAudit } from "../../../commons/apiresource/status_pb.js";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/billing/subscription/v1/status.proto.
+ */
+export declare const file_ai_stigmer_billing_subscription_v1_status: GenFile;
+/**
+ * SubscriptionStatus is the system-managed state of a subscription: its audit
+ * trail, its lifecycle state and the billing period it is in.
+ *
+ * Deliberately absent: the entitlements. They are derived from the plan on
+ * every read (SubscriptionQueryController.getEntitlements) so a plan's
+ * terms are stated once, on the plan.
+ *
+ * @generated from message ai.stigmer.billing.subscription.v1.SubscriptionStatus
+ */
+export type SubscriptionStatus = Message<"ai.stigmer.billing.subscription.v1.SubscriptionStatus"> & {
+    /**
+     * Standard audit information tracking creation and modification.
+     *
+     * @generated from field: ai.stigmer.commons.apiresource.ApiResourceAudit audit = 99;
+     */
+    audit?: ApiResourceAudit;
+    /**
+     * The lifecycle state the payment system last reported.
+     *
+     * @generated from field: ai.stigmer.billing.subscription.v1.SubscriptionState state = 1;
+     */
+    state: SubscriptionState;
+    /**
+     * Start of the current billing period.
+     *
+     * @generated from field: google.protobuf.Timestamp current_period_start = 2;
+     */
+    currentPeriodStart?: Timestamp;
+    /**
+     * End of the current billing period.
+     *
+     * @generated from field: google.protobuf.Timestamp current_period_end = 3;
+     */
+    currentPeriodEnd?: Timestamp;
+    /**
+     * When the subscription was canceled. Unset while it is not.
+     *
+     * @generated from field: google.protobuf.Timestamp canceled_at = 4;
+     */
+    canceledAt?: Timestamp;
+};
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.SubscriptionStatus.
+ * Use `create(SubscriptionStatusSchema)` to create a new message.
+ */
+export declare const SubscriptionStatusSchema: GenMessage<SubscriptionStatus>;
+/**
+ * SubscriptionState is the lifecycle state a subscription is in.
+ *
+ * The vocabulary is the smallest set the entitlement read cannot do without
+ * and names no payment processor; the billing engine adds states as it needs
+ * them, additively.
+ *
+ * @generated from enum ai.stigmer.billing.subscription.v1.SubscriptionState
+ */
+export declare enum SubscriptionState {
+    /**
+     * @generated from enum value: subscription_state_unspecified = 0;
+     */
+    subscription_state_unspecified = 0,
+    /**
+     * In good standing; the plan's entitlements apply.
+     *
+     * @generated from enum value: active = 1;
+     */
+    active = 1,
+    /**
+     * A payment is overdue; the plan's entitlements still apply while the
+     * payment system retries.
+     *
+     * @generated from enum value: past_due = 2;
+     */
+    past_due = 2,
+    /**
+     * Ended by the organization or the payment system; the organization is
+     * on Free from the end of the period.
+     *
+     * @generated from enum value: canceled = 3;
+     */
+    canceled = 3
+}
+/**
+ * Describes the enum ai.stigmer.billing.subscription.v1.SubscriptionState.
+ */
+export declare const SubscriptionStateSchema: GenEnum<SubscriptionState>;

package/ai/stigmer/billing/subscription/v1/status_pb.js

@@ -0,0 +1,56 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/billing/subscription/v1/status.proto (package ai.stigmer.billing.subscription.v1, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_commons_apiresource_status } from "../../../commons/apiresource/status_pb.js";
+import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file ai/stigmer/billing/subscription/v1/status.proto.
+ */
+export const file_ai_stigmer_billing_subscription_v1_status = /*@__PURE__*/ fileDesc("Ci9haS9zdGlnbWVyL2JpbGxpbmcvc3Vic2NyaXB0aW9uL3YxL3N0YXR1cy5wcm90bxIiYWkuc3RpZ21lci5iaWxsaW5nLnN1YnNjcmlwdGlvbi52MSK+AgoSU3Vic2NyaXB0aW9uU3RhdHVzEj8KBWF1ZGl0GGMgASgLMjAuYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLkFwaVJlc291cmNlQXVkaXQSRAoFc3RhdGUYASABKA4yNS5haS5zdGlnbWVyLmJpbGxpbmcuc3Vic2NyaXB0aW9uLnYxLlN1YnNjcmlwdGlvblN0YXRlEjgKFGN1cnJlbnRfcGVyaW9kX3N0YXJ0GAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI2ChJjdXJyZW50X3BlcmlvZF9lbmQYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEi8KC2NhbmNlbGVkX2F0GAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCpfChFTdWJzY3JpcHRpb25TdGF0ZRIiCh5zdWJzY3JpcHRpb25fc3RhdGVfdW5zcGVjaWZpZWQQABIKCgZhY3RpdmUQARIMCghwYXN0X2R1ZRACEgwKCGNhbmNlbGVkEANiBnByb3RvMw", [file_ai_stigmer_commons_apiresource_status, file_google_protobuf_timestamp]);
+/**
+ * Describes the message ai.stigmer.billing.subscription.v1.SubscriptionStatus.
+ * Use `create(SubscriptionStatusSchema)` to create a new message.
+ */
+export const SubscriptionStatusSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_billing_subscription_v1_status, 0);
+/**
+ * SubscriptionState is the lifecycle state a subscription is in.
+ *
+ * The vocabulary is the smallest set the entitlement read cannot do without
+ * and names no payment processor; the billing engine adds states as it needs
+ * them, additively.
+ *
+ * @generated from enum ai.stigmer.billing.subscription.v1.SubscriptionState
+ */
+export var SubscriptionState;
+(function (SubscriptionState) {
+    /**
+     * @generated from enum value: subscription_state_unspecified = 0;
+     */
+    SubscriptionState[SubscriptionState["subscription_state_unspecified"] = 0] = "subscription_state_unspecified";
+    /**
+     * In good standing; the plan's entitlements apply.
+     *
+     * @generated from enum value: active = 1;
+     */
+    SubscriptionState[SubscriptionState["active"] = 1] = "active";
+    /**
+     * A payment is overdue; the plan's entitlements still apply while the
+     * payment system retries.
+     *
+     * @generated from enum value: past_due = 2;
+     */
+    SubscriptionState[SubscriptionState["past_due"] = 2] = "past_due";
+    /**
+     * Ended by the organization or the payment system; the organization is
+     * on Free from the end of the period.
+     *
+     * @generated from enum value: canceled = 3;
+     */
+    SubscriptionState[SubscriptionState["canceled"] = 3] = "canceled";
+})(SubscriptionState || (SubscriptionState = {}));
+/**
+ * Describes the enum ai.stigmer.billing.subscription.v1.SubscriptionState.
+ */
+export const SubscriptionStateSchema = /*@__PURE__*/ enumDesc(file_ai_stigmer_billing_subscription_v1_status, 0);
+//# sourceMappingURL=status_pb.js.map

package/ai/stigmer/billing/subscription/v1/status_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/billing/subscription/v1/status_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,mIAAmI;AACnI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE/E,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AAEvG,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAGxE;;GAEG;AACH,MAAM,CAAC,MAAM,8CAA8C,GAAY,aAAa,CAClF,QAAQ,CAAC,4qBAA4qB,EAAE,CAAC,0CAA0C,EAAE,8BAA8B,CAAC,CAAC,CAAC;AAiDvwB;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmC,aAAa,CACnF,WAAW,CAAC,8CAA8C,EAAE,CAAC,CAAC,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,iBA4BX;AA5BD,WAAY,iBAAiB;IAC3B;;OAEG;IACH,6GAAkC,CAAA;IAElC;;;;OAIG;IACH,6DAAU,CAAA;IAEV;;;;;OAKG;IACH,iEAAY,CAAA;IAEZ;;;;;OAKG;IACH,iEAAY,CAAA;AACd,CAAC,EA5BW,iBAAiB,KAAjB,iBAAiB,QA4B5B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA+B,aAAa,CAC9E,QAAQ,CAAC,8CAA8C,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_group_pb.d.ts

@@ -56,7 +56,18 @@ export declare enum ApiResourceGroup {
      *
      * @generated from enum value: tenancy = 3;
      */
-    tenancy = 3
+    tenancy = 3,
+    /**
+     * Billing - What is sold: plans, the subscriptions and licenses that
+     * grant them. The entitlement vocabulary these kinds carry lives under
+     * platform, because every edition reads it; the kinds live here because
+     * only the cloud sells. The flat billing/v1 aggregate (BillingAccount and
+     * its ledger) is a plain message, not an envelope kind, and stays outside
+     * the group; this group covers the envelope kinds only.
+     *
+     * @generated from enum value: billing = 4;
+     */
+    billing = 4
 }
 /**
  * Describes the enum ai.stigmer.commons.apiresource.apiresourcekind.ApiResourceGroup.

package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_group_pb.js

@@ -6,7 +6,7 @@ import { file_google_protobuf_descriptor } from "@bufbuild/protobuf/wkt";
 /**
  * Describes the file ai/stigmer/commons/apiresource/apiresourcekind/api_resource_group.proto.
  */
-export const file_ai_stigmer_commons_apiresource_apiresourcekind_api_resource_group = /*@__PURE__*/ fileDesc("CkdhaS9zdGlnbWVyL2NvbW1vbnMvYXBpcmVzb3VyY2UvYXBpcmVzb3VyY2VraW5kL2FwaV9yZXNvdXJjZV9ncm91cC5wcm90bxIuYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLmFwaXJlc291cmNla2luZCI8ChRBcGlSZXNvdXJjZUdyb3VwTWV0YRIOCgZkb21haW4YASABKAkSFAoMZGlzcGxheV9uYW1lGAIgASgJKroBChBBcGlSZXNvdXJjZUdyb3VwEiIKHmFwaV9yZXNvdXJjZV9ncm91cF91bnNwZWNpZmllZBAAEi4KB2FnZW50aWMQARoh6r0sHQoSYWdlbnRpYy5zdGlnbWVyLmFpEgdBZ2VudGljEiIKA2lhbRACGhnqvSwVCg5pYW0uc3RpZ21lci5haRIDSUFNEi4KB3RlbmFuY3kQAxoh6r0sHQoSdGVuYW5jeS5zdGlnbWVyLmFpEgdUZW5hbmN5OogBCgpncm91cF9tZXRhEiEuZ29vZ2xlLnByb3RvYnVmLkVudW1WYWx1ZU9wdGlvbnMY3ccFIAEoCzJELmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5hcGlyZXNvdXJjZWtpbmQuQXBpUmVzb3VyY2VHcm91cE1ldGFSCWdyb3VwTWV0YWIGcHJvdG8z", [file_google_protobuf_descriptor]);
+export const file_ai_stigmer_commons_apiresource_apiresourcekind_api_resource_group = /*@__PURE__*/ fileDesc("CkdhaS9zdGlnbWVyL2NvbW1vbnMvYXBpcmVzb3VyY2UvYXBpcmVzb3VyY2VraW5kL2FwaV9yZXNvdXJjZV9ncm91cC5wcm90bxIuYWkuc3RpZ21lci5jb21tb25zLmFwaXJlc291cmNlLmFwaXJlc291cmNla2luZCI8ChRBcGlSZXNvdXJjZUdyb3VwTWV0YRIOCgZkb21haW4YASABKAkSFAoMZGlzcGxheV9uYW1lGAIgASgJKuoBChBBcGlSZXNvdXJjZUdyb3VwEiIKHmFwaV9yZXNvdXJjZV9ncm91cF91bnNwZWNpZmllZBAAEi4KB2FnZW50aWMQARoh6r0sHQoSYWdlbnRpYy5zdGlnbWVyLmFpEgdBZ2VudGljEiIKA2lhbRACGhnqvSwVCg5pYW0uc3RpZ21lci5haRIDSUFNEi4KB3RlbmFuY3kQAxoh6r0sHQoSdGVuYW5jeS5zdGlnbWVyLmFpEgdUZW5hbmN5Ei4KB2JpbGxpbmcQBBoh6r0sHQoSYmlsbGluZy5zdGlnbWVyLmFpEgdCaWxsaW5nOogBCgpncm91cF9tZXRhEiEuZ29vZ2xlLnByb3RvYnVmLkVudW1WYWx1ZU9wdGlvbnMY3ccFIAEoCzJELmFpLnN0aWdtZXIuY29tbW9ucy5hcGlyZXNvdXJjZS5hcGlyZXNvdXJjZWtpbmQuQXBpUmVzb3VyY2VHcm91cE1ldGFSCWdyb3VwTWV0YWIGcHJvdG8z", [file_google_protobuf_descriptor]);
 /**
  * Describes the message ai.stigmer.commons.apiresource.apiresourcekind.ApiResourceGroupMeta.
  * Use `create(ApiResourceGroupMetaSchema)` to create a new message.
@@ -41,6 +41,17 @@ export var ApiResourceGroup;
      * @generated from enum value: tenancy = 3;
      */
     ApiResourceGroup[ApiResourceGroup["tenancy"] = 3] = "tenancy";
+    /**
+     * Billing - What is sold: plans, the subscriptions and licenses that
+     * grant them. The entitlement vocabulary these kinds carry lives under
+     * platform, because every edition reads it; the kinds live here because
+     * only the cloud sells. The flat billing/v1 aggregate (BillingAccount and
+     * its ledger) is a plain message, not an envelope kind, and stays outside
+     * the group; this group covers the envelope kinds only.
+     *
+     * @generated from enum value: billing = 4;
+     */
+    ApiResourceGroup[ApiResourceGroup["billing"] = 4] = "billing";
 })(ApiResourceGroup || (ApiResourceGroup = {}));
 /**
  * Describes the enum ai.stigmer.commons.apiresource.apiresourcekind.ApiResourceGroup.

package/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_group_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"api_resource_group_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/commons/apiresource/apiresourcekind/api_resource_group_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,uKAAuK;AACvK,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAExF,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAGzE;;GAEG;AACH,MAAM,CAAC,MAAM,sEAAsE,GAAY,aAAa,CAC1G,QAAQ,CAAC,srBAAsrB,EAAE,CAAC,+BAA+B,CAAC,CAAC,CAAC;AAuBtuB;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,sEAAsE,EAAE,CAAC,CAAC,CAAC;AAEzF;;;;GAIG;AACH,MAAM,CAAN,IAAY,gBA0BX;AA1BD,WAAY,gBAAgB;IAC1B;;OAEG;IACH,2GAAkC,CAAA;IAElC;;;;OAIG;IACH,6DAAW,CAAA;IAEX;;;;OAIG;IACH,qDAAO,CAAA;IAEP;;;;OAIG;IACH,6DAAW,CAAA;AACb,CAAC,EA1BW,gBAAgB,KAAhB,gBAAgB,QA0B3B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA8B,aAAa,CAC5E,QAAQ,CAAC,sEAAsE,EAAE,CAAC,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAyD,aAAa,CAC3F,OAAO,CAAC,sEAAsE,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"api_resource_group_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/commons/apiresource/apiresourcekind/api_resource_group_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,uKAAuK;AACvK,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAExF,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAGzE;;GAEG;AACH,MAAM,CAAC,MAAM,sEAAsE,GAAY,aAAa,CAC1G,QAAQ,CAAC,svBAAsvB,EAAE,CAAC,+BAA+B,CAAC,CAAC,CAAC;AAuBtyB;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,sEAAsE,EAAE,CAAC,CAAC,CAAC;AAEzF;;;;GAIG;AACH,MAAM,CAAN,IAAY,gBAsCX;AAtCD,WAAY,gBAAgB;IAC1B;;OAEG;IACH,2GAAkC,CAAA;IAElC;;;;OAIG;IACH,6DAAW,CAAA;IAEX;;;;OAIG;IACH,qDAAO,CAAA;IAEP;;;;OAIG;IACH,6DAAW,CAAA;IAEX;;;;;;;;;OASG;IACH,6DAAW,CAAA;AACb,CAAC,EAtCW,gBAAgB,KAAhB,gBAAgB,QAsC3B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA8B,aAAa,CAC5E,QAAQ,CAAC,sEAAsE,EAAE,CAAC,CAAC,CAAC;AAEtF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAyD,aAAa,CAC3F,OAAO,CAAC,sEAAsE,EAAE,CAAC,CAAC,CAAC"}