@fourlights/strapi-plugin-deep-populate 1.0.0-beta.0 → 1.0.1

package/README.md

@@ -1,5 +1,7 @@
 # @fourlights/strapi-plugin-deep-populate
 
+[![npm version](https://badge.fury.io/js/@fourlights%2Fstrapi-plugin-deep-populate.svg)](https://badge.fury.io/js/@fourlights%2Fstrapi-plugin-deep-populate)
+
 This Strapi v5 plugin provides a simple way of retrieving all nested objects in a single request.
 It does this by traversing the schema and comparing that to the actual retrieved document(s).
 Only relations that are actually set will be populated.
@@ -8,17 +10,25 @@ Only relations that are actually set will be populated.
 
 ```ts
 // Option 1: get the populate object and use where you see fit
-const populate = await strapi.plugin("deep-populate").service("populate").getPopulate({ documentId: 'xyz', contentType: 'api::page.page' })
+const populate = await strapi.plugin("deep-populate").service("populate").get({ documentId: 'xyz', contentType: 'api::page.page' })
 const document = strapi.documents('api::page.page').findOne({ documentId: 'xyz', populate })
 ```
 ```ts
-// Option 2: use the wrapped `findOne` method around documentService
+// Option 2: use the `findOne` method that wraps around documentService.findOne
 const { findOne } = strapi.plugin("deep-populate").service("populate").documents("api::page.page")
 const document = await findOne({ documentId: 'xyz' })
+```
 
-// You can also override the populate this way:
+```ts
+// Using the wrapped FindOne provides some handy features:
+
+// Allow you to override the populate this way:
 const documentWithCreatedBy = findOne({ documentId: 'xyz', populate: ['createdBy']})
 const documentWithoutSection = findOne({ documentId: 'xyz', populate: { section: false }})
+
+// And if you supply a `*` as populate, it will return a fully populated document (i.e. non-sparse)
+const sparseDocument = findOne({ documentId: 'xyz' }) // sparse, so only attributes are returned that have a value
+const fullDocument = findOne({ documentId: 'xyz', populate: '*' })   // fully populated, so all attributes are returned
 ```
 
 ### populateCreatorFields

package/dist/server/index.js

@@ -24584,7 +24584,7 @@ const isPopulateString = (value) => {
 };
 const isStringArray$1 = (value) => fp.isArray(value) && value.every(fp.isString);
 const isObj = (value) => fp.isObject(value);
-const populate = traverseFactory().intercept(isPopulateString, async (visitor2, options, populate2, { recurse }) => {
+const populate$1 = traverseFactory().intercept(isPopulateString, async (visitor2, options, populate2, { recurse }) => {
   const populateObject = pathsToObjectPopulate([populate2]);
   const traversedPopulate = await recurse(visitor2, options, populateObject);
   const [result] = objectPopulateToPaths(traversedPopulate);
@@ -24752,7 +24752,7 @@ const populate = traverseFactory().intercept(isPopulateString, async (visitor2,
     }
   }
 );
-const traverseQueryPopulate = fp.curry(populate.traverse);
+const traverseQueryPopulate = fp.curry(populate$1.traverse);
 const objectPopulateToPaths = (input) => {
   const paths = [];
   function traverse(currentObj, parentPath) {
@@ -25073,31 +25073,42 @@ async function _populateComponent({
   mainUid,
   mainDocumentId,
   schema: schema2,
-  populate: populate2,
-  lookup
+  populate: populate2 = {},
+  lookup,
+  inDynamicZone = false,
+  omitEmpty
 }) {
-  const nestedPopulate = await _populate({ mainUid, mainDocumentId, schema: schema2, populate: populate2, lookup });
-  return { populate: nestedPopulate ? nestedPopulate : "*" };
+  const attrName = lookup.pop();
+  const componentLookup = lookup.length === 0 ? [attrName] : [...lookup, inDynamicZone ? "on" : "populate", attrName];
+  const componentPopulate = json$1.klona(populate2);
+  merge$1.dset(componentPopulate, componentLookup, { populate: "*" });
+  const nestedPopulate = await _populate({
+    mainUid,
+    mainDocumentId,
+    schema: schema2,
+    populate: componentPopulate,
+    lookup: componentLookup,
+    omitEmpty
+  });
+  return isEmpty(nestedPopulate) ? true : { populate: nestedPopulate };
 }
 async function _populateDynamicZone({
   mainUid,
   mainDocumentId,
   components,
   populate: populate2,
-  lookup
+  lookup,
+  omitEmpty
 }) {
-  const dzLookup = [...lookup, "on"];
-  const dzPopulate = json$1.klona(populate2);
-  merge$1.dset(dzPopulate, dzLookup, {});
   const resolvedPopulate = await components.reduce(async (prev, cur) => {
-    const componentPopulate = json$1.klona(dzPopulate);
-    delve__default.default(componentPopulate, dzLookup)[cur] = { populate: "*" };
     const curPopulate = await _populateComponent({
       mainUid,
       mainDocumentId,
       schema: cur,
-      populate: componentPopulate,
-      lookup: [...dzLookup, cur]
+      populate: populate2,
+      lookup: [...lookup, cur],
+      inDynamicZone: true,
+      omitEmpty
     });
     const newPop = await prev;
     merge$1.dset(newPop, [cur], curPopulate);
@@ -25107,12 +25118,13 @@ async function _populateDynamicZone({
   return { on: resolvedPopulate };
 }
 function _populateMedia() {
-  return { populate: "*" };
+  return true;
 }
 async function _populateRelation({
   contentType,
   relation,
-  resolvedRelations
+  resolvedRelations,
+  omitEmpty
 }) {
   const isSingleRelation = !Array.isArray(relation);
   const relations = isSingleRelation ? [relation] : relation;
@@ -25122,7 +25134,8 @@ async function _populateRelation({
       mainUid: contentType,
       mainDocumentId: relation2.documentId,
       schema: contentType,
-      resolvedRelations
+      resolvedRelations,
+      omitEmpty
     });
     resolvedRelations.set(relation2.documentId, relationPopulate);
   }
@@ -25131,15 +25144,34 @@ async function _populateRelation({
     const relationPopulate = resolvedRelations.get(documentId);
     Object.keys(relationPopulate).map((r) => merge$1.dset(newPopulate, r, relationPopulate[r]));
   }
-  return { populate: newPopulate };
+  return isEmpty(newPopulate) ? true : { populate: newPopulate };
 }
+const _resolveValue = ({ document: document2, lookup, attrName }) => {
+  if (lookup.find((l) => l === "on")) {
+    const attrLookup = lookup.filter((l) => l !== "on");
+    const parentAttr = attrLookup.pop();
+    const parentValue2 = (delve__default.default(document2, attrLookup) ?? []).filter((b) => b.__component === parentAttr) ?? [];
+    return (Array.isArray(parentValue2) ? parentValue2 : [parentValue2]).find((v) => hasValue(v[attrName]))?.[attrName];
+  }
+  if (lookup.find((l) => l === "populate")) {
+    const attrLookup = lookup.filter((l) => l !== "populate");
+    const parentValue2 = delve__default.default(document2, attrLookup) ?? [];
+    return (Array.isArray(parentValue2) ? parentValue2 : [parentValue2]).find((v) => hasValue(v[attrName]))?.[attrName];
+  }
+  const parentValue = delve__default.default(document2, lookup);
+  if (Array.isArray(parentValue)) {
+    return parentValue.map((v) => v[attrName]);
+  }
+  return parentValue?.[attrName];
+};
 async function _populate({
   mainUid,
   mainDocumentId,
   schema: schema2,
   populate: populate2 = {},
   lookup = [],
-  resolvedRelations = /* @__PURE__ */ new Map()
+  resolvedRelations = /* @__PURE__ */ new Map(),
+  omitEmpty = true
 }) {
   const newPopulate = {};
   const model = strapi.getModel(schema2);
@@ -25160,10 +25192,9 @@ async function _populate({
     populate: currentPopulate ? currentPopulate : "*"
   });
   for (const [attrName, attr] of relations) {
-    const attrLookup = [...lookup, attrName];
-    const value = delve__default.default(document2, attrLookup);
+    const value = _resolveValue({ document: document2, attrName, lookup });
     if (!hasValue(value)) {
-      newPopulate[attrName] = true;
+      if (!omitEmpty) newPopulate[attrName] = true;
       continue;
     }
     if (contentTypes.isDynamicZoneAttribute(attr)) {
@@ -25174,8 +25205,8 @@ async function _populate({
         mainUid,
         mainDocumentId,
         components: relComponents,
-        populate: newPopulate,
-        lookup: [...lookup, attrName]
+        lookup: [...lookup, attrName],
+        omitEmpty
       });
     }
     if (contentTypes.isRelationalAttribute(attr)) {
@@ -25183,7 +25214,8 @@ async function _populate({
       newPopulate[attrName] = await _populateRelation({
         contentType: relContentType,
         relation: value,
-        resolvedRelations
+        resolvedRelations,
+        omitEmpty
       });
     }
     if (contentTypes.isComponentAttribute(attr) && !contentTypes.isDynamicZoneAttribute(attr)) {
@@ -25191,26 +25223,35 @@ async function _populate({
         mainUid,
         mainDocumentId,
         schema: attr.component,
-        populate: newPopulate,
-        lookup: [...lookup, attrName]
+        lookup: [...lookup, attrName],
+        omitEmpty
       });
     }
     if (contentTypes.isMediaAttribute(attr)) {
       newPopulate[attrName] = _populateMedia();
     }
   }
-  return isEmpty(newPopulate) ? "*" : newPopulate;
+  return newPopulate;
 }
-const deepPopulateService = ({ strapi: strapi2 }) => ({
-  async getPopulate({ contentType, documentId }) {
-    return await _populate({ mainUid: contentType, mainDocumentId: documentId, schema: contentType });
+const populate = ({ strapi: strapi2 }) => ({
+  async get({
+    contentType,
+    documentId,
+    omitEmpty = false
+  }) {
+    return await _populate({ mainUid: contentType, mainDocumentId: documentId, schema: contentType, omitEmpty });
   },
   documents(contentType) {
     strapi2.documents(contentType);
     const { findOne, ...wrapped } = strapi2.documents(contentType);
     const wrappedFindOne = async (params) => {
       const { documentId, populate: originalPopulate } = params;
-      const deepPopulate = await _populate({ mainUid: contentType, mainDocumentId: documentId, schema: contentType });
+      const deepPopulate = await _populate({
+        mainUid: contentType,
+        mainDocumentId: documentId,
+        schema: contentType,
+        omitEmpty: originalPopulate !== "*"
+      });
       if (originalPopulate && originalPopulate !== "*") {
         strapi2.log.warn(
           `passed "populate" will be merged with deepPopulate, which could result in unexpected behavior.`
@@ -25225,7 +25266,7 @@ const deepPopulateService = ({ strapi: strapi2 }) => ({
   }
 });
 const services = {
-  populate: deepPopulateService
+  populate
 };
 const index = {
   services

package/dist/server/index.mjs

@@ -24570,7 +24570,7 @@ const isPopulateString = (value) => {
 };
 const isStringArray$1 = (value) => fp.isArray(value) && value.every(fp.isString);
 const isObj = (value) => fp.isObject(value);
-const populate = traverseFactory().intercept(isPopulateString, async (visitor2, options, populate2, { recurse }) => {
+const populate$1 = traverseFactory().intercept(isPopulateString, async (visitor2, options, populate2, { recurse }) => {
   const populateObject = pathsToObjectPopulate([populate2]);
   const traversedPopulate = await recurse(visitor2, options, populateObject);
   const [result] = objectPopulateToPaths(traversedPopulate);
@@ -24738,7 +24738,7 @@ const populate = traverseFactory().intercept(isPopulateString, async (visitor2,
     }
   }
 );
-const traverseQueryPopulate = fp.curry(populate.traverse);
+const traverseQueryPopulate = fp.curry(populate$1.traverse);
 const objectPopulateToPaths = (input) => {
   const paths = [];
   function traverse(currentObj, parentPath) {
@@ -25059,31 +25059,42 @@ async function _populateComponent({
   mainUid,
   mainDocumentId,
   schema: schema2,
-  populate: populate2,
-  lookup
+  populate: populate2 = {},
+  lookup,
+  inDynamicZone = false,
+  omitEmpty
 }) {
-  const nestedPopulate = await _populate({ mainUid, mainDocumentId, schema: schema2, populate: populate2, lookup });
-  return { populate: nestedPopulate ? nestedPopulate : "*" };
+  const attrName = lookup.pop();
+  const componentLookup = lookup.length === 0 ? [attrName] : [...lookup, inDynamicZone ? "on" : "populate", attrName];
+  const componentPopulate = klona(populate2);
+  dset(componentPopulate, componentLookup, { populate: "*" });
+  const nestedPopulate = await _populate({
+    mainUid,
+    mainDocumentId,
+    schema: schema2,
+    populate: componentPopulate,
+    lookup: componentLookup,
+    omitEmpty
+  });
+  return isEmpty(nestedPopulate) ? true : { populate: nestedPopulate };
 }
 async function _populateDynamicZone({
   mainUid,
   mainDocumentId,
   components,
   populate: populate2,
-  lookup
+  lookup,
+  omitEmpty
 }) {
-  const dzLookup = [...lookup, "on"];
-  const dzPopulate = klona(populate2);
-  dset(dzPopulate, dzLookup, {});
   const resolvedPopulate = await components.reduce(async (prev, cur) => {
-    const componentPopulate = klona(dzPopulate);
-    delve(componentPopulate, dzLookup)[cur] = { populate: "*" };
     const curPopulate = await _populateComponent({
       mainUid,
       mainDocumentId,
       schema: cur,
-      populate: componentPopulate,
-      lookup: [...dzLookup, cur]
+      populate: populate2,
+      lookup: [...lookup, cur],
+      inDynamicZone: true,
+      omitEmpty
     });
     const newPop = await prev;
     dset(newPop, [cur], curPopulate);
@@ -25093,12 +25104,13 @@ async function _populateDynamicZone({
   return { on: resolvedPopulate };
 }
 function _populateMedia() {
-  return { populate: "*" };
+  return true;
 }
 async function _populateRelation({
   contentType,
   relation,
-  resolvedRelations
+  resolvedRelations,
+  omitEmpty
 }) {
   const isSingleRelation = !Array.isArray(relation);
   const relations = isSingleRelation ? [relation] : relation;
@@ -25108,7 +25120,8 @@ async function _populateRelation({
       mainUid: contentType,
       mainDocumentId: relation2.documentId,
       schema: contentType,
-      resolvedRelations
+      resolvedRelations,
+      omitEmpty
     });
     resolvedRelations.set(relation2.documentId, relationPopulate);
   }
@@ -25117,15 +25130,34 @@ async function _populateRelation({
     const relationPopulate = resolvedRelations.get(documentId);
     Object.keys(relationPopulate).map((r) => dset(newPopulate, r, relationPopulate[r]));
   }
-  return { populate: newPopulate };
+  return isEmpty(newPopulate) ? true : { populate: newPopulate };
 }
+const _resolveValue = ({ document: document2, lookup, attrName }) => {
+  if (lookup.find((l) => l === "on")) {
+    const attrLookup = lookup.filter((l) => l !== "on");
+    const parentAttr = attrLookup.pop();
+    const parentValue2 = (delve(document2, attrLookup) ?? []).filter((b) => b.__component === parentAttr) ?? [];
+    return (Array.isArray(parentValue2) ? parentValue2 : [parentValue2]).find((v) => hasValue(v[attrName]))?.[attrName];
+  }
+  if (lookup.find((l) => l === "populate")) {
+    const attrLookup = lookup.filter((l) => l !== "populate");
+    const parentValue2 = delve(document2, attrLookup) ?? [];
+    return (Array.isArray(parentValue2) ? parentValue2 : [parentValue2]).find((v) => hasValue(v[attrName]))?.[attrName];
+  }
+  const parentValue = delve(document2, lookup);
+  if (Array.isArray(parentValue)) {
+    return parentValue.map((v) => v[attrName]);
+  }
+  return parentValue?.[attrName];
+};
 async function _populate({
   mainUid,
   mainDocumentId,
   schema: schema2,
   populate: populate2 = {},
   lookup = [],
-  resolvedRelations = /* @__PURE__ */ new Map()
+  resolvedRelations = /* @__PURE__ */ new Map(),
+  omitEmpty = true
 }) {
   const newPopulate = {};
   const model = strapi.getModel(schema2);
@@ -25146,10 +25178,9 @@ async function _populate({
     populate: currentPopulate ? currentPopulate : "*"
   });
   for (const [attrName, attr] of relations) {
-    const attrLookup = [...lookup, attrName];
-    const value = delve(document2, attrLookup);
+    const value = _resolveValue({ document: document2, attrName, lookup });
     if (!hasValue(value)) {
-      newPopulate[attrName] = true;
+      if (!omitEmpty) newPopulate[attrName] = true;
       continue;
     }
     if (contentTypes.isDynamicZoneAttribute(attr)) {
@@ -25160,8 +25191,8 @@ async function _populate({
         mainUid,
         mainDocumentId,
         components: relComponents,
-        populate: newPopulate,
-        lookup: [...lookup, attrName]
+        lookup: [...lookup, attrName],
+        omitEmpty
       });
     }
     if (contentTypes.isRelationalAttribute(attr)) {
@@ -25169,7 +25200,8 @@ async function _populate({
       newPopulate[attrName] = await _populateRelation({
         contentType: relContentType,
         relation: value,
-        resolvedRelations
+        resolvedRelations,
+        omitEmpty
       });
     }
     if (contentTypes.isComponentAttribute(attr) && !contentTypes.isDynamicZoneAttribute(attr)) {
@@ -25177,26 +25209,35 @@ async function _populate({
         mainUid,
         mainDocumentId,
         schema: attr.component,
-        populate: newPopulate,
-        lookup: [...lookup, attrName]
+        lookup: [...lookup, attrName],
+        omitEmpty
       });
     }
     if (contentTypes.isMediaAttribute(attr)) {
       newPopulate[attrName] = _populateMedia();
     }
   }
-  return isEmpty(newPopulate) ? "*" : newPopulate;
+  return newPopulate;
 }
-const deepPopulateService = ({ strapi: strapi2 }) => ({
-  async getPopulate({ contentType, documentId }) {
-    return await _populate({ mainUid: contentType, mainDocumentId: documentId, schema: contentType });
+const populate = ({ strapi: strapi2 }) => ({
+  async get({
+    contentType,
+    documentId,
+    omitEmpty = false
+  }) {
+    return await _populate({ mainUid: contentType, mainDocumentId: documentId, schema: contentType, omitEmpty });
   },
   documents(contentType) {
     strapi2.documents(contentType);
     const { findOne, ...wrapped } = strapi2.documents(contentType);
     const wrappedFindOne = async (params) => {
       const { documentId, populate: originalPopulate } = params;
-      const deepPopulate = await _populate({ mainUid: contentType, mainDocumentId: documentId, schema: contentType });
+      const deepPopulate = await _populate({
+        mainUid: contentType,
+        mainDocumentId: documentId,
+        schema: contentType,
+        omitEmpty: originalPopulate !== "*"
+      });
       if (originalPopulate && originalPopulate !== "*") {
         strapi2.log.warn(
           `passed "populate" will be merged with deepPopulate, which could result in unexpected behavior.`
@@ -25211,7 +25252,7 @@ const deepPopulateService = ({ strapi: strapi2 }) => ({
   }
 });
 const services = {
-  populate: deepPopulateService
+  populate
 };
 const index = {
   services

package/dist/server/src/index.d.ts

@@ -3,9 +3,10 @@ declare const _default: {
         populate: ({ strapi }: {
             strapi: import("@strapi/types/dist/core").Strapi;
         }) => {
-            getPopulate({ contentType, documentId }: {
+            get({ contentType, documentId, omitEmpty, }: {
                 contentType: import("@strapi/types/dist/uid").ContentType;
                 documentId: string;
+                omitEmpty?: boolean;
             }): Promise<{}>;
             documents(contentType: import("@strapi/types/dist/uid").ContentType): {
                 findMany<const TParams extends import("@strapi/types/dist/modules/documents/params/document-engine").FindMany<import("@strapi/types/dist/uid").ContentType>>(params?: TParams): import("@strapi/types/dist/modules/documents/result/document-engine").FindMany<import("@strapi/types/dist/uid").ContentType, TParams>;

package/dist/server/src/services/deep-populate/index.d.ts

@@ -1,3 +1,3 @@
 import type { UID } from "@strapi/strapi";
 import type { PopulateProps } from "./types";
-export default function _populate<TContentType extends UID.ContentType, TSchema extends UID.Schema>({ mainUid, mainDocumentId, schema, populate, lookup, resolvedRelations, }: PopulateProps<TContentType, TSchema>): Promise<{}>;
+export default function _populate<TContentType extends UID.ContentType, TSchema extends UID.Schema>({ mainUid, mainDocumentId, schema, populate, lookup, resolvedRelations, omitEmpty, }: PopulateProps<TContentType, TSchema>): Promise<{}>;

package/dist/server/src/services/index.d.ts

@@ -2,9 +2,10 @@ declare const _default: {
     populate: ({ strapi }: {
         strapi: import("@strapi/types/dist/core").Strapi;
     }) => {
-        getPopulate({ contentType, documentId }: {
+        get({ contentType, documentId, omitEmpty, }: {
             contentType: import("@strapi/types/dist/uid").ContentType;
             documentId: string;
+            omitEmpty?: boolean;
         }): Promise<{}>;
         documents(contentType: import("@strapi/types/dist/uid").ContentType): {
             findMany<const TParams extends import("@strapi/types/dist/modules/documents/params/document-engine").FindMany<import("@strapi/types/dist/uid").ContentType>>(params?: TParams): import("@strapi/types/dist/modules/documents/result/document-engine").FindMany<import("@strapi/types/dist/uid").ContentType, TParams>;

package/dist/server/src/services/populate.d.ts

@@ -1,10 +1,11 @@
 import type { Core, UID } from "@strapi/strapi";
-declare const deepPopulateService: ({ strapi }: {
+declare const _default: ({ strapi }: {
     strapi: Core.Strapi;
 }) => {
-    getPopulate({ contentType, documentId }: {
+    get({ contentType, documentId, omitEmpty, }: {
         contentType: UID.ContentType;
         documentId: string;
+        omitEmpty?: boolean;
     }): Promise<{}>;
     documents(contentType: UID.ContentType): {
         findMany<const TParams extends import("@strapi/types/dist/modules/documents/params/document-engine").FindMany<UID.ContentType>>(params?: TParams): import("@strapi/types/dist/modules/documents/result/document-engine").FindMany<UID.ContentType, TParams>;
@@ -17,4 +18,4 @@ declare const deepPopulateService: ({ strapi }: {
         clone<const TParams_7 extends import("@strapi/types/dist/modules/documents/params/document-engine").Clone<UID.ContentType>>(params: TParams_7): import("@strapi/types/dist/modules/documents/result/document-engine").Clone<UID.ContentType, TParams_7>;
     } & import("@strapi/types/dist/modules/documents").DraftAndPublishExtension<UID.ContentType> & import("@strapi/types/dist/modules/documents/component-extension").ComponentExtension<UID.ContentType>;
 };
-export default deepPopulateService;
+export default _default;

package/package.json

@@ -1,6 +1,11 @@
 {
-  "version": "1.0.0-beta.0",
-  "keywords": [],
+  "version": "1.0.1",
+  "keywords": [
+    "strapi",
+    "strapi-plugin",
+    "populate",
+    "strapi-v5"
+  ],
   "type": "commonjs",
   "exports": {
     "./package.json": "./package.json",
@@ -25,7 +30,7 @@
     "test:integration": "jest --verbose --forceExit --detectOpenHandles",
     "ci": "biome ci server",
     "release": "release-it",
-    "playground:install": "$npm_execpath run playground:yalc-add && cd playground && $npm_execpath install",
+    "playground:install": "$npm_execpath run playground:yalc-add && cd playground && $npm_execpath install --loglevel error",
     "playground:yalc-add": "cd playground && yalc add @fourlights/strapi-plugin-deep-populate",
     "playground:yalc-add-link": "cd playground && yalc add --link @fourlights/strapi-plugin-deep-populate"
   },
@@ -36,7 +41,6 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
-    "@release-it/conventional-changelog": "^10.0.0",
     "@strapi/sdk-plugin": "^5.3.0",
     "@strapi/strapi": "^5.8.0",
     "@strapi/typescript-utils": "^5.8.0",
@@ -53,8 +57,8 @@
     "yalc": "^1.0.0-pre.53"
   },
   "peerDependencies": {
-    "@strapi/sdk-plugin": "^5.3.0",
-    "@strapi/strapi": "^5.8.0"
+    "@strapi/sdk-plugin": "^5",
+    "@strapi/strapi": "^5"
   },
   "strapi": {
     "kind": "plugin",