platform-types 1.10.724 → 1.10.725

package/dist/subscription.d.ts

@@ -882,8 +882,12 @@ declare global {
          * non-null value for one is refused (`PLAN_GRANT_UNKNOWN_KEY`).
          */
         grants: Record<string, Partial<Record<PlanTier, PlanGrantValue | null>>>;
-        /** Screened operator reason (10-500 characters, no personal data); lands in each tier's audit entry. */
-        reason: string;
+        /**
+         * Optional on a draft edit: the reason that lands in the permanent audit
+         * rows is the publish's (`PlanCataloguePublishInput.reason`). Still
+         * screened when sent (10-500 characters, no personal data).
+         */
+        reason?: string;
         /**
          * Accepted and NOT checked: a grant edit writes the draft, and the echo that
          * gates what readers see is the publish's (`PlanCataloguePublishInput.confirm`).
@@ -891,6 +895,36 @@ declare global {
         confirm?: string;
         /** `true` writes nothing and returns the impact plus the `confirm` string. */
         dryRun?: boolean;
+        /**
+         * The draft revision the editor read (`GET /platform/billing/plans/draft`),
+         * or `null` when there was no draft. Checked when sent: a stale one is
+         * `409 PLAN_CATALOGUE_REVISION_CONFLICT` and nothing is written.
+         */
+        expectedDraftRevision?: string | null;
+    }
+    /**
+     * The body of `PATCH /platform/billing/plans/{tier}`: template fields written
+     * to the DRAFT catalogue only (customers see them after a publish). Every
+     * field is optional; a `null` clears a nullable one. Grants go through
+     * `PATCH /platform/billing/plans/grants` (a body carrying `features` or
+     * `grants` is `400 PLAN_GRANTS_USE_GRANTS_ROUTE`), and the retired `bullets`
+     * copy is refused.
+     */
+    interface PlanTemplatePatchRequest {
+        name?: string;
+        description?: string;
+        displayOrder?: number;
+        isActive?: boolean;
+        isPopular?: boolean;
+        /** `#rgb` or `#rrggbb`; `null` clears it. */
+        color?: string | null;
+        priceMonthlyCents?: number | null;
+        priceAnnualCents?: number | null;
+        currency?: Plan['currency'];
+        /** Optional on a draft edit; still screened when sent. The audited reason is the publish's. */
+        reason?: string;
+        /** As on {@link PlanGrantsWriteRequest.expectedDraftRevision}. */
+        expectedDraftRevision?: string | null;
     }
     /** One key's effective grant on one tier, before and after the write. */
     interface PlanGrantChange {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.724",
+	"version": "1.10.725",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",