kaafil-js 0.1.0-beta.7 → 0.2.0

package/dist/{vocabulary-Cjd7p4_r.d.cts → vocabulary-uZXjYsxn.d.cts}

@@ -48979,6 +48979,12 @@ declare class ApiKeyEnvironmentMismatchError extends KaafilConfigError {
  * outright (self-hosted / proxied / sandbox deployment) — the two are never
  * merged or partially applied. Construction-time and immutable: there is no
  * setter, callers re-construct a client to point elsewhere.
+ *
+ * `environment` is validated here rather than in each constructor because
+ * this is the one call every client entry point makes before anything else
+ * reads `environment` — including the `baseUrl`-override path, where the
+ * value is otherwise never looked at and would go on to mis-shape the API
+ * key guard and the sandbox-only `test` resource.
  */
 declare function resolveBaseUrl(environment: Environment, baseUrl?: string): string;
 
@@ -49774,8 +49780,18 @@ declare class KaafilPaginationInFlightError extends KaafilPaginationError {
 declare class KaafilPaginationExhaustedError extends KaafilPaginationError {
     constructor();
 }
+/**
+ * A `list()` call builds one of these and returns it SYNCHRONOUSLY, before
+ * any request goes out: it is not a promise, and `await list()` is a no-op
+ * that hands back this same object with `items: []`. The first page arrives
+ * only from `await paginator.next()` or from iterating the paginator — an
+ * untouched paginator reading as an empty tenant is the shape of that
+ * mistake, and `meta === undefined` distinguishes "not fetched yet" from a
+ * genuinely empty first page.
+ */
 interface KaafilPaginator<T, F> {
-    /** Every row fetched so far, across every page pulled on the current filters. */
+    /** Every row fetched so far, across every page pulled on the current
+     * filters — `[]` until `next()` (or iteration) has actually run. */
     readonly items: readonly T[];
     /** From the last page's `meta.page.hasNext` — `true` until a first fetch has run. */
     readonly hasNext: boolean;

package/dist/{vocabulary-Cjd7p4_r.d.ts → vocabulary-uZXjYsxn.d.ts}

@@ -48979,6 +48979,12 @@ declare class ApiKeyEnvironmentMismatchError extends KaafilConfigError {
  * outright (self-hosted / proxied / sandbox deployment) — the two are never
  * merged or partially applied. Construction-time and immutable: there is no
  * setter, callers re-construct a client to point elsewhere.
+ *
+ * `environment` is validated here rather than in each constructor because
+ * this is the one call every client entry point makes before anything else
+ * reads `environment` — including the `baseUrl`-override path, where the
+ * value is otherwise never looked at and would go on to mis-shape the API
+ * key guard and the sandbox-only `test` resource.
  */
 declare function resolveBaseUrl(environment: Environment, baseUrl?: string): string;
 
@@ -49774,8 +49780,18 @@ declare class KaafilPaginationInFlightError extends KaafilPaginationError {
 declare class KaafilPaginationExhaustedError extends KaafilPaginationError {
     constructor();
 }
+/**
+ * A `list()` call builds one of these and returns it SYNCHRONOUSLY, before
+ * any request goes out: it is not a promise, and `await list()` is a no-op
+ * that hands back this same object with `items: []`. The first page arrives
+ * only from `await paginator.next()` or from iterating the paginator — an
+ * untouched paginator reading as an empty tenant is the shape of that
+ * mistake, and `meta === undefined` distinguishes "not fetched yet" from a
+ * genuinely empty first page.
+ */
 interface KaafilPaginator<T, F> {
-    /** Every row fetched so far, across every page pulled on the current filters. */
+    /** Every row fetched so far, across every page pulled on the current
+     * filters — `[]` until `next()` (or iteration) has actually run. */
     readonly items: readonly T[];
     /** From the last page's `meta.page.hasNext` — `true` until a first fetch has run. */
     readonly hasNext: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kaafil-js",
-  "version": "0.1.0-beta.7",
+  "version": "0.2.0",
   "description": "Headless, typed TypeScript client for the Kaafil on-ground and post-trip engine.",
   "keywords": [
     "kaafil",
@@ -23,7 +23,7 @@
   },
   "publishConfig": {
     "access": "public",
-    "tag": "beta",
+    "tag": "latest",
     "provenance": true
   },
   "exports": {
@@ -73,6 +73,7 @@
     "smoke:surface": "pnpm build && node smoke/browser-entry-surface.mjs",
     "smoke:offline": "pnpm build && node smoke/offline-engine.mjs",
     "smoke": "pnpm build && node smoke/browser-entry-surface.mjs && node smoke/offline-engine.mjs",
+    "release": "pnpm build && pnpm publish --tag latest --no-provenance",
     "release:beta": "pnpm build && pnpm publish --tag beta --no-provenance"
   }
 }