Misc compatibility fixes (fixes string_decoder)

Author: blakeembrey

0.10/node.d.ts

@@ -5,10 +5,81 @@
 
 /************************************************
 *                                               *
-*               Node.js v0.10.1 API             *
+*               Node.js v0.10.x API             *
 *                                               *
 ************************************************/
 
+interface NodeError {
+  /**
+   * Returns a string describing the point in the code at which the Error was instantiated.
+   *
+   * For example:
+   *
+   * ```
+   * Error: Things keep happening!
+   *    at /home/gbusey/file.js:525:2
+   *    at Frobnicator.refrobulate (/home/gbusey/business-logic.js:424:21)
+   *    at Actor.<anonymous> (/home/gbusey/actors.js:400:8)
+   *    at increaseSynergy (/home/gbusey/actors.js:701:6)
+   * ```
+   *
+   * The first line is formatted as <error class name>: <error message>, and is followed by a series of stack frames (each line beginning with "at "). Each frame describes a call site within the code that lead to the error being generated. V8 attempts to display a name for each function (by variable name, function name, or object method name), but occasionally it will not be able to find a suitable name. If V8 cannot determine a name for the function, only location information will be displayed for that frame. Otherwise, the determined function name will be displayed with location information appended in parentheses.
+   */
+  stack?: string;
+
+  /**
+   * Returns the string description of error as set by calling new Error(message). The message passed to the constructor will also appear in the first line of the stack trace of the Error, however changing this property after the Error object is created may not change the first line of the stack trace.
+   *
+   * ```
+   * const err = new Error('The message');
+   * console.log(err.message);
+   * // Prints: The message
+   * ```
+   */
+  message: string;
+}
+
+interface Error extends NodeError { }
+
+interface ErrorConstructor {
+  /**
+   * Creates a `.stack` property on `targetObject`, which when accessed returns a string representing the location in the code at which `Error.captureStackTrace()`` was called.
+   *
+   * ```js
+   * const myObject = {};
+   * Error.captureStackTrace(myObject);
+   * myObject.stack  // similar to `new Error().stack`
+   * ```
+   *
+   * The first line of the trace, instead of being prefixed with `ErrorType : message`, will be the result of calling `targetObject.toString()``.
+   *
+   * The optional constructorOpt argument accepts a function. If given, all frames above constructorOpt, including constructorOpt, will be omitted from the generated stack trace.
+   *
+   * The constructorOpt argument is useful for hiding implementation details of error generation from an end user. For instance:
+   *
+   * ```js
+   * function MyError() {
+   *   Error.captureStackTrace(this, MyError);
+   * }
+   *
+   * // Without passing MyError to captureStackTrace, the MyError
+   * // frame would should up in the .stack property. by passing
+   * // the constructor, we omit that frame and all frames above it.
+   * new MyError().stack
+   * ```
+   */
+  captureStackTrace<T extends { stack?: string }>(targetObject: T, constructorOpt?: new () => T): void;
+
+  /**
+   * The Error.stackTraceLimit property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj))``.
+   *
+   * The default value is 10 but may be set to any valid JavaScript number. Changes will affect any stack trace captured after the value has been changed.
+   *
+   * If set to a non-number value, or set to a negative number, stack traces will not capture any frames.
+   */
+  stackTraceLimit: number;
+}
+
 /************************************************
 *                                               *
 *                   GLOBAL                      *
@@ -232,6 +303,7 @@ declare namespace NodeJS {
       ares: string;
       uv: string;
       zlib: string;
+      modules: string;
       openssl: string;
     };
     config: {
@@ -1035,6 +1107,7 @@ declare module "fs" {
     bytesRead: number;
     path: string;
     close(): void;
+    destroy(): void;
   }
 
   export class WriteStream extends stream.Writable implements
@@ -1582,13 +1655,22 @@ declare module "path" {
 }
 
 declare module "string_decoder" {
-  export interface NodeStringDecoder {
+  import * as buffer from "buffer";
+
+  export class StringDecoder {
+    /**
+     * @param encoding The character encoding the `StringDecoder` will use. Defaults to `'utf8'`.
+     */
+    constructor(encoding?: buffer.Encoding);
+    /**
+     * Returns a decoded string.
+     */
     write(buffer: Buffer): string;
-    detectIncompleteChar(buffer: Buffer): number;
+    /**
+     * Returns any trailing bytes that were left in the buffer.
+     */
+    end(buffer?: Buffer): string;
   }
-  export var StringDecoder: {
-    new (encoding: string): NodeStringDecoder;
-  };
 }
 
 declare module "tls" {

0.12/node.d.ts

@@ -5,7 +5,7 @@
 
 /************************************************
 *                                               *
-*               Node.js v0.12.0 API             *
+*               Node.js v0.12.x API             *
 *                                               *
 ************************************************/
 
@@ -38,8 +38,48 @@ interface NodeError {
    */
   message: string;
 }
+
 interface Error extends NodeError { }
 
+interface ErrorConstructor {
+  /**
+   * Creates a `.stack` property on `targetObject`, which when accessed returns a string representing the location in the code at which `Error.captureStackTrace()`` was called.
+   *
+   * ```js
+   * const myObject = {};
+   * Error.captureStackTrace(myObject);
+   * myObject.stack  // similar to `new Error().stack`
+   * ```
+   *
+   * The first line of the trace, instead of being prefixed with `ErrorType : message`, will be the result of calling `targetObject.toString()``.
+   *
+   * The optional constructorOpt argument accepts a function. If given, all frames above constructorOpt, including constructorOpt, will be omitted from the generated stack trace.
+   *
+   * The constructorOpt argument is useful for hiding implementation details of error generation from an end user. For instance:
+   *
+   * ```js
+   * function MyError() {
+   *   Error.captureStackTrace(this, MyError);
+   * }
+   *
+   * // Without passing MyError to captureStackTrace, the MyError
+   * // frame would should up in the .stack property. by passing
+   * // the constructor, we omit that frame and all frames above it.
+   * new MyError().stack
+   * ```
+   */
+  captureStackTrace<T extends { stack?: string }>(targetObject: T, constructorOpt?: new () => T): void;
+
+  /**
+   * The Error.stackTraceLimit property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj))``.
+   *
+   * The default value is 10 but may be set to any valid JavaScript number. Changes will affect any stack trace captured after the value has been changed.
+   *
+   * If set to a non-number value, or set to a negative number, stack traces will not capture any frames.
+   */
+  stackTraceLimit: number;
+}
+
 // compat for TypeScript 1.5.3
 // if you use with --target es3 or --target es5 and use below definitions,
 // use the lib.es6.d.ts that is bundled with TypeScript 1.5.3.
@@ -335,6 +375,7 @@ declare namespace NodeJS {
       ares: string;
       uv: string;
       zlib: string;
+      modules: string;
       openssl: string;
     };
     config: {
@@ -1325,6 +1366,7 @@ declare module "fs" {
     bytesRead: number;
     path: string;
     close(): void;
+    destroy(): void;
   }
 
   export class WriteStream extends stream.Writable implements
@@ -2021,13 +2063,22 @@ declare module "path" {
 }
 
 declare module "string_decoder" {
-  export interface NodeStringDecoder {
+  import * as buffer from "buffer";
+
+  export class StringDecoder {
+    /**
+     * @param encoding The character encoding the `StringDecoder` will use. Defaults to `'utf8'`.
+     */
+    constructor(encoding?: buffer.Encoding);
+    /**
+     * Returns a decoded string.
+     */
     write(buffer: Buffer): string;
-    detectIncompleteChar(buffer: Buffer): number;
+    /**
+     * Returns any trailing bytes that were left in the buffer.
+     */
+    end(buffer?: Buffer): string;
   }
-  export var StringDecoder: {
-    new (encoding: string): NodeStringDecoder;
-  };
 }
 
 declare module "tls" {

4.0/node.d.ts

@@ -38,6 +38,7 @@ interface NodeError {
    */
   message: string;
 }
+
 interface Error extends NodeError { }
 
 interface ErrorConstructor {
@@ -513,6 +514,7 @@ declare namespace NodeJS {
       ares: string;
       uv: string;
       zlib: string;
+      modules: string;
       openssl: string;
     };
     config: {
@@ -1570,6 +1572,7 @@ declare module "fs" {
     bytesRead: number;
     path: string;
     close(): void;
+    destroy(): void;
   }
 
   export class WriteStream extends stream.Writable implements
@@ -2272,13 +2275,22 @@ declare module "path" {
 }
 
 declare module "string_decoder" {
-  export interface NodeStringDecoder {
+  import * as buffer from "buffer";
+
+  export class StringDecoder {
+    /**
+     * @param encoding The character encoding the `StringDecoder` will use. Defaults to `'utf8'`.
+     */
+    constructor(encoding?: buffer.Encoding);
+    /**
+     * Returns a decoded string.
+     */
     write(buffer: Buffer): string;
-    detectIncompleteChar(buffer: Buffer): number;
+    /**
+     * Returns any trailing bytes that were left in the buffer.
+     */
+    end(buffer?: Buffer): string;
   }
-  export var StringDecoder: {
-    new (encoding: string): NodeStringDecoder;
-  };
 }
 
 declare module "tls" {