ghost 5.82.8 → 5.82.9

package/core/built/admin/assets/{vendor-5ef343f0a55366497ef903095548a0d5.js → vendor-96853bcc300bd0b0cda2913c8edb0d14.js}

@@ -7011,7 +7011,7 @@ const s=function(){const e=n.GLOBAL_OBJ
 return e.__sentryEmberConfig=e.__sentryEmberConfig??{},e.__sentryEmberConfig}()
 Object.assign(s,i),o.init(i)}Object.keys(t).forEach((function(r){"default"!==r&&"__esModule"!==r&&(Object.prototype.hasOwnProperty.call(i,r)||r in e&&e[r]===t[r]||Object.defineProperty(e,r,{enumerable:!0,get:function(){return t[r]}}))}))
 e.getActiveTransaction=()=>o.getCurrentScope().getTransaction()
-e.instrumentRoutePerformance=e=>{const n=async(e,n,i,o)=>(0,t.startSpan)({attributes:{[r.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]:"ember"},op:e,name:n},(()=>i(...o))),i=e.name
+e.instrumentRoutePerformance=e=>{const n=async(e,n,i,o)=>(0,t.startSpan)({attributes:{[r.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]:"custom",[r.SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]:"auto.ui.ember"},op:e,name:n,onlyIfParent:!0},(()=>i(...o))),i=e.name
 return{[i]:class extends e{beforeModel(...e){return n("ui.ember.route.before_model",this.fullRouteName,super.beforeModel.bind(this),e)}async model(...e){return n("ui.ember.route.model",this.fullRouteName,super.model.bind(this),e)}afterModel(...e){return n("ui.ember.route.after_model",this.fullRouteName,super.afterModel.bind(this),e)}setupController(...e){return n("ui.ember.route.setup_controller",this.fullRouteName,super.setupController.bind(this),e)}}}[i]}
 e.InitSentryForEmber=s})),define("@sentry/ember/instance-initializers/sentry-performance",["exports","@sentry/browser","@sentry/utils"],(function(e,t,r){"use strict"
 function n(){const e=r.GLOBAL_OBJ
@@ -7022,15 +7022,15 @@ if(t?.isFastBoot)return
 if(n().disablePerformance)return
 c(e)}function o(){return Ember.run.backburner||Ember.run.backburner?Ember.run.backburner:{on(){},off(){}}}function s(e,r,n,i,s){const{disableRunloopPerformance:a}=n,l=r.location
 let u,c
-const d=n.browserTracingOptions||n.sentry.browserTracingOptions||{},h=function(e){if(!e||!e.getURL||!e.formatURL)return""
+const h=n.browserTracingOptions||n.sentry.browserTracingOptions||{},p=function(e){if(!e||!e.getURL||!e.formatURL)return""
 const t=e.formatURL(e.getURL())
-return"hash"===e.implementation?`${e.rootURL}${t}`:t}(l),p=(0,t.getClient)()
-if(!p)return
-if(h&&!1!==d.startTransactionOnPageLoad&&!1!==d.instrumentPageLoad){const r=e.recognize(h)
-u=i(p,{name:`route:${r.name}`,origin:"auto.pageload.ember",attributes:{[t.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]:"route"},tags:{url:h,toRoute:r.name,"routing.instrumentation":"@sentry/ember"}})}const f=(e,t)=>{t||(u?.end(),o().off("end",f))}
-!1===d.startTransactionOnLocationChange&&!1===d.instrumentNavigation||(e.on("routeWillChange",(r=>{const{fromRoute:n,toRoute:i}=function(e,t){const r=e?.from?.name
+return"hash"===e.implementation?`${e.rootURL}${t}`:t}(l),f=(0,t.getClient)()
+if(!f)return
+if(p&&!1!==h.startTransactionOnPageLoad&&!1!==h.instrumentPageLoad){const r=e.recognize(p)
+u=i(f,{name:`route:${r.name}`,origin:"auto.pageload.ember",attributes:{[t.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]:"route"},tags:{url:p,toRoute:r.name,"routing.instrumentation":"@sentry/ember"}})}const m=(e,t)=>{t||(u?.end(),o().off("end",m))}
+!1===h.startTransactionOnLocationChange&&!1===h.instrumentNavigation||(e.on("routeWillChange",(r=>{const{fromRoute:n,toRoute:i}=function(e,t){const r=e?.from?.name
 return{fromRoute:r,toRoute:e?.to?.name||t.currentRouteName}}(r,e)
-u?.end(),u=s(p,{name:`route:${i}`,origin:"auto.navigation.ember",attributes:{[t.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]:"route"},tags:{fromRoute:n,toRoute:i,"routing.instrumentation":"@sentry/ember"}}),c=(0,t.startInactiveSpan)({attributes:{[t.SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]:"auto.ui.ember"},op:"ui.ember.transition",name:`route:${n} -> route:${i}`,onlyIfParent:!0})})),e.on("routeDidChange",(()=>{c&&u&&(c.end(),a?u.end():o().on("end",f))})))}function a(e,t){const n={payload:e,now:(0,r.timestampInSeconds)()}
+d(r)||(u?.end(),u=s(f,{name:`route:${i}`,origin:"auto.navigation.ember",attributes:{[t.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]:"route"},tags:{fromRoute:n,toRoute:i,"routing.instrumentation":"@sentry/ember"}}),c=(0,t.startInactiveSpan)({attributes:{[t.SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN]:"auto.ui.ember"},op:"ui.ember.transition",name:`route:${n} -> route:${i}`,onlyIfParent:!0}))})),e.on("routeDidChange",(e=>{c&&u&&!d(e)&&(c.end(),a?u.end():o().on("end",m))})))}function a(e,t){const n={payload:e,now:(0,r.timestampInSeconds)()}
 t[e.object]=n}function l(e,n,i,o){const s=n[e.object]
 if(!s)return
 const a=(0,r.timestampInSeconds)()
@@ -7062,7 +7062,9 @@ l.forEach((e=>{Ember.run.scheduleOnce(e,null,o,e)}))})),o().on("end",((e,t)=>{t|
 if(t)return
 const i=r??2,o={},s={}
 Ember.Instrumentation.subscribe("render.component",{before(e,t,r){a(r,o)},after(e,t,r,n){l(r,o,"ui.ember.component.render",i)}}),n&&Ember.Instrumentation.subscribe("render.getComponentDefinition",{before(e,t,r){a(r,s)},after(e,t,r,n){l(r,s,"ui.ember.component.definition",0)}})}(i),u(i)}Object.defineProperty(e,"__esModule",{value:!0}),e._instrumentEmberRouter=s,e.default=void 0,e.initialize=i,e.instrumentForPerformance=c
-e.default={initialize:i}})),define("@sentry/ember/types",["exports"],(function(e){"use strict"
+e.default={initialize:i}
+function d(e){const t=e.isIntermediate
+return"boolean"==typeof t?t:"loading"===e.to?.localName||"error"===e.to?.localName}})),define("@sentry/ember/types",["exports"],(function(e){"use strict"
 Object.defineProperty(e,"__esModule",{value:!0})})),define("@tryghost/ember-promise-modals/components/modal-container",["exports","@tryghost/ember-promise-modals/templates/components/modal-container"],(function(e,t){"use strict"
 Object.defineProperty(e,"__esModule",{value:!0}),e.default=void 0
 e.default=Ember.Component.extend({layout:t.default,tagName:"",modals:Ember.inject.service()})})),define("@tryghost/ember-promise-modals/components/modal",["exports","focus-trap","@tryghost/ember-promise-modals/templates/components/modal"],(function(e,t,r){"use strict"
@@ -9176,7 +9178,7 @@ e.default={content:'<defs><style>.labs_svg__a{fill:none;stroke:currentColor;stro
 Object.defineProperty(e,"__esModule",{value:!0}),e.default=void 0
 e.default={content:'<path stroke="currentColor" d="M14.5 12.5l.086.086a2 2 0 002.828 0l3.965-3.964a3.01 3.01 0 000-4.243l-1.758-1.757a3.008 3.008 0 00-4.242 0l-3.965 3.964a2 2 0 000 2.829l.086.085m-2 2l-.086-.085a2 2 0 00-2.828 0l-3.965 3.964a3.01 3.01 0 000 4.243l1.758 1.757a3.008 3.008 0 004.242 0l3.965-3.964a2 2 0 000-2.829L12.5 14.5m-4.389 1.389l7.778-7.778" fill="none"/>',attrs:{viewBox:"0 0 24 24"}}})),define("ember-svg-jar/inlined/lock-filled",["exports"],(function(e){"use strict"
 Object.defineProperty(e,"__esModule",{value:!0}),e.default=void 0
-e.default={content:'<path d="M19.5 9.5h-.75V6.75a6.75 6.75 0 00-13.5 0V9.5H4.5a2 2 0 00-2 2V22a2 2 0 002 2h15a2 2 0 002-2V11.5a2 2 0 00-2-2zm-7.5 9a2 2 0 112-2 2 2 0 01-2 2zM16.25 9a.5.5 0 01-.5.5h-7.5a.5.5 0 01-.5-.5V6.75a4.25 4.25 0 018.5 0z"/>',attrs:{viewBox:"0 0 24 24"}}})),define("ember-svg-jar/inlined/lock",["exports"],(function(e){"use strict"
+e.default={content:'<path d="M19.5 9.5h-.75V6.75a6.75 6.75 0 00-13.5 0V9.5H4.5a2 2 0 00-2 2V22a2 2 0 002 2h15a2 2 0 002-2V11.5a2 2 0 00-2-2zm-7.5 9a2 2 0 112-2 2 2 0 01-2 2zM16.25 9a.5.5 0 01-.5.5h-7.5a.5.5 0 01-.5-.5V6.75a4.25 4.25 0 018.5 0z" fill="currentColor"/>',attrs:{viewBox:"0 0 24 24"}}})),define("ember-svg-jar/inlined/lock",["exports"],(function(e){"use strict"
 Object.defineProperty(e,"__esModule",{value:!0}),e.default=void 0
 e.default={content:'<rect width="16.5" height="13.5" x="3.75" y="9.75" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" rx="1.5" ry="1.5"/><path fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="M6.75 9.75V6a5.25 5.25 0 0110.5 0v3.75M12 15v3"/>',attrs:{"stroke-width":"1.5",viewBox:"0 0 24 24"}}})),define("ember-svg-jar/inlined/megaphone",["exports"],(function(e){"use strict"
 Object.defineProperty(e,"__esModule",{value:!0}),e.default=void 0
@@ -9924,4 +9926,4 @@ e.default=class{constructor(e){if(this._data=new t.default,e)for(let t=0;t<e.len
 return this}get(e){let t=this._data[e]
 return t===r.UNDEFINED_KEY?void 0:t}set(e,t){return this._data[e]=t,this}delete(e){return this._data[e]=r.UNDEFINED_KEY,!0}}}))
 
-//# sourceMappingURL=vendor-5b3c871639e8269236f1a32144698b0d.map
+//# sourceMappingURL=vendor-184a0eb190eeca86128313ada2ad7e97.map

package/core/built/admin/index.html

@@ -8,7 +8,7 @@
     <title>Ghost Admin</title>
 
     
-<meta name="ghost-admin/config/environment" content="%7B%22modulePrefix%22%3A%22ghost-admin%22%2C%22environment%22%3A%22production%22%2C%22cdnUrl%22%3A%22%22%2C%22editorUrl%22%3A%22%22%2C%22rootURL%22%3A%22%22%2C%22locationType%22%3A%22trailing-hash%22%2C%22EmberENV%22%3A%7B%22FEATURES%22%3A%7B%7D%2C%22EXTEND_PROTOTYPES%22%3A%7B%22Date%22%3Afalse%2C%22Array%22%3Atrue%2C%22String%22%3Atrue%2C%22Function%22%3Afalse%7D%2C%22_APPLICATION_TEMPLATE_WRAPPER%22%3Afalse%2C%22_JQUERY_INTEGRATION%22%3Atrue%2C%22_TEMPLATE_ONLY_GLIMMER_COMPONENTS%22%3Atrue%7D%2C%22APP%22%3A%7B%22version%22%3A%225.82%22%2C%22name%22%3A%22ghost-admin%22%7D%2C%22ember-simple-auth%22%3A%7B%7D%2C%22ember-websockets%22%3A%7B%22socketIO%22%3Atrue%7D%2C%22%40sentry%2Fember%22%3A%7B%22disablePerformance%22%3Atrue%2C%22sentry%22%3A%7B%7D%7D%2C%22ember-cli-mirage%22%3A%7B%22usingProxy%22%3Afalse%2C%22useDefaultPassthroughs%22%3Atrue%7D%2C%22exportApplicationGlobal%22%3Afalse%2C%22ember-load%22%3A%7B%22loadingIndicatorClass%22%3A%22ember-load-indicator%22%7D%2C%22editorFilename%22%3A%22koenig-lexical.umd.js%22%2C%22editorHash%22%3A%2215c735fb44%22%2C%22adminXDemoFilename%22%3A%22admin-x-demo.js%22%2C%22adminXDemoHash%22%3A%22cb1aa176ec%22%2C%22adminXSettingsFilename%22%3A%22admin-x-settings.js%22%2C%22adminXSettingsHash%22%3A%22a2190ecc4c%22%2C%22adminXActivitypubFilename%22%3A%22admin-x-activitypub.js%22%2C%22adminXActivitypubHash%22%3A%22ee41f6f558%22%7D" />
+<meta name="ghost-admin/config/environment" content="%7B%22modulePrefix%22%3A%22ghost-admin%22%2C%22environment%22%3A%22production%22%2C%22cdnUrl%22%3A%22%22%2C%22editorUrl%22%3A%22%22%2C%22rootURL%22%3A%22%22%2C%22locationType%22%3A%22trailing-hash%22%2C%22EmberENV%22%3A%7B%22FEATURES%22%3A%7B%7D%2C%22EXTEND_PROTOTYPES%22%3A%7B%22Date%22%3Afalse%2C%22Array%22%3Atrue%2C%22String%22%3Atrue%2C%22Function%22%3Afalse%7D%2C%22_APPLICATION_TEMPLATE_WRAPPER%22%3Afalse%2C%22_JQUERY_INTEGRATION%22%3Atrue%2C%22_TEMPLATE_ONLY_GLIMMER_COMPONENTS%22%3Atrue%7D%2C%22APP%22%3A%7B%22version%22%3A%225.82%22%2C%22name%22%3A%22ghost-admin%22%7D%2C%22ember-simple-auth%22%3A%7B%7D%2C%22ember-websockets%22%3A%7B%22socketIO%22%3Atrue%7D%2C%22%40sentry%2Fember%22%3A%7B%22disablePerformance%22%3Atrue%2C%22sentry%22%3A%7B%7D%7D%2C%22ember-cli-mirage%22%3A%7B%22usingProxy%22%3Afalse%2C%22useDefaultPassthroughs%22%3Atrue%7D%2C%22exportApplicationGlobal%22%3Afalse%2C%22ember-load%22%3A%7B%22loadingIndicatorClass%22%3A%22ember-load-indicator%22%7D%2C%22editorFilename%22%3A%22koenig-lexical.umd.js%22%2C%22editorHash%22%3A%22de6c86d49f%22%2C%22adminXDemoFilename%22%3A%22admin-x-demo.js%22%2C%22adminXDemoHash%22%3A%22e3e5407d53%22%2C%22adminXSettingsFilename%22%3A%22admin-x-settings.js%22%2C%22adminXSettingsHash%22%3A%223b683fe57d%22%2C%22adminXActivitypubFilename%22%3A%22admin-x-activitypub.js%22%2C%22adminXActivitypubHash%22%3A%2298cba57561%22%7D" />
 
     <meta name="HandheldFriendly" content="True" />
     <meta name="MobileOptimized" content="320" />
@@ -56,9 +56,9 @@
 
     <div id="ember-basic-dropdown-wormhole"></div>
 
-    <script src="assets/vendor-5ef343f0a55366497ef903095548a0d5.js"></script>
-<script src="assets/chunk.799.5012e659e3d64d043636.js"></script>
-<script src="assets/chunk.524.784dc858253af4b339a9.js"></script>
-    <script src="assets/ghost-e16d0c67f0a0262f4cbe0d2745f90f5a.js"></script>
+    <script src="assets/vendor-96853bcc300bd0b0cda2913c8edb0d14.js"></script>
+<script src="assets/chunk.799.5bcf6feef26f9fe94f0a.js"></script>
+<script src="assets/chunk.524.cad7f24c33927f31923c.js"></script>
+    <script src="assets/ghost-377ce682ddf6e53f0ccb91aeae235f29.js"></script>
 </body>
 </html>

package/core/frontend/meta/og-image.js

@@ -5,7 +5,7 @@ const settingsCache = require('../../shared/settings-cache');
 
 function getOgImage(data) {
     const context = data.context ? data.context : null;
-    const contextObject = getContextObject(data, context, false);
+    const contextObject = getContextObject(data, context);
 
     if (_.includes(context, 'home')) {
         const imgUrl = settingsCache.get('og_image') || settingsCache.get('cover_image');

package/core/frontend/meta/twitter-image.js

@@ -5,7 +5,7 @@ const settingsCache = require('../../shared/settings-cache');
 
 function getTwitterImage(data) {
     const context = data.context ? data.context : null;
-    const contextObject = getContextObject(data, context, false);
+    const contextObject = getContextObject(data, context);
 
     if (_.includes(context, 'home')) {
         const imgUrl = settingsCache.get('twitter_image') || settingsCache.get('cover_image');

package/core/frontend/services/routing/ParentRouter.js

@@ -56,7 +56,7 @@ class ParentRouter {
     /**
      * @description Helper function to find the site router in the express router stack.
      * @param {Object} req
-     * @returns {Express-Router}
+     * @returns {import('express').Router}
      * @private
      */
     _getSiteRouter(req) {
@@ -116,8 +116,8 @@ class ParentRouter {
 
     /**
      * @description Mount a router on a router (sub-routing)
-     * @param {String} path
-     * @param {Express-Router} router
+     * @param {String | import('express').Router} path
+     * @param {import('express').Router} [router]
      */
     mountRouter(path, router) {
         if (arguments.length === 1) {

package/core/frontend/web/middleware/error-handler.js

@@ -34,7 +34,7 @@ const errorFallbackMessage = err => `<h1>${tpl(messages.oopsErrorTemplateHasErro
      <br ><p>${tpl(messages.whilstTryingToRender)}</p>
      ${err.statusCode} <pre>${escapeExpression(err.message || err)}</pre>`;
 
-const themeErrorRenderer = (err, req, res, next) => {
+const themeErrorRenderer = function themeErrorRenderer(err, req, res, next) {
     // If the error code is explicitly set to STATIC_FILE_NOT_FOUND,
     // Skip trying to render an HTML error, and move on to the basic error renderer
     // We do this because customised 404 templates could reference the image that's missing

package/core/frontend/web/site.js

@@ -50,7 +50,7 @@ module.exports = function setupSiteApp(routerConfig) {
     // enable CORS headers (allows admin client to hit front-end when configured on separate URLs)
     siteApp.use(mw.cors);
 
-    siteApp.use(async (req, res, next) => {
+    siteApp.use(async function nestApp(req, res, next) {
         if (labs.isSet('NestPlayground') || labs.isSet('ActivityPub')) {
             const originalExpressApp = req.app;
             const app = await GhostNestApp.getApp();
@@ -112,7 +112,9 @@ module.exports = function setupSiteApp(routerConfig) {
     siteApp.use(
         '/members/.well-known',
         shared.middleware.cacheControl('public', {maxAge: config.get('caching:wellKnown:maxAge')}),
-        (req, res, next) => membersService.api.middleware.wellKnown(req, res, next)
+        function lazyWellKnownMw(req, res, next) {
+            return membersService.api.middleware.wellKnown(req, res, next);
+        }
     );
 
     // Recommendations well-known

package/core/server/GhostServer.js

@@ -67,7 +67,7 @@ class GhostServer {
      * Starts the ghost server listening on the configured port.
      * Requires an express app to be passed in
      *
-     * @param  {Object} rootApp - Required express app instance.
+     * @param  {import('express').Application} rootApp - Required express app instance.
      * @return {Promise} Resolves once Ghost has started
      */
     start(rootApp) {

package/core/server/api/endpoints/actions.js

@@ -1,6 +1,7 @@
 const models = require('../../models');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'actions',
 
     browse: {
@@ -20,3 +21,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/announcements.js

@@ -1,6 +1,7 @@
 const announcementBarSettings = require('../../services/announcement-bar-service');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'announcement',
 
     browse: {
@@ -13,3 +14,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/authentication.js

@@ -18,7 +18,8 @@ const messages = {
     notTheBlogOwner: 'You are not the site owner.'
 };
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'authentication',
 
     setup: {
@@ -250,3 +251,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/authors-public.js

@@ -19,7 +19,8 @@ const rejectPrivateFieldsTransformer = input => mapQuery(input, function (value,
     };
 });
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'authors',
 
     browse: {
@@ -92,3 +93,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/collections-public.js

@@ -6,7 +6,8 @@ const messages = {
     collectionNotFound: 'Collection not found.'
 };
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'collections',
 
     readBySlug: {
@@ -51,3 +52,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/collections.js

@@ -6,7 +6,8 @@ const messages = {
     collectionNotFound: 'Collection not found.'
 };
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'collections',
 
     browse: {
@@ -136,3 +137,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/comments-members.js

@@ -2,7 +2,8 @@ const commentsService = require('../../services/comments');
 const ALLOWED_INCLUDES = ['member', 'replies', 'replies.member', 'replies.count.likes', 'replies.liked', 'count.replies', 'count.likes', 'liked', 'post', 'parent'];
 const UNSAFE_ATTRS = ['status'];
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'comments',
 
     browse: {
@@ -143,8 +144,8 @@ module.exports = {
             }
         },
         permissions: true,
-        query(frame) {
-            return commentsService.controller.destroy(frame);
+        query() {
+            return commentsService.controller.destroy();
         }
     },
 
@@ -207,3 +208,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/comments.js

@@ -1,6 +1,7 @@
 const models = require('../../models');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'comments',
 
     edit: {
@@ -26,3 +27,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/config.js

@@ -1,6 +1,7 @@
 const publicConfig = require('../../services/public-config');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'config',
 
     read: {
@@ -13,3 +14,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/custom-theme-settings.js

@@ -1,6 +1,7 @@
 const customThemeSettingsService = require('../../services/custom-theme-settings');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'custom_theme_settings',
 
     browse: {
@@ -23,3 +24,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/db.js

@@ -8,7 +8,8 @@ const {pool} = require('@tryghost/promise');
 const models = require('../../models');
 const settingsCache = require('../../../shared/settings-cache');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'db',
 
     backupContent: {
@@ -173,3 +174,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/email-post.js

@@ -7,7 +7,8 @@ const messages = {
     postNotFound: 'Post not found.'
 };
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'email_post',
 
     read: {
@@ -46,3 +47,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/email-previews.js

@@ -1,6 +1,7 @@
 const emailService = require('../../services/email-service');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'email_previews',
 
     read: {
@@ -47,3 +48,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/emails.js

@@ -12,7 +12,8 @@ const messages = {
 const allowedBatchIncludes = ['count.recipients'];
 const allowedFailureIncludes = ['member', 'email_recipient'];
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'emails',
 
     browse: {
@@ -180,3 +181,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/explore.js

@@ -1,6 +1,7 @@
 const exploreService = require('../../services/explore');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'explore',
 
     read: {
@@ -13,3 +14,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/feedback-members.js

@@ -1,6 +1,7 @@
 const feedbackService = require('../../services/audience-feedback');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'feedback',
 
     add: {
@@ -24,3 +25,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/files.js

@@ -1,6 +1,7 @@
 const storage = require('../../adapters/storage');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'files',
     upload: {
         statusCode: 201,
@@ -20,3 +21,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/identities.js

@@ -23,7 +23,8 @@ const sign = async (claims, options) => {
     }, options));
 };
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'identities',
     read: {
         headers: {
@@ -36,3 +37,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/images.js

@@ -6,7 +6,8 @@ const imageTransform = require('@tryghost/image-transform');
 const storage = require('../../adapters/storage');
 const config = require('../../../shared/config');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'images',
     upload: {
         statusCode: 201,
@@ -80,3 +81,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/incoming-recommendations.js

@@ -1,6 +1,7 @@
 const recommendations = require('../../services/recommendations');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'recommendations',
 
     browse: {
@@ -18,3 +19,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/integrations.js

@@ -12,7 +12,8 @@ const integrationsService = getIntegrationsServiceInstance({
     ApiKeyModel: models.ApiKey
 });
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'integrations',
     browse: {
         headers: {
@@ -163,3 +164,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/invites.js

@@ -10,7 +10,8 @@ const messages = {
     inviteNotFound: 'Invite not found.'
 };
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'invites',
 
     browse: {
@@ -127,3 +128,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/labels.js

@@ -9,7 +9,8 @@ const messages = {
 
 const ALLOWED_INCLUDES = ['count.members'];
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'labels',
 
     browse: {
@@ -161,3 +162,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/links.js

@@ -1,7 +1,8 @@
 const linkTrackingService = require('../../services/link-tracking');
 const INVALIDATE_ALL_REDIRECTS = '/r/*';
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'links',
     browse: {
         headers: {
@@ -59,3 +60,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/mail-events.js

@@ -1,6 +1,7 @@
 const mailEvents = require('../../services/mail-events');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'mail_events',
     add: {
         headers: {
@@ -12,3 +13,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/mail.js

@@ -35,7 +35,8 @@ _private.sendMail = (object) => {
     });
 };
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'mail',
 
     send: {
@@ -46,23 +47,7 @@ module.exports = {
         query(frame) {
             return _private.sendMail(frame.data);
         }
-    },
-
-    sendTest(frame) {
-        return mailService.utils.generateContent({template: 'test'})
-            .then((content) => {
-                const payload = {
-                    mail: [{
-                        message: {
-                            to: frame.user.get('email'),
-                            subject: tpl(messages.testGhostEmail),
-                            html: content.html,
-                            text: content.text
-                        }
-                    }]
-                };
-
-                return _private.sendMail(payload);
-            });
     }
 };
+
+module.exports = controller;

package/core/server/api/endpoints/media.js

@@ -1,7 +1,8 @@
 const path = require('path');
 const storage = require('../../adapters/storage');
 
-module.exports = {
+/** @type {import('@tryghost/api-framework').Controller} */
+const controller = {
     docName: 'media',
     upload: {
         statusCode: 201,
@@ -47,3 +48,5 @@ module.exports = {
         }
     }
 };
+
+module.exports = controller;