@pro-laico/payload-dev-tools 0.0.0

package/dist/endpoints/dev.d.ts

@@ -0,0 +1,12 @@
+import type { Endpoint } from 'payload';
+/**
+ * `GET /api/dev` — the machine-readable snapshot (see {@link buildDevSnapshot}) for `fetch`,
+ * `curl`, and AI agents. A browser asking for HTML is redirected to the dev pages (`devRoute`,
+ * where the host mounts `createDevPage`) — the human view lives there, inside the app;
+ * `?format=json` skips the redirect. Outside dev it 404s (see {@link devToolsEnabled}).
+ */
+export declare function createDevEndpoint({ enabled, devRoute }: {
+    enabled?: boolean;
+    devRoute: string;
+}): Endpoint;
+//# sourceMappingURL=dev.d.ts.map

package/dist/endpoints/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/endpoints/dev.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAIvC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAc1G"}

package/dist/endpoints/dev.js

@@ -0,0 +1,31 @@
+import { buildDevSnapshot } from "../lib/snapshot.js";
+import { devToolsEnabled } from "../options.js";
+/**
+ * `GET /api/dev` — the machine-readable snapshot (see {@link buildDevSnapshot}) for `fetch`,
+ * `curl`, and AI agents. A browser asking for HTML is redirected to the dev pages (`devRoute`,
+ * where the host mounts `createDevPage`) — the human view lives there, inside the app;
+ * `?format=json` skips the redirect. Outside dev it 404s (see {@link devToolsEnabled}).
+ */ export function createDevEndpoint({ enabled, devRoute }) {
+    return {
+        path: '/dev',
+        method: 'get',
+        handler: async (req)=>{
+            if (!devToolsEnabled(enabled)) return Response.json({
+                error: 'Not found'
+            }, {
+                status: 404
+            });
+            const url = new URL(req.url ?? '/api/dev', 'http://localhost');
+            const wantsHtml = url.searchParams.get('format') !== 'json' && (req.headers.get('accept') ?? '').includes('text/html');
+            if (wantsHtml) return new Response(null, {
+                status: 307,
+                headers: {
+                    location: devRoute
+                }
+            });
+            return Response.json(await buildDevSnapshot(req.payload));
+        }
+    };
+}
+
+//# sourceMappingURL=dev.js.map

package/dist/endpoints/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/dev.ts"],"sourcesContent":["import type { Endpoint } from 'payload'\nimport { buildDevSnapshot } from '../lib/snapshot'\nimport { devToolsEnabled } from '../options'\n\n/**\n * `GET /api/dev` — the machine-readable snapshot (see {@link buildDevSnapshot}) for `fetch`,\n * `curl`, and AI agents. A browser asking for HTML is redirected to the dev pages (`devRoute`,\n * where the host mounts `createDevPage`) — the human view lives there, inside the app;\n * `?format=json` skips the redirect. Outside dev it 404s (see {@link devToolsEnabled}).\n */\nexport function createDevEndpoint({ enabled, devRoute }: { enabled?: boolean; devRoute: string }): Endpoint {\n  return {\n    path: '/dev',\n    method: 'get',\n    handler: async (req) => {\n      if (!devToolsEnabled(enabled)) return Response.json({ error: 'Not found' }, { status: 404 })\n\n      const url = new URL(req.url ?? '/api/dev', 'http://localhost')\n      const wantsHtml = url.searchParams.get('format') !== 'json' && (req.headers.get('accept') ?? '').includes('text/html')\n      if (wantsHtml) return new Response(null, { status: 307, headers: { location: devRoute } })\n\n      return Response.json(await buildDevSnapshot(req.payload))\n    },\n  }\n}\n"],"names":["buildDevSnapshot","devToolsEnabled","createDevEndpoint","enabled","devRoute","path","method","handler","req","Response","json","error","status","url","URL","wantsHtml","searchParams","get","headers","includes","location","payload"],"mappings":"AACA,SAASA,gBAAgB,QAAQ,qBAAiB;AAClD,SAASC,eAAe,QAAQ,gBAAY;AAE5C;;;;;CAKC,GACD,OAAO,SAASC,kBAAkB,EAAEC,OAAO,EAAEC,QAAQ,EAA2C;IAC9F,OAAO;QACLC,MAAM;QACNC,QAAQ;QACRC,SAAS,OAAOC;YACd,IAAI,CAACP,gBAAgBE,UAAU,OAAOM,SAASC,IAAI,CAAC;gBAAEC,OAAO;YAAY,GAAG;gBAAEC,QAAQ;YAAI;YAE1F,MAAMC,MAAM,IAAIC,IAAIN,IAAIK,GAAG,IAAI,YAAY;YAC3C,MAAME,YAAYF,IAAIG,YAAY,CAACC,GAAG,CAAC,cAAc,UAAU,AAACT,CAAAA,IAAIU,OAAO,CAACD,GAAG,CAAC,aAAa,EAAC,EAAGE,QAAQ,CAAC;YAC1G,IAAIJ,WAAW,OAAO,IAAIN,SAAS,MAAM;gBAAEG,QAAQ;gBAAKM,SAAS;oBAAEE,UAAUhB;gBAAS;YAAE;YAExF,OAAOK,SAASC,IAAI,CAAC,MAAMV,iBAAiBQ,IAAIa,OAAO;QACzD;IACF;AACF"}

package/dist/endpoints/stage.d.ts

@@ -0,0 +1,14 @@
+import type { Endpoint } from 'payload';
+/**
+ * `GET /api/dev/stage?test=<key>&version=<id>` — URL-addressable version selection. Sets the
+ * selection cookie and redirects to the test's page (`<devRoute>/tests/<key>`, or `to` when
+ * given), which renders that version. `?slot=header|footer` targets a chrome-override cookie
+ * instead (redirecting to `/` — the override applies site-wide via `resolveDevChrome`).
+ * `?clear=1` clears the targeted cookie. Exists so a screenshot script or an AI agent can put a
+ * specific version on screen by navigating to one URL instead of driving the toolbar UI.
+ */
+export declare function createStageEndpoint({ enabled, devRoute }: {
+    enabled?: boolean;
+    devRoute: string;
+}): Endpoint;
+//# sourceMappingURL=stage.d.ts.map

package/dist/endpoints/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/endpoints/stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAIvC;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CA0B5G"}

package/dist/endpoints/stage.js

@@ -0,0 +1,42 @@
+import { CHROME_COOKIES, STAGE_COOKIE } from "../cookies.js";
+import { devToolsEnabled } from "../options.js";
+/**
+ * `GET /api/dev/stage?test=<key>&version=<id>` — URL-addressable version selection. Sets the
+ * selection cookie and redirects to the test's page (`<devRoute>/tests/<key>`, or `to` when
+ * given), which renders that version. `?slot=header|footer` targets a chrome-override cookie
+ * instead (redirecting to `/` — the override applies site-wide via `resolveDevChrome`).
+ * `?clear=1` clears the targeted cookie. Exists so a screenshot script or an AI agent can put a
+ * specific version on screen by navigating to one URL instead of driving the toolbar UI.
+ */ export function createStageEndpoint({ enabled, devRoute }) {
+    return {
+        path: '/dev/stage',
+        method: 'get',
+        handler: async (req)=>{
+            if (!devToolsEnabled(enabled)) return Response.json({
+                error: 'Not found'
+            }, {
+                status: 404
+            });
+            const url = new URL(req.url ?? '/api/dev/stage', 'http://localhost');
+            const test = url.searchParams.get('test');
+            const version = url.searchParams.get('version');
+            const slotParam = url.searchParams.get('slot');
+            const slot = slotParam === 'header' || slotParam === 'footer' ? slotParam : null;
+            const cookieName = slot ? CHROME_COOKIES[slot] : STAGE_COOKIE;
+            const clearing = url.searchParams.get('clear') !== null || !test || !version;
+            const rawTo = url.searchParams.get('to') ?? (clearing || slot ? '/' : `${devRoute}/tests/${test}`);
+            // Same-site paths only — no open redirect, even in dev.
+            const to = rawTo.startsWith('/') && !rawTo.startsWith('//') ? rawTo : '/';
+            const cookie = clearing ? `${cookieName}=; Path=/; Max-Age=0; SameSite=Lax` : `${cookieName}=${encodeURIComponent(`${test}:${version}`)}; Path=/; SameSite=Lax`;
+            return new Response(null, {
+                status: 303,
+                headers: {
+                    location: to,
+                    'set-cookie': cookie
+                }
+            });
+        }
+    };
+}
+
+//# sourceMappingURL=stage.js.map

package/dist/endpoints/stage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoints/stage.ts"],"sourcesContent":["import type { Endpoint } from 'payload'\nimport { CHROME_COOKIES, STAGE_COOKIE } from '../cookies'\nimport { devToolsEnabled } from '../options'\n\n/**\n * `GET /api/dev/stage?test=<key>&version=<id>` — URL-addressable version selection. Sets the\n * selection cookie and redirects to the test's page (`<devRoute>/tests/<key>`, or `to` when\n * given), which renders that version. `?slot=header|footer` targets a chrome-override cookie\n * instead (redirecting to `/` — the override applies site-wide via `resolveDevChrome`).\n * `?clear=1` clears the targeted cookie. Exists so a screenshot script or an AI agent can put a\n * specific version on screen by navigating to one URL instead of driving the toolbar UI.\n */\nexport function createStageEndpoint({ enabled, devRoute }: { enabled?: boolean; devRoute: string }): Endpoint {\n  return {\n    path: '/dev/stage',\n    method: 'get',\n    handler: async (req) => {\n      if (!devToolsEnabled(enabled)) return Response.json({ error: 'Not found' }, { status: 404 })\n\n      const url = new URL(req.url ?? '/api/dev/stage', 'http://localhost')\n      const test = url.searchParams.get('test')\n      const version = url.searchParams.get('version')\n      const slotParam = url.searchParams.get('slot')\n      const slot = slotParam === 'header' || slotParam === 'footer' ? slotParam : null\n      const cookieName = slot ? CHROME_COOKIES[slot] : STAGE_COOKIE\n      const clearing = url.searchParams.get('clear') !== null || !test || !version\n\n      const rawTo = url.searchParams.get('to') ?? (clearing || slot ? '/' : `${devRoute}/tests/${test}`)\n      // Same-site paths only — no open redirect, even in dev.\n      const to = rawTo.startsWith('/') && !rawTo.startsWith('//') ? rawTo : '/'\n\n      const cookie = clearing\n        ? `${cookieName}=; Path=/; Max-Age=0; SameSite=Lax`\n        : `${cookieName}=${encodeURIComponent(`${test}:${version}`)}; Path=/; SameSite=Lax`\n\n      return new Response(null, { status: 303, headers: { location: to, 'set-cookie': cookie } })\n    },\n  }\n}\n"],"names":["CHROME_COOKIES","STAGE_COOKIE","devToolsEnabled","createStageEndpoint","enabled","devRoute","path","method","handler","req","Response","json","error","status","url","URL","test","searchParams","get","version","slotParam","slot","cookieName","clearing","rawTo","to","startsWith","cookie","encodeURIComponent","headers","location"],"mappings":"AACA,SAASA,cAAc,EAAEC,YAAY,QAAQ,gBAAY;AACzD,SAASC,eAAe,QAAQ,gBAAY;AAE5C;;;;;;;CAOC,GACD,OAAO,SAASC,oBAAoB,EAAEC,OAAO,EAAEC,QAAQ,EAA2C;IAChG,OAAO;QACLC,MAAM;QACNC,QAAQ;QACRC,SAAS,OAAOC;YACd,IAAI,CAACP,gBAAgBE,UAAU,OAAOM,SAASC,IAAI,CAAC;gBAAEC,OAAO;YAAY,GAAG;gBAAEC,QAAQ;YAAI;YAE1F,MAAMC,MAAM,IAAIC,IAAIN,IAAIK,GAAG,IAAI,kBAAkB;YACjD,MAAME,OAAOF,IAAIG,YAAY,CAACC,GAAG,CAAC;YAClC,MAAMC,UAAUL,IAAIG,YAAY,CAACC,GAAG,CAAC;YACrC,MAAME,YAAYN,IAAIG,YAAY,CAACC,GAAG,CAAC;YACvC,MAAMG,OAAOD,cAAc,YAAYA,cAAc,WAAWA,YAAY;YAC5E,MAAME,aAAaD,OAAOrB,cAAc,CAACqB,KAAK,GAAGpB;YACjD,MAAMsB,WAAWT,IAAIG,YAAY,CAACC,GAAG,CAAC,aAAa,QAAQ,CAACF,QAAQ,CAACG;YAErE,MAAMK,QAAQV,IAAIG,YAAY,CAACC,GAAG,CAAC,SAAUK,CAAAA,YAAYF,OAAO,MAAM,GAAGhB,SAAS,OAAO,EAAEW,MAAM,AAAD;YAChG,wDAAwD;YACxD,MAAMS,KAAKD,MAAME,UAAU,CAAC,QAAQ,CAACF,MAAME,UAAU,CAAC,QAAQF,QAAQ;YAEtE,MAAMG,SAASJ,WACX,GAAGD,WAAW,kCAAkC,CAAC,GACjD,GAAGA,WAAW,CAAC,EAAEM,mBAAmB,GAAGZ,KAAK,CAAC,EAAEG,SAAS,EAAE,sBAAsB,CAAC;YAErF,OAAO,IAAIT,SAAS,MAAM;gBAAEG,QAAQ;gBAAKgB,SAAS;oBAAEC,UAAUL;oBAAI,cAAcE;gBAAO;YAAE;QAC3F;IACF;AACF"}

package/dist/harness.d.ts

@@ -0,0 +1,40 @@
+import type { ReactNode } from 'react';
+/** How the toolbar groups and labels a test — purely presentational in v1 (every version stages
+ *  in the same full-screen overlay). */
+export type TestKind = 'page' | 'header' | 'footer' | 'block' | 'custom';
+export type TestVersion = {
+    /** Stable id — the cookie value segment. Keep it URL-safe (`[a-z0-9-]`). */
+    id: string;
+    label: string;
+    /** A prop-less (optionally async) server component — fetch your own data inside it. Runs only
+     *  when this version is staged, and only in dev. */
+    render: () => ReactNode | Promise<ReactNode>;
+};
+export type Test = {
+    /** Stable key — the cookie value segment. Keep it URL-safe (`[a-z0-9-]`). */
+    key: string;
+    label: string;
+    kind: TestKind;
+    versions: TestVersion[];
+};
+/** Identity helper — defines a test with full type-checking of its versions. */
+export declare const defineTest: (test: Test) => Test;
+/** Client-safe test metadata (no render fns) — what the toolbar UI receives. */
+export type TestMeta = {
+    key: string;
+    label: string;
+    kind: TestKind;
+    versions: {
+        id: string;
+        label: string;
+    }[];
+};
+export declare const toTestMeta: (tests: Test[]) => TestMeta[];
+export type ActiveStage = {
+    test: Test;
+    version: TestVersion;
+};
+/** Resolve a raw stage-cookie value (`testKey:versionId`) against the registered tests. Unknown
+ *  or malformed values resolve to null — a stale cookie never breaks a page. */
+export declare const parseStage: (raw: string | undefined, tests: Test[]) => ActiveStage | null;
+//# sourceMappingURL=harness.d.ts.map

package/dist/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC;wCACwC;AACxC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;AAExE,MAAM,MAAM,WAAW,GAAG;IACxB,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb;wDACoD;IACpD,MAAM,EAAE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;CAC7C,CAAA;AAED,MAAM,MAAM,IAAI,GAAG;IACjB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,QAAQ,CAAA;IACd,QAAQ,EAAE,WAAW,EAAE,CAAA;CACxB,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,IAAY,CAAA;AAEpD,gFAAgF;AAChF,MAAM,MAAM,QAAQ,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAA;AAEhH,eAAO,MAAM,UAAU,GAAI,OAAO,IAAI,EAAE,KAAG,QAAQ,EACgF,CAAA;AAEnI,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAA;AAE9D;gFACgF;AAChF,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,GAAG,SAAS,EAAE,OAAO,IAAI,EAAE,KAAG,WAAW,GAAG,IAajF,CAAA"}

package/dist/harness.js

@@ -0,0 +1,30 @@
+/** Identity helper — defines a test with full type-checking of its versions. */ export const defineTest = (test)=>test;
+export const toTestMeta = (tests)=>tests.map((t)=>({
+            key: t.key,
+            label: t.label,
+            kind: t.kind,
+            versions: t.versions.map((v)=>({
+                    id: v.id,
+                    label: v.label
+                }))
+        }));
+/** Resolve a raw stage-cookie value (`testKey:versionId`) against the registered tests. Unknown
+ *  or malformed values resolve to null — a stale cookie never breaks a page. */ export const parseStage = (raw, tests)=>{
+    if (!raw) return null;
+    let decoded = raw;
+    try {
+        decoded = decodeURIComponent(raw);
+    } catch  {
+        return null;
+    }
+    const sep = decoded.indexOf(':');
+    if (sep < 1) return null;
+    const test = tests.find((t)=>t.key === decoded.slice(0, sep));
+    const version = test?.versions.find((v)=>v.id === decoded.slice(sep + 1));
+    return test && version ? {
+        test,
+        version
+    } : null;
+};
+
+//# sourceMappingURL=harness.js.map

package/dist/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/harness.ts"],"sourcesContent":["import type { ReactNode } from 'react'\n\n/** How the toolbar groups and labels a test — purely presentational in v1 (every version stages\n *  in the same full-screen overlay). */\nexport type TestKind = 'page' | 'header' | 'footer' | 'block' | 'custom'\n\nexport type TestVersion = {\n  /** Stable id — the cookie value segment. Keep it URL-safe (`[a-z0-9-]`). */\n  id: string\n  label: string\n  /** A prop-less (optionally async) server component — fetch your own data inside it. Runs only\n   *  when this version is staged, and only in dev. */\n  render: () => ReactNode | Promise<ReactNode>\n}\n\nexport type Test = {\n  /** Stable key — the cookie value segment. Keep it URL-safe (`[a-z0-9-]`). */\n  key: string\n  label: string\n  kind: TestKind\n  versions: TestVersion[]\n}\n\n/** Identity helper — defines a test with full type-checking of its versions. */\nexport const defineTest = (test: Test): Test => test\n\n/** Client-safe test metadata (no render fns) — what the toolbar UI receives. */\nexport type TestMeta = { key: string; label: string; kind: TestKind; versions: { id: string; label: string }[] }\n\nexport const toTestMeta = (tests: Test[]): TestMeta[] =>\n  tests.map((t) => ({ key: t.key, label: t.label, kind: t.kind, versions: t.versions.map((v) => ({ id: v.id, label: v.label })) }))\n\nexport type ActiveStage = { test: Test; version: TestVersion }\n\n/** Resolve a raw stage-cookie value (`testKey:versionId`) against the registered tests. Unknown\n *  or malformed values resolve to null — a stale cookie never breaks a page. */\nexport const parseStage = (raw: string | undefined, tests: Test[]): ActiveStage | null => {\n  if (!raw) return null\n  let decoded = raw\n  try {\n    decoded = decodeURIComponent(raw)\n  } catch {\n    return null\n  }\n  const sep = decoded.indexOf(':')\n  if (sep < 1) return null\n  const test = tests.find((t) => t.key === decoded.slice(0, sep))\n  const version = test?.versions.find((v) => v.id === decoded.slice(sep + 1))\n  return test && version ? { test, version } : null\n}\n"],"names":["defineTest","test","toTestMeta","tests","map","t","key","label","kind","versions","v","id","parseStage","raw","decoded","decodeURIComponent","sep","indexOf","find","slice","version"],"mappings":"AAuBA,8EAA8E,GAC9E,OAAO,MAAMA,aAAa,CAACC,OAAqBA,KAAI;AAKpD,OAAO,MAAMC,aAAa,CAACC,QACzBA,MAAMC,GAAG,CAAC,CAACC,IAAO,CAAA;YAAEC,KAAKD,EAAEC,GAAG;YAAEC,OAAOF,EAAEE,KAAK;YAAEC,MAAMH,EAAEG,IAAI;YAAEC,UAAUJ,EAAEI,QAAQ,CAACL,GAAG,CAAC,CAACM,IAAO,CAAA;oBAAEC,IAAID,EAAEC,EAAE;oBAAEJ,OAAOG,EAAEH,KAAK;gBAAC,CAAA;QAAI,CAAA,GAAG;AAInI;8EAC8E,GAC9E,OAAO,MAAMK,aAAa,CAACC,KAAyBV;IAClD,IAAI,CAACU,KAAK,OAAO;IACjB,IAAIC,UAAUD;IACd,IAAI;QACFC,UAAUC,mBAAmBF;IAC/B,EAAE,OAAM;QACN,OAAO;IACT;IACA,MAAMG,MAAMF,QAAQG,OAAO,CAAC;IAC5B,IAAID,MAAM,GAAG,OAAO;IACpB,MAAMf,OAAOE,MAAMe,IAAI,CAAC,CAACb,IAAMA,EAAEC,GAAG,KAAKQ,QAAQK,KAAK,CAAC,GAAGH;IAC1D,MAAMI,UAAUnB,MAAMQ,SAASS,KAAK,CAACR,IAAMA,EAAEC,EAAE,KAAKG,QAAQK,KAAK,CAACH,MAAM;IACxE,OAAOf,QAAQmB,UAAU;QAAEnB;QAAMmB;IAAQ,IAAI;AAC/C,EAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { default, devToolsPlugin } from './plugin';
+export type { DevToolsPluginOptions } from './options';
+export { defineTest } from './harness';
+export type { Test, TestKind, TestMeta, TestVersion } from './harness';
+export { STAGE_COOKIE } from './cookies';
+export type { CollectionCount, DevSnapshot, FontsSnapshot, IconsSnapshot, ImagesSnapshot, MuxSnapshot, SeedSnapshot, } from './lib/snapshot';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAItD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAGtE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAGxC,YAAY,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// The plugin (safe to import from payload.config — no next/react-client imports here)
+export { default, devToolsPlugin } from "./plugin.js";
+// The test harness authoring helper + types. `defineTest` lives here (not just /toolbar) so seed
+// scripts, screenshot tooling, and payload-side code can import it without pulling in next.
+export { defineTest } from "./harness.js";
+// The stage cookie name — for custom tooling that stages a version itself.
+export { STAGE_COOKIE } from "./cookies.js";
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// The plugin (safe to import from payload.config — no next/react-client imports here)\nexport { default, devToolsPlugin } from './plugin'\nexport type { DevToolsPluginOptions } from './options'\n\n// The test harness authoring helper + types. `defineTest` lives here (not just /toolbar) so seed\n// scripts, screenshot tooling, and payload-side code can import it without pulling in next.\nexport { defineTest } from './harness'\nexport type { Test, TestKind, TestMeta, TestVersion } from './harness'\n\n// The stage cookie name — for custom tooling that stages a version itself.\nexport { STAGE_COOKIE } from './cookies'\n\n// Response shape of `GET /api/dev`, for typed consumers (scripts, agents, custom panels).\nexport type {\n  CollectionCount,\n  DevSnapshot,\n  FontsSnapshot,\n  IconsSnapshot,\n  ImagesSnapshot,\n  MuxSnapshot,\n  SeedSnapshot,\n} from './lib/snapshot'\n"],"names":["default","devToolsPlugin","defineTest","STAGE_COOKIE"],"mappings":"AAAA,sFAAsF;AACtF,SAASA,OAAO,EAAEC,cAAc,QAAQ,cAAU;AAGlD,iGAAiG;AACjG,4FAA4F;AAC5F,SAASC,UAAU,QAAQ,eAAW;AAGtC,2EAA2E;AAC3E,SAASC,YAAY,QAAQ,eAAW"}

package/dist/lib/getPayloadClient.d.ts

@@ -0,0 +1,15 @@
+import { type Payload, type SanitizedConfig } from 'payload';
+/** Called from the plugin's `onInit`: remember the running app's config for the dev pages. */
+export declare const stashConfig: (config: SanitizedConfig) => void;
+/**
+ * Resolve the host app's Payload config, in order:
+ *  1. the globalThis stash filled the moment Payload boots — covers every render after init with
+ *     no bundler involvement, or
+ *  2. the `@payload-config` alias `withPayload` sets up — which resolves from inside a published
+ *     package only when the consumer transpiles it. The `as string` keeps TS from resolving the
+ *     alias at this package's own build time.
+ */
+export declare const getConfig: () => Promise<SanitizedConfig>;
+/** A booted Payload instance using the host app's config — the server entry for the dev pages. */
+export declare const getPayloadClient: () => Promise<Payload>;
+//# sourceMappingURL=getPayloadClient.d.ts.map

package/dist/lib/getPayloadClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPayloadClient.d.ts","sourceRoot":"","sources":["../../src/lib/getPayloadClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AASxE,8FAA8F;AAC9F,eAAO,MAAM,WAAW,GAAI,QAAQ,eAAe,KAAG,IAErD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,QAAa,OAAO,CAAC,eAAe,CAYzD,CAAA;AAED,kGAAkG;AAClG,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,OAAO,CAA8C,CAAA"}

package/dist/lib/getPayloadClient.js

@@ -0,0 +1,29 @@
+import { getPayload } from "payload";
+/** The globalThis slot the plugin's `onInit` fills with the app's sanitized config. `Symbol.for`
+ *  → one shared registry entry across every pro-laico package (payload-icons stashes the same
+ *  slot), so whichever plugin boots first covers them all. */ const CONFIG_SLOT = Symbol.for('pro-laico.payload-config');
+/** Called from the plugin's `onInit`: remember the running app's config for the dev pages. */ export const stashConfig = (config)=>{
+    ;
+    globalThis[CONFIG_SLOT] = config;
+};
+/**
+ * Resolve the host app's Payload config, in order:
+ *  1. the globalThis stash filled the moment Payload boots — covers every render after init with
+ *     no bundler involvement, or
+ *  2. the `@payload-config` alias `withPayload` sets up — which resolves from inside a published
+ *     package only when the consumer transpiles it. The `as string` keeps TS from resolving the
+ *     alias at this package's own build time.
+ */ export const getConfig = async ()=>{
+    const stashed = globalThis[CONFIG_SLOT];
+    if (stashed) return stashed;
+    try {
+        return await (await import("@payload-config")).default;
+    } catch  {
+        throw new Error("[payload-dev-tools] could not resolve the app's Payload config: Payload hasn't initialized in this process yet, and the '@payload-config' alias didn't resolve from inside this package. Either add '@pro-laico/payload-dev-tools' to `transpilePackages` in next.config, or ensure something calls getPayload() before the dev pages render.");
+    }
+};
+/** A booted Payload instance using the host app's config — the server entry for the dev pages. */ export const getPayloadClient = async ()=>getPayload({
+        config: await getConfig()
+    });
+
+//# sourceMappingURL=getPayloadClient.js.map

package/dist/lib/getPayloadClient.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/getPayloadClient.ts"],"sourcesContent":["import { getPayload, type Payload, type SanitizedConfig } from 'payload'\n\ntype Awaitable<T> = T | Promise<T>\n\n/** The globalThis slot the plugin's `onInit` fills with the app's sanitized config. `Symbol.for`\n *  → one shared registry entry across every pro-laico package (payload-icons stashes the same\n *  slot), so whichever plugin boots first covers them all. */\nconst CONFIG_SLOT = Symbol.for('pro-laico.payload-config')\n\n/** Called from the plugin's `onInit`: remember the running app's config for the dev pages. */\nexport const stashConfig = (config: SanitizedConfig): void => {\n  ;(globalThis as Record<symbol, unknown>)[CONFIG_SLOT] = config\n}\n\n/**\n * Resolve the host app's Payload config, in order:\n *  1. the globalThis stash filled the moment Payload boots — covers every render after init with\n *     no bundler involvement, or\n *  2. the `@payload-config` alias `withPayload` sets up — which resolves from inside a published\n *     package only when the consumer transpiles it. The `as string` keeps TS from resolving the\n *     alias at this package's own build time.\n */\nexport const getConfig = async (): Promise<SanitizedConfig> => {\n  const stashed = (globalThis as Record<symbol, unknown>)[CONFIG_SLOT] as SanitizedConfig | undefined\n  if (stashed) return stashed\n  try {\n    return (await ((\n      await import('@payload-config' as string)\n    ).default as Awaitable<SanitizedConfig>)) as SanitizedConfig\n  } catch {\n    throw new Error(\n      \"[payload-dev-tools] could not resolve the app's Payload config: Payload hasn't initialized in this process yet, and the '@payload-config' alias didn't resolve from inside this package. Either add '@pro-laico/payload-dev-tools' to `transpilePackages` in next.config, or ensure something calls getPayload() before the dev pages render.\",\n    )\n  }\n}\n\n/** A booted Payload instance using the host app's config — the server entry for the dev pages. */\nexport const getPayloadClient = async (): Promise<Payload> => getPayload({ config: await getConfig() })\n"],"names":["getPayload","CONFIG_SLOT","Symbol","for","stashConfig","config","globalThis","getConfig","stashed","default","Error","getPayloadClient"],"mappings":"AAAA,SAASA,UAAU,QAA4C,UAAS;AAIxE;;4DAE4D,GAC5D,MAAMC,cAAcC,OAAOC,GAAG,CAAC;AAE/B,4FAA4F,GAC5F,OAAO,MAAMC,cAAc,CAACC;;IACxBC,UAAsC,CAACL,YAAY,GAAGI;AAC1D,EAAC;AAED;;;;;;;CAOC,GACD,OAAO,MAAME,YAAY;IACvB,MAAMC,UAAU,AAACF,UAAsC,CAACL,YAAY;IACpE,IAAIO,SAAS,OAAOA;IACpB,IAAI;QACF,OAAQ,MAAO,AACb,CAAA,MAAM,MAAM,CAAC,kBAA2B,EACxCC,OAAO;IACX,EAAE,OAAM;QACN,MAAM,IAAIC,MACR;IAEJ;AACF,EAAC;AAED,gGAAgG,GAChG,OAAO,MAAMC,mBAAmB,UAA8BX,WAAW;QAAEK,QAAQ,MAAME;IAAY,GAAE"}

package/dist/lib/snapshot.d.ts

@@ -0,0 +1,89 @@
+import type { Payload } from 'payload';
+/** One collection's row in the snapshot. `count` is null when counting failed (e.g. a slug the
+ *  adapter can't count) — distinct from an honest 0. */
+export type CollectionCount = {
+    slug: string;
+    count: number | null;
+};
+export type SeedSnapshot = {
+    /** Whether `ENABLE_SEED=true` is set — the kill switch every seed path checks. */
+    enabled: boolean;
+    endpoint: string;
+    definitions: {
+        slug: string;
+        kind: 'collection' | 'global';
+        disabled?: string;
+    }[];
+    /** Doc counts per collection-kind definition slug (globals always exist, so they're skipped). */
+    counts: Record<string, number>;
+    totalDocs: number;
+    /** True once any seeded collection has documents. */
+    seeded: boolean;
+};
+export type ImagesSnapshot = {
+    sourceSlug: string;
+    variantSlug: string | null;
+    basePath: string;
+    sourceCount: number | null;
+    variantCount: number | null;
+};
+export type IconsSnapshot = {
+    iconSlug: string;
+    iconSetSlug: string | null;
+    iconCount: number | null;
+    /** Title of the active (published) icon set, or null when none is active. */
+    activeSet: string | null;
+    /** Runtime misses from the `iconRequest` diagnostic collection — names requested in code that
+     *  did not resolve through the active set. Empty when request tracking is off. */
+    misses: {
+        name: string;
+        count: number;
+        lastRequestedAt: string | null;
+    }[];
+};
+export type FontsSnapshot = {
+    fontSlug: string;
+    fontSetSlug: string | null;
+    fontOptimizedSlug: string | null;
+    familyKeys: string[];
+    /** Active typeface title per family slot (from the `fontSet` global), or null when unset. */
+    slots: Record<string, string | null>;
+    fontCount: number | null;
+    exportPath: string;
+};
+export type MuxSnapshot = {
+    slug: string;
+    credentialed: boolean;
+    total: number | null;
+    ready: number | null;
+};
+/** Everything `GET /api/dev` reports: environment, per-plugin panels (null = plugin not
+ *  installed), and doc counts for every collection. Built fresh on each request — dev only. */
+export type DevSnapshot = {
+    generatedAt: string;
+    env: {
+        nodeEnv: string;
+        nodeVersion: string;
+    };
+    adminRoute: string;
+    /** Where the host mounts the `createDevPage` catch-all (the plugin's `devRoute` option). */
+    devRoute: string;
+    plugins: {
+        seed: boolean;
+        images: boolean;
+        icons: boolean;
+        fonts: boolean;
+        mux: boolean;
+    };
+    seed: SeedSnapshot | null;
+    images: ImagesSnapshot | null;
+    icons: IconsSnapshot | null;
+    fonts: FontsSnapshot | null;
+    mux: MuxSnapshot | null;
+    collections: CollectionCount[];
+    globals: string[];
+};
+/** Build the full dev snapshot from a booted Payload instance. Sibling @pro-laico plugins are
+ *  discovered through their `config.custom` markers — no imports, so none of them are required. */
+export declare function buildDevSnapshot(payload: Payload): Promise<DevSnapshot>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/lib/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/lib/snapshot.ts"],"names":[],"mappings":"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"}

package/dist/lib/snapshot.js

@@ -0,0 +1,183 @@
+const countDocs = async (payload, slug, where)=>{
+    try {
+        return (await payload.count({
+            collection: slug,
+            overrideAccess: true,
+            ...where ? {
+                where
+            } : {}
+        })).totalDocs;
+    } catch  {
+        return null;
+    }
+};
+const seedSnapshot = async (payload, marker)=>{
+    const definitions = (marker.options?.definitions ?? []).map((d)=>({
+            slug: d.slug,
+            kind: d.kind,
+            ...d.disabled ? {
+                disabled: typeof d.disabled === 'string' ? d.disabled : 'disabled'
+            } : {}
+        }));
+    const counts = {};
+    for (const d of definitions){
+        if (d.kind !== 'collection') continue;
+        const n = await countDocs(payload, d.slug);
+        if (n !== null) counts[d.slug] = n;
+    }
+    const totalDocs = Object.values(counts).reduce((sum, n)=>sum + n, 0);
+    return {
+        enabled: process.env.ENABLE_SEED === 'true',
+        endpoint: '/api/seed',
+        definitions,
+        counts,
+        totalDocs,
+        seeded: totalDocs > 0
+    };
+};
+const imagesSnapshot = async (payload, marker)=>{
+    const sourceSlug = marker.sourceSlug ?? 'images';
+    const variantSlug = marker.variantSlug ?? null;
+    return {
+        sourceSlug,
+        variantSlug,
+        // The marker stores the endpoint-relative path ('/img'); report it as requested (/api/img).
+        basePath: `/api${marker.basePath ?? '/img'}`,
+        sourceCount: await countDocs(payload, sourceSlug),
+        variantCount: variantSlug ? await countDocs(payload, variantSlug) : null
+    };
+};
+const iconsSnapshot = async (payload, marker)=>{
+    const iconSlug = marker.iconSlug ?? 'icon';
+    const iconSetSlug = marker.iconSetSlug ?? null;
+    let activeSet = null;
+    if (iconSetSlug) {
+        try {
+            const res = await payload.find({
+                collection: iconSetSlug,
+                where: {
+                    active: {
+                        equals: true
+                    }
+                },
+                limit: 1,
+                depth: 0,
+                overrideAccess: true,
+                pagination: false
+            });
+            const doc = res.docs[0];
+            activeSet = doc?.title ?? null;
+        } catch  {}
+    }
+    let misses = [];
+    if (marker.iconRequestSlug) {
+        try {
+            const res = await payload.find({
+                collection: marker.iconRequestSlug,
+                sort: '-count',
+                limit: 20,
+                depth: 0,
+                overrideAccess: true,
+                pagination: false
+            });
+            misses = res.docs.flatMap((d)=>d.name ? [
+                    {
+                        name: d.name,
+                        count: d.count ?? 1,
+                        lastRequestedAt: d.lastRequestedAt ?? null
+                    }
+                ] : []);
+        } catch  {}
+    }
+    return {
+        iconSlug,
+        iconSetSlug,
+        iconCount: await countDocs(payload, iconSlug),
+        activeSet,
+        misses
+    };
+};
+const fontsSnapshot = async (payload, marker)=>{
+    const fontSlug = marker.fontSlug ?? 'font';
+    const fontSetSlug = marker.fontSetSlug ?? null;
+    const familyKeys = marker.familyKeys ?? [];
+    const slots = {};
+    for (const key of familyKeys)slots[key] = null;
+    if (fontSetSlug && familyKeys.length) {
+        try {
+            // Through `unknown`: in an app context `findGlobal` returns the app's generated global type.
+            const set = await payload.findGlobal({
+                slug: fontSetSlug,
+                depth: 1,
+                overrideAccess: true
+            });
+            for (const key of familyKeys){
+                const value = set[key];
+                slots[key] = value && typeof value === 'object' && 'title' in value ? value.title ?? null : null;
+            }
+        } catch  {}
+    }
+    return {
+        fontSlug,
+        fontSetSlug,
+        fontOptimizedSlug: marker.fontOptimizedSlug ?? null,
+        familyKeys,
+        slots,
+        fontCount: await countDocs(payload, fontSlug),
+        exportPath: `/api${marker.exportPath ?? '/fonts/export'}`
+    };
+};
+const muxSnapshot = async (payload, marker)=>{
+    const slug = marker.options?.extendCollection ?? 'mux-video';
+    const collection = payload.config.collections.find((c)=>c.slug === slug);
+    return {
+        slug,
+        // The mux plugin marks its collection `custom.seedDisabled` when MUX_TOKEN_ID/SECRET are absent.
+        credentialed: !collection?.custom?.seedDisabled,
+        total: await countDocs(payload, slug),
+        ready: await countDocs(payload, slug, {
+            status: {
+                equals: 'ready'
+            }
+        })
+    };
+};
+/** Build the full dev snapshot from a booted Payload instance. Sibling @pro-laico plugins are
+ *  discovered through their `config.custom` markers — no imports, so none of them are required. */ export async function buildDevSnapshot(payload) {
+    const custom = payload.config.custom ?? {};
+    const seedMarker = custom.payloadSeed;
+    const imagesMarker = custom.payloadImages;
+    const iconsMarker = custom.payloadIcons;
+    const fontsMarker = custom.payloadFonts;
+    const muxMarker = custom.payloadMux;
+    const collections = [];
+    for (const c of payload.config.collections)collections.push({
+        slug: c.slug,
+        count: await countDocs(payload, c.slug)
+    });
+    return {
+        generatedAt: new Date().toISOString(),
+        env: {
+            nodeEnv: process.env.NODE_ENV ?? 'development',
+            nodeVersion: process.version
+        },
+        adminRoute: payload.config.routes?.admin ?? '/admin',
+        devRoute: custom.payloadDevTools?.devRoute ?? '/dev',
+        plugins: {
+            seed: !!seedMarker,
+            images: !!imagesMarker,
+            icons: !!iconsMarker,
+            fonts: !!fontsMarker,
+            mux: !!muxMarker
+        },
+        seed: seedMarker ? await seedSnapshot(payload, seedMarker) : null,
+        images: imagesMarker ? await imagesSnapshot(payload, imagesMarker) : null,
+        icons: iconsMarker ? await iconsSnapshot(payload, iconsMarker) : null,
+        fonts: fontsMarker ? await fontsSnapshot(payload, fontsMarker) : null,
+        mux: muxMarker ? await muxSnapshot(payload, muxMarker) : null,
+        collections,
+        globals: (payload.config.globals ?? []).map((g)=>g.slug)
+    };
+}
+
+//# sourceMappingURL=snapshot.js.map

package/dist/lib/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/snapshot.ts"],"sourcesContent":["import type { CollectionSlug, GlobalSlug, Payload, Where } from 'payload'\n\n/** One collection's row in the snapshot. `count` is null when counting failed (e.g. a slug the\n *  adapter can't count) — distinct from an honest 0. */\nexport type CollectionCount = { slug: string; count: number | null }\n\nexport type SeedSnapshot = {\n  /** Whether `ENABLE_SEED=true` is set — the kill switch every seed path checks. */\n  enabled: boolean\n  endpoint: string\n  definitions: { slug: string; kind: 'collection' | 'global'; disabled?: string }[]\n  /** Doc counts per collection-kind definition slug (globals always exist, so they're skipped). */\n  counts: Record<string, number>\n  totalDocs: number\n  /** True once any seeded collection has documents. */\n  seeded: boolean\n}\n\nexport type ImagesSnapshot = {\n  sourceSlug: string\n  variantSlug: string | null\n  basePath: string\n  sourceCount: number | null\n  variantCount: number | null\n}\n\nexport type IconsSnapshot = {\n  iconSlug: string\n  iconSetSlug: string | null\n  iconCount: number | null\n  /** Title of the active (published) icon set, or null when none is active. */\n  activeSet: string | null\n  /** Runtime misses from the `iconRequest` diagnostic collection — names requested in code that\n   *  did not resolve through the active set. Empty when request tracking is off. */\n  misses: { name: string; count: number; lastRequestedAt: string | null }[]\n}\n\nexport type FontsSnapshot = {\n  fontSlug: string\n  fontSetSlug: string | null\n  fontOptimizedSlug: string | null\n  familyKeys: string[]\n  /** Active typeface title per family slot (from the `fontSet` global), or null when unset. */\n  slots: Record<string, string | null>\n  fontCount: number | null\n  exportPath: string\n}\n\nexport type MuxSnapshot = { slug: string; credentialed: boolean; total: number | null; ready: number | null }\n\n/** Everything `GET /api/dev` reports: environment, per-plugin panels (null = plugin not\n *  installed), and doc counts for every collection. Built fresh on each request — dev only. */\nexport type DevSnapshot = {\n  generatedAt: string\n  env: { nodeEnv: string; nodeVersion: string }\n  adminRoute: string\n  /** Where the host mounts the `createDevPage` catch-all (the plugin's `devRoute` option). */\n  devRoute: string\n  plugins: { seed: boolean; images: boolean; icons: boolean; fonts: boolean; mux: boolean }\n  seed: SeedSnapshot | null\n  images: ImagesSnapshot | null\n  icons: IconsSnapshot | null\n  fonts: FontsSnapshot | null\n  mux: MuxSnapshot | null\n  collections: CollectionCount[]\n  globals: string[]\n}\n\nconst countDocs = async (payload: Payload, slug: string, where?: Where): Promise<number | null> => {\n  try {\n    return (await payload.count({ collection: slug as CollectionSlug, overrideAccess: true, ...(where ? { where } : {}) })).totalDocs\n  } catch {\n    return null\n  }\n}\n\ntype SeedMarker = { options?: { definitions?: { slug: string; kind: 'collection' | 'global'; disabled?: string | boolean }[] } }\n\nconst seedSnapshot = async (payload: Payload, marker: SeedMarker): Promise<SeedSnapshot> => {\n  const definitions = (marker.options?.definitions ?? []).map((d) => ({\n    slug: d.slug,\n    kind: d.kind,\n    ...(d.disabled ? { disabled: typeof d.disabled === 'string' ? d.disabled : 'disabled' } : {}),\n  }))\n  const counts: Record<string, number> = {}\n  for (const d of definitions) {\n    if (d.kind !== 'collection') continue\n    const n = await countDocs(payload, d.slug)\n    if (n !== null) counts[d.slug] = n\n  }\n  const totalDocs = Object.values(counts).reduce((sum, n) => sum + n, 0)\n  return { enabled: process.env.ENABLE_SEED === 'true', endpoint: '/api/seed', definitions, counts, totalDocs, seeded: totalDocs > 0 }\n}\n\ntype ImagesMarker = { sourceSlug?: string; variantSlug?: string | null; basePath?: string }\n\nconst imagesSnapshot = async (payload: Payload, marker: ImagesMarker): Promise<ImagesSnapshot> => {\n  const sourceSlug = marker.sourceSlug ?? 'images'\n  const variantSlug = marker.variantSlug ?? null\n  return {\n    sourceSlug,\n    variantSlug,\n    // The marker stores the endpoint-relative path ('/img'); report it as requested (/api/img).\n    basePath: `/api${marker.basePath ?? '/img'}`,\n    sourceCount: await countDocs(payload, sourceSlug),\n    variantCount: variantSlug ? await countDocs(payload, variantSlug) : null,\n  }\n}\n\ntype IconsMarker = { iconSlug?: string; iconSetSlug?: string | null; iconRequestSlug?: string | null }\n\nconst iconsSnapshot = async (payload: Payload, marker: IconsMarker): Promise<IconsSnapshot> => {\n  const iconSlug = marker.iconSlug ?? 'icon'\n  const iconSetSlug = marker.iconSetSlug ?? null\n\n  let activeSet: string | null = null\n  if (iconSetSlug) {\n    try {\n      const res = await payload.find({\n        collection: iconSetSlug as CollectionSlug,\n        where: { active: { equals: true } },\n        limit: 1,\n        depth: 0,\n        overrideAccess: true,\n        pagination: false,\n      })\n      const doc = res.docs[0] as { title?: string } | undefined\n      activeSet = doc?.title ?? null\n    } catch {}\n  }\n\n  let misses: IconsSnapshot['misses'] = []\n  if (marker.iconRequestSlug) {\n    try {\n      const res = await payload.find({\n        collection: marker.iconRequestSlug as CollectionSlug,\n        sort: '-count',\n        limit: 20,\n        depth: 0,\n        overrideAccess: true,\n        pagination: false,\n      })\n      misses = (res.docs as { name?: string; count?: number; lastRequestedAt?: string }[]).flatMap((d) =>\n        d.name ? [{ name: d.name, count: d.count ?? 1, lastRequestedAt: d.lastRequestedAt ?? null }] : [],\n      )\n    } catch {}\n  }\n\n  return { iconSlug, iconSetSlug, iconCount: await countDocs(payload, iconSlug), activeSet, misses }\n}\n\ntype FontsMarker = {\n  fontSlug?: string\n  fontSetSlug?: string | null\n  fontOptimizedSlug?: string | null\n  familyKeys?: string[]\n  exportPath?: string\n}\n\nconst fontsSnapshot = async (payload: Payload, marker: FontsMarker): Promise<FontsSnapshot> => {\n  const fontSlug = marker.fontSlug ?? 'font'\n  const fontSetSlug = marker.fontSetSlug ?? null\n  const familyKeys = marker.familyKeys ?? []\n\n  const slots: Record<string, string | null> = {}\n  for (const key of familyKeys) slots[key] = null\n  if (fontSetSlug && familyKeys.length) {\n    try {\n      // Through `unknown`: in an app context `findGlobal` returns the app's generated global type.\n      const set = (await payload.findGlobal({ slug: fontSetSlug as GlobalSlug, depth: 1, overrideAccess: true })) as unknown as Record<\n        string,\n        unknown\n      >\n      for (const key of familyKeys) {\n        const value = set[key]\n        slots[key] = value && typeof value === 'object' && 'title' in value ? ((value as { title?: string }).title ?? null) : null\n      }\n    } catch {}\n  }\n\n  return {\n    fontSlug,\n    fontSetSlug,\n    fontOptimizedSlug: marker.fontOptimizedSlug ?? null,\n    familyKeys,\n    slots,\n    fontCount: await countDocs(payload, fontSlug),\n    exportPath: `/api${marker.exportPath ?? '/fonts/export'}`,\n  }\n}\n\ntype MuxMarker = { options?: { extendCollection?: string } }\n\nconst muxSnapshot = async (payload: Payload, marker: MuxMarker): Promise<MuxSnapshot> => {\n  const slug = marker.options?.extendCollection ?? 'mux-video'\n  const collection = payload.config.collections.find((c) => c.slug === slug)\n  return {\n    slug,\n    // The mux plugin marks its collection `custom.seedDisabled` when MUX_TOKEN_ID/SECRET are absent.\n    credentialed: !collection?.custom?.seedDisabled,\n    total: await countDocs(payload, slug),\n    ready: await countDocs(payload, slug, { status: { equals: 'ready' } }),\n  }\n}\n\n/** Build the full dev snapshot from a booted Payload instance. Sibling @pro-laico plugins are\n *  discovered through their `config.custom` markers — no imports, so none of them are required. */\nexport async function buildDevSnapshot(payload: Payload): Promise<DevSnapshot> {\n  const custom = (payload.config.custom ?? {}) as Record<string, Record<string, unknown> | undefined>\n  const seedMarker = custom.payloadSeed\n  const imagesMarker = custom.payloadImages\n  const iconsMarker = custom.payloadIcons\n  const fontsMarker = custom.payloadFonts\n  const muxMarker = custom.payloadMux\n\n  const collections: CollectionCount[] = []\n  for (const c of payload.config.collections) collections.push({ slug: c.slug, count: await countDocs(payload, c.slug) })\n\n  return {\n    generatedAt: new Date().toISOString(),\n    env: { nodeEnv: process.env.NODE_ENV ?? 'development', nodeVersion: process.version },\n    adminRoute: payload.config.routes?.admin ?? '/admin',\n    devRoute: (custom.payloadDevTools?.devRoute as string | undefined) ?? '/dev',\n    plugins: { seed: !!seedMarker, images: !!imagesMarker, icons: !!iconsMarker, fonts: !!fontsMarker, mux: !!muxMarker },\n    seed: seedMarker ? await seedSnapshot(payload, seedMarker) : null,\n    images: imagesMarker ? await imagesSnapshot(payload, imagesMarker) : null,\n    icons: iconsMarker ? await iconsSnapshot(payload, iconsMarker) : null,\n    fonts: fontsMarker ? await fontsSnapshot(payload, fontsMarker) : null,\n    mux: muxMarker ? await muxSnapshot(payload, muxMarker) : null,\n    collections,\n    globals: (payload.config.globals ?? []).map((g) => g.slug),\n  }\n}\n"],"names":["countDocs","payload","slug","where","count","collection","overrideAccess","totalDocs","seedSnapshot","marker","definitions","options","map","d","kind","disabled","counts","n","Object","values","reduce","sum","enabled","process","env","ENABLE_SEED","endpoint","seeded","imagesSnapshot","sourceSlug","variantSlug","basePath","sourceCount","variantCount","iconsSnapshot","iconSlug","iconSetSlug","activeSet","res","find","active","equals","limit","depth","pagination","doc","docs","title","misses","iconRequestSlug","sort","flatMap","name","lastRequestedAt","iconCount","fontsSnapshot","fontSlug","fontSetSlug","familyKeys","slots","key","length","set","findGlobal","value","fontOptimizedSlug","fontCount","exportPath","muxSnapshot","extendCollection","config","collections","c","credentialed","custom","seedDisabled","total","ready","status","buildDevSnapshot","seedMarker","payloadSeed","imagesMarker","payloadImages","iconsMarker","payloadIcons","fontsMarker","payloadFonts","muxMarker","payloadMux","push","generatedAt","Date","toISOString","nodeEnv","NODE_ENV","nodeVersion","version","adminRoute","routes","admin","devRoute","payloadDevTools","plugins","seed","images","icons","fonts","mux","globals","g"],"mappings":"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"}