/// <reference path="google-apps-script.types.d.ts" />
/// <reference path="google-apps-script.base.d.ts" />

declare namespace GoogleAppsScript {
    namespace Utilities {
        /**
         * A typesafe enum for character sets.
         */
        enum Charset {
            US_ASCII,
            UTF_8,
        }
        /**
         * Selector of Digest algorithm.
         */
        enum DigestAlgorithm {
            MD2,
            MD5,
            SHA_1,
            SHA_256,
            SHA_384,
            SHA_512,
        }
        /**
         * Selector of MAC algorithm
         */
        enum MacAlgorithm {
            HMAC_MD5,
            HMAC_SHA_1,
            HMAC_SHA_256,
            HMAC_SHA_384,
            HMAC_SHA_512,
        }
        /**
         * Selector of RSA algorithm
         */
        enum RsaAlgorithm {
            RSA_SHA_1,
            RSA_SHA_256,
        }
        /**
         * This service provides utilities for string encoding/decoding, date formatting, JSON manipulation,
         * and other miscellaneous tasks.
         */
        interface Utilities {
            Charset: typeof Charset;
            DigestAlgorithm: typeof DigestAlgorithm;
            MacAlgorithm: typeof MacAlgorithm;
            RsaAlgorithm: typeof RsaAlgorithm;
            base64Decode(encoded: string): Byte[];
            base64Decode(encoded: string, charset: Charset): Byte[];
            base64DecodeWebSafe(encoded: string): Byte[];
            base64DecodeWebSafe(encoded: string, charset: Charset): Byte[];
            base64Encode(data: Byte[]): string;
            base64Encode(data: string): string;
            base64Encode(data: string, charset: Charset): string;
            base64EncodeWebSafe(data: Byte[]): string;
            base64EncodeWebSafe(data: string): string;
            base64EncodeWebSafe(data: string, charset: Charset): string;
            computeDigest(algorithm: DigestAlgorithm, value: Byte[]): Byte[];
            computeDigest(algorithm: DigestAlgorithm, value: string): Byte[];
            computeDigest(algorithm: DigestAlgorithm, value: string, charset: Charset): Byte[];
            computeHmacSha256Signature(value: Byte[], key: Byte[]): Byte[];
            computeHmacSha256Signature(value: string, key: string): Byte[];
            computeHmacSha256Signature(value: string, key: string, charset: Charset): Byte[];
            computeHmacSignature(algorithm: MacAlgorithm, value: Byte[], key: Byte[]): Byte[];
            computeHmacSignature(algorithm: MacAlgorithm, value: string, key: string): Byte[];
            computeHmacSignature(algorithm: MacAlgorithm, value: string, key: string, charset: Charset): Byte[];
            computeRsaSha1Signature(value: string, key: string): Byte[];
            computeRsaSha1Signature(value: string, key: string, charset: Charset): Byte[];
            computeRsaSha256Signature(value: string, key: string): Byte[];
            computeRsaSha256Signature(value: string, key: string, charset: Charset): Byte[];
            computeRsaSignature(algorithm: RsaAlgorithm, value: string, key: string): Byte[];
            computeRsaSignature(algorithm: RsaAlgorithm, value: string, key: string, charset: Charset): Byte[];
            formatDate(date: Base.Date, timeZone: string, format: string): string;
            formatString(template: string, ...args: any[]): string;
            getUuid(): string;
            gzip(blob: Base.BlobSource): Base.Blob;
            gzip(blob: Base.BlobSource, name: string): Base.Blob;
            newBlob(data: Byte[]): Base.Blob;
            newBlob(data: Byte[], contentType: string): Base.Blob;
            newBlob(data: Byte[], contentType: string, name: string): Base.Blob;
            newBlob(data: string): Base.Blob;
            newBlob(data: string, contentType: string): Base.Blob;
            newBlob(data: string, contentType: string, name: string): Base.Blob;
            parseCsv(csv: string): string[][];
            parseCsv(csv: string, delimiter: Char): string[][];
            parseDate(date: string, timeZone: string, format: string): Date;
            sleep(milliseconds: Integer): void;
            ungzip(blob: Base.BlobSource): Base.Blob;
            unzip(blob: Base.BlobSource): Base.Blob[];
            zip(blobs: Base.BlobSource[]): Base.Blob;
            zip(blobs: Base.BlobSource[], name: string): Base.Blob;
            /** @deprecated DO NOT USE */ jsonParse(jsonString: string): any;
            /** @deprecated DO NOT USE */ jsonStringify(obj: any): string;
        }
    }
}

declare var Charset: GoogleAppsScript.Utilities.Charset;
declare var DigestAlgorithm: GoogleAppsScript.Utilities.DigestAlgorithm;
declare var MacAlgorithm: GoogleAppsScript.Utilities.MacAlgorithm;
declare var RsaAlgorithm: GoogleAppsScript.Utilities.RsaAlgorithm;
declare var Utilities: GoogleAppsScript.Utilities.Utilities;