PluginAPI for more stable backwards compatibility going forward

app/assets/javascripts/discourse/initializers/post-decorations.js.es6

@@ -1,11 +1,13 @@
-import { decorateCooked } from 'discourse/lib/plugin-api';
 import highlightSyntax from 'discourse/lib/highlight-syntax';
 import lightbox from 'discourse/lib/lightbox';
+import { getPluginApi } from 'discourse/lib/plugin-api';
 
 export default {
   name: "post-decorations",
-  initialize: function(container) {
+  initialize() {
-    decorateCooked(container, highlightSyntax);
+    const api = getPluginApi('0.1');
-    decorateCooked(container, lightbox);
+
+    api.decorateCooked(highlightSyntax);
+    api.decorateCooked(lightbox);
   }
 };

app/assets/javascripts/discourse/lib/plugin-api.js.es6

@@ -8,8 +8,31 @@ function decorate(klass, evt, cb) {
   klass.reopen(mixin);
 }
 
-export function decorateCooked(container, cb) {
+export function decorateCooked() {
-  addDecorator(cb);
+  console.warn('`decorateCooked` has been removed. Use `getPluginApi(version).decorateCooked` instead');
-  decorate(ComposerEditor, 'previewRefreshed', cb);
-  decorate(container.lookupFactory('view:user-stream'), 'didInsertElement', cb);
 }
+
+class PluginApi {
+  constructor(version, container) {
+    this.version = version;
+    this.container = container;
+  }
+
+  decorateCooked(cb) {
+    addDecorator(cb);
+    decorate(ComposerEditor, 'previewRefreshed', cb);
+    decorate(this.container.lookupFactory('view:user-stream'), 'didInsertElement', cb);
+  }
+}
+
+let _pluginv01;
+
+export function getPluginApi(version) {
+  if (version === "0.1") {
+    if (!_pluginv01) {
+      _pluginv01 = new PluginApi(version, Discourse.__container__);
+    }
+    return _pluginv01;
+  }
+}
+

plugins/discourse-details/assets/javascripts/initializers/apply-details.js.es6

@@ -1,10 +1,11 @@
-import { decorateCooked } from "discourse/lib/plugin-api";
+import { getPluginApi } from 'discourse/lib/plugin-api';
 
 export default {
   name: "apply-details",
 
-  initialize(container) {
+  initialize() {
-    decorateCooked(container, $elem => $("details", $elem).details());
+    const api = getPluginApi('0.1');
+    api.decorateCooked($elem => $("details", $elem).details());
   }
 
 };

plugins/lazyYT/assets/javascripts/initializers/lazyYT.js.es6

@@ -1,13 +1,9 @@
-/**
+import { getPluginApi } from 'discourse/lib/plugin-api';
-  Apply lazyYT when the app boots
-**/
-import { decorateCooked } from 'discourse/lib/plugin-api';
 
 export default {
   name: "apply-lazyYT",
-  initialize: function(container) {
+  initialize() {
-    decorateCooked(container, function($elem) {
+    const api = getPluginApi('0.1');
-      $('.lazyYT', $elem).lazyYT();
+    api.decorateCooked($elem => $('.lazyYT', $elem).lazyYT());
-    });
   }
 };