@atlaskit/smart-card 44.5.1 → 44.5.3

package/dist/esm/state/services/personalization/index.js

@@ -0,0 +1,258 @@
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _typeof from "@babel/runtime/helpers/typeof";
+import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
+import _createClass from "@babel/runtime/helpers/createClass";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+import { StorageClient } from '@atlaskit/frontend-utilities/storage-client';
+import { getCurrentSiteCloudId, getCachedCurrentSiteCloudIdAndRefresh } from '../current-site-cloud-id';
+var BASE_URL = '/gateway/api/tap-delivery/api/v3/personalization';
+
+/**
+ * Logical key shape: `@atlaskit/smart-card:<feature>:<schema-version>:<scope>` (see smart-card
+ * storage conventions). {@link StorageClient} narrows the localStorage key to
+ * `<clientKey>_<itemKey>` with `clientKey === '@atlaskit/smart-card'` and
+ * `itemKey === 'pct-map:v1:<cloudId>:<traitName>'` (scope segments URI-encoded).
+ */
+export var PERSONALIZATION_STORAGE_SCOPE = '@atlaskit/smart-card';
+export var PERSONALIZATION_STORAGE_ITEM_KEY_PREFIX = 'pct-map:v1:';
+var smartCardStorage = new StorageClient(PERSONALIZATION_STORAGE_SCOPE);
+
+/** Keys written by this service in localStorage when using {@link smartCardStorage}. */
+var LOCAL_STORAGE_ROW_KEY_PREFIX = "".concat(PERSONALIZATION_STORAGE_SCOPE, "_").concat(PERSONALIZATION_STORAGE_ITEM_KEY_PREFIX);
+function pctMapStorageItemKey(cloudId, traitName) {
+  return "".concat(PERSONALIZATION_STORAGE_ITEM_KEY_PREFIX).concat(encodeURIComponent(cloudId), ":").concat(encodeURIComponent(traitName));
+}
+function fetchSiteTraits(_x) {
+  return _fetchSiteTraits.apply(this, arguments);
+}
+/**
+ * Service for fetching site-level traits from the TAP Delivery personalization API.
+ */
+function _fetchSiteTraits() {
+  _fetchSiteTraits = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3(cloudId) {
+    var _data$attributes;
+    var response, data;
+    return _regeneratorRuntime.wrap(function _callee3$(_context3) {
+      while (1) switch (_context3.prev = _context3.next) {
+        case 0:
+          _context3.next = 2;
+          return fetch("".concat(BASE_URL, "/site/").concat(cloudId), {
+            method: 'GET',
+            credentials: 'include',
+            headers: {
+              'Content-Type': 'application/json'
+            }
+          });
+        case 2:
+          response = _context3.sent;
+          if (response.ok) {
+            _context3.next = 5;
+            break;
+          }
+          return _context3.abrupt("return", []);
+        case 5:
+          _context3.next = 7;
+          return response.json();
+        case 7:
+          data = _context3.sent;
+          return _context3.abrupt("return", (_data$attributes = data === null || data === void 0 ? void 0 : data.attributes) !== null && _data$attributes !== void 0 ? _data$attributes : []);
+        case 9:
+        case "end":
+          return _context3.stop();
+      }
+    }, _callee3);
+  }));
+  return _fetchSiteTraits.apply(this, arguments);
+}
+export var PersonalizationService = /*#__PURE__*/function () {
+  function PersonalizationService() {
+    _classCallCheck(this, PersonalizationService);
+    _defineProperty(this, "cache", new Map());
+  }
+  return _createClass(PersonalizationService, [{
+    key: "getCachedProviderPctMapAndRefresh",
+    value:
+    /**
+     * Returns the currently cached provider percentage map synchronously and starts a background refresh.
+     * The refresh result is persisted for future calls but is not awaited by this call.
+     */
+    function getCachedProviderPctMapAndRefresh(traitName) {
+      var cloudId = getCachedCurrentSiteCloudIdAndRefresh();
+      var fromStorage = cloudId && this.readStoredProviderPctMap(cloudId, traitName) || null;
+      void this.getProviderPctMap(traitName);
+      return fromStorage;
+    }
+  }, {
+    key: "getProviderPctMap",
+    value: function () {
+      var _getProviderPctMap = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(traitName) {
+        var _this = this;
+        var cachedPromise, promise;
+        return _regeneratorRuntime.wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              cachedPromise = this.cache.get(traitName);
+              if (!cachedPromise) {
+                _context2.next = 3;
+                break;
+              }
+              return _context2.abrupt("return", cachedPromise);
+            case 3:
+              promise = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+                var cloudId, traits, trait, mapped;
+                return _regeneratorRuntime.wrap(function _callee$(_context) {
+                  while (1) switch (_context.prev = _context.next) {
+                    case 0:
+                      _context.prev = 0;
+                      _context.next = 3;
+                      return getCurrentSiteCloudId();
+                    case 3:
+                      cloudId = _context.sent;
+                      if (cloudId) {
+                        _context.next = 6;
+                        break;
+                      }
+                      return _context.abrupt("return", undefined);
+                    case 6:
+                      _context.next = 8;
+                      return fetchSiteTraits(cloudId);
+                    case 8:
+                      traits = _context.sent;
+                      trait = traits.find(function (t) {
+                        return t.name === traitName;
+                      });
+                      mapped = _this.parseTraitValue(trait === null || trait === void 0 ? void 0 : trait.value);
+                      if (mapped !== undefined) {
+                        _this.writeStoredProviderPctMap(cloudId, traitName, mapped);
+                      }
+                      return _context.abrupt("return", mapped);
+                    case 15:
+                      _context.prev = 15;
+                      _context.t0 = _context["catch"](0);
+                      return _context.abrupt("return", undefined);
+                    case 18:
+                    case "end":
+                      return _context.stop();
+                  }
+                }, _callee, null, [[0, 15]]);
+              }))();
+              this.cache.set(traitName, promise);
+              return _context2.abrupt("return", promise);
+            case 6:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this);
+      }));
+      function getProviderPctMap(_x2) {
+        return _getProviderPctMap.apply(this, arguments);
+      }
+      return getProviderPctMap;
+    }()
+  }, {
+    key: "readStoredProviderPctMap",
+    value: function readStoredProviderPctMap(cloudId, traitName) {
+      try {
+        var stored = smartCardStorage.getItem(pctMapStorageItemKey(cloudId, traitName));
+        if (stored === undefined || stored === null) {
+          return null;
+        }
+        return this.normalizeProviderPctMap(stored);
+      } catch (_unused2) {
+        return null;
+      }
+    }
+  }, {
+    key: "writeStoredProviderPctMap",
+    value: function writeStoredProviderPctMap(cloudId, traitName, map) {
+      try {
+        smartCardStorage.setItemWithExpiry(pctMapStorageItemKey(cloudId, traitName), map);
+      } catch (_unused3) {
+        // Quota, private-mode, etc.
+      }
+    }
+  }, {
+    key: "normalizeProviderPctMap",
+    value: function normalizeProviderPctMap(value) {
+      if (_typeof(value) !== 'object' || value === null || Array.isArray(value)) {
+        return null;
+      }
+      var map = {};
+      var entries = Object.entries(value);
+      for (var _i = 0, _entries = entries; _i < _entries.length; _i++) {
+        var _entries$_i = _slicedToArray(_entries[_i], 2),
+          providerKey = _entries$_i[0],
+          percentageRaw = _entries$_i[1];
+        if (typeof percentageRaw !== 'number' || !Number.isFinite(percentageRaw)) {
+          return null;
+        }
+        map[providerKey] = percentageRaw;
+      }
+      return map;
+    }
+  }, {
+    key: "parseTraitValue",
+    value: function parseTraitValue(raw) {
+      if (typeof raw !== 'string') {
+        return undefined;
+      }
+      try {
+        var parsed = JSON.parse(raw);
+        var normalized = this.normalizeProviderPctMap(parsed);
+        return normalized === null ? undefined : normalized;
+      } catch (_unused4) {
+        return undefined;
+      }
+    }
+  }, {
+    key: "clearCache",
+    value: function clearCache() {
+      this.cache.clear();
+      this.clearStoredProviderPctMaps();
+    }
+  }, {
+    key: "clearStoredProviderPctMaps",
+    value: function clearStoredProviderPctMaps() {
+      if (typeof globalThis.localStorage === 'undefined' || globalThis.localStorage === null) {
+        return;
+      }
+      var keysToRemove = [];
+      for (var index = 0; index < globalThis.localStorage.length; index += 1) {
+        var key = globalThis.localStorage.key(index);
+        if (key !== null && key.startsWith(LOCAL_STORAGE_ROW_KEY_PREFIX)) {
+          keysToRemove.push(key);
+        }
+      }
+      for (var _i2 = 0, _keysToRemove = keysToRemove; _i2 < _keysToRemove.length; _i2++) {
+        var _key = _keysToRemove[_i2];
+        try {
+          globalThis.localStorage.removeItem(_key);
+        } catch (_unused5) {
+          /* ignore */
+        }
+      }
+    }
+  }]);
+}();
+export var personalizationService = new PersonalizationService();
+
+/**
+ * Resolves the provider percentage map for a TAP Delivery trait through the module-level
+ * {@link personalizationService}. Work is deduped per trait name for the page lifetime, and a
+ * successful response is persisted by cloud id and trait name for later cached reads.
+ */
+export var getProviderPctMap = function getProviderPctMap(traitName) {
+  return personalizationService.getProviderPctMap(traitName);
+};
+
+/**
+ * Reads the provider percentage map for a trait from browser storage via the module-level
+ * {@link personalizationService} singleton, without awaiting network work.
+ * Calling this also starts the trait-scoped shared refresh in the background, so a later call can
+ * use a refreshed value when it becomes available.
+ */
+export function getCachedProviderPctMapAndRefresh(traitName) {
+  return personalizationService.getCachedProviderPctMapAndRefresh(traitName);
+}

package/dist/esm/utils/analytics/analytics.js

@@ -4,7 +4,7 @@ export var ANALYTICS_CHANNEL = 'media';
 export var context = {
   componentName: 'smart-cards',
   packageName: "@atlaskit/smart-card" || '',
-  packageVersion: "44.5.0" || ''
+  packageVersion: "44.5.2" || ''
 };
 export var TrackQuickActionType = /*#__PURE__*/function (TrackQuickActionType) {
   TrackQuickActionType["StatusUpdate"] = "StatusUpdate";

package/dist/esm/view/LinkUrl/index.js

@@ -15,7 +15,7 @@ import LinkWarningModal from './LinkWarningModal';
 import { useLinkWarningModal } from './LinkWarningModal/hooks/use-link-warning-modal';
 var PACKAGE_DATA = {
   packageName: "@atlaskit/smart-card",
-  packageVersion: "44.5.0",
+  packageVersion: "44.5.2",
   componentName: 'linkUrl'
 };
 var Anchor = withLinkClickedEvent('a');

package/dist/types/common/ui/icons/blog-icon.d.ts

@@ -1,7 +1,7 @@
 import type { FC } from 'react';
 import type { ObjectProps } from '@atlaskit/object/types';
 import type { SmartLinkSize } from '../../../constants';
-declare const BlogIconWithColor: FC<Omit<ObjectProps, "size"> & {
+declare const BlogIconWithColor: FC<Omit<ObjectProps, 'size'> & {
     size?: SmartLinkSize;
 }>;
 export default BlogIconWithColor;

package/dist/types/common/ui/icons/live-document-icon.d.ts

@@ -1,7 +1,7 @@
 import type { FC } from 'react';
 import type { ObjectProps } from '@atlaskit/object/types';
 import type { SmartLinkSize } from '../../../constants';
-declare const LiveDocumentIconWithColor: FC<Omit<ObjectProps, "size"> & {
+declare const LiveDocumentIconWithColor: FC<Omit<ObjectProps, 'size'> & {
     size?: SmartLinkSize;
 }>;
 export default LiveDocumentIconWithColor;

package/dist/types/state/hooks/use-current-site-cloud-id/index.d.ts

@@ -0,0 +1,6 @@
+export { CURRENT_SITE_CLOUD_ID_LOCAL_STORAGE_KEY, CURRENT_SITE_CLOUD_ID_STORAGE_ITEM_KEY, currentSiteCloudIdService, getCurrentSiteCloudId, getCachedCurrentSiteCloudIdAndRefresh, } from '../../services/current-site-cloud-id';
+declare const useCurrentSiteCloudId: () => {
+    cloudId: string | undefined;
+    isLoading: boolean;
+};
+export default useCurrentSiteCloudId;

package/dist/types/state/hooks/use-social-proof/index.d.ts

@@ -0,0 +1,13 @@
+export interface SocialProof {
+    connectedPct: number | undefined;
+    isEnabled: boolean;
+    /** True while fetching personalization (only when `isEnabled`). */
+    isLoading: boolean;
+}
+/**
+ * Fetches provider usage percentage from the TAP Delivery personalization service when the
+ * killswitch allows it. Callers decide separately (e.g. via Statsig experiment) whether to
+ * surface that data in the UI.
+ */
+declare const useSocialProof: (traitName: string, extensionKey?: string, isKillswitchOn?: boolean) => SocialProof;
+export default useSocialProof;

package/dist/types/state/services/current-site-cloud-id/index.d.ts

@@ -0,0 +1,46 @@
+export declare const CURRENT_SITE_CLOUD_ID_STORAGE_ITEM_KEY: string;
+/** Keys written by this service in localStorage when using {@link smartCardStorage}. */
+export declare const CURRENT_SITE_CLOUD_ID_LOCAL_STORAGE_KEY: string;
+export declare class CurrentSiteCloudIdService {
+    /**
+     * Holds the shared tenant_info work: one in-flight fetch, then (on success) a settled promise for the session cloud
+     * id so later callers never trigger another `tenant_info` in the same page lifetime (until {@link clearCache}).
+     */
+    private tenantInfoInflightPromise;
+    private readStoredCloudId;
+    private writeStoredCloudId;
+    private ensureTenantInfoInflightStarted;
+    /**
+     * Returns the currently cached cloud id synchronously and starts a background refresh.
+     * The refresh result is persisted for future calls but is not awaited by this call.
+     */
+    getCachedCloudIdAndRefresh(): string | undefined;
+    /** Writes tenant cloud id for tests or callers that intentionally warm storage before edge resolves. */
+    persistStoredCloudId(cloudId: string): void;
+    /**
+     * When local storage already has a tenant cloud id, it is returned immediately; a background tenant_info refresh
+     * is still kicked off unless one is already in flight.
+     *
+     * Without storage, this awaits the deduped in-flight tenant_info (first concurrent caller chooses the URL;
+     * all share one promise regardless of subsequent `baseUriWithNoTrailingSlash`).
+     *
+     * On network success with no cloud id, or on failure: falls back via {@link readStoredCloudId}.
+     */
+    get(baseUriWithNoTrailingSlash?: string): Promise<string | undefined>;
+    /** Clears the session pin so the next {@link get} may run `tenant_info` again (e.g. tests). */
+    clearCache(): void;
+}
+export declare const currentSiteCloudIdService: CurrentSiteCloudIdService;
+/**
+ * Resolves the current site cloud id through the module-level {@link currentSiteCloudIdService}.
+ * Returns a stored cloud id immediately when one exists; otherwise waits for the shared
+ * `tenant_info` request and persists the result for subsequent cached reads.
+ */
+export declare const getCurrentSiteCloudId: (baseUriWithNoTrailingSlash?: string) => Promise<string | undefined>;
+/**
+ * Reads the current site cloud id from browser storage (the `site-cloud-id:v1` row) via the
+ * module-level {@link currentSiteCloudIdService} singleton, without awaiting network work.
+ * Calling this also starts the shared `tenant_info` refresh in the background when one is not
+ * already running, so a later call can observe a refreshed value when available.
+ */
+export declare function getCachedCurrentSiteCloudIdAndRefresh(): string | undefined;

package/dist/types/state/services/personalization/index.d.ts

@@ -0,0 +1,41 @@
+import type { ProviderPctMap } from './types';
+/**
+ * Logical key shape: `@atlaskit/smart-card:<feature>:<schema-version>:<scope>` (see smart-card
+ * storage conventions). {@link StorageClient} narrows the localStorage key to
+ * `<clientKey>_<itemKey>` with `clientKey === '@atlaskit/smart-card'` and
+ * `itemKey === 'pct-map:v1:<cloudId>:<traitName>'` (scope segments URI-encoded).
+ */
+export declare const PERSONALIZATION_STORAGE_SCOPE: string;
+export declare const PERSONALIZATION_STORAGE_ITEM_KEY_PREFIX: string;
+/**
+ * Service for fetching site-level traits from the TAP Delivery personalization API.
+ */
+export declare class PersonalizationService {
+    private cache;
+    /**
+     * Returns the currently cached provider percentage map synchronously and starts a background refresh.
+     * The refresh result is persisted for future calls but is not awaited by this call.
+     */
+    getCachedProviderPctMapAndRefresh(traitName: string): ProviderPctMap | null;
+    getProviderPctMap(traitName: string): Promise<ProviderPctMap | undefined>;
+    private readStoredProviderPctMap;
+    private writeStoredProviderPctMap;
+    private normalizeProviderPctMap;
+    private parseTraitValue;
+    clearCache(): void;
+    private clearStoredProviderPctMaps;
+}
+export declare const personalizationService: PersonalizationService;
+/**
+ * Resolves the provider percentage map for a TAP Delivery trait through the module-level
+ * {@link personalizationService}. Work is deduped per trait name for the page lifetime, and a
+ * successful response is persisted by cloud id and trait name for later cached reads.
+ */
+export declare const getProviderPctMap: (traitName: string) => Promise<ProviderPctMap | undefined>;
+/**
+ * Reads the provider percentage map for a trait from browser storage via the module-level
+ * {@link personalizationService} singleton, without awaiting network work.
+ * Calling this also starts the trait-scoped shared refresh in the background, so a later call can
+ * use a refreshed value when it becomes available.
+ */
+export declare function getCachedProviderPctMapAndRefresh(traitName: string): ProviderPctMap | null;

package/dist/types/state/services/personalization/types.d.ts

@@ -0,0 +1,10 @@
+export type PersonalizationTrait = {
+    name: string;
+    value: string | boolean | number;
+};
+/**
+ * Map of extensionKey to connected users percentage.
+ * Keys are extensionKeys directly (e.g. 'google-object-provider').
+ * Values are integers 0-100.
+ */
+export type ProviderPctMap = Record<string, number>;

package/dist/types/view/FlexibleCard/assets/ai-chapter-icon.d.ts

@@ -1,5 +1,6 @@
-declare const AiChapterIcon: {
+interface AiChapterIconFunction {
     (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const AiChapterIcon: AiChapterIconFunction;
 export default AiChapterIcon;

package/dist/types/view/FlexibleCard/assets/ai-edit-icon.d.ts

@@ -1,5 +1,6 @@
-declare const AiEditIcon: {
+interface AiEditIconFunction {
     (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const AiEditIcon: AiEditIconFunction;
 export default AiEditIcon;

package/dist/types/view/FlexibleCard/assets/ai-search-icon.d.ts

@@ -1,5 +1,6 @@
-declare const AiSearchIcon: {
+interface AiSearchIconFunction {
     (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const AiSearchIcon: AiSearchIconFunction;
 export default AiSearchIcon;

package/dist/types/view/FlexibleCard/assets/rovo-hex-logo.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
-declare const RovoHexLogo: {
-    ({ width, height, ...props }: React.SVGProps<SVGSVGElement>): React.JSX.Element;
+interface RovoHexLogoFunction {
+    (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const RovoHexLogo: RovoHexLogoFunction;
 export default RovoHexLogo;

package/dist/types-ts4.5/common/ui/icons/blog-icon.d.ts

@@ -1,7 +1,7 @@
 import type { FC } from 'react';
 import type { ObjectProps } from '@atlaskit/object/types';
 import type { SmartLinkSize } from '../../../constants';
-declare const BlogIconWithColor: FC<Omit<ObjectProps, "size"> & {
+declare const BlogIconWithColor: FC<Omit<ObjectProps, 'size'> & {
     size?: SmartLinkSize;
 }>;
 export default BlogIconWithColor;

package/dist/types-ts4.5/common/ui/icons/live-document-icon.d.ts

@@ -1,7 +1,7 @@
 import type { FC } from 'react';
 import type { ObjectProps } from '@atlaskit/object/types';
 import type { SmartLinkSize } from '../../../constants';
-declare const LiveDocumentIconWithColor: FC<Omit<ObjectProps, "size"> & {
+declare const LiveDocumentIconWithColor: FC<Omit<ObjectProps, 'size'> & {
     size?: SmartLinkSize;
 }>;
 export default LiveDocumentIconWithColor;

package/dist/types-ts4.5/state/hooks/use-current-site-cloud-id/index.d.ts

@@ -0,0 +1,6 @@
+export { CURRENT_SITE_CLOUD_ID_LOCAL_STORAGE_KEY, CURRENT_SITE_CLOUD_ID_STORAGE_ITEM_KEY, currentSiteCloudIdService, getCurrentSiteCloudId, getCachedCurrentSiteCloudIdAndRefresh, } from '../../services/current-site-cloud-id';
+declare const useCurrentSiteCloudId: () => {
+    cloudId: string | undefined;
+    isLoading: boolean;
+};
+export default useCurrentSiteCloudId;

package/dist/types-ts4.5/state/hooks/use-social-proof/index.d.ts

@@ -0,0 +1,13 @@
+export interface SocialProof {
+    connectedPct: number | undefined;
+    isEnabled: boolean;
+    /** True while fetching personalization (only when `isEnabled`). */
+    isLoading: boolean;
+}
+/**
+ * Fetches provider usage percentage from the TAP Delivery personalization service when the
+ * killswitch allows it. Callers decide separately (e.g. via Statsig experiment) whether to
+ * surface that data in the UI.
+ */
+declare const useSocialProof: (traitName: string, extensionKey?: string, isKillswitchOn?: boolean) => SocialProof;
+export default useSocialProof;

package/dist/types-ts4.5/state/services/current-site-cloud-id/index.d.ts

@@ -0,0 +1,46 @@
+export declare const CURRENT_SITE_CLOUD_ID_STORAGE_ITEM_KEY: string;
+/** Keys written by this service in localStorage when using {@link smartCardStorage}. */
+export declare const CURRENT_SITE_CLOUD_ID_LOCAL_STORAGE_KEY: string;
+export declare class CurrentSiteCloudIdService {
+    /**
+     * Holds the shared tenant_info work: one in-flight fetch, then (on success) a settled promise for the session cloud
+     * id so later callers never trigger another `tenant_info` in the same page lifetime (until {@link clearCache}).
+     */
+    private tenantInfoInflightPromise;
+    private readStoredCloudId;
+    private writeStoredCloudId;
+    private ensureTenantInfoInflightStarted;
+    /**
+     * Returns the currently cached cloud id synchronously and starts a background refresh.
+     * The refresh result is persisted for future calls but is not awaited by this call.
+     */
+    getCachedCloudIdAndRefresh(): string | undefined;
+    /** Writes tenant cloud id for tests or callers that intentionally warm storage before edge resolves. */
+    persistStoredCloudId(cloudId: string): void;
+    /**
+     * When local storage already has a tenant cloud id, it is returned immediately; a background tenant_info refresh
+     * is still kicked off unless one is already in flight.
+     *
+     * Without storage, this awaits the deduped in-flight tenant_info (first concurrent caller chooses the URL;
+     * all share one promise regardless of subsequent `baseUriWithNoTrailingSlash`).
+     *
+     * On network success with no cloud id, or on failure: falls back via {@link readStoredCloudId}.
+     */
+    get(baseUriWithNoTrailingSlash?: string): Promise<string | undefined>;
+    /** Clears the session pin so the next {@link get} may run `tenant_info` again (e.g. tests). */
+    clearCache(): void;
+}
+export declare const currentSiteCloudIdService: CurrentSiteCloudIdService;
+/**
+ * Resolves the current site cloud id through the module-level {@link currentSiteCloudIdService}.
+ * Returns a stored cloud id immediately when one exists; otherwise waits for the shared
+ * `tenant_info` request and persists the result for subsequent cached reads.
+ */
+export declare const getCurrentSiteCloudId: (baseUriWithNoTrailingSlash?: string) => Promise<string | undefined>;
+/**
+ * Reads the current site cloud id from browser storage (the `site-cloud-id:v1` row) via the
+ * module-level {@link currentSiteCloudIdService} singleton, without awaiting network work.
+ * Calling this also starts the shared `tenant_info` refresh in the background when one is not
+ * already running, so a later call can observe a refreshed value when available.
+ */
+export declare function getCachedCurrentSiteCloudIdAndRefresh(): string | undefined;

package/dist/types-ts4.5/state/services/personalization/index.d.ts

@@ -0,0 +1,41 @@
+import type { ProviderPctMap } from './types';
+/**
+ * Logical key shape: `@atlaskit/smart-card:<feature>:<schema-version>:<scope>` (see smart-card
+ * storage conventions). {@link StorageClient} narrows the localStorage key to
+ * `<clientKey>_<itemKey>` with `clientKey === '@atlaskit/smart-card'` and
+ * `itemKey === 'pct-map:v1:<cloudId>:<traitName>'` (scope segments URI-encoded).
+ */
+export declare const PERSONALIZATION_STORAGE_SCOPE: string;
+export declare const PERSONALIZATION_STORAGE_ITEM_KEY_PREFIX: string;
+/**
+ * Service for fetching site-level traits from the TAP Delivery personalization API.
+ */
+export declare class PersonalizationService {
+    private cache;
+    /**
+     * Returns the currently cached provider percentage map synchronously and starts a background refresh.
+     * The refresh result is persisted for future calls but is not awaited by this call.
+     */
+    getCachedProviderPctMapAndRefresh(traitName: string): ProviderPctMap | null;
+    getProviderPctMap(traitName: string): Promise<ProviderPctMap | undefined>;
+    private readStoredProviderPctMap;
+    private writeStoredProviderPctMap;
+    private normalizeProviderPctMap;
+    private parseTraitValue;
+    clearCache(): void;
+    private clearStoredProviderPctMaps;
+}
+export declare const personalizationService: PersonalizationService;
+/**
+ * Resolves the provider percentage map for a TAP Delivery trait through the module-level
+ * {@link personalizationService}. Work is deduped per trait name for the page lifetime, and a
+ * successful response is persisted by cloud id and trait name for later cached reads.
+ */
+export declare const getProviderPctMap: (traitName: string) => Promise<ProviderPctMap | undefined>;
+/**
+ * Reads the provider percentage map for a trait from browser storage via the module-level
+ * {@link personalizationService} singleton, without awaiting network work.
+ * Calling this also starts the trait-scoped shared refresh in the background, so a later call can
+ * use a refreshed value when it becomes available.
+ */
+export declare function getCachedProviderPctMapAndRefresh(traitName: string): ProviderPctMap | null;

package/dist/types-ts4.5/state/services/personalization/types.d.ts

@@ -0,0 +1,10 @@
+export type PersonalizationTrait = {
+    name: string;
+    value: string | boolean | number;
+};
+/**
+ * Map of extensionKey to connected users percentage.
+ * Keys are extensionKeys directly (e.g. 'google-object-provider').
+ * Values are integers 0-100.
+ */
+export type ProviderPctMap = Record<string, number>;

package/dist/types-ts4.5/view/FlexibleCard/assets/ai-chapter-icon.d.ts

@@ -1,5 +1,6 @@
-declare const AiChapterIcon: {
+interface AiChapterIconFunction {
     (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const AiChapterIcon: AiChapterIconFunction;
 export default AiChapterIcon;

package/dist/types-ts4.5/view/FlexibleCard/assets/ai-edit-icon.d.ts

@@ -1,5 +1,6 @@
-declare const AiEditIcon: {
+interface AiEditIconFunction {
     (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const AiEditIcon: AiEditIconFunction;
 export default AiEditIcon;

package/dist/types-ts4.5/view/FlexibleCard/assets/ai-search-icon.d.ts

@@ -1,5 +1,6 @@
-declare const AiSearchIcon: {
+interface AiSearchIconFunction {
     (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const AiSearchIcon: AiSearchIconFunction;
 export default AiSearchIcon;

package/dist/types-ts4.5/view/FlexibleCard/assets/rovo-hex-logo.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
-declare const RovoHexLogo: {
-    ({ width, height, ...props }: React.SVGProps<SVGSVGElement>): React.JSX.Element;
+interface RovoHexLogoFunction {
+    (props: React.SVGProps<SVGSVGElement>): React.JSX.Element;
     displayName: string;
-};
+}
+declare const RovoHexLogo: RovoHexLogoFunction;
 export default RovoHexLogo;