@surfiran/public-api-client 0.28.0 → 0.29.0

package/README.md

@@ -18,7 +18,7 @@ The repository split and production cutover are complete. This repository is the
 
 `contract/public-api-v1.yaml` is the package-local immutable snapshot used for generation. `contract/provenance.json` records its source identity, immutable source revision, checksums, and, for standalone releases, the exact API artifact identity.
 
-The checked-in `0.28.0` snapshot and provenance come from the `SURFIRAN/surfiran-crm-api` main-branch release `public-api-contract/56ba99f1008e85dd59b51d91be29ac23fa3a1051-36217113430-1`. Published `0.20.0` and earlier keep their historical provenance, which may still reference the former monorepo owner or path. Do not rewrite an already published package version solely to rename historical provenance.
+The checked-in `0.29.0` snapshot and provenance come from the `SURFIRAN/surfiran-crm-api` main-branch release `public-api-contract/ad9252578477406f13cb7db52e4f12c32715b00e-36233980383-1`. Published `0.20.0` and earlier keep their historical provenance, which may still reference the former monorepo owner or path. Do not rewrite an already published package version solely to rename historical provenance.
 
 New client versions must consume the exact immutable GitHub Release assets produced from a successful `SURFIRAN/surfiran-crm-api` main-branch CI run. The release tag is `public-api-contract/<source SHA>-<run ID>-<attempt>` and contains only `public-api-v1.yaml` and `manifest.json`. Publication verifies the immutable release and both GitHub release attestations, the tag SHA, final successful source run, asset digests, manifest identity, and checked-in snapshot bytes. If any check is unavailable, publication stops. Pull-request artifacts are verification evidence only and are not valid release inputs. This repository must never read another repository's private working tree at build time.
 
@@ -94,6 +94,6 @@ Published versions are immutable. Rollback means pinning consumers to the previo
 - This README owns local setup, contract synchronization, CI, publication, and rollback guidance.
 - [AGENTS.md](AGENTS.md) owns agent operating instructions.
 - [Repository boundaries and documentation governance](https://github.com/SURFIRAN/surfiran-crm-api/blob/main/docs/architecture/REPOSITORY_BOUNDARIES.md) own shared architecture and current system state.
-- [Contract snapshot](contract/public-api-v1.yaml) and [provenance](contract/provenance.json) are immutable evidence for `0.28.0`, not current API ownership authorities.
+- [Contract snapshot](contract/public-api-v1.yaml) and [provenance](contract/provenance.json) are immutable evidence for `0.29.0`, not current API ownership authorities.
 
 Update existing guidance instead of creating duplicate contract or publication authorities. Preserve the historical snapshot, provenance, and generated bytes until a reviewed new package version imports a verified API artifact.

package/dist/types.d.ts

@@ -1002,6 +1002,18 @@ export type PublicSearchResultItem = {
     slug: string;
     path: string;
     summary: string | null;
+    /**
+     * Present only when a non-English locale was explicitly requested. Locale of
+     * the displayed label, from approved field provenance; `en` means the English
+     * source is displayed as a fallback (always the case for destinations).
+     */
+    labelSourceLocale?: PublicContentLocale;
+    /**
+     * Present only when a non-English locale was explicitly requested. Locale of
+     * the displayed summary, from approved field provenance; null when `summary`
+     * is null, and `en` when the English source is displayed as a fallback.
+     */
+    summarySourceLocale?: PublicContentLocale | null;
 };
 export type PublicSearchResultGroup = {
     type: 'tour' | 'destination';
@@ -1566,7 +1578,7 @@ export type ListPublicToursParams = {
     locale?: PublicContentLocale;
 };
 /** Locales the public content contract will resolve translations for. */
-export type PublicContentLocale = 'en' | 'de' | 'fr' | 'es' | 'it' | 'fa' | 'ar';
+export type PublicContentLocale = 'en' | 'de' | 'fr' | 'tr' | 'ru' | 'es' | 'it' | 'fa' | 'ar';
 export type GetPublicTourParams = {
     /** See ListPublicToursParams['locale']. */
     locale?: PublicContentLocale;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surfiran/public-api-client",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "TypeScript types and client for SURFIRAN CRM Public API V1",
   "type": "module",
   "engines": {