@strapi/upload 5.51.2 → 5.52.1

package/dist/admin/future/components/TruncatedText.mjs

@@ -0,0 +1,74 @@
+import { jsx } from 'react/jsx-runtime';
+import { useRef, useState } from 'react';
+import { Tooltip, Typography } from '@strapi/design-system';
+
+/**
+ * Text that ellipsizes, with a tooltip carrying the full value once it actually
+ * does. Used for folder and asset names, which are user-supplied and routinely
+ * longer than the column, card or rail holding them.
+ *
+ * The tooltip is conditional rather than always-on: a permanent tooltip would
+ * make every short name hoverable for no reason, and would announce a
+ * description that merely repeats the visible text.
+ *
+ * Whether the text is truncated can't be derived from the string — it depends on
+ * the rendered width — so it has to be measured. That measurement happens when
+ * the pointer or focus arrives, not at mount.
+ *
+ * Measuring at mount is the obvious approach and it does not work here. The
+ * reading is only correct once the row's width constraint has reached this span,
+ * and the tree remounts its rows during first render: the instance that survives
+ * can take its one measurement while still unconstrained, conclude it fits, and
+ * be stuck there. Nothing corrects it afterwards, because a ResizeObserver on
+ * this span never fires again — an ancestor clamps the row, so the text
+ * overflows inside a box whose own size stops changing.
+ *
+ * Reading on hover sidesteps all of that. It is the only moment the answer is
+ * needed, the layout is settled by then, and nothing is cached across remounts
+ * or resizes that could go stale.
+ */ const TruncatedText = ({ children, ...props })=>{
+    const textRef = useRef(null);
+    const [isTruncated, setIsTruncated] = useState(false);
+    const checkTruncation = ()=>{
+        const el = textRef.current;
+        if (el) {
+            setIsTruncated(el.scrollWidth > el.clientWidth);
+        }
+    };
+    // A ref callback rather than useRef alone, so the first measurement happens
+    // when the node attaches and again whenever it is replaced. The tree remounts
+    // its rows during first render, and a value measured against the discarded
+    // node would never be revisited — this re-runs against the node that survives.
+    const attachRef = (el)=>{
+        textRef.current = el;
+        if (el) {
+            checkTruncation();
+        }
+    };
+    // The Tooltip stays mounted and the *label* is what's conditional, rather than
+    // swapping between a wrapped and unwrapped span. Swapping loses the first
+    // hover: the measurement that decides to show a tooltip is itself triggered by
+    // the pointer arriving, so the trigger would mount underneath a pointer that
+    // has already entered, and Radix — which starts watching at mount — sees no
+    // enter event and stays closed until the pointer leaves and returns.
+    //
+    // With `label` empty the DS Tooltip renders its child as-is and attaches
+    // nothing, so untruncated text still costs no DOM node and announces no
+    // description duplicating what is already on screen.
+    return /*#__PURE__*/ jsx(Tooltip, {
+        label: isTruncated ? children : undefined,
+        children: /*#__PURE__*/ jsx(Typography, {
+            ref: attachRef,
+            ellipsis: true,
+            // Focus is covered as well as hover: the tooltip has to be reachable by
+            // keyboard, and these rows are buttons.
+            onPointerEnter: checkTruncation,
+            onFocus: checkTruncation,
+            ...props,
+            children: children
+        })
+    });
+};
+
+export { TruncatedText };
+//# sourceMappingURL=TruncatedText.mjs.map

package/dist/admin/future/components/TruncatedText.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TruncatedText.mjs","sources":["../../../../admin/src/future/components/TruncatedText.tsx"],"sourcesContent":["import { useRef, useState } from 'react';\n\nimport { Tooltip, Typography, type TypographyProps } from '@strapi/design-system';\n\ninterface TruncatedTextProps extends Omit<TypographyProps, 'children' | 'ellipsis'> {\n  /** The full text. Doubles as the tooltip content once it no longer fits. */\n  children: string;\n}\n\n/**\n * Text that ellipsizes, with a tooltip carrying the full value once it actually\n * does. Used for folder and asset names, which are user-supplied and routinely\n * longer than the column, card or rail holding them.\n *\n * The tooltip is conditional rather than always-on: a permanent tooltip would\n * make every short name hoverable for no reason, and would announce a\n * description that merely repeats the visible text.\n *\n * Whether the text is truncated can't be derived from the string — it depends on\n * the rendered width — so it has to be measured. That measurement happens when\n * the pointer or focus arrives, not at mount.\n *\n * Measuring at mount is the obvious approach and it does not work here. The\n * reading is only correct once the row's width constraint has reached this span,\n * and the tree remounts its rows during first render: the instance that survives\n * can take its one measurement while still unconstrained, conclude it fits, and\n * be stuck there. Nothing corrects it afterwards, because a ResizeObserver on\n * this span never fires again — an ancestor clamps the row, so the text\n * overflows inside a box whose own size stops changing.\n *\n * Reading on hover sidesteps all of that. It is the only moment the answer is\n * needed, the layout is settled by then, and nothing is cached across remounts\n * or resizes that could go stale.\n */\nexport const TruncatedText = ({ children, ...props }: TruncatedTextProps) => {\n  const textRef = useRef<HTMLSpanElement | null>(null);\n  const [isTruncated, setIsTruncated] = useState(false);\n\n  const checkTruncation = () => {\n    const el = textRef.current;\n\n    if (el) {\n      setIsTruncated(el.scrollWidth > el.clientWidth);\n    }\n  };\n\n  // A ref callback rather than useRef alone, so the first measurement happens\n  // when the node attaches and again whenever it is replaced. The tree remounts\n  // its rows during first render, and a value measured against the discarded\n  // node would never be revisited — this re-runs against the node that survives.\n  const attachRef = (el: HTMLSpanElement | null) => {\n    textRef.current = el;\n\n    if (el) {\n      checkTruncation();\n    }\n  };\n\n  // The Tooltip stays mounted and the *label* is what's conditional, rather than\n  // swapping between a wrapped and unwrapped span. Swapping loses the first\n  // hover: the measurement that decides to show a tooltip is itself triggered by\n  // the pointer arriving, so the trigger would mount underneath a pointer that\n  // has already entered, and Radix — which starts watching at mount — sees no\n  // enter event and stays closed until the pointer leaves and returns.\n  //\n  // With `label` empty the DS Tooltip renders its child as-is and attaches\n  // nothing, so untruncated text still costs no DOM node and announces no\n  // description duplicating what is already on screen.\n  return (\n    <Tooltip label={isTruncated ? children : undefined}>\n      <Typography\n        ref={attachRef}\n        ellipsis\n        // Focus is covered as well as hover: the tooltip has to be reachable by\n        // keyboard, and these rows are buttons.\n        onPointerEnter={checkTruncation}\n        onFocus={checkTruncation}\n        {...props}\n      >\n        {children}\n      </Typography>\n    </Tooltip>\n  );\n};\n"],"names":["TruncatedText","children","props","textRef","useRef","isTruncated","setIsTruncated","useState","checkTruncation","el","current","scrollWidth","clientWidth","attachRef","_jsx","Tooltip","label","undefined","Typography","ref","ellipsis","onPointerEnter","onFocus"],"mappings":";;;;AASA;;;;;;;;;;;;;;;;;;;;;;;;UAyBaA,aAAAA,GAAgB,CAAC,EAAEC,QAAQ,EAAE,GAAGC,KAAAA,EAA2B,GAAA;AACtE,IAAA,MAAMC,UAAUC,MAAAA,CAA+B,IAAA,CAAA;AAC/C,IAAA,MAAM,CAACC,WAAAA,EAAaC,cAAAA,CAAe,GAAGC,QAAAA,CAAS,KAAA,CAAA;AAE/C,IAAA,MAAMC,eAAAA,GAAkB,IAAA;QACtB,MAAMC,EAAAA,GAAKN,QAAQO,OAAO;AAE1B,QAAA,IAAID,EAAAA,EAAI;AACNH,YAAAA,cAAAA,CAAeG,EAAAA,CAAGE,WAAW,GAAGF,EAAAA,CAAGG,WAAW,CAAA;AAChD,QAAA;AACF,IAAA,CAAA;;;;;AAMA,IAAA,MAAMC,YAAY,CAACJ,EAAAA,GAAAA;AACjBN,QAAAA,OAAAA,CAAQO,OAAO,GAAGD,EAAAA;AAElB,QAAA,IAAIA,EAAAA,EAAI;AACND,YAAAA,eAAAA,EAAAA;AACF,QAAA;AACF,IAAA,CAAA;;;;;;;;;;;AAYA,IAAA,qBACEM,GAAA,CAACC,OAAAA,EAAAA;AAAQC,QAAAA,KAAAA,EAAOX,cAAcJ,QAAAA,GAAWgB,SAAAA;AACvC,QAAA,QAAA,gBAAAH,GAAA,CAACI,UAAAA,EAAAA;YACCC,GAAAA,EAAKN,SAAAA;YACLO,QAAQ,EAAA,IAAA;;;YAGRC,cAAAA,EAAgBb,eAAAA;YAChBc,OAAAA,EAASd,eAAAA;AACR,YAAA,GAAGN,KAAK;AAERD,YAAAA,QAAAA,EAAAA;;;AAIT;;;;"}

package/dist/admin/future/hooks/useAIMetadataEnabled.js

@@ -0,0 +1,39 @@
+'use strict';
+
+var ee = require('@strapi/admin/strapi-admin/ee');
+var constants = require('../../shared/constants.js');
+var settings = require('../services/settings.js');
+
+/**
+ * Whether the replace flow will actually regenerate AI metadata, so the UI only
+ * promises it when it happens.
+ *
+ * Two independent gates, both required — `GET /upload/settings` returns the
+ * stored `aiMetadata` toggle on its own, which stays `true` (its default) on
+ * licenses without AI, so the setting alone over-promises. The server's own
+ * check (`aiMetadata.isEnabled()`) ANDs the same two conditions.
+ *
+ * Pass `{ mime }` to add the third gate the replace flow applies: it only
+ * regenerates metadata for images the AI provider can read
+ * (`admin-upload.replaceFile` → `aiMetadata.processFiles`, which filters on this
+ * same allowlist). Promising it for a PDF — or for a GIF, which clears the
+ * server's looser `image/*` gate but is skipped by the provider — would describe
+ * something that never happens.
+ *
+ * The argument is an object rather than a bare `mime` so the two intents stay
+ * distinguishable: `File.mime` is optional on the contract, so a positional
+ * parameter let `useAIMetadataEnabled(asset.mime)` collapse into the ungated
+ * call whenever the mime was missing — silently taking the permissive path this
+ * hook exists to close. `useAIMetadataEnabled({ mime: undefined })` still gates
+ * (and fails closed); only an omitted `options` skips the mime check.
+ */ const useAIMetadataEnabled = (options)=>{
+    const isAIAvailable = ee.useAIAvailability();
+    const { data: settings$1 } = settings.useGetUploadSettingsQuery();
+    if (!isAIAvailable || !(settings$1?.data?.aiMetadata ?? false)) {
+        return false;
+    }
+    return options === undefined ? true : constants.isAIMetadataSupportedMime(options.mime);
+};
+
+exports.useAIMetadataEnabled = useAIMetadataEnabled;
+//# sourceMappingURL=useAIMetadataEnabled.js.map

package/dist/admin/future/hooks/useAIMetadataEnabled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAIMetadataEnabled.js","sources":["../../../../admin/src/future/hooks/useAIMetadataEnabled.ts"],"sourcesContent":["import { useAIAvailability } from '@strapi/admin/strapi-admin/ee';\n\nimport { isAIMetadataSupportedMime } from '../../../../shared/constants';\nimport { useGetUploadSettingsQuery } from '../services/settings';\n\n/**\n * Whether the replace flow will actually regenerate AI metadata, so the UI only\n * promises it when it happens.\n *\n * Two independent gates, both required — `GET /upload/settings` returns the\n * stored `aiMetadata` toggle on its own, which stays `true` (its default) on\n * licenses without AI, so the setting alone over-promises. The server's own\n * check (`aiMetadata.isEnabled()`) ANDs the same two conditions.\n *\n * Pass `{ mime }` to add the third gate the replace flow applies: it only\n * regenerates metadata for images the AI provider can read\n * (`admin-upload.replaceFile` → `aiMetadata.processFiles`, which filters on this\n * same allowlist). Promising it for a PDF — or for a GIF, which clears the\n * server's looser `image/*` gate but is skipped by the provider — would describe\n * something that never happens.\n *\n * The argument is an object rather than a bare `mime` so the two intents stay\n * distinguishable: `File.mime` is optional on the contract, so a positional\n * parameter let `useAIMetadataEnabled(asset.mime)` collapse into the ungated\n * call whenever the mime was missing — silently taking the permissive path this\n * hook exists to close. `useAIMetadataEnabled({ mime: undefined })` still gates\n * (and fails closed); only an omitted `options` skips the mime check.\n */\nexport const useAIMetadataEnabled = (options?: { mime?: string | null }): boolean => {\n  const isAIAvailable = useAIAvailability();\n  const { data: settings } = useGetUploadSettingsQuery();\n\n  if (!isAIAvailable || !(settings?.data?.aiMetadata ?? false)) {\n    return false;\n  }\n\n  return options === undefined ? true : isAIMetadataSupportedMime(options.mime);\n};\n"],"names":["useAIMetadataEnabled","options","isAIAvailable","useAIAvailability","data","settings","useGetUploadSettingsQuery","aiMetadata","undefined","isAIMetadataSupportedMime","mime"],"mappings":";;;;;;AAKA;;;;;;;;;;;;;;;;;;;;;;IAuBO,MAAMA,oBAAAA,GAAuB,CAACC,OAAAA,GAAAA;AACnC,IAAA,MAAMC,aAAAA,GAAgBC,oBAAAA,EAAAA;AACtB,IAAA,MAAM,EAAEC,IAAAA,EAAMC,UAAQ,EAAE,GAAGC,kCAAAA,EAAAA;IAE3B,IAAI,CAACJ,iBAAiB,EAAEG,YAAUD,IAAAA,EAAMG,UAAAA,IAAc,KAAI,CAAA,EAAI;QAC5D,OAAO,KAAA;AACT,IAAA;AAEA,IAAA,OAAON,OAAAA,KAAYO,SAAAA,GAAY,IAAA,GAAOC,mCAAAA,CAA0BR,QAAQS,IAAI,CAAA;AAC9E;;;;"}

package/dist/admin/future/hooks/useAIMetadataEnabled.mjs

@@ -0,0 +1,37 @@
+import { useAIAvailability } from '@strapi/admin/strapi-admin/ee';
+import { isAIMetadataSupportedMime } from '../../shared/constants.mjs';
+import { useGetUploadSettingsQuery } from '../services/settings.mjs';
+
+/**
+ * Whether the replace flow will actually regenerate AI metadata, so the UI only
+ * promises it when it happens.
+ *
+ * Two independent gates, both required — `GET /upload/settings` returns the
+ * stored `aiMetadata` toggle on its own, which stays `true` (its default) on
+ * licenses without AI, so the setting alone over-promises. The server's own
+ * check (`aiMetadata.isEnabled()`) ANDs the same two conditions.
+ *
+ * Pass `{ mime }` to add the third gate the replace flow applies: it only
+ * regenerates metadata for images the AI provider can read
+ * (`admin-upload.replaceFile` → `aiMetadata.processFiles`, which filters on this
+ * same allowlist). Promising it for a PDF — or for a GIF, which clears the
+ * server's looser `image/*` gate but is skipped by the provider — would describe
+ * something that never happens.
+ *
+ * The argument is an object rather than a bare `mime` so the two intents stay
+ * distinguishable: `File.mime` is optional on the contract, so a positional
+ * parameter let `useAIMetadataEnabled(asset.mime)` collapse into the ungated
+ * call whenever the mime was missing — silently taking the permissive path this
+ * hook exists to close. `useAIMetadataEnabled({ mime: undefined })` still gates
+ * (and fails closed); only an omitted `options` skips the mime check.
+ */ const useAIMetadataEnabled = (options)=>{
+    const isAIAvailable = useAIAvailability();
+    const { data: settings } = useGetUploadSettingsQuery();
+    if (!isAIAvailable || !(settings?.data?.aiMetadata ?? false)) {
+        return false;
+    }
+    return options === undefined ? true : isAIMetadataSupportedMime(options.mime);
+};
+
+export { useAIMetadataEnabled };
+//# sourceMappingURL=useAIMetadataEnabled.mjs.map

package/dist/admin/future/hooks/useAIMetadataEnabled.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAIMetadataEnabled.mjs","sources":["../../../../admin/src/future/hooks/useAIMetadataEnabled.ts"],"sourcesContent":["import { useAIAvailability } from '@strapi/admin/strapi-admin/ee';\n\nimport { isAIMetadataSupportedMime } from '../../../../shared/constants';\nimport { useGetUploadSettingsQuery } from '../services/settings';\n\n/**\n * Whether the replace flow will actually regenerate AI metadata, so the UI only\n * promises it when it happens.\n *\n * Two independent gates, both required — `GET /upload/settings` returns the\n * stored `aiMetadata` toggle on its own, which stays `true` (its default) on\n * licenses without AI, so the setting alone over-promises. The server's own\n * check (`aiMetadata.isEnabled()`) ANDs the same two conditions.\n *\n * Pass `{ mime }` to add the third gate the replace flow applies: it only\n * regenerates metadata for images the AI provider can read\n * (`admin-upload.replaceFile` → `aiMetadata.processFiles`, which filters on this\n * same allowlist). Promising it for a PDF — or for a GIF, which clears the\n * server's looser `image/*` gate but is skipped by the provider — would describe\n * something that never happens.\n *\n * The argument is an object rather than a bare `mime` so the two intents stay\n * distinguishable: `File.mime` is optional on the contract, so a positional\n * parameter let `useAIMetadataEnabled(asset.mime)` collapse into the ungated\n * call whenever the mime was missing — silently taking the permissive path this\n * hook exists to close. `useAIMetadataEnabled({ mime: undefined })` still gates\n * (and fails closed); only an omitted `options` skips the mime check.\n */\nexport const useAIMetadataEnabled = (options?: { mime?: string | null }): boolean => {\n  const isAIAvailable = useAIAvailability();\n  const { data: settings } = useGetUploadSettingsQuery();\n\n  if (!isAIAvailable || !(settings?.data?.aiMetadata ?? false)) {\n    return false;\n  }\n\n  return options === undefined ? true : isAIMetadataSupportedMime(options.mime);\n};\n"],"names":["useAIMetadataEnabled","options","isAIAvailable","useAIAvailability","data","settings","useGetUploadSettingsQuery","aiMetadata","undefined","isAIMetadataSupportedMime","mime"],"mappings":";;;;AAKA;;;;;;;;;;;;;;;;;;;;;;IAuBO,MAAMA,oBAAAA,GAAuB,CAACC,OAAAA,GAAAA;AACnC,IAAA,MAAMC,aAAAA,GAAgBC,iBAAAA,EAAAA;AACtB,IAAA,MAAM,EAAEC,IAAAA,EAAMC,QAAQ,EAAE,GAAGC,yBAAAA,EAAAA;IAE3B,IAAI,CAACJ,iBAAiB,EAAEG,UAAUD,IAAAA,EAAMG,UAAAA,IAAc,KAAI,CAAA,EAAI;QAC5D,OAAO,KAAA;AACT,IAAA;AAEA,IAAA,OAAON,OAAAA,KAAYO,SAAAA,GAAY,IAAA,GAAOC,yBAAAA,CAA0BR,QAAQS,IAAI,CAAA;AAC9E;;;;"}

package/dist/admin/future/hooks/useTracking.js

@@ -0,0 +1,57 @@
+'use strict';
+
+var React = require('react');
+var strapiAdmin = require('@strapi/admin/strapi-admin');
+var ee = require('@strapi/admin/strapi-admin/ee');
+var settings = require('../services/settings.js');
+
+/**
+ * Media Library version tag stamped on every event fired from the new
+ * (`src/future`) Media Library. Legacy events omit it, so analytics can filter
+ * new usage from the old plan while both trees emit the SAME event names (see
+ * CMS-246). Bump this if a future revamp ever needs its own bucket.
+ */ const MEDIA_LIBRARY_VERSION = 'v2';
+/**
+ * `location` value for every new Media Library event. The new tree is the
+ * standalone Media Library page, which the legacy plan tags `'upload'` (as
+ * opposed to `'content-manager'` for the asset-picker modal). Kept identical so
+ * migrated events line up with the legacy ones on the `location` axis.
+ */ const MEDIA_LIBRARY_LOCATION = 'upload';
+/**
+ * Tracking wrapper scoped to the new Media Library. Mirrors the legacy
+ * `admin/src/hooks/useTracking` — it forwards to the admin `trackUsage` and
+ * injects `isAiMediaLibraryConfigured` when AI is available — and additionally
+ * stamps `mediaLibraryVersion` on every event so the migrated plan stays
+ * distinguishable from the legacy one.
+ *
+ * The cast mirrors the legacy wrapper: these two properties are cross-cutting
+ * media-tracking metadata that the admin `TrackingEvent` type does not (and
+ * should not) enumerate per event.
+ */ const useTracking = ()=>{
+    const { trackUsage: trackStrapiUsage } = strapiAdmin.useTracking();
+    const { data } = settings.useGetUploadSettingsQuery();
+    const isAiAvailable = ee.useAIAvailability();
+    // Memoised so consumers can safely list `trackUsage` in effect deps (the
+    // search-input debounce commit does) without re-firing every render.
+    const trackUsage = React.useCallback((event, properties)=>{
+        return trackStrapiUsage(event, {
+            ...properties,
+            ...isAiAvailable ? {
+                isAiMediaLibraryConfigured: Boolean(data?.data?.aiMetadata)
+            } : {},
+            mediaLibraryVersion: MEDIA_LIBRARY_VERSION
+        });
+    }, [
+        trackStrapiUsage,
+        isAiAvailable,
+        data
+    ]);
+    return {
+        trackUsage
+    };
+};
+
+exports.MEDIA_LIBRARY_LOCATION = MEDIA_LIBRARY_LOCATION;
+exports.MEDIA_LIBRARY_VERSION = MEDIA_LIBRARY_VERSION;
+exports.useTracking = useTracking;
+//# sourceMappingURL=useTracking.js.map

package/dist/admin/future/hooks/useTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTracking.js","sources":["../../../../admin/src/future/hooks/useTracking.ts"],"sourcesContent":["import { useCallback } from 'react';\n\nimport { useTracking as useStrapiTracking, type TrackingEvent } from '@strapi/admin/strapi-admin';\nimport { useAIAvailability } from '@strapi/admin/strapi-admin/ee';\n\nimport { useGetUploadSettingsQuery } from '../services/settings';\n\n/**\n * Media Library version tag stamped on every event fired from the new\n * (`src/future`) Media Library. Legacy events omit it, so analytics can filter\n * new usage from the old plan while both trees emit the SAME event names (see\n * CMS-246). Bump this if a future revamp ever needs its own bucket.\n */\nexport const MEDIA_LIBRARY_VERSION = 'v2';\n\n/**\n * `location` value for every new Media Library event. The new tree is the\n * standalone Media Library page, which the legacy plan tags `'upload'` (as\n * opposed to `'content-manager'` for the asset-picker modal). Kept identical so\n * migrated events line up with the legacy ones on the `location` axis.\n */\nexport const MEDIA_LIBRARY_LOCATION = 'upload';\n\n/**\n * Tracking wrapper scoped to the new Media Library. Mirrors the legacy\n * `admin/src/hooks/useTracking` — it forwards to the admin `trackUsage` and\n * injects `isAiMediaLibraryConfigured` when AI is available — and additionally\n * stamps `mediaLibraryVersion` on every event so the migrated plan stays\n * distinguishable from the legacy one.\n *\n * The cast mirrors the legacy wrapper: these two properties are cross-cutting\n * media-tracking metadata that the admin `TrackingEvent` type does not (and\n * should not) enumerate per event.\n */\nexport const useTracking = () => {\n  const { trackUsage: trackStrapiUsage } = useStrapiTracking();\n  const { data } = useGetUploadSettingsQuery();\n  const isAiAvailable = useAIAvailability();\n\n  // Memoised so consumers can safely list `trackUsage` in effect deps (the\n  // search-input debounce commit does) without re-firing every render.\n  const trackUsage = useCallback(\n    <TEvent extends TrackingEvent>(event: TEvent['name'], properties?: TEvent['properties']) => {\n      return trackStrapiUsage(event, {\n        ...properties,\n        ...(isAiAvailable ? { isAiMediaLibraryConfigured: Boolean(data?.data?.aiMetadata) } : {}),\n        mediaLibraryVersion: MEDIA_LIBRARY_VERSION,\n      } as TEvent['properties']);\n    },\n    [trackStrapiUsage, isAiAvailable, data]\n  );\n\n  return { trackUsage };\n};\n"],"names":["MEDIA_LIBRARY_VERSION","MEDIA_LIBRARY_LOCATION","useTracking","trackUsage","trackStrapiUsage","useStrapiTracking","data","useGetUploadSettingsQuery","isAiAvailable","useAIAvailability","useCallback","event","properties","isAiMediaLibraryConfigured","Boolean","aiMetadata","mediaLibraryVersion"],"mappings":";;;;;;;AAOA;;;;;IAMO,MAAMA,qBAAAA,GAAwB;AAErC;;;;;IAMO,MAAMC,sBAAAA,GAAyB;AAEtC;;;;;;;;;;UAWaC,WAAAA,GAAc,IAAA;AACzB,IAAA,MAAM,EAAEC,UAAAA,EAAYC,gBAAgB,EAAE,GAAGC,uBAAAA,EAAAA;IACzC,MAAM,EAAEC,IAAI,EAAE,GAAGC,kCAAAA,EAAAA;AACjB,IAAA,MAAMC,aAAAA,GAAgBC,oBAAAA,EAAAA;;;IAItB,MAAMN,UAAAA,GAAaO,iBAAAA,CACjB,CAA+BC,KAAAA,EAAuBC,UAAAA,GAAAA;AACpD,QAAA,OAAOR,iBAAiBO,KAAAA,EAAO;AAC7B,YAAA,GAAGC,UAAU;AACb,YAAA,GAAIJ,aAAAA,GAAgB;gBAAEK,0BAAAA,EAA4BC,OAAAA,CAAQR,MAAMA,IAAAA,EAAMS,UAAAA;AAAY,aAAA,GAAI,EAAE;YACxFC,mBAAAA,EAAqBhB;AACvB,SAAA,CAAA;IACF,CAAA,EACA;AAACI,QAAAA,gBAAAA;AAAkBI,QAAAA,aAAAA;AAAeF,QAAAA;AAAK,KAAA,CAAA;IAGzC,OAAO;AAAEH,QAAAA;AAAW,KAAA;AACtB;;;;;;"}

package/dist/admin/future/hooks/useTracking.mjs

@@ -0,0 +1,53 @@
+import { useCallback } from 'react';
+import { useTracking as useTracking$1 } from '@strapi/admin/strapi-admin';
+import { useAIAvailability } from '@strapi/admin/strapi-admin/ee';
+import { useGetUploadSettingsQuery } from '../services/settings.mjs';
+
+/**
+ * Media Library version tag stamped on every event fired from the new
+ * (`src/future`) Media Library. Legacy events omit it, so analytics can filter
+ * new usage from the old plan while both trees emit the SAME event names (see
+ * CMS-246). Bump this if a future revamp ever needs its own bucket.
+ */ const MEDIA_LIBRARY_VERSION = 'v2';
+/**
+ * `location` value for every new Media Library event. The new tree is the
+ * standalone Media Library page, which the legacy plan tags `'upload'` (as
+ * opposed to `'content-manager'` for the asset-picker modal). Kept identical so
+ * migrated events line up with the legacy ones on the `location` axis.
+ */ const MEDIA_LIBRARY_LOCATION = 'upload';
+/**
+ * Tracking wrapper scoped to the new Media Library. Mirrors the legacy
+ * `admin/src/hooks/useTracking` — it forwards to the admin `trackUsage` and
+ * injects `isAiMediaLibraryConfigured` when AI is available — and additionally
+ * stamps `mediaLibraryVersion` on every event so the migrated plan stays
+ * distinguishable from the legacy one.
+ *
+ * The cast mirrors the legacy wrapper: these two properties are cross-cutting
+ * media-tracking metadata that the admin `TrackingEvent` type does not (and
+ * should not) enumerate per event.
+ */ const useTracking = ()=>{
+    const { trackUsage: trackStrapiUsage } = useTracking$1();
+    const { data } = useGetUploadSettingsQuery();
+    const isAiAvailable = useAIAvailability();
+    // Memoised so consumers can safely list `trackUsage` in effect deps (the
+    // search-input debounce commit does) without re-firing every render.
+    const trackUsage = useCallback((event, properties)=>{
+        return trackStrapiUsage(event, {
+            ...properties,
+            ...isAiAvailable ? {
+                isAiMediaLibraryConfigured: Boolean(data?.data?.aiMetadata)
+            } : {},
+            mediaLibraryVersion: MEDIA_LIBRARY_VERSION
+        });
+    }, [
+        trackStrapiUsage,
+        isAiAvailable,
+        data
+    ]);
+    return {
+        trackUsage
+    };
+};
+
+export { MEDIA_LIBRARY_LOCATION, MEDIA_LIBRARY_VERSION, useTracking };
+//# sourceMappingURL=useTracking.mjs.map

package/dist/admin/future/hooks/useTracking.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTracking.mjs","sources":["../../../../admin/src/future/hooks/useTracking.ts"],"sourcesContent":["import { useCallback } from 'react';\n\nimport { useTracking as useStrapiTracking, type TrackingEvent } from '@strapi/admin/strapi-admin';\nimport { useAIAvailability } from '@strapi/admin/strapi-admin/ee';\n\nimport { useGetUploadSettingsQuery } from '../services/settings';\n\n/**\n * Media Library version tag stamped on every event fired from the new\n * (`src/future`) Media Library. Legacy events omit it, so analytics can filter\n * new usage from the old plan while both trees emit the SAME event names (see\n * CMS-246). Bump this if a future revamp ever needs its own bucket.\n */\nexport const MEDIA_LIBRARY_VERSION = 'v2';\n\n/**\n * `location` value for every new Media Library event. The new tree is the\n * standalone Media Library page, which the legacy plan tags `'upload'` (as\n * opposed to `'content-manager'` for the asset-picker modal). Kept identical so\n * migrated events line up with the legacy ones on the `location` axis.\n */\nexport const MEDIA_LIBRARY_LOCATION = 'upload';\n\n/**\n * Tracking wrapper scoped to the new Media Library. Mirrors the legacy\n * `admin/src/hooks/useTracking` — it forwards to the admin `trackUsage` and\n * injects `isAiMediaLibraryConfigured` when AI is available — and additionally\n * stamps `mediaLibraryVersion` on every event so the migrated plan stays\n * distinguishable from the legacy one.\n *\n * The cast mirrors the legacy wrapper: these two properties are cross-cutting\n * media-tracking metadata that the admin `TrackingEvent` type does not (and\n * should not) enumerate per event.\n */\nexport const useTracking = () => {\n  const { trackUsage: trackStrapiUsage } = useStrapiTracking();\n  const { data } = useGetUploadSettingsQuery();\n  const isAiAvailable = useAIAvailability();\n\n  // Memoised so consumers can safely list `trackUsage` in effect deps (the\n  // search-input debounce commit does) without re-firing every render.\n  const trackUsage = useCallback(\n    <TEvent extends TrackingEvent>(event: TEvent['name'], properties?: TEvent['properties']) => {\n      return trackStrapiUsage(event, {\n        ...properties,\n        ...(isAiAvailable ? { isAiMediaLibraryConfigured: Boolean(data?.data?.aiMetadata) } : {}),\n        mediaLibraryVersion: MEDIA_LIBRARY_VERSION,\n      } as TEvent['properties']);\n    },\n    [trackStrapiUsage, isAiAvailable, data]\n  );\n\n  return { trackUsage };\n};\n"],"names":["MEDIA_LIBRARY_VERSION","MEDIA_LIBRARY_LOCATION","useTracking","trackUsage","trackStrapiUsage","useStrapiTracking","data","useGetUploadSettingsQuery","isAiAvailable","useAIAvailability","useCallback","event","properties","isAiMediaLibraryConfigured","Boolean","aiMetadata","mediaLibraryVersion"],"mappings":";;;;;AAOA;;;;;IAMO,MAAMA,qBAAAA,GAAwB;AAErC;;;;;IAMO,MAAMC,sBAAAA,GAAyB;AAEtC;;;;;;;;;;UAWaC,WAAAA,GAAc,IAAA;AACzB,IAAA,MAAM,EAAEC,UAAAA,EAAYC,gBAAgB,EAAE,GAAGC,aAAAA,EAAAA;IACzC,MAAM,EAAEC,IAAI,EAAE,GAAGC,yBAAAA,EAAAA;AACjB,IAAA,MAAMC,aAAAA,GAAgBC,iBAAAA,EAAAA;;;IAItB,MAAMN,UAAAA,GAAaO,WAAAA,CACjB,CAA+BC,KAAAA,EAAuBC,UAAAA,GAAAA;AACpD,QAAA,OAAOR,iBAAiBO,KAAAA,EAAO;AAC7B,YAAA,GAAGC,UAAU;AACb,YAAA,GAAIJ,aAAAA,GAAgB;gBAAEK,0BAAAA,EAA4BC,OAAAA,CAAQR,MAAMA,IAAAA,EAAMS,UAAAA;AAAY,aAAA,GAAI,EAAE;YACxFC,mBAAAA,EAAqBhB;AACvB,SAAA,CAAA;IACF,CAAA,EACA;AAACI,QAAAA,gBAAAA;AAAkBI,QAAAA,aAAAA;AAAeF,QAAAA;AAAK,KAAA,CAAA;IAGzC,OAAO;AAAEH,QAAAA;AAAW,KAAA;AACtB;;;;"}