@prenta/admin 1.17.5 → 1.17.6

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @actuate-media/cms-admin
 
+## 1.17.6
+
+### Patch Changes
+
+- aa62695: Tag admin Sentry events with `NEXT_PUBLIC_SENTRY_RELEASE`. New projects pass `NEXT_PUBLIC_SENTRY_DSN` into the admin and install `@sentry/node` so `SENTRY_DSN` reports API errors.
+
 ## 1.17.5
 
 ### Patch Changes

package/dist/__tests__/components/error-boundary.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-boundary.test.d.ts.map

package/dist/__tests__/components/error-boundary.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/components/error-boundary.test.tsx"],"names":[],"mappings":""}

package/dist/__tests__/components/error-boundary.test.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @vitest-environment happy-dom
+import { render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+const captureAdminException = vi.fn();
+vi.mock('../../lib/sentry.js', () => ({
+    captureAdminException: (...args) => captureAdminException(...args),
+}));
+const { ErrorBoundary } = await import('../../components/ErrorBoundary.js');
+function Boom() {
+    throw new Error('boundary boom');
+}
+describe('ErrorBoundary', () => {
+    it('reports a render error to Sentry (#407)', () => {
+        vi.spyOn(console, 'error').mockImplementation(() => { });
+        captureAdminException.mockClear();
+        render(_jsx(ErrorBoundary, { children: _jsx(Boom, {}) }));
+        expect(screen.getByRole('heading', { name: 'Something went wrong' })).toBeTruthy();
+        expect(captureAdminException).toHaveBeenCalledWith(expect.objectContaining({ message: 'boundary boom' }), expect.objectContaining({ componentStack: expect.any(String) }));
+    });
+});
+//# sourceMappingURL=error-boundary.test.js.map

package/dist/__tests__/components/error-boundary.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.test.js","sourceRoot":"","sources":["../../../src/__tests__/components/error-boundary.test.tsx"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEjD,MAAM,qBAAqB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;AAErC,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;IACpC,qBAAqB,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC;CAC9E,CAAC,CAAC,CAAA;AAEH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAA;AAE3E,SAAS,IAAI;IACX,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAA;AAClC,CAAC;AAED,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACvD,qBAAqB,CAAC,SAAS,EAAE,CAAA;QAEjC,MAAM,CACJ,KAAC,aAAa,cACZ,KAAC,IAAI,KAAG,GACM,CACjB,CAAA;QAED,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAA;QAClF,MAAM,CAAC,qBAAqB,CAAC,CAAC,oBAAoB,CAChD,MAAM,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,EACrD,MAAM,CAAC,gBAAgB,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAChE,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/__tests__/lib/sentry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sentry.test.d.ts.map

package/dist/__tests__/lib/sentry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentry.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/lib/sentry.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/sentry.test.js

@@ -0,0 +1,63 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+const sentryMocks = vi.hoisted(() => ({
+    init: vi.fn(),
+    captureException: vi.fn(),
+}));
+vi.mock('@sentry/react', () => ({
+    init: sentryMocks.init,
+    captureException: sentryMocks.captureException,
+}));
+describe('admin Sentry', () => {
+    const originalRelease = process.env.NEXT_PUBLIC_SENTRY_RELEASE;
+    beforeEach(() => {
+        vi.resetModules();
+        sentryMocks.init.mockClear();
+        sentryMocks.captureException.mockClear();
+        delete process.env.NEXT_PUBLIC_SENTRY_RELEASE;
+    });
+    afterEach(() => {
+        if (originalRelease === undefined)
+            delete process.env.NEXT_PUBLIC_SENTRY_RELEASE;
+        else
+            process.env.NEXT_PUBLIC_SENTRY_RELEASE = originalRelease;
+    });
+    it('does not initialize without a DSN', async () => {
+        const { initAdminSentry } = await import('../../lib/sentry.js');
+        initAdminSentry(undefined);
+        initAdminSentry('   ');
+        expect(sentryMocks.init).not.toHaveBeenCalled();
+    });
+    it('initializes once and tags the release', async () => {
+        process.env.NEXT_PUBLIC_SENTRY_RELEASE = ' prenta@1.2.3 ';
+        const { initAdminSentry } = await import('../../lib/sentry.js');
+        initAdminSentry(' https://example@sentry.io/1 ');
+        initAdminSentry('https://example@sentry.io/1');
+        expect(sentryMocks.init).toHaveBeenCalledTimes(1);
+        expect(sentryMocks.init).toHaveBeenCalledWith(expect.objectContaining({
+            dsn: 'https://example@sentry.io/1',
+            release: 'prenta@1.2.3',
+            tracesSampleRate: 0,
+        }));
+    });
+    it('omits the release when NEXT_PUBLIC_SENTRY_RELEASE is unset', async () => {
+        const { initAdminSentry } = await import('../../lib/sentry.js');
+        initAdminSentry('https://example@sentry.io/1');
+        expect(sentryMocks.init).toHaveBeenCalledWith(expect.objectContaining({
+            dsn: 'https://example@sentry.io/1',
+            release: undefined,
+        }));
+    });
+    it('captures only after init, including the React component stack', async () => {
+        const { initAdminSentry, captureAdminException } = await import('../../lib/sentry.js');
+        const early = new Error('early');
+        captureAdminException(early);
+        expect(sentryMocks.captureException).not.toHaveBeenCalled();
+        initAdminSentry('https://example@sentry.io/1');
+        const err = new Error('boom');
+        captureAdminException(err, { componentStack: '\n    at Foo' });
+        expect(sentryMocks.captureException).toHaveBeenCalledWith(err, {
+            contexts: { react: { componentStack: '\n    at Foo' } },
+        });
+    });
+});
+//# sourceMappingURL=sentry.test.js.map

package/dist/__tests__/lib/sentry.test.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"sentry.d.ts","sourceRoot":"","sources":["../../src/lib/sentry.ts"],"names":[],"mappings":"AAIA,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAoB7D;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3C,IAAI,CAWN"}
+{"version":3,"file":"sentry.d.ts","sourceRoot":"","sources":["../../src/lib/sentry.ts"],"names":[],"mappings":"AAIA,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAyB7D;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3C,IAAI,CAWN"}

package/dist/lib/sentry.js

@@ -4,9 +4,13 @@ let initialized = false;
 export function initAdminSentry(dsn) {
     if (initialized || !dsn?.trim())
         return;
+    // Next inlines NEXT_PUBLIC_* at the consumer build, including this
+    // reference inside the published admin package.
+    const release = process.env.NEXT_PUBLIC_SENTRY_RELEASE?.trim() || undefined;
     Sentry.init({
         dsn: dsn.trim(),
         environment: process.env.NODE_ENV ?? 'development',
+        release,
         tracesSampleRate: 0,
         beforeSend(event) {
             const str = JSON.stringify(event);

package/dist/lib/sentry.js.map

@@ -1 +1 @@
-{"version":3,"file":"sentry.js","sourceRoot":"","sources":["../../src/lib/sentry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,IAAI,WAAW,GAAG,KAAK,CAAA;AAEvB,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,GAAuB;IACrD,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;QAAE,OAAM;IAEvC,MAAM,CAAC,IAAI,CAAC;QACV,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE;QACf,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa;QAClD,gBAAgB,EAAE,CAAC;QACnB,UAAU,CAAC,KAAK;YACd,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YACjC,IAAI,qCAAqC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpD,OAAO;oBACL,GAAG,KAAK;oBACR,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACzB,WAAW,EAAE,EAAE;iBAChB,CAAA;YACH,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;KACF,CAAC,CAAA;IACF,WAAW,GAAG,IAAI,CAAA;AACpB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CACnC,KAAY,EACZ,OAA4C;IAE5C,IAAI,CAAC;QACH,IAAI,CAAC,WAAW;YAAE,OAAM;QACxB,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE;YAC7B,QAAQ,EAAE,OAAO,EAAE,cAAc;gBAC/B,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE;gBACvD,CAAC,CAAC,SAAS;SACd,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;AACH,CAAC"}
+{"version":3,"file":"sentry.js","sourceRoot":"","sources":["../../src/lib/sentry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,IAAI,WAAW,GAAG,KAAK,CAAA;AAEvB,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,GAAuB;IACrD,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;QAAE,OAAM;IAEvC,mEAAmE;IACnE,gDAAgD;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,EAAE,IAAI,SAAS,CAAA;IAE3E,MAAM,CAAC,IAAI,CAAC;QACV,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE;QACf,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa;QAClD,OAAO;QACP,gBAAgB,EAAE,CAAC;QACnB,UAAU,CAAC,KAAK;YACd,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YACjC,IAAI,qCAAqC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpD,OAAO;oBACL,GAAG,KAAK;oBACR,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACzB,WAAW,EAAE,EAAE;iBAChB,CAAA;YACH,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;KACF,CAAC,CAAA;IACF,WAAW,GAAG,IAAI,CAAA;AACpB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CACnC,KAAY,EACZ,OAA4C;IAE5C,IAAI,CAAC;QACH,IAAI,CAAC,WAAW;YAAE,OAAM;QACxB,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE;YAC7B,QAAQ,EAAE,OAAO,EAAE,cAAc;gBAC/B,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,EAAE;gBACvD,CAAC,CAAC,SAAS;SACd,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prenta/admin",
-  "version": "1.17.5",
+  "version": "1.17.6",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -99,14 +99,14 @@
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
     "@prenta/component-blocks": "0.3.1",
+    "@prenta/core": "7.2.1",
     "@prenta/plugin-ai": "3.0.0",
     "@prenta/plugin-blocks": "0.2.0",
-    "@prenta/core": "7.2.1",
     "@prenta/plugin-commerce": "0.2.1",
     "@prenta/plugin-forms": "0.1.0",
-    "@prenta/plugin-seo": "1.0.0",
-    "@prenta/plugin-navigation": "0.3.0",
     "@prenta/plugin-media": "0.2.0",
+    "@prenta/plugin-navigation": "0.3.0",
+    "@prenta/plugin-seo": "1.0.0",
     "@prenta/sections-react": "0.17.46"
   },
   "scripts": {

package/src/__tests__/components/error-boundary.test.tsx

@@ -0,0 +1,34 @@
+// @vitest-environment happy-dom
+import { render, screen } from '@testing-library/react'
+import { describe, expect, it, vi } from 'vitest'
+
+const captureAdminException = vi.fn()
+
+vi.mock('../../lib/sentry.js', () => ({
+  captureAdminException: (...args: unknown[]) => captureAdminException(...args),
+}))
+
+const { ErrorBoundary } = await import('../../components/ErrorBoundary.js')
+
+function Boom(): never {
+  throw new Error('boundary boom')
+}
+
+describe('ErrorBoundary', () => {
+  it('reports a render error to Sentry (#407)', () => {
+    vi.spyOn(console, 'error').mockImplementation(() => {})
+    captureAdminException.mockClear()
+
+    render(
+      <ErrorBoundary>
+        <Boom />
+      </ErrorBoundary>,
+    )
+
+    expect(screen.getByRole('heading', { name: 'Something went wrong' })).toBeTruthy()
+    expect(captureAdminException).toHaveBeenCalledWith(
+      expect.objectContaining({ message: 'boundary boom' }),
+      expect.objectContaining({ componentStack: expect.any(String) }),
+    )
+  })
+})

package/src/__tests__/lib/sentry.test.ts

@@ -0,0 +1,77 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+
+const sentryMocks = vi.hoisted(() => ({
+  init: vi.fn(),
+  captureException: vi.fn(),
+}))
+
+vi.mock('@sentry/react', () => ({
+  init: sentryMocks.init,
+  captureException: sentryMocks.captureException,
+}))
+
+describe('admin Sentry', () => {
+  const originalRelease = process.env.NEXT_PUBLIC_SENTRY_RELEASE
+
+  beforeEach(() => {
+    vi.resetModules()
+    sentryMocks.init.mockClear()
+    sentryMocks.captureException.mockClear()
+    delete process.env.NEXT_PUBLIC_SENTRY_RELEASE
+  })
+
+  afterEach(() => {
+    if (originalRelease === undefined) delete process.env.NEXT_PUBLIC_SENTRY_RELEASE
+    else process.env.NEXT_PUBLIC_SENTRY_RELEASE = originalRelease
+  })
+
+  it('does not initialize without a DSN', async () => {
+    const { initAdminSentry } = await import('../../lib/sentry.js')
+    initAdminSentry(undefined)
+    initAdminSentry('   ')
+    expect(sentryMocks.init).not.toHaveBeenCalled()
+  })
+
+  it('initializes once and tags the release', async () => {
+    process.env.NEXT_PUBLIC_SENTRY_RELEASE = ' prenta@1.2.3 '
+    const { initAdminSentry } = await import('../../lib/sentry.js')
+
+    initAdminSentry(' https://example@sentry.io/1 ')
+    initAdminSentry('https://example@sentry.io/1')
+
+    expect(sentryMocks.init).toHaveBeenCalledTimes(1)
+    expect(sentryMocks.init).toHaveBeenCalledWith(
+      expect.objectContaining({
+        dsn: 'https://example@sentry.io/1',
+        release: 'prenta@1.2.3',
+        tracesSampleRate: 0,
+      }),
+    )
+  })
+
+  it('omits the release when NEXT_PUBLIC_SENTRY_RELEASE is unset', async () => {
+    const { initAdminSentry } = await import('../../lib/sentry.js')
+    initAdminSentry('https://example@sentry.io/1')
+    expect(sentryMocks.init).toHaveBeenCalledWith(
+      expect.objectContaining({
+        dsn: 'https://example@sentry.io/1',
+        release: undefined,
+      }),
+    )
+  })
+
+  it('captures only after init, including the React component stack', async () => {
+    const { initAdminSentry, captureAdminException } = await import('../../lib/sentry.js')
+    const early = new Error('early')
+    captureAdminException(early)
+    expect(sentryMocks.captureException).not.toHaveBeenCalled()
+
+    initAdminSentry('https://example@sentry.io/1')
+    const err = new Error('boom')
+    captureAdminException(err, { componentStack: '\n    at Foo' })
+
+    expect(sentryMocks.captureException).toHaveBeenCalledWith(err, {
+      contexts: { react: { componentStack: '\n    at Foo' } },
+    })
+  })
+})

package/src/lib/sentry.ts

@@ -6,9 +6,14 @@ let initialized = false
 export function initAdminSentry(dsn: string | undefined): void {
   if (initialized || !dsn?.trim()) return
 
+  // Next inlines NEXT_PUBLIC_* at the consumer build, including this
+  // reference inside the published admin package.
+  const release = process.env.NEXT_PUBLIC_SENTRY_RELEASE?.trim() || undefined
+
   Sentry.init({
     dsn: dsn.trim(),
     environment: process.env.NODE_ENV ?? 'development',
+    release,
     tracesSampleRate: 0,
     beforeSend(event) {
       const str = JSON.stringify(event)