promoting helpers namespace to Beta.

.istanbul.yml

@@ -2,7 +2,7 @@ verbose: false
 instrumentation:
     root: .
     default-excludes: true
-    excludes: ['**/helpers/**', 'column.js', 'array.js']
+    excludes: ['**/helpers/**']
     embed-source: false
     variable: __coverage__
     compact: true

lib/errors/index.js

@@ -4,8 +4,7 @@ var $npm = {
     qResult: require('./queryResult'),
     qFile: require('./queryFile'),
     prepared: require('./prepared'),
-    paramQuery: require('./paramQuery'),
-    column: require('./column')
+    paramQuery: require('./paramQuery')
 };
 
 /**
@@ -38,17 +37,12 @@ var $npm = {
  *
  */
 
-// To add when ready:
-// * @property {errors.ColumnError} ColumnError
-// * Represents an error in parsing a column information by class {@link Columns}.
-
 module.exports = {
     QueryResultError: $npm.qResult.QueryResultError,
     queryResultErrorCode: $npm.qResult.queryResultErrorCode,
     PreparedStatementError: $npm.prepared,
     ParameterizedQueryError: $npm.paramQuery,
-    QueryFileError: $npm.qFile,
-    ColumnError: $npm.column
+    QueryFileError: $npm.qFile
 };
 
 Object.freeze(module.exports);

lib/helpers/README.md

@@ -1,7 +1,7 @@
 ### Query Formatting Helpers
 
-Everything in this folder is currently in its Alpha version. Use it at your own risk.
+Everything in this folder is currently a Beta version.
 
-See [helpers] namespace.
+For details see [helpers namespace].
 
-[helpers]:http://vitaly-t.github.io/pg-promise/helpers.html
+[helpers namespace]:http://vitaly-t.github.io/pg-promise/helpers.html

lib/helpers/column.js

@@ -11,7 +11,7 @@ var $npm = {
  * @class helpers.Column
  * @description
  *
- * ** WARNING: Everything within the {@link helpers} namespace is currently in its Alpha version.**
+ * ** WARNING: Everything within the {@link helpers} namespace is currently a Beta version.**
  *
  * Read-only structure that represents formatting details for a single column.
  *

lib/helpers/columnSet.js

@@ -1,7 +1,5 @@
 'use strict';
 
-require('../array');
-
 var $npm = {
     os: require('os'),
     utils: require('../utils'),
@@ -14,7 +12,7 @@ var $npm = {
  * @class helpers.ColumnSet
  * @description
  *
- * ** WARNING: Everything within the {@link helpers} namespace is currently in its Alpha version.**
+ * ** WARNING: Everything within the {@link helpers} namespace is currently a Beta version.**
  *
  * Performance-optimized, read-only structure about all query-formatting columns.
  *

lib/helpers/index.js

@@ -12,7 +12,7 @@ var $npm = {
  * @namespace helpers
  * @description
  *
- * ** WARNING: Everything within the {@link helpers} namespace is currently in its Alpha version.**
+ * ** WARNING: Everything within the {@link helpers} namespace is currently a Beta version.**
  *
  * Namespace for automated query formatting helpers, available as `pgp.helpers` after initializing the library.
  *

lib/helpers/tableName.js

@@ -8,6 +8,9 @@ var $npm = {
 /**
  * @class helpers.TableName
  * @description
+ * 
+ * ** WARNING: Everything within the {@link helpers} namespace is currently a Beta version.**
+ * 
  * **Alternative Syntax:** `TableName({table, [schema]})` ⇒ {@link helpers.TableName}
  *
  * Prepares and escapes a full table name that can be injected into queries directly.

lib/index.js

@@ -3,6 +3,7 @@
 var $npm = {
     pg: require('pg'),
     minify: require('pg-minify'),
+    array: require('./array'),
     adapter: require('./adapter'),
     result: require('./result'),
     promise: require('./promise'),

lib/types/parameterized.js

@@ -1,7 +1,5 @@
 'use strict';
 
-require('../array');
-
 var $npm = {
     os: require('os'),
     utils: require('../utils'),

lib/types/prepared.js

@@ -1,7 +1,5 @@
 'use strict';
 
-require('../array');
-
 var $npm = {
     os: require('os'),
     utils: require('../utils'),

package.json

@@ -1,6 +1,6 @@
 {
   "name": "pg-promise",
-  "version": "4.0.13",
+  "version": "4.0.14",
   "description": "PostgreSQL via promises",
   "main": "lib/index.js",
   "scripts": {

test/arraySpec.js

@@ -0,0 +1,138 @@
+'use strict';
+
+require('../lib/array');
+
+var data = [1, 2, 3];
+
+describe("map", function () {
+
+    describe("with context", function () {
+        var ctx, indexes = [];
+        var res = data.$map(function (d, idx) {
+            ctx = this;
+            indexes.push(idx);
+            return d * 2;
+        }, data);
+        it("must iterate correctly", function () {
+            expect(ctx).toBe(data);
+            expect(res).toEqual([2, 4, 6]);
+            expect(indexes).toEqual([0, 1, 2]);
+        });
+    });
+
+    describe("without context", function () {
+        var ctx, indexes = [];
+        var res = data.$map(function (d, idx) {
+            ctx = ctx || this;
+            indexes.push(idx);
+            return d * 2;
+        });
+        it("must iterate correctly", function () {
+            expect(ctx).toBeUndefined();
+            expect(res).toEqual([2, 4, 6]);
+            expect(indexes).toEqual([0, 1, 2]);
+        });
+    });
+
+});
+
+describe("filter", function () {
+
+    describe("with context", function () {
+        var ctx, indexes = [];
+        var res = data.$filter(function (d, idx) {
+            ctx = this;
+            indexes.push(idx);
+            return d != 2;
+        }, data);
+        it("must iterate correctly", function () {
+            expect(ctx).toBe(data);
+            expect(res).toEqual([1, 3]);
+            expect(indexes).toEqual([0, 1, 2]);
+        });
+    });
+
+    describe("without context", function () {
+        var ctx, indexes = [];
+        var res = data.$filter(function (d, idx) {
+            ctx = ctx || this;
+            indexes.push(idx);
+            return d != 2;
+        });
+        it("must iterate correctly", function () {
+            expect(ctx).toBeUndefined();
+            expect(res).toEqual([1, 3]);
+            expect(indexes).toEqual([0, 1, 2]);
+        });
+    });
+
+});
+
+describe("forEach", function () {
+
+    describe("with context", function () {
+        var ctx, values = [], indexes = [];
+        data.$forEach(function (d, idx) {
+            ctx = this;
+            values.push(d);
+            indexes.push(idx);
+        }, data);
+        it("must iterate correctly", function () {
+            expect(ctx).toBe(data);
+            expect(values).toEqual([1, 2, 3]);
+            expect(indexes).toEqual([0, 1, 2]);
+        });
+    });
+
+    describe("without context", function () {
+        var ctx, values = [], indexes = [];
+        data.$filter(function (d, idx) {
+            ctx = ctx || this;
+            values.push(d);
+            indexes.push(idx);
+            return d != 2;
+        });
+        it("must iterate correctly", function () {
+            expect(ctx).toBeUndefined();
+            expect(values).toEqual([1, 2, 3]);
+            expect(indexes).toEqual([0, 1, 2]);
+        });
+    });
+
+});
+
+describe("countIf", function () {
+
+    describe("with context", function () {
+        var ctx, values = [], indexes = [];
+        var res = data.$countIf(function (d, idx) {
+            ctx = this;
+            values.push(d);
+            indexes.push(idx);
+            return d != 2;
+        }, data);
+        it("must iterate correctly", function () {
+            expect(res).toBe(2);
+            expect(ctx).toBe(data);
+            expect(values).toEqual([1, 2, 3]);
+            expect(indexes).toEqual([0, 1, 2]);
+        });
+    });
+
+    describe("without context", function () {
+        var ctx, values = [], indexes = [];
+        var res = data.$countIf(function (d, idx) {
+            ctx = ctx || this;
+            values.push(d);
+            indexes.push(idx);
+            return d != 2;
+        });
+        it("must iterate correctly", function () {
+            expect(ctx).toBeUndefined();
+            expect(res).toBe(2);
+            expect(values).toEqual([1, 2, 3]);
+            expect(indexes).toEqual([0, 1, 2]);
+        });
+    });
+
+});