@quizbase/client 0.8.0 → 0.9.0

package/dist/index.d.cts

@@ -606,7 +606,7 @@ interface paths {
         };
         /**
          * List region codes (cultural affinity)
-         * @description Discovery dla `regions` filter. **Cultural affinity** — pytanie ma code regionu, jeśli mieszkańcy kraju lub członkowie grupy kulturowej/religijnej są statystycznie częściej w stanie odpowiedzieć (NIE geografia tematu pytania). Lowercase ISO 3166-1 alpha-2 (`us`, `pl`, `gb`) + cultural codes (`jewish`, `christian-catholic`, `islam` — LLM schema whitelist parity). Sourced z `mv_region_counts` (pre-aggregated TABLE). Cardinality ~150 distinct codes per language.
+         * @description Discovery dla `regions` filter. **Cultural affinity** — pytanie ma code regionu, jeśli mieszkańcy kraju lub członkowie grupy kulturowej/religijnej są statystycznie częściej w stanie odpowiedzieć (NIE geografia tematu pytania). Lowercase ISO 3166-1 alpha-2 (`us`, `pl`, `gb`) + cultural codes (`jewish`, `christian-catholic`, `islam` — LLM schema whitelist parity). Sourced from a pre-aggregated table. Cardinality ~150 distinct codes per language.
          */
         get: {
             parameters: {
@@ -939,13 +939,13 @@ interface paths {
                     topic?: string;
                     topics_any?: string;
                     subcategory?: string;
-                    /** @description Quality preset: "high" (default) skips needs_review=true; "all" includes everything */
+                    /** @description Quality preset: "high" (default) skips questions flagged for review; "all" includes everything */
                     quality?: "high" | "all";
                     /** @description Cultural affinity codes. A question is tagged with a region if residents of that country, or members of that cultural/religious group, are statistically more likely to know the answer (NOT geography of the subject). Lowercase ISO 3166-1 alpha-2 (e.g. `us`, `pl`, `gb`) plus cultural codes (`jewish`, `christian-catholic`, `islam`). AND-logic. Empty array on a question = universally accessible (no cultural advantage). Discover via `GET /api/v1/regions`. Uppercase tolerated on input (normalized to lowercase). */
                     regions?: string;
                     source?: "arc" | "creak" | "entityq" | "kqa-pro" | "mintaka" | "mkqa" | "nq-open" | "opentdb" | "opentriviaqa" | "qasc" | "quizbase" | "webq";
                     license?: "CC-BY-SA-4.0" | "CC-BY-SA-3.0" | "CC-BY-4.0" | "MIT" | "proprietary";
-                    count?: "estimate" | "none";
+                    count?: "exact" | "none";
                 };
                 header?: never;
                 path?: never;
@@ -1042,7 +1042,7 @@ interface paths {
                     topic?: string;
                     topics_any?: string;
                     subcategory?: string;
-                    /** @description Quality preset: "high" (default) skips needs_review=true; "all" includes everything */
+                    /** @description Quality preset: "high" (default) skips questions flagged for review; "all" includes everything */
                     quality?: "high" | "all";
                     /** @description Cultural affinity codes. A question is tagged with a region if residents of that country, or members of that cultural/religious group, are statistically more likely to know the answer (NOT geography of the subject). Lowercase ISO 3166-1 alpha-2 (e.g. `us`, `pl`, `gb`) plus cultural codes (`jewish`, `christian-catholic`, `islam`). AND-logic. Empty array on a question = universally accessible (no cultural advantage). Discover via `GET /api/v1/regions`. Uppercase tolerated on input (normalized to lowercase). */
                     regions?: string;
@@ -1458,7 +1458,7 @@ interface components {
             /** @example 146384 */
             count: number;
         };
-        /** @description Difficulty distribution across 5 LLM-calibrated levels (Plan 121) plus `unrated` for pre-rescore records. */
+        /** @description Difficulty distribution across 5 LLM-calibrated levels plus `unrated` for records not yet LLM-rated. */
         StatsByDifficulty: {
             /** @example 12480 */
             trivial: number;
@@ -1489,7 +1489,7 @@ interface components {
             /** @example 15281 */
             count: number;
         };
-        /** @description Top regions by cultural affinity (Plan 120). Code = ISO 3166-1 alpha-2 or cultural identifier; not a geographic filter — indicates "person from this region has higher statistical chance to answer correctly". */
+        /** @description Top regions by cultural affinity. Code = ISO 3166-1 alpha-2 or cultural identifier; not a geographic filter — indicates "person from this region has higher statistical chance to answer correctly". */
         StatsTopRegions: {
             /** @example us */
             code: string;
@@ -1498,7 +1498,7 @@ interface components {
             /** @example 309090 */
             count: number;
         }[];
-        /** @description Counts of records eligible for `?quality=high` filter (Plan 121: needs_review=false AND content_grade != 0) per language. */
+        /** @description Counts of records eligible for the `?quality=high` filter per language. */
         StatsByQualityHigh: {
             /** @example 329266 */
             en: number;
@@ -1885,16 +1885,16 @@ interface components {
              */
             count: number;
             /**
-             * @description Planner-estimated total (default `count=estimate`, ±5-50% accuracy).
+             * @description Exact count of matching questions. Present only when `count=exact`. Omitted by default — page via cursor + `_links.next`.
              * @example 545379
              */
-            totalEstimate?: number;
+            total?: number;
             /**
              * @description Echo of the `count` query param.
-             * @example estimate
+             * @example none
              * @enum {string}
              */
-            countMode?: "estimate" | "none";
+            countMode?: "exact" | "none";
             /**
              * @description Language of the response content.
              * @example en

package/dist/index.d.ts

@@ -606,7 +606,7 @@ interface paths {
         };
         /**
          * List region codes (cultural affinity)
-         * @description Discovery dla `regions` filter. **Cultural affinity** — pytanie ma code regionu, jeśli mieszkańcy kraju lub członkowie grupy kulturowej/religijnej są statystycznie częściej w stanie odpowiedzieć (NIE geografia tematu pytania). Lowercase ISO 3166-1 alpha-2 (`us`, `pl`, `gb`) + cultural codes (`jewish`, `christian-catholic`, `islam` — LLM schema whitelist parity). Sourced z `mv_region_counts` (pre-aggregated TABLE). Cardinality ~150 distinct codes per language.
+         * @description Discovery dla `regions` filter. **Cultural affinity** — pytanie ma code regionu, jeśli mieszkańcy kraju lub członkowie grupy kulturowej/religijnej są statystycznie częściej w stanie odpowiedzieć (NIE geografia tematu pytania). Lowercase ISO 3166-1 alpha-2 (`us`, `pl`, `gb`) + cultural codes (`jewish`, `christian-catholic`, `islam` — LLM schema whitelist parity). Sourced from a pre-aggregated table. Cardinality ~150 distinct codes per language.
          */
         get: {
             parameters: {
@@ -939,13 +939,13 @@ interface paths {
                     topic?: string;
                     topics_any?: string;
                     subcategory?: string;
-                    /** @description Quality preset: "high" (default) skips needs_review=true; "all" includes everything */
+                    /** @description Quality preset: "high" (default) skips questions flagged for review; "all" includes everything */
                     quality?: "high" | "all";
                     /** @description Cultural affinity codes. A question is tagged with a region if residents of that country, or members of that cultural/religious group, are statistically more likely to know the answer (NOT geography of the subject). Lowercase ISO 3166-1 alpha-2 (e.g. `us`, `pl`, `gb`) plus cultural codes (`jewish`, `christian-catholic`, `islam`). AND-logic. Empty array on a question = universally accessible (no cultural advantage). Discover via `GET /api/v1/regions`. Uppercase tolerated on input (normalized to lowercase). */
                     regions?: string;
                     source?: "arc" | "creak" | "entityq" | "kqa-pro" | "mintaka" | "mkqa" | "nq-open" | "opentdb" | "opentriviaqa" | "qasc" | "quizbase" | "webq";
                     license?: "CC-BY-SA-4.0" | "CC-BY-SA-3.0" | "CC-BY-4.0" | "MIT" | "proprietary";
-                    count?: "estimate" | "none";
+                    count?: "exact" | "none";
                 };
                 header?: never;
                 path?: never;
@@ -1042,7 +1042,7 @@ interface paths {
                     topic?: string;
                     topics_any?: string;
                     subcategory?: string;
-                    /** @description Quality preset: "high" (default) skips needs_review=true; "all" includes everything */
+                    /** @description Quality preset: "high" (default) skips questions flagged for review; "all" includes everything */
                     quality?: "high" | "all";
                     /** @description Cultural affinity codes. A question is tagged with a region if residents of that country, or members of that cultural/religious group, are statistically more likely to know the answer (NOT geography of the subject). Lowercase ISO 3166-1 alpha-2 (e.g. `us`, `pl`, `gb`) plus cultural codes (`jewish`, `christian-catholic`, `islam`). AND-logic. Empty array on a question = universally accessible (no cultural advantage). Discover via `GET /api/v1/regions`. Uppercase tolerated on input (normalized to lowercase). */
                     regions?: string;
@@ -1458,7 +1458,7 @@ interface components {
             /** @example 146384 */
             count: number;
         };
-        /** @description Difficulty distribution across 5 LLM-calibrated levels (Plan 121) plus `unrated` for pre-rescore records. */
+        /** @description Difficulty distribution across 5 LLM-calibrated levels plus `unrated` for records not yet LLM-rated. */
         StatsByDifficulty: {
             /** @example 12480 */
             trivial: number;
@@ -1489,7 +1489,7 @@ interface components {
             /** @example 15281 */
             count: number;
         };
-        /** @description Top regions by cultural affinity (Plan 120). Code = ISO 3166-1 alpha-2 or cultural identifier; not a geographic filter — indicates "person from this region has higher statistical chance to answer correctly". */
+        /** @description Top regions by cultural affinity. Code = ISO 3166-1 alpha-2 or cultural identifier; not a geographic filter — indicates "person from this region has higher statistical chance to answer correctly". */
         StatsTopRegions: {
             /** @example us */
             code: string;
@@ -1498,7 +1498,7 @@ interface components {
             /** @example 309090 */
             count: number;
         }[];
-        /** @description Counts of records eligible for `?quality=high` filter (Plan 121: needs_review=false AND content_grade != 0) per language. */
+        /** @description Counts of records eligible for the `?quality=high` filter per language. */
         StatsByQualityHigh: {
             /** @example 329266 */
             en: number;
@@ -1885,16 +1885,16 @@ interface components {
              */
             count: number;
             /**
-             * @description Planner-estimated total (default `count=estimate`, ±5-50% accuracy).
+             * @description Exact count of matching questions. Present only when `count=exact`. Omitted by default — page via cursor + `_links.next`.
              * @example 545379
              */
-            totalEstimate?: number;
+            total?: number;
             /**
              * @description Echo of the `count` query param.
-             * @example estimate
+             * @example none
              * @enum {string}
              */
-            countMode?: "estimate" | "none";
+            countMode?: "exact" | "none";
             /**
              * @description Language of the response content.
              * @example en

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quizbase/client",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "TypeScript SDK for QuizBase API — typed client, retry, RFC 9457 errors, telemetry hook. Generated from openapi.json.",
   "license": "MIT",
   "author": "Maciej Dzierżek",