Add Revealing Module (ES5 + ES6 + CoffeeScript + TypeScript)

Author: Badacadabra

misc/RevealingModule/CoffeeScript/index.coffee

@@ -0,0 +1,24 @@
+'use strict'
+
+me = do -> 
+    # Public variables 
+    firstName = "Baptiste"
+    lastName = "Vannesson"
+
+    # Private variable 
+    secretNickname = "Bada"
+
+    # Public functions
+    sayHello = -> "Hello, #{firstName} #{lastName}!"
+    getSecretNickname = -> secretNickname
+
+    # Revealed module
+    firstName: firstName
+    lastName: lastName
+    sayHello: sayHello
+    getSecretNickname: getSecretNickname
+
+console.log me.firstName, me.lastName # OK 
+console.log me.sayHello() # OK
+console.log me.secretNickname # Oops! Undefined!
+console.log me.getSecretNickname() # OK

misc/RevealingModule/ECMAScript/ES5/index.js

@@ -0,0 +1,32 @@
+'use strict';
+
+var me = (function () {
+    // Public variables 
+    var firstName = "Baptiste",
+        lastName = "Vannesson";
+
+    // Private variable 
+    var secretNickname = "Bada";
+
+    // Public functions
+    function sayHello() {
+        return "Hello, " + firstName + " " + lastName + "!"; 
+    }
+
+    function getSecretNickname() {
+        return secretNickname; 
+    }
+
+    // Revealed module
+    return {
+        firstName: firstName,
+        lastName: lastName,
+        sayHello: sayHello,
+        getSecretNickname: getSecretNickname,
+    };
+})(); 
+
+console.log(me.firstName, me.lastName); // OK 
+console.log(me.sayHello()); // OK
+console.log(me.secretNickname); // Oops! Undefined!
+console.log(me.getSecretNickname()); // OK

misc/RevealingModule/ECMAScript/ES6/index.js

@@ -0,0 +1,20 @@
+const me = (() => {
+    // Public variables 
+    const firstName = "Baptiste",
+          lastName = "Vannesson";
+
+    // Private variable 
+    const secretNickname = "Bada";
+
+    // Public functions
+    const sayHello = () => `Hello, ${firstName} ${lastName}!`; 
+    const getSecretNickname = () => secretNickname;
+
+    // Revealed module
+    return { firstName, lastName, sayHello, getSecretNickname };
+})();
+
+console.log(me.firstName, me.lastName); // OK 
+console.log(me.sayHello()); // OK
+console.log(me.secretNickname); // Oops! Undefined!
+console.log(me.getSecretNickname()); // OK

misc/RevealingModule/README.md

@@ -0,0 +1,19 @@
+# Problem
+
+JavaScript is not very strict when it comes to encapsulation and each script tends to pollute the global namespace. This is because the language has been built with global variables in mind.
+
+# Solution
+
+The Revealing Module pattern is a great solution to encapsulate some code. The idea is to store in a variable the returned expression of an IIFE (Immediately-Invoked Function Expression), which is generally an object literal that exposes all public members of the module. Within the IIFE, the scope is private. We can then declare private variables and functions that will be invisible from the outside. Conceptually, a module is a bit like a class. 
+
+N.B. In practice, this pattern is not often used anymore. CommonJS, AMD, or built-in ES6 modules are much better solutions nowadays... However, the legacy of this pattern is still visible in ES5 code, especially in CommonJS modules where module.exports exposes public members using an object literal.
+
+```javascript
+// CommonJS (Revealing) Module exports
+module.exports = {
+    firstName: firstName,
+    lastName: lastName,
+    sayHello: sayHello,
+    getSecretNickname: getSecretNickname
+};
+```

misc/RevealingModule/TypeScript/index.ts

@@ -0,0 +1,22 @@
+namespace person {
+    // Public variables 
+    const firstName: string = "Baptiste",
+          lastName: string = "Vannesson";
+
+    // Private variable 
+    const secretNickname: string = "Bada";
+
+    // Public functions
+    const sayHello = (): string => `Hello, ${firstName} ${lastName}!`; 
+    const getSecretNickname = (): string => secretNickname;
+
+    // Revealed module
+    export const me = { firstName, lastName, sayHello, getSecretNickname };
+}
+
+import me = person.me;
+
+console.log(me.firstName, me.lastName); // OK 
+console.log(me.sayHello()); // OK
+// console.log(me.secretNickname); Oops! Undefined!
+console.log(me.getSecretNickname()); // OK