nextjs-cms 0.9.22 → 0.9.23

package/dist/plugins/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/plugins/manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,kBAAkB,CAAA;IACzB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,kBAAkB,CAAA;IACzB,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IAClE,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,iBAAiB,CAAA;IACzB,QAAQ,EAAE,cAAc,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;CACrB;AAoDD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA+B1E;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAUpF"}

package/dist/plugins/manifest.js

@@ -0,0 +1,83 @@
+import { createRequire } from 'module';
+import path from 'path';
+import fs from 'fs';
+import { getCMSConfig } from '../core/config/index.js';
+const appRequire = createRequire(path.join(process.cwd(), 'package.json'));
+const pkgRequire = createRequire(import.meta.url);
+const resolvePluginPackageJson = (pluginPackage) => {
+    const target = `${pluginPackage}/package.json`;
+    try {
+        return appRequire.resolve(target);
+    }
+    catch {
+        try {
+            return pkgRequire.resolve(target, { paths: [process.cwd()] });
+        }
+        catch {
+            return null;
+        }
+    }
+};
+const readManifestFromPackage = (pluginPackage) => {
+    const pkgJsonPath = resolvePluginPackageJson(pluginPackage);
+    if (!pkgJsonPath) {
+        console.warn(`[plugins] Could not resolve "${pluginPackage}/package.json".`);
+        return null;
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
+    }
+    catch (error) {
+        console.warn(`[plugins] Failed to read "${pkgJsonPath}":`, error);
+        return null;
+    }
+    const manifest = pkg.pluginManifest;
+    if (!manifest) {
+        console.warn(`[plugins] Package "${pluginPackage}" is missing the "pluginManifest" field in package.json. ` +
+            `Plugins must declare metadata statically so the CLI can read it without evaluating plugin code.`);
+        return null;
+    }
+    if (!manifest.name || !manifest.registryName || !manifest.title) {
+        console.warn(`[plugins] Package "${pluginPackage}" has an invalid "pluginManifest" — required fields: name, registryName, title.`);
+        return null;
+    }
+    return manifest;
+};
+export async function getPluginManifests() {
+    const config = await getCMSConfig();
+    const registrations = config.plugins ?? [];
+    const seenPackages = new Set();
+    const seenNames = new Set();
+    const loaded = [];
+    for (const registration of registrations) {
+        if (!registration.package)
+            continue;
+        if (seenPackages.has(registration.package))
+            continue;
+        const manifest = readManifestFromPackage(registration.package);
+        if (!manifest)
+            continue;
+        if (seenNames.has(manifest.name)) {
+            console.warn(`[plugins] Duplicate plugin name "${manifest.name}" — skipping "${registration.package}".`);
+            continue;
+        }
+        seenPackages.add(registration.package);
+        seenNames.add(manifest.name);
+        loaded.push({
+            config: registration,
+            manifest,
+            moduleName: registration.package,
+        });
+    }
+    return loaded;
+}
+export async function getPluginRouteManifests() {
+    const loaded = await getPluginManifests();
+    return loaded.flatMap((entry) => (entry.manifest.routes ?? []).map((route) => ({
+        ...route,
+        pluginId: entry.config.package,
+        pluginName: entry.manifest.name,
+        pluginRegistryName: entry.manifest.registryName,
+    })));
+}

package/dist/plugins/prefetch.d.ts

@@ -0,0 +1,16 @@
+import type { LoadedPluginRoute } from './loader.js';
+/**
+ * Walks a dot-path into a tRPC RSC `api` proxy and invokes `.prefetch()` at the leaf.
+ *
+ * Example: `runApiPrefetch(api, 'cpanelEmails.getEmails')` runs
+ * `await api.cpanelEmails.getEmails.prefetch()`.
+ *
+ * Throws if any segment is missing or the leaf has no `prefetch` helper, so a typo
+ * in `PluginRoute.prefetch` fails loudly during development.
+ */
+export declare function runApiPrefetch(api: unknown, dotPath: string): Promise<void>;
+/** Normalizes a route's `prefetch` field (string | string[] | undefined) into an array. */
+export declare function getRoutePrefetchPaths(route: Pick<LoadedPluginRoute, 'prefetch'>): string[];
+/** Runs all declared prefetches for a route in parallel. */
+export declare function runRoutePrefetches(api: unknown, route: Pick<LoadedPluginRoute, 'prefetch'>): Promise<void>;
+//# sourceMappingURL=prefetch.d.ts.map

package/dist/plugins/prefetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.d.ts","sourceRoot":"","sources":["../../src/plugins/prefetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBjF;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,GAAG,MAAM,EAAE,CAG1F;AAED,4DAA4D;AAC5D,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhH"}

package/dist/plugins/prefetch.js

@@ -0,0 +1,40 @@
+/**
+ * Walks a dot-path into a tRPC RSC `api` proxy and invokes `.prefetch()` at the leaf.
+ *
+ * Example: `runApiPrefetch(api, 'cpanelEmails.getEmails')` runs
+ * `await api.cpanelEmails.getEmails.prefetch()`.
+ *
+ * Throws if any segment is missing or the leaf has no `prefetch` helper, so a typo
+ * in `PluginRoute.prefetch` fails loudly during development.
+ */
+export async function runApiPrefetch(api, dotPath) {
+    const segments = dotPath.split('.').filter(Boolean);
+    if (segments.length === 0) {
+        throw new Error('[plugins] Empty prefetch path.');
+    }
+    let node = api;
+    for (const key of segments) {
+        if (node == null || (typeof node !== 'object' && typeof node !== 'function')) {
+            throw new Error(`[plugins] Cannot resolve prefetch path "${dotPath}" — segment "${key}" is unreachable.`);
+        }
+        node = node[key];
+    }
+    const prefetch = node?.prefetch;
+    if (typeof prefetch !== 'function') {
+        throw new Error(`[plugins] Prefetch path "${dotPath}" does not resolve to a procedure with a prefetch helper.`);
+    }
+    await prefetch();
+}
+/** Normalizes a route's `prefetch` field (string | string[] | undefined) into an array. */
+export function getRoutePrefetchPaths(route) {
+    if (!route.prefetch)
+        return [];
+    return Array.isArray(route.prefetch) ? route.prefetch : [route.prefetch];
+}
+/** Runs all declared prefetches for a route in parallel. */
+export async function runRoutePrefetches(api, route) {
+    const paths = getRoutePrefetchPaths(route);
+    if (paths.length === 0)
+        return;
+    await Promise.all(paths.map((path) => runApiPrefetch(api, path)));
+}

package/dist/plugins/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Static import map for all official @nextjscms plugins.
+ *
+ * Why this file exists: the plugin loader needs to import plugin packages by
+ * name at runtime. Bare `await import(variable)` calls are rejected by
+ * Turbopack/webpack as "too dynamic" because the bundler cannot statically
+ * see which packages may be loaded. Listing each package as a literal
+ * `() => import('@nextjscms/plugin-x')` thunk lets the bundler analyze the
+ * import sites, and the host's module loader applies the correct export
+ * conditions at runtime — most importantly "react-server" during RSC
+ * requests, so plugin transitive deps marked `import 'server-only'` resolve
+ * to a no-op instead of throwing.
+ *
+ * Each thunk is wrapped in its own arrow so the import is deferred until the
+ * plugin is actually configured in cms.config.ts. Plugins not installed in
+ * the host app will fail at thunk invocation, which the loader treats as a
+ * normal "plugin not available" outcome.
+ *
+ * When a new official plugin is published, add an entry here.
+ */
+export declare const officialPluginRegistry: Record<string, () => Promise<unknown>>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugins/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAIzE,CAAA"}

package/dist/plugins/registry.js

@@ -0,0 +1,25 @@
+/**
+ * Static import map for all official @nextjscms plugins.
+ *
+ * Why this file exists: the plugin loader needs to import plugin packages by
+ * name at runtime. Bare `await import(variable)` calls are rejected by
+ * Turbopack/webpack as "too dynamic" because the bundler cannot statically
+ * see which packages may be loaded. Listing each package as a literal
+ * `() => import('@nextjscms/plugin-x')` thunk lets the bundler analyze the
+ * import sites, and the host's module loader applies the correct export
+ * conditions at runtime — most importantly "react-server" during RSC
+ * requests, so plugin transitive deps marked `import 'server-only'` resolve
+ * to a no-op instead of throwing.
+ *
+ * Each thunk is wrapped in its own arrow so the import is deferred until the
+ * plugin is actually configured in cms.config.ts. Plugins not installed in
+ * the host app will fail at thunk invocation, which the loader treats as a
+ * normal "plugin not available" outcome.
+ *
+ * When a new official plugin is published, add an entry here.
+ */
+export const officialPluginRegistry = {
+    '@nextjscms/plugin-cpanel-dashboard': () => import('@nextjscms/plugin-cpanel-dashboard'),
+    '@nextjscms/plugin-cpanel-emails': () => import('@nextjscms/plugin-cpanel-emails'),
+    '@nextjscms/plugin-google-analytics': () => import('@nextjscms/plugin-google-analytics'),
+};

package/dist/plugins/server.d.ts

@@ -1,2 +1,4 @@
 export * from './loader.js';
+export { derivePluginName, derivePluginRouterKey, extractPluginName, PLUGIN_PACKAGE_PREFIX } from './derive.js';
+export { runApiPrefetch, runRoutePrefetches, getRoutePrefetchPaths } from './prefetch.js';
 //# sourceMappingURL=server.d.ts.map

package/dist/plugins/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/plugins/server.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/plugins/server.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAC/G,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA"}

package/dist/plugins/server.js

@@ -1 +1,3 @@
 export * from './loader.js';
+export { derivePluginName, derivePluginRouterKey, extractPluginName, PLUGIN_PACKAGE_PREFIX } from './derive.js';
+export { runApiPrefetch, runRoutePrefetches, getRoutePrefetchPaths } from './prefetch.js';

package/dist/plugins/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Props passed to a plugin's server component by the host app.
+ *
+ * Currently empty — the host owns prefetching (declared via `PluginRoute.prefetch`)
+ * and wraps the plugin's tree in `<HydrateClient>`. Plugins receive no tRPC `api`
+ * proxy, which keeps the proxy off the RSC→Client serialization path.
+ */
+export type PluginServerComponentProps = Record<string, never>;
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA"}

package/dist/translations/base/en.d.ts

@@ -369,6 +369,7 @@ declare const _default: {
     readonly addedAgo: "Added {time} ago";
     readonly hoursAgo: "hours ago";
     readonly main: "Main";
+    readonly plugins: "Plugins";
     readonly categorySections: "Category Sections";
     readonly sectionsWithItems: "Sections with Items";
     readonly simpleSections: "Simple Sections";

package/dist/translations/base/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/translations/base/en.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAogBU"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../src/translations/base/en.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAqgBU"}

package/dist/translations/base/en.js

@@ -369,6 +369,7 @@ export default {
     addedAgo: 'Added {time} ago',
     hoursAgo: 'hours ago',
     main: 'Main',
+    plugins: 'Plugins',
     categorySections: 'Category Sections',
     sectionsWithItems: 'Sections with Items',
     simpleSections: 'Simple Sections',