@vibexp/api-client 0.98.0 → 0.99.0

package/dist/axios/types.gen.d.ts

@@ -6437,18 +6437,22 @@ export type AdminInstanceSearchSettings = {
     updated_by_name: string | null;
     /**
      * The stored row's optimistic-lock version; null when nothing is stored.
-     * Send it back as `expected_version` to reject a save that would
-     * overwrite someone else's change.
+     * Send it back as `expected_version` (`0` when it is null) to reject a
+     * save that would overwrite someone else's change.
      *
      */
     version: number | null;
 };
 /**
  * A whole replacement of the instance search ranking defaults. Every value is
- * required. `expected_version` is optional: when present, the save is
- * rejected with 409 unless it equals the stored version (and when nothing is
- * stored, any `expected_version` other than null is a conflict). Omit it for
- * last-write-wins.
+ * required. `expected_version` is optional and makes the save a
+ * compare-and-set:
+ *
+ * - omitted or null: last-write-wins, never a conflict.
+ * - `0`: nothing may be stored yet; the save is rejected with 409 when a row
+ * is stored. Send it when the `version` last read was null.
+ * - a positive value: the save is rejected with 409 unless it equals the
+ * stored `version`, and also when nothing is stored.
  *
  */
 export type AdminInstanceSearchSettingsUpdate = {
@@ -6459,7 +6463,10 @@ export type AdminInstanceSearchSettingsUpdate = {
     rank_half_life_days: number;
     rank_candidate_cap: number;
     /**
-     * The `version` the caller last read; omit or null for last-write-wins.
+     * The `version` the caller last read. Send `0` when that `version` was
+     * null, to save only while nothing is stored. Omit it or send null for
+     * last-write-wins. A negative value matches nothing and is a 409.
+     *
      */
     expected_version?: number | null;
 };
@@ -6542,18 +6549,22 @@ export type AdminInstanceAiSummarySettings = {
     updated_by_name: string | null;
     /**
      * The stored row's optimistic-lock version; null when nothing is stored.
-     * Send it back as `expected_version` to reject a save that would
-     * overwrite someone else's change.
+     * Send it back as `expected_version` (`0` when it is null) to reject a
+     * save that would overwrite someone else's change.
      *
      */
     version: number | null;
 };
 /**
  * A whole replacement of the instance AI summary settings. Every value is
- * required. `expected_version` is optional: when present, the save is
- * rejected with 409 unless it equals the stored version (and when nothing is
- * stored, any `expected_version` other than null is a conflict). Omit it for
- * last-write-wins.
+ * required. `expected_version` is optional and makes the save a
+ * compare-and-set:
+ *
+ * - omitted or null: last-write-wins, never a conflict.
+ * - `0`: nothing may be stored yet; the save is rejected with 409 when a row
+ * is stored. Send it when the `version` last read was null.
+ * - a positive value: the save is rejected with 409 unless it equals the
+ * stored `version`, and also when nothing is stored.
  *
  */
 export type AdminInstanceAiSummarySettingsUpdate = {
@@ -6565,7 +6576,10 @@ export type AdminInstanceAiSummarySettingsUpdate = {
     total_context_chars: number;
     request_timeout_ms: number;
     /**
-     * The `version` the caller last read; omit or null for last-write-wins.
+     * The `version` the caller last read. Send `0` when that `version` was
+     * null, to save only while nothing is stored. Omit it or send null for
+     * last-write-wins. A negative value matches nothing and is a 409.
+     *
      */
     expected_version?: number | null;
 };
@@ -6814,7 +6828,10 @@ export type AdminAuthAllowlist = {
      */
     active: boolean;
     /**
-     * The stored allowlist's own version; null when nothing is stored.
+     * The stored allowlist's own version; null when nothing is stored. Send
+     * it back as `expected_version` (`0` when it is null) to reject a save
+     * that would overwrite someone else's change.
+     *
      */
     version: number | null;
     /**
@@ -6835,17 +6852,23 @@ export type AdminAuthAllowlist = {
  * is a DNS name of at least two labels with no leading `@`. Storing two empty
  * lists means open access.
  *
- * `expected_version` is optional: when present, the save is rejected with
- * 409 unless it equals the stored allowlist's `version` (and when nothing is
- * stored, any `expected_version` other than null is a conflict). Omit it for
- * last-write-wins.
+ * `expected_version` is optional and makes the save a compare-and-set:
+ *
+ * - omitted or null: last-write-wins, never a conflict.
+ * - `0`: no allowlist may be stored yet; the save is rejected with 409 when
+ * one is. Send it when the `version` last read was null.
+ * - a positive value: the save is rejected with 409 unless it equals the
+ * stored allowlist's `version`, and also when nothing is stored.
  *
  */
 export type AdminAuthAllowlistUpdate = {
     domains: Array<string>;
     emails: Array<string>;
     /**
-     * The `version` the caller last read; omit or null for last-write-wins.
+     * The `version` the caller last read. Send `0` when that `version` was
+     * null, to save only while nothing is stored. Omit it or send null for
+     * last-write-wins. A negative value matches nothing and is a 409.
+     *
      */
     expected_version?: number | null;
 };

package/dist/schema.d.ts

@@ -13418,18 +13418,22 @@ export interface components {
             /**
              * Format: int64
              * @description The stored row's optimistic-lock version; null when nothing is stored.
-             *     Send it back as `expected_version` to reject a save that would
-             *     overwrite someone else's change.
+             *     Send it back as `expected_version` (`0` when it is null) to reject a
+             *     save that would overwrite someone else's change.
              * @example 4
              */
             version: number | null;
         };
         /**
          * @description A whole replacement of the instance search ranking defaults. Every value is
-         *     required. `expected_version` is optional: when present, the save is
-         *     rejected with 409 unless it equals the stored version (and when nothing is
-         *     stored, any `expected_version` other than null is a conflict). Omit it for
-         *     last-write-wins.
+         *     required. `expected_version` is optional and makes the save a
+         *     compare-and-set:
+         *
+         *     - omitted or null: last-write-wins, never a conflict.
+         *     - `0`: nothing may be stored yet; the save is rejected with 409 when a row
+         *       is stored. Send it when the `version` last read was null.
+         *     - a positive value: the save is rejected with 409 unless it equals the
+         *       stored `version`, and also when nothing is stored.
          */
         AdminInstanceSearchSettingsUpdate: {
             recency_ranking_enabled: boolean;
@@ -13444,7 +13448,9 @@ export interface components {
             rank_candidate_cap: number;
             /**
              * Format: int64
-             * @description The `version` the caller last read; omit or null for last-write-wins.
+             * @description The `version` the caller last read. Send `0` when that `version` was
+             *     null, to save only while nothing is stored. Omit it or send null for
+             *     last-write-wins. A negative value matches nothing and is a 409.
              */
             expected_version?: number | null;
         };
@@ -13540,18 +13546,22 @@ export interface components {
             /**
              * Format: int64
              * @description The stored row's optimistic-lock version; null when nothing is stored.
-             *     Send it back as `expected_version` to reject a save that would
-             *     overwrite someone else's change.
+             *     Send it back as `expected_version` (`0` when it is null) to reject a
+             *     save that would overwrite someone else's change.
              * @example 4
              */
             version: number | null;
         };
         /**
          * @description A whole replacement of the instance AI summary settings. Every value is
-         *     required. `expected_version` is optional: when present, the save is
-         *     rejected with 409 unless it equals the stored version (and when nothing is
-         *     stored, any `expected_version` other than null is a conflict). Omit it for
-         *     last-write-wins.
+         *     required. `expected_version` is optional and makes the save a
+         *     compare-and-set:
+         *
+         *     - omitted or null: last-write-wins, never a conflict.
+         *     - `0`: nothing may be stored yet; the save is rejected with 409 when a row
+         *       is stored. Send it when the `version` last read was null.
+         *     - a positive value: the save is rejected with 409 unless it equals the
+         *       stored `version`, and also when nothing is stored.
          */
         AdminInstanceAISummarySettingsUpdate: {
             enabled: boolean;
@@ -13563,7 +13573,9 @@ export interface components {
             request_timeout_ms: number;
             /**
              * Format: int64
-             * @description The `version` the caller last read; omit or null for last-write-wins.
+             * @description The `version` the caller last read. Send `0` when that `version` was
+             *     null, to save only while nothing is stored. Omit it or send null for
+             *     last-write-wins. A negative value matches nothing and is a 409.
              */
             expected_version?: number | null;
         };
@@ -13841,7 +13853,9 @@ export interface components {
             active: boolean;
             /**
              * Format: int64
-             * @description The stored allowlist's own version; null when nothing is stored.
+             * @description The stored allowlist's own version; null when nothing is stored. Send
+             *     it back as `expected_version` (`0` when it is null) to reject a save
+             *     that would overwrite someone else's change.
              * @example 3
              */
             version: number | null;
@@ -13864,10 +13878,13 @@ export interface components {
          *     is a DNS name of at least two labels with no leading `@`. Storing two empty
          *     lists means open access.
          *
-         *     `expected_version` is optional: when present, the save is rejected with
-         *     409 unless it equals the stored allowlist's `version` (and when nothing is
-         *     stored, any `expected_version` other than null is a conflict). Omit it for
-         *     last-write-wins.
+         *     `expected_version` is optional and makes the save a compare-and-set:
+         *
+         *     - omitted or null: last-write-wins, never a conflict.
+         *     - `0`: no allowlist may be stored yet; the save is rejected with 409 when
+         *       one is. Send it when the `version` last read was null.
+         *     - a positive value: the save is rejected with 409 unless it equals the
+         *       stored allowlist's `version`, and also when nothing is stored.
          */
         AdminAuthAllowlistUpdate: {
             /**
@@ -13884,7 +13901,9 @@ export interface components {
             emails: string[];
             /**
              * Format: int64
-             * @description The `version` the caller last read; omit or null for last-write-wins.
+             * @description The `version` the caller last read. Send `0` when that `version` was
+             *     null, to save only while nothing is stored. Omit it or send null for
+             *     last-write-wins. A negative value matches nothing and is a 409.
              */
             expected_version?: number | null;
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibexp/api-client",
-  "version": "0.98.0",
+  "version": "0.99.0",
   "description": "Typed VibeXP API client generated from the OpenAPI spec (openapi-fetch main entrypoint, axios SDK at ./axios)",
   "license": "MIT",
   "repository": {