@zthun/helpful-internet 0.21.0

package/LICENSE

@@ -0,0 +1,16 @@
+# MIT License
+
+Copyright © 2023 Anthony Bonta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/lib/index.esm.js

@@ -0,0 +1,2 @@
+function t(){return t=Object.assign?Object.assign.bind():function(t){for(var i=1;i<arguments.length;i++){var e=arguments[i];for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&(t[n]=e[n])}return t},t.apply(this,arguments)}var i=/*#__PURE__*/function(){function i(){this._cookie=void 0,this.immortal=this.expires.bind(this,void 0),this.lax=this.sameSite.bind(this,"lax"),this.strict=this.sameSite.bind(this,"strict"),this._cookie={name:"",value:""}}var e=i.prototype;return e.name=function(t){return this._cookie.name=t,this},e.value=function(t){return this._cookie.value=t,this},e.domain=function(t){return this._cookie.domain=t,this},e.expires=function(t){return null==t?(delete this._cookie.expires,this):(this._cookie.expires="string"==typeof t?t:t.toJSON(),this)},e.expiresTomorrow=function(){return this.expires(new Date(Date.now()+i.MillisecondsOneDay))},e.secure=function(t){return void 0===t&&(t=!0),this._cookie.secure=t,this},e.sameSite=function(t){return this._cookie.sameSite=t,this},e.allowCrossSite=function(){return this.secure().sameSite("none")},e.httpOnly=function(t){return void 0===t&&(t=!0),this._cookie.httpOnly=t,this},e.authentication=function(t){var i=this.name("Authentication").expiresTomorrow().secure().httpOnly();return null==t?i:i.value(t)},e.build=function(){return t({},this._cookie)},i}();i.MillisecondsOneDay=864e5;var e=/*#__PURE__*/function(){function t(){this._envelope=void 0,this._envelope={from:""}}var i=t.prototype;return i.from=function(t){return this._envelope.from=t,this},i.to=function(t){return this._envelope.to=this._envelope.to||[],this._envelope.to.push(t),this},i.tos=function(t){return this._envelope.to=t,this},i.cc=function(t){return this._envelope.cc=this._envelope.cc||[],this._envelope.cc.push(t),this},i.ccs=function(t){return this._envelope.cc=t,this},i.bcc=function(t){return this._envelope.bcc=this._envelope.bcc||[],this._envelope.bcc.push(t),this},i.bccs=function(t){return this._envelope.bcc=t,this},i.assign=function(t){return this._envelope=Object.assign({},this._envelope,t),this._envelope=JSON.parse(JSON.stringify(this._envelope)),this},i.copy=function(t){return this._envelope=JSON.parse(JSON.stringify(t)),this},i.build=function(){return JSON.parse(JSON.stringify(this._envelope))},t}(),n=/*#__PURE__*/function(){function t(){this._email=void 0,this._email={envelope:(new e).build()}}var i=t.prototype;return i.envelope=function(t){return this._email.envelope=t,this},i.subject=function(t){return this._email.subject=t,this},i.message=function(t){return this._email.message=t,this},i.assign=function(t){return this._email=Object.assign(this._email,t),this._email=JSON.parse(JSON.stringify(this._email)),this},i.copy=function(t){return this._email=JSON.parse(JSON.stringify(t)),this},i.build=function(){return JSON.parse(JSON.stringify(this._email))},t}(),s=/*#__PURE__*/function(){function t(){this._contact=void 0,this._contact={address:""}}var i=t.prototype;return i.address=function(t){return this._contact.address=t,this},i.type=function(t){return this._contact.type=t,this},i.display=function(t){return this._contact.display=t,this},i.assign=function(t){return this._contact=Object.assign({},this._contact,t),this._contact=JSON.parse(JSON.stringify(this._contact)),this},i.copy=function(t){return this._contact=JSON.parse(JSON.stringify(t)),this},i.build=function(){return JSON.parse(JSON.stringify(this._contact))},t}(),r=/*#__PURE__*/function(){function t(){this._addresses=[],this._delimiter=", "}var i=t.prototype;return i.address=function(t){return this._addresses.push(t),this},i.addresses=function(t){return this._addresses=t.slice(),this},i.delimiter=function(t){return this._delimiter=t,this},i.build=function(){return this._addresses.map(function(t){if(t)return"string"==typeof t?t:t.address}).filter(function(t){return!!t}).join(this._delimiter)},t}(),o=/*#__PURE__*/function(){function t(){this._server=void 0,this._server={address:""}}var i=t.prototype;return i.address=function(t){return this._server.address=t,this},i.port=function(t){return this._server.port=t,this},i.username=function(t){return this._server.username=t,this},i.password=function(t){return this._server.password=t,this},i.assign=function(t){return this._server=Object.assign({},this._server,t),this},i.copy=function(t){return this._server=JSON.parse(JSON.stringify(t)),this},i.build=function(){return JSON.parse(JSON.stringify(this._server))},t}();export{i as ZCookieBuilder,n as ZEmailBuilder,r as ZEmailContactAddressBuilder,s as ZEmailContactBuilder,e as ZEmailEnvelopeBuilder,o as ZServerBuilder};
+//# sourceMappingURL=index.esm.js.map

package/dist/lib/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../src/cookie/cookie.ts","../../src/email/email-envelope.ts","../../src/email/email.ts","../../src/email/email-contact.ts","../../src/email/email-contact-address.ts","../../src/server/server.ts"],"sourcesContent":["/**\n * Represents a generic cookie.\n */\nexport interface IZCookie {\n  /**\n   * The cookie name.\n   */\n  name: string;\n  /**\n   * The cookie value.\n   */\n  value: string;\n  /**\n   * The scope domain attached to the cookie.\n   */\n  domain?: string;\n  /**\n   * The utc formatted date at which the cookie expires\n   */\n  expires?: string;\n  /**\n   * A flag that determines if this is a secure cookie.\n   */\n  secure?: boolean;\n  /**\n   * A flag that determines if this cookie can be ready by javascript.\n   */\n  httpOnly?: boolean;\n  /**\n   * A value that determines how the cookie is sent by the browser.\n   */\n  sameSite?: 'lax' | 'strict' | 'none';\n}\n\n/**\n * Represents a builder for an IZCookie object.\n */\nexport class ZCookieBuilder {\n  public static readonly MillisecondsOneDay = 86400000;\n\n  private _cookie: IZCookie;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._cookie = {\n      name: '',\n      value: ''\n    };\n  }\n\n  /**\n   * Sets the cookie name.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public name(val: string): this {\n    this._cookie.name = val;\n    return this;\n  }\n\n  /**\n   * Sets the cookie value.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public value(val: string): this {\n    this._cookie.value = val;\n    return this;\n  }\n\n  /**\n   * Sets the cookie domain.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public domain(val: string | undefined): this {\n    this._cookie.domain = val;\n    return this;\n  }\n\n  /**\n   * Sets the cookie expiration date.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public expires(val: Date | string | undefined): this {\n    if (val == null) {\n      delete this._cookie.expires;\n      return this;\n    }\n\n    this._cookie.expires = typeof val === 'string' ? val : val.toJSON();\n    return this;\n  }\n\n  /**\n   * Sets the cookie expiration date to one day from the moment this is invoked.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public expiresTomorrow(): this {\n    return this.expires(new Date(Date.now() + ZCookieBuilder.MillisecondsOneDay));\n  }\n\n  /**\n   * Removes the cookie expiration.\n   *\n   * @returns\n   *        This object.\n   */\n  public immortal: () => this = this.expires.bind(this, undefined);\n\n  /**\n   * Sets the cookie secure flag.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public secure(val = true): this {\n    this._cookie.secure = val;\n    return this;\n  }\n\n  /**\n   * Sets the cookie same site policy.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public sameSite(val: 'lax' | 'strict' | 'none'): this {\n    this._cookie.sameSite = val;\n    return this;\n  }\n\n  /**\n   * Sets the same site policy to 'lax'\n   *\n   * @returns\n   *        This object.\n   */\n  public lax = this.sameSite.bind(this, 'lax');\n\n  /**\n   * Sets the same site polity to 'strict'\n   *\n   * @returns\n   *        This object.\n   */\n  public strict = this.sameSite.bind(this, 'strict');\n\n  /**\n   * Sets the same site policy to 'none' and turns on the secure flag.\n   *\n   * @returns\n   *        This object.\n   */\n  public allowCrossSite(): this {\n    return this.secure().sameSite('none');\n  }\n\n  /**\n   * Sets the cookie http only flag.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public httpOnly(val = true): this {\n    this._cookie.httpOnly = val;\n    return this;\n  }\n\n  /**\n   * Creates a token based authentication cookie.\n   *\n   * @param token -\n   *        The token value for the cookie.  You\n   *        can leave this as undefined to set it\n   *        later.\n   *\n   * @returns\n   *        This object.\n   */\n  public authentication(token?: string): this {\n    const builder = this.name('Authentication').expiresTomorrow().secure().httpOnly();\n    return token == null ? builder : builder.value(token);\n  }\n\n  /**\n   * Returns a copy of the built instance of the cookie.\n   *\n   * @returns\n   *        A shallow copy of the current cookie object.\n   */\n  public build(): IZCookie {\n    return { ...this._cookie };\n  }\n}\n","import { IZEmailContact } from './email-contact';\n\n/**\n * Represents an email envelope of information about who the email is from and where it's going to.\n */\nexport interface IZEmailEnvelope {\n  /**\n   * Who the email is from.\n   *\n   * This can be the full contact or just the address.\n   */\n  from: IZEmailContact | string;\n\n  /**\n   * Where the email is going.\n   *\n   * This can be falsy if cc is filled out.\n   */\n  to?: Array<IZEmailContact | string>;\n\n  /**\n   * Who is receiving a carbon copy of the email.\n   *\n   * This can be falsy if to is filled out.\n   */\n  cc?: Array<IZEmailContact | string>;\n\n  /**\n   * Who is receiving a blind carbon copy of an email.\n   */\n  bcc?: Array<IZEmailContact | string>;\n}\n\n/**\n * Represents a builder for an email envelope.\n */\nexport class ZEmailEnvelopeBuilder {\n  private _envelope: IZEmailEnvelope;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._envelope = {\n      from: ''\n    };\n  }\n\n  /**\n   * Sets the from field.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public from(val: IZEmailContact | string): this {\n    this._envelope.from = val;\n    return this;\n  }\n\n  /**\n   * Adds a value to the 'to' field.\n   *\n   * @param val -\n   *        The value to add.\n   *\n   * @returns\n   *        This object.\n   */\n  public to(val: IZEmailContact | string): this {\n    this._envelope.to = this._envelope.to || [];\n    this._envelope.to.push(val);\n    return this;\n  }\n\n  /**\n   * Sets the to field.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public tos(val: Array<IZEmailContact | string>): this {\n    this._envelope.to = val;\n    return this;\n  }\n\n  /**\n   * Adds a value to the cc field.\n   *\n   * @param val -\n   *        The value to add.\n   *\n   * @returns\n   *        This object.\n   */\n  public cc(val: IZEmailContact | string): this {\n    this._envelope.cc = this._envelope.cc || [];\n    this._envelope.cc.push(val);\n    return this;\n  }\n\n  /**\n   * Sets the cc field.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public ccs(val: Array<IZEmailContact | string>): this {\n    this._envelope.cc = val;\n    return this;\n  }\n\n  /**\n   * Adds a value to the bcc field.\n   *\n   * @param val -\n   *        The value to add.\n   *\n   * @returns\n   *        This object.\n   */\n  public bcc(val: IZEmailContact | string): this {\n    this._envelope.bcc = this._envelope.bcc || [];\n    this._envelope.bcc.push(val);\n    return this;\n  }\n\n  /**\n   * Sets the bcc field.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public bccs(val: Array<IZEmailContact | string>): this {\n    this._envelope.bcc = val;\n    return this;\n  }\n\n  /**\n   * Assigns another partial email envelope to this object.\n   *\n   * @param other -\n   *        The value to partial copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public assign(other: Partial<IZEmailEnvelope>): this {\n    this._envelope = Object.assign({}, this._envelope, other);\n    this._envelope = JSON.parse(JSON.stringify(this._envelope));\n    return this;\n  }\n\n  /**\n   * Copies another email envelope to this object.\n   *\n   * @param other -\n   *        The value to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public copy(other: IZEmailEnvelope): this {\n    this._envelope = JSON.parse(JSON.stringify(other));\n    return this;\n  }\n\n  /**\n   * Returns a copy of the built envelope.\n   *\n   * @returns\n   *        A copy of the currently built up envelope object.\n   */\n  public build(): IZEmailEnvelope {\n    return JSON.parse(JSON.stringify(this._envelope));\n  }\n}\n","import { IZEmailEnvelope, ZEmailEnvelopeBuilder } from './email-envelope';\n\n/**\n * Represents an email message.\n */\nexport interface IZEmail {\n  /**\n   * The email envelope of where the email is going to.\n   */\n  envelope: IZEmailEnvelope;\n\n  /**\n   * The subject (title) of the email.\n   */\n  subject?: string;\n\n  /**\n   * The message to send.\n   */\n  message?: string;\n}\n\n/**\n * Represents a builder for an email.\n */\nexport class ZEmailBuilder {\n  private _email: IZEmail;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._email = {\n      envelope: new ZEmailEnvelopeBuilder().build()\n    };\n  }\n\n  /**\n   * Sets the envelope of where the email is going.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public envelope(val: IZEmailEnvelope): this {\n    this._email.envelope = val;\n    return this;\n  }\n\n  /**\n   * Sets the subject line of the email.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public subject(val: string): this {\n    this._email.subject = val;\n    return this;\n  }\n\n  /**\n   * Sets the message of the email.\n   *\n   * The message can be raw text or html.\n   *\n   * @param val -\n   *        A html enabled formatted message to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public message(val: string): this {\n    this._email.message = val;\n    return this;\n  }\n\n  /**\n   * Assigns the other object to the current email object.\n   *\n   * @param other -\n   *        The object to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public assign(other: Partial<IZEmail>): this {\n    this._email = Object.assign(this._email, other);\n    this._email = JSON.parse(JSON.stringify(this._email));\n    return this;\n  }\n\n  /**\n   * Copies another email into the builder.\n   *\n   * @param other -\n   *        The object to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public copy(other: IZEmail) {\n    this._email = JSON.parse(JSON.stringify(other));\n    return this;\n  }\n\n  /**\n   * Returns a copy of the built object.\n   *\n   * @returns\n   *        A copy of the built object.\n   */\n  public build(): IZEmail {\n    return JSON.parse(JSON.stringify(this._email));\n  }\n}\n","/**\n * Represents an email contact.\n */\nexport interface IZEmailContact {\n  /**\n   * The email address of the contact.\n   */\n  address: string;\n\n  /**\n   * The type of contact.\n   *\n   * This can be anything you want.  In the end, this has no bearing\n   * on the final sent message.  It's just a descriptor to determine what this contact\n   * represents if needed.\n   */\n  type?: string;\n\n  /**\n   * The display name of the contact.\n   *\n   * If this is falsy, then you can consider the\n   * address as the display.\n   */\n  display?: string;\n}\n\n/**\n * Represents a builder for an email contact.\n */\nexport class ZEmailContactBuilder {\n  private _contact: IZEmailContact;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._contact = {\n      address: ''\n    };\n  }\n\n  /**\n   * Sets the address of the contact.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public address(val: string): this {\n    this._contact.address = val;\n    return this;\n  }\n\n  /**\n   * Sets the type of the contact.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public type(val: string): this {\n    this._contact.type = val;\n    return this;\n  }\n\n  /**\n   * Sets the display of the contact.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public display(val: string) {\n    this._contact.display = val;\n    return this;\n  }\n\n  /**\n   * Assigns the values in other to this object.\n   *\n   * @param other -\n   *        The value to partial copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public assign(other: Partial<IZEmailContact>): this {\n    this._contact = Object.assign({}, this._contact, other);\n    this._contact = JSON.parse(JSON.stringify(this._contact));\n    return this;\n  }\n\n  /**\n   * Copies another object.\n   *\n   * @param other -\n   *        The value to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public copy(other: IZEmailContact): this {\n    this._contact = JSON.parse(JSON.stringify(other));\n    return this;\n  }\n\n  /**\n   * Returns a copy of the built object.\n   *\n   * @returns\n   *        A copy of the built email contact.\n   */\n  public build(): IZEmailContact {\n    return JSON.parse(JSON.stringify(this._contact));\n  }\n}\n","import { IZEmailContact } from './email-contact';\n\n/**\n * Represents a builder that will build a comma separated\n * list of addresses for an email message.\n */\nexport class ZEmailContactAddressBuilder {\n  private _addresses: Array<string | IZEmailContact> = [];\n  private _delimiter = ', ';\n\n  /**\n   * Adds an address to the list to builder.\n   *\n   * @param val -\n   *        The address to add. This can be the empty string,\n   *        null, or undefined.\n   *\n   * @returns\n   *        This object.\n   */\n  public address(val: string | IZEmailContact): this {\n    this._addresses.push(val);\n    return this;\n  }\n\n  /**\n   * Sets the addresses to build from.\n   *\n   * @param val -\n   *        The address to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public addresses(val: Array<string | IZEmailContact>) {\n    this._addresses = val.slice();\n    return this;\n  }\n\n  /**\n   * Sets the delimiter to split the addresses with.\n   *\n   * The default is a comma with a space.\n   *\n   * @param val -\n   *        The delimiter to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public delimiter(val: string): this {\n    this._delimiter = val;\n    return this;\n  }\n\n  /**\n   * Builds the delimiters separated list of addresses.\n   *\n   * @returns\n   *        The delimited separated list of addresses.\n   */\n  public build(): string {\n    const addr = (ct: string | IZEmailContact) => {\n      if (!ct) {\n        return undefined;\n      }\n\n      return typeof ct === 'string' ? ct : ct.address;\n    };\n\n    const truthy = (ct: string) => {\n      return !!ct;\n    };\n\n    return this._addresses.map(addr).filter(truthy).join(this._delimiter);\n  }\n}\n","/**\n * Represents an abstract server connection.\n */\nexport interface IZServer {\n  /**\n   * The host or ip address to connect to.\n   *\n   * Does not distinguish between the protocol and hostname.\n   */\n  address: string;\n\n  /**\n   * The optional port to connect on.\n   *\n   * If this is falsy, then it is up to the implementation\n   * taking this object to properly default the value.\n   */\n  port?: number;\n\n  /**\n   * The optional username.\n   *\n   * Falsy usually implies guest access.\n   */\n  username?: string;\n\n  /**\n   * The user's password to connect with.\n   *\n   * If username is not supplied, then this generally has no meaning.\n   */\n  password?: string;\n}\n\n/**\n * Represents a builder for a server object.\n */\nexport class ZServerBuilder {\n  private _server: IZServer;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._server = {\n      address: ''\n    };\n  }\n\n  /**\n   * The server ip address or hostname.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public address(val: string): this {\n    this._server.address = val;\n    return this;\n  }\n\n  /**\n   * Sets the optional port to connect on.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public port(val: number): this {\n    this._server.port = val;\n    return this;\n  }\n\n  /**\n   * Sets the optional username to connect on.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public username(val: string): this {\n    this._server.username = val;\n    return this;\n  }\n\n  /**\n   * Sets the password to connect on.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public password(val: string): this {\n    this._server.password = val;\n    return this;\n  }\n\n  /**\n   * Assigns all truthy properties in other to this object.\n   *\n   * @param other -\n   *        The server object to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public assign(other: Partial<IZServer>): this {\n    this._server = Object.assign({}, this._server, other);\n    return this;\n  }\n\n  /**\n   * Copies all properties in other to this object.\n   *\n   * @param other -\n   *        The server object to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public copy(other: IZServer): this {\n    this._server = JSON.parse(JSON.stringify(other));\n    return this;\n  }\n\n  /**\n   * Returns a copy of the built object.\n   *\n   * @returns\n   *        A copy of the built object.\n   */\n  public build(): IZServer {\n    return JSON.parse(JSON.stringify(this._server));\n  }\n}\n"],"names":["ZCookieBuilder","_cookie","this","immortal","expires","bind","undefined","lax","sameSite","strict","name","value","_proto","prototype","val","domain","toJSON","expiresTomorrow","Date","now","MillisecondsOneDay","secure","allowCrossSite","httpOnly","authentication","token","builder","build","_extends","ZEmailEnvelopeBuilder","_envelope","from","to","push","tos","cc","ccs","bcc","bccs","assign","other","Object","JSON","parse","stringify","copy","ZEmailBuilder","_email","envelope","subject","message","ZEmailContactBuilder","_contact","address","type","display","ZEmailContactAddressBuilder","_addresses","_delimiter","addresses","slice","delimiter","map","ct","filter","join","ZServerBuilder","_server","port","username","password"],"mappings":"oOAqCa,IAAAA,eAAc,WAQzB,SAAAA,SALQC,aAAO,EAAAC,KA4FRC,SAAuBD,KAAKE,QAAQC,KAAKH,UAAMI,QAoC/CC,IAAML,KAAKM,SAASH,KAAKH,KAAM,OAQ/BO,KAAAA,OAASP,KAAKM,SAASH,KAAKH,KAAM,UAlIvCA,KAAKD,QAAU,CACbS,KAAM,GACNC,MAAO,GAEX,CAAC,IAAAC,EAAAZ,EAAAa,iBAAAD,EAWMF,KAAA,SAAKI,GAEV,OADAZ,KAAKD,QAAQS,KAAOI,EAEtBZ,IAAA,EAACU,EAWMD,MAAA,SAAMG,GAEX,OADAZ,KAAKD,QAAQU,MAAQG,EACdZ,IACT,EAACU,EAWMG,OAAA,SAAOD,GAEZ,OADAZ,KAAKD,QAAQc,OAASD,EACfZ,IACT,EAACU,EAWMR,QAAA,SAAQU,GACb,OAAW,MAAPA,UACSZ,KAACD,QAAQG,QACbF,OAGTA,KAAKD,QAAQG,QAAyB,iBAARU,EAAmBA,EAAMA,EAAIE,cAE7D,EAACJ,EAWMK,gBAAA,WACL,OAAWf,KAACE,QAAQ,IAAIc,KAAKA,KAAKC,MAAQnB,EAAeoB,oBAC3D,EAACR,EAmBMS,OAAA,SAAOP,GAEZ,YAFYA,IAAAA,IAAAA,GAAM,GAClBZ,KAAKD,QAAQoB,OAASP,EAExBZ,IAAA,EAACU,EAWMJ,SAAA,SAASM,GAEd,OADAZ,KAAKD,QAAQO,SAAWM,EAE1BZ,IAAA,EAACU,EAwBMU,eAAA,WACL,OAAWpB,KAACmB,SAASb,SAAS,OAChC,EAACI,EAWMW,SAAA,SAAST,GAEd,YAFiB,IAAHA,IAAAA,GAAM,GACpBZ,KAAKD,QAAQsB,SAAWT,EAE1BZ,IAAA,EAACU,EAaMY,eAAA,SAAeC,GACpB,IAAMC,EAAUxB,KAAKQ,KAAK,kBAAkBO,kBAAkBI,SAASE,WACvE,OAAgB,MAATE,EAAgBC,EAAUA,EAAQf,MAAMc,EACjD,EAACb,EAQMe,MAAA,WACL,OAAAC,KAAY1B,KAAKD,QACnB,EAACD,CAAA,CA7LwB,GAAdA,EACYoB,mBAAqB,MCFjC,IAAAS,eAAqB,WAMhC,SAAAA,IALQC,KAAAA,eAMN,EAAA5B,KAAK4B,UAAY,CACfC,KAAM,GAEV,CAAC,IAAAnB,EAAAiB,EAAAhB,iBAAAD,EAWMmB,KAAA,SAAKjB,GAEV,OADAZ,KAAK4B,UAAUC,KAAOjB,EAExBZ,IAAA,EAACU,EAWMoB,GAAA,SAAGlB,GAGR,OAFAZ,KAAK4B,UAAUE,GAAK9B,KAAK4B,UAAUE,IAAM,GACzC9B,KAAK4B,UAAUE,GAAGC,KAAKnB,OAEzB,EAACF,EAWMsB,IAAA,SAAIpB,GAET,OADAZ,KAAK4B,UAAUE,GAAKlB,EAEtBZ,IAAA,EAACU,EAWMuB,GAAA,SAAGrB,GAGR,OAFAZ,KAAK4B,UAAUK,GAAKjC,KAAK4B,UAAUK,IAAM,GACzCjC,KAAK4B,UAAUK,GAAGF,KAAKnB,GAChBZ,IACT,EAACU,EAWMwB,IAAA,SAAItB,GAET,OADAZ,KAAK4B,UAAUK,GAAKrB,EACbZ,IACT,EAACU,EAWMyB,IAAA,SAAIvB,GAGT,OAFAZ,KAAK4B,UAAUO,IAAMnC,KAAK4B,UAAUO,KAAO,GAC3CnC,KAAK4B,UAAUO,IAAIJ,KAAKnB,GACjBZ,IACT,EAACU,EAWM0B,KAAA,SAAKxB,GAEV,OADAZ,KAAK4B,UAAUO,IAAMvB,EACdZ,IACT,EAACU,EAWM2B,OAAA,SAAOC,GAGZ,OAFAtC,KAAK4B,UAAYW,OAAOF,OAAO,CAAE,EAAErC,KAAK4B,UAAWU,GACnDtC,KAAK4B,UAAYY,KAAKC,MAAMD,KAAKE,UAAU1C,KAAK4B,YACzC5B,IACT,EAACU,EAWMiC,KAAA,SAAKL,GAEV,OADAtC,KAAK4B,UAAYY,KAAKC,MAAMD,KAAKE,UAAUJ,QAE7C,EAAC5B,EAQMe,MAAA,WACL,OAAOe,KAAKC,MAAMD,KAAKE,UAAU1C,KAAK4B,WACxC,EAACD,CAAA,CAtJ+B,GCXrBiB,0BAMX,SAAAA,IALQC,KAAAA,cAMN7C,KAAK6C,OAAS,CACZC,UAAU,IAAInB,GAAwBF,QAE1C,CAAC,IAAAf,EAAAkC,EAAAjC,UAmFA,OAnFAD,EAWMoC,SAAA,SAASlC,GAEd,OADAZ,KAAK6C,OAAOC,SAAWlC,MAEzB,EAACF,EAWMqC,QAAA,SAAQnC,GAEb,OADAZ,KAAK6C,OAAOE,QAAUnC,EACfZ,IACT,EAACU,EAaMsC,QAAA,SAAQpC,GAEb,OADAZ,KAAK6C,OAAOG,QAAUpC,EACfZ,IACT,EAACU,EAWM2B,OAAA,SAAOC,GAGZ,OAFAtC,KAAK6C,OAASN,OAAOF,OAAOrC,KAAK6C,OAAQP,GACzCtC,KAAK6C,OAASL,KAAKC,MAAMD,KAAKE,UAAU1C,KAAK6C,SACtC7C,IACT,EAACU,EAWMiC,KAAA,SAAKL,GAEV,OADAtC,KAAK6C,OAASL,KAAKC,MAAMD,KAAKE,UAAUJ,IAE1CtC,IAAA,EAACU,EAQMe,MAAA,WACL,OAAOe,KAAKC,MAAMD,KAAKE,UAAU1C,KAAK6C,QACxC,EAACD,CAAA,ICxFUK,eAMX,WAAA,SAAAA,IAAAjD,KALQkD,cAMN,EAAAlD,KAAKkD,SAAW,CACdC,QAAS,GAEb,CAAC,IAAAzC,EAAAuC,EAAAtC,UAiFA,OAjFAD,EAWMyC,QAAA,SAAQvC,GAEb,OADAZ,KAAKkD,SAASC,QAAUvC,EACjBZ,IACT,EAACU,EAWM0C,KAAA,SAAKxC,GAEV,OADAZ,KAAKkD,SAASE,KAAOxC,MAEvB,EAACF,EAWM2C,QAAA,SAAQzC,GAEb,OADAZ,KAAKkD,SAASG,QAAUzC,MAE1B,EAACF,EAWM2B,OAAA,SAAOC,GAGZ,OAFAtC,KAAKkD,SAAWX,OAAOF,OAAO,CAAA,EAAIrC,KAAKkD,SAAUZ,GACjDtC,KAAKkD,SAAWV,KAAKC,MAAMD,KAAKE,UAAU1C,KAAKkD,eAEjD,EAACxC,EAWMiC,KAAA,SAAKL,GAEV,OADAtC,KAAKkD,SAAWV,KAAKC,MAAMD,KAAKE,UAAUJ,IAE5CtC,IAAA,EAACU,EAQMe,MAAA,WACL,OAAOe,KAAKC,MAAMD,KAAKE,UAAU1C,KAAKkD,UACxC,EAACD,CAAA,CArFD,GC9BWK,eAA2B,WAAA,SAAAA,IAAAtD,KAC9BuD,WAA6C,GAC7CC,KAAAA,WAAa,IAAI,CAAA,IAAA9C,EAAA4C,EAAA3C,iBAAAD,EAYlByC,QAAA,SAAQvC,GAEb,OADAZ,KAAKuD,WAAWxB,KAAKnB,GAEvBZ,IAAA,EAACU,EAWM+C,UAAA,SAAU7C,GAEf,OADAZ,KAAKuD,WAAa3C,EAAI8C,QACf1D,IACT,EAACU,EAaMiD,UAAA,SAAU/C,GAEf,OADAZ,KAAKwD,WAAa5C,MAEpB,EAACF,EAQMe,MAAA,WAaL,YAAY8B,WAAWK,IAZV,SAACC,GACZ,GAAKA,EAIL,MAAqB,iBAAPA,EAAkBA,EAAKA,EAAGV,OAC1C,GAMiCW,OAJlB,SAACD,GACd,QAASA,CACX,GAEgDE,KAAK/D,KAAKwD,WAC5D,EAACF,CAAA,CArEqC,GC+B3BU,eAMX,WAAA,SAAAA,IAAAhE,KALQiE,aAMN,EAAAjE,KAAKiE,QAAU,CACbd,QAAS,GAEb,CAAC,IAAAzC,EAAAsD,EAAArD,UA8FA,OA9FAD,EAWMyC,QAAA,SAAQvC,GAEb,OADAZ,KAAKiE,QAAQd,QAAUvC,EAChBZ,IACT,EAACU,EAWMwD,KAAA,SAAKtD,GAEV,OADAZ,KAAKiE,QAAQC,KAAOtD,MAEtB,EAACF,EAWMyD,SAAA,SAASvD,GAEd,OADAZ,KAAKiE,QAAQE,SAAWvD,EACjBZ,IACT,EAACU,EAWM0D,SAAA,SAASxD,GAEd,OADAZ,KAAKiE,QAAQG,SAAWxD,EAE1BZ,IAAA,EAACU,EAWM2B,OAAA,SAAOC,GAEZ,OADAtC,KAAKiE,QAAU1B,OAAOF,OAAO,CAAE,EAAErC,KAAKiE,QAAS3B,GAEjDtC,IAAA,EAACU,EAWMiC,KAAA,SAAKL,GAEV,OADAtC,KAAKiE,QAAUzB,KAAKC,MAAMD,KAAKE,UAAUJ,IAClCtC,IACT,EAACU,EAQMe,MAAA,WACL,OAAOe,KAAKC,MAAMD,KAAKE,UAAU1C,KAAKiE,SACxC,EAACD,CAAA,CAlGD"}

package/dist/lib/index.js

@@ -0,0 +1,2 @@
+function t(){return t=Object.assign?Object.assign.bind():function(t){for(var e=1;e<arguments.length;e++){var i=arguments[e];for(var n in i)Object.prototype.hasOwnProperty.call(i,n)&&(t[n]=i[n])}return t},t.apply(this,arguments)}var e=/*#__PURE__*/function(){function e(){this._cookie=void 0,this.immortal=this.expires.bind(this,void 0),this.lax=this.sameSite.bind(this,"lax"),this.strict=this.sameSite.bind(this,"strict"),this._cookie={name:"",value:""}}var i=e.prototype;return i.name=function(t){return this._cookie.name=t,this},i.value=function(t){return this._cookie.value=t,this},i.domain=function(t){return this._cookie.domain=t,this},i.expires=function(t){return null==t?(delete this._cookie.expires,this):(this._cookie.expires="string"==typeof t?t:t.toJSON(),this)},i.expiresTomorrow=function(){return this.expires(new Date(Date.now()+e.MillisecondsOneDay))},i.secure=function(t){return void 0===t&&(t=!0),this._cookie.secure=t,this},i.sameSite=function(t){return this._cookie.sameSite=t,this},i.allowCrossSite=function(){return this.secure().sameSite("none")},i.httpOnly=function(t){return void 0===t&&(t=!0),this._cookie.httpOnly=t,this},i.authentication=function(t){var e=this.name("Authentication").expiresTomorrow().secure().httpOnly();return null==t?e:e.value(t)},i.build=function(){return t({},this._cookie)},e}();e.MillisecondsOneDay=864e5;var i=/*#__PURE__*/function(){function t(){this._envelope=void 0,this._envelope={from:""}}var e=t.prototype;return e.from=function(t){return this._envelope.from=t,this},e.to=function(t){return this._envelope.to=this._envelope.to||[],this._envelope.to.push(t),this},e.tos=function(t){return this._envelope.to=t,this},e.cc=function(t){return this._envelope.cc=this._envelope.cc||[],this._envelope.cc.push(t),this},e.ccs=function(t){return this._envelope.cc=t,this},e.bcc=function(t){return this._envelope.bcc=this._envelope.bcc||[],this._envelope.bcc.push(t),this},e.bccs=function(t){return this._envelope.bcc=t,this},e.assign=function(t){return this._envelope=Object.assign({},this._envelope,t),this._envelope=JSON.parse(JSON.stringify(this._envelope)),this},e.copy=function(t){return this._envelope=JSON.parse(JSON.stringify(t)),this},e.build=function(){return JSON.parse(JSON.stringify(this._envelope))},t}(),n=/*#__PURE__*/function(){function t(){this._email=void 0,this._email={envelope:(new i).build()}}var e=t.prototype;return e.envelope=function(t){return this._email.envelope=t,this},e.subject=function(t){return this._email.subject=t,this},e.message=function(t){return this._email.message=t,this},e.assign=function(t){return this._email=Object.assign(this._email,t),this._email=JSON.parse(JSON.stringify(this._email)),this},e.copy=function(t){return this._email=JSON.parse(JSON.stringify(t)),this},e.build=function(){return JSON.parse(JSON.stringify(this._email))},t}(),s=/*#__PURE__*/function(){function t(){this._contact=void 0,this._contact={address:""}}var e=t.prototype;return e.address=function(t){return this._contact.address=t,this},e.type=function(t){return this._contact.type=t,this},e.display=function(t){return this._contact.display=t,this},e.assign=function(t){return this._contact=Object.assign({},this._contact,t),this._contact=JSON.parse(JSON.stringify(this._contact)),this},e.copy=function(t){return this._contact=JSON.parse(JSON.stringify(t)),this},e.build=function(){return JSON.parse(JSON.stringify(this._contact))},t}(),r=/*#__PURE__*/function(){function t(){this._addresses=[],this._delimiter=", "}var e=t.prototype;return e.address=function(t){return this._addresses.push(t),this},e.addresses=function(t){return this._addresses=t.slice(),this},e.delimiter=function(t){return this._delimiter=t,this},e.build=function(){return this._addresses.map(function(t){if(t)return"string"==typeof t?t:t.address}).filter(function(t){return!!t}).join(this._delimiter)},t}(),o=/*#__PURE__*/function(){function t(){this._server=void 0,this._server={address:""}}var e=t.prototype;return e.address=function(t){return this._server.address=t,this},e.port=function(t){return this._server.port=t,this},e.username=function(t){return this._server.username=t,this},e.password=function(t){return this._server.password=t,this},e.assign=function(t){return this._server=Object.assign({},this._server,t),this},e.copy=function(t){return this._server=JSON.parse(JSON.stringify(t)),this},e.build=function(){return JSON.parse(JSON.stringify(this._server))},t}();exports.ZCookieBuilder=e,exports.ZEmailBuilder=n,exports.ZEmailContactAddressBuilder=r,exports.ZEmailContactBuilder=s,exports.ZEmailEnvelopeBuilder=i,exports.ZServerBuilder=o;
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/cookie/cookie.ts","../../src/email/email-envelope.ts","../../src/email/email.ts","../../src/email/email-contact.ts","../../src/email/email-contact-address.ts","../../src/server/server.ts"],"sourcesContent":["/**\n * Represents a generic cookie.\n */\nexport interface IZCookie {\n  /**\n   * The cookie name.\n   */\n  name: string;\n  /**\n   * The cookie value.\n   */\n  value: string;\n  /**\n   * The scope domain attached to the cookie.\n   */\n  domain?: string;\n  /**\n   * The utc formatted date at which the cookie expires\n   */\n  expires?: string;\n  /**\n   * A flag that determines if this is a secure cookie.\n   */\n  secure?: boolean;\n  /**\n   * A flag that determines if this cookie can be ready by javascript.\n   */\n  httpOnly?: boolean;\n  /**\n   * A value that determines how the cookie is sent by the browser.\n   */\n  sameSite?: 'lax' | 'strict' | 'none';\n}\n\n/**\n * Represents a builder for an IZCookie object.\n */\nexport class ZCookieBuilder {\n  public static readonly MillisecondsOneDay = 86400000;\n\n  private _cookie: IZCookie;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._cookie = {\n      name: '',\n      value: ''\n    };\n  }\n\n  /**\n   * Sets the cookie name.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public name(val: string): this {\n    this._cookie.name = val;\n    return this;\n  }\n\n  /**\n   * Sets the cookie value.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public value(val: string): this {\n    this._cookie.value = val;\n    return this;\n  }\n\n  /**\n   * Sets the cookie domain.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public domain(val: string | undefined): this {\n    this._cookie.domain = val;\n    return this;\n  }\n\n  /**\n   * Sets the cookie expiration date.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public expires(val: Date | string | undefined): this {\n    if (val == null) {\n      delete this._cookie.expires;\n      return this;\n    }\n\n    this._cookie.expires = typeof val === 'string' ? val : val.toJSON();\n    return this;\n  }\n\n  /**\n   * Sets the cookie expiration date to one day from the moment this is invoked.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public expiresTomorrow(): this {\n    return this.expires(new Date(Date.now() + ZCookieBuilder.MillisecondsOneDay));\n  }\n\n  /**\n   * Removes the cookie expiration.\n   *\n   * @returns\n   *        This object.\n   */\n  public immortal: () => this = this.expires.bind(this, undefined);\n\n  /**\n   * Sets the cookie secure flag.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public secure(val = true): this {\n    this._cookie.secure = val;\n    return this;\n  }\n\n  /**\n   * Sets the cookie same site policy.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public sameSite(val: 'lax' | 'strict' | 'none'): this {\n    this._cookie.sameSite = val;\n    return this;\n  }\n\n  /**\n   * Sets the same site policy to 'lax'\n   *\n   * @returns\n   *        This object.\n   */\n  public lax = this.sameSite.bind(this, 'lax');\n\n  /**\n   * Sets the same site polity to 'strict'\n   *\n   * @returns\n   *        This object.\n   */\n  public strict = this.sameSite.bind(this, 'strict');\n\n  /**\n   * Sets the same site policy to 'none' and turns on the secure flag.\n   *\n   * @returns\n   *        This object.\n   */\n  public allowCrossSite(): this {\n    return this.secure().sameSite('none');\n  }\n\n  /**\n   * Sets the cookie http only flag.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public httpOnly(val = true): this {\n    this._cookie.httpOnly = val;\n    return this;\n  }\n\n  /**\n   * Creates a token based authentication cookie.\n   *\n   * @param token -\n   *        The token value for the cookie.  You\n   *        can leave this as undefined to set it\n   *        later.\n   *\n   * @returns\n   *        This object.\n   */\n  public authentication(token?: string): this {\n    const builder = this.name('Authentication').expiresTomorrow().secure().httpOnly();\n    return token == null ? builder : builder.value(token);\n  }\n\n  /**\n   * Returns a copy of the built instance of the cookie.\n   *\n   * @returns\n   *        A shallow copy of the current cookie object.\n   */\n  public build(): IZCookie {\n    return { ...this._cookie };\n  }\n}\n","import { IZEmailContact } from './email-contact';\n\n/**\n * Represents an email envelope of information about who the email is from and where it's going to.\n */\nexport interface IZEmailEnvelope {\n  /**\n   * Who the email is from.\n   *\n   * This can be the full contact or just the address.\n   */\n  from: IZEmailContact | string;\n\n  /**\n   * Where the email is going.\n   *\n   * This can be falsy if cc is filled out.\n   */\n  to?: Array<IZEmailContact | string>;\n\n  /**\n   * Who is receiving a carbon copy of the email.\n   *\n   * This can be falsy if to is filled out.\n   */\n  cc?: Array<IZEmailContact | string>;\n\n  /**\n   * Who is receiving a blind carbon copy of an email.\n   */\n  bcc?: Array<IZEmailContact | string>;\n}\n\n/**\n * Represents a builder for an email envelope.\n */\nexport class ZEmailEnvelopeBuilder {\n  private _envelope: IZEmailEnvelope;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._envelope = {\n      from: ''\n    };\n  }\n\n  /**\n   * Sets the from field.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public from(val: IZEmailContact | string): this {\n    this._envelope.from = val;\n    return this;\n  }\n\n  /**\n   * Adds a value to the 'to' field.\n   *\n   * @param val -\n   *        The value to add.\n   *\n   * @returns\n   *        This object.\n   */\n  public to(val: IZEmailContact | string): this {\n    this._envelope.to = this._envelope.to || [];\n    this._envelope.to.push(val);\n    return this;\n  }\n\n  /**\n   * Sets the to field.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public tos(val: Array<IZEmailContact | string>): this {\n    this._envelope.to = val;\n    return this;\n  }\n\n  /**\n   * Adds a value to the cc field.\n   *\n   * @param val -\n   *        The value to add.\n   *\n   * @returns\n   *        This object.\n   */\n  public cc(val: IZEmailContact | string): this {\n    this._envelope.cc = this._envelope.cc || [];\n    this._envelope.cc.push(val);\n    return this;\n  }\n\n  /**\n   * Sets the cc field.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public ccs(val: Array<IZEmailContact | string>): this {\n    this._envelope.cc = val;\n    return this;\n  }\n\n  /**\n   * Adds a value to the bcc field.\n   *\n   * @param val -\n   *        The value to add.\n   *\n   * @returns\n   *        This object.\n   */\n  public bcc(val: IZEmailContact | string): this {\n    this._envelope.bcc = this._envelope.bcc || [];\n    this._envelope.bcc.push(val);\n    return this;\n  }\n\n  /**\n   * Sets the bcc field.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public bccs(val: Array<IZEmailContact | string>): this {\n    this._envelope.bcc = val;\n    return this;\n  }\n\n  /**\n   * Assigns another partial email envelope to this object.\n   *\n   * @param other -\n   *        The value to partial copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public assign(other: Partial<IZEmailEnvelope>): this {\n    this._envelope = Object.assign({}, this._envelope, other);\n    this._envelope = JSON.parse(JSON.stringify(this._envelope));\n    return this;\n  }\n\n  /**\n   * Copies another email envelope to this object.\n   *\n   * @param other -\n   *        The value to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public copy(other: IZEmailEnvelope): this {\n    this._envelope = JSON.parse(JSON.stringify(other));\n    return this;\n  }\n\n  /**\n   * Returns a copy of the built envelope.\n   *\n   * @returns\n   *        A copy of the currently built up envelope object.\n   */\n  public build(): IZEmailEnvelope {\n    return JSON.parse(JSON.stringify(this._envelope));\n  }\n}\n","import { IZEmailEnvelope, ZEmailEnvelopeBuilder } from './email-envelope';\n\n/**\n * Represents an email message.\n */\nexport interface IZEmail {\n  /**\n   * The email envelope of where the email is going to.\n   */\n  envelope: IZEmailEnvelope;\n\n  /**\n   * The subject (title) of the email.\n   */\n  subject?: string;\n\n  /**\n   * The message to send.\n   */\n  message?: string;\n}\n\n/**\n * Represents a builder for an email.\n */\nexport class ZEmailBuilder {\n  private _email: IZEmail;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._email = {\n      envelope: new ZEmailEnvelopeBuilder().build()\n    };\n  }\n\n  /**\n   * Sets the envelope of where the email is going.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public envelope(val: IZEmailEnvelope): this {\n    this._email.envelope = val;\n    return this;\n  }\n\n  /**\n   * Sets the subject line of the email.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public subject(val: string): this {\n    this._email.subject = val;\n    return this;\n  }\n\n  /**\n   * Sets the message of the email.\n   *\n   * The message can be raw text or html.\n   *\n   * @param val -\n   *        A html enabled formatted message to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public message(val: string): this {\n    this._email.message = val;\n    return this;\n  }\n\n  /**\n   * Assigns the other object to the current email object.\n   *\n   * @param other -\n   *        The object to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public assign(other: Partial<IZEmail>): this {\n    this._email = Object.assign(this._email, other);\n    this._email = JSON.parse(JSON.stringify(this._email));\n    return this;\n  }\n\n  /**\n   * Copies another email into the builder.\n   *\n   * @param other -\n   *        The object to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public copy(other: IZEmail) {\n    this._email = JSON.parse(JSON.stringify(other));\n    return this;\n  }\n\n  /**\n   * Returns a copy of the built object.\n   *\n   * @returns\n   *        A copy of the built object.\n   */\n  public build(): IZEmail {\n    return JSON.parse(JSON.stringify(this._email));\n  }\n}\n","/**\n * Represents an email contact.\n */\nexport interface IZEmailContact {\n  /**\n   * The email address of the contact.\n   */\n  address: string;\n\n  /**\n   * The type of contact.\n   *\n   * This can be anything you want.  In the end, this has no bearing\n   * on the final sent message.  It's just a descriptor to determine what this contact\n   * represents if needed.\n   */\n  type?: string;\n\n  /**\n   * The display name of the contact.\n   *\n   * If this is falsy, then you can consider the\n   * address as the display.\n   */\n  display?: string;\n}\n\n/**\n * Represents a builder for an email contact.\n */\nexport class ZEmailContactBuilder {\n  private _contact: IZEmailContact;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._contact = {\n      address: ''\n    };\n  }\n\n  /**\n   * Sets the address of the contact.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public address(val: string): this {\n    this._contact.address = val;\n    return this;\n  }\n\n  /**\n   * Sets the type of the contact.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public type(val: string): this {\n    this._contact.type = val;\n    return this;\n  }\n\n  /**\n   * Sets the display of the contact.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public display(val: string) {\n    this._contact.display = val;\n    return this;\n  }\n\n  /**\n   * Assigns the values in other to this object.\n   *\n   * @param other -\n   *        The value to partial copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public assign(other: Partial<IZEmailContact>): this {\n    this._contact = Object.assign({}, this._contact, other);\n    this._contact = JSON.parse(JSON.stringify(this._contact));\n    return this;\n  }\n\n  /**\n   * Copies another object.\n   *\n   * @param other -\n   *        The value to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public copy(other: IZEmailContact): this {\n    this._contact = JSON.parse(JSON.stringify(other));\n    return this;\n  }\n\n  /**\n   * Returns a copy of the built object.\n   *\n   * @returns\n   *        A copy of the built email contact.\n   */\n  public build(): IZEmailContact {\n    return JSON.parse(JSON.stringify(this._contact));\n  }\n}\n","import { IZEmailContact } from './email-contact';\n\n/**\n * Represents a builder that will build a comma separated\n * list of addresses for an email message.\n */\nexport class ZEmailContactAddressBuilder {\n  private _addresses: Array<string | IZEmailContact> = [];\n  private _delimiter = ', ';\n\n  /**\n   * Adds an address to the list to builder.\n   *\n   * @param val -\n   *        The address to add. This can be the empty string,\n   *        null, or undefined.\n   *\n   * @returns\n   *        This object.\n   */\n  public address(val: string | IZEmailContact): this {\n    this._addresses.push(val);\n    return this;\n  }\n\n  /**\n   * Sets the addresses to build from.\n   *\n   * @param val -\n   *        The address to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public addresses(val: Array<string | IZEmailContact>) {\n    this._addresses = val.slice();\n    return this;\n  }\n\n  /**\n   * Sets the delimiter to split the addresses with.\n   *\n   * The default is a comma with a space.\n   *\n   * @param val -\n   *        The delimiter to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public delimiter(val: string): this {\n    this._delimiter = val;\n    return this;\n  }\n\n  /**\n   * Builds the delimiters separated list of addresses.\n   *\n   * @returns\n   *        The delimited separated list of addresses.\n   */\n  public build(): string {\n    const addr = (ct: string | IZEmailContact) => {\n      if (!ct) {\n        return undefined;\n      }\n\n      return typeof ct === 'string' ? ct : ct.address;\n    };\n\n    const truthy = (ct: string) => {\n      return !!ct;\n    };\n\n    return this._addresses.map(addr).filter(truthy).join(this._delimiter);\n  }\n}\n","/**\n * Represents an abstract server connection.\n */\nexport interface IZServer {\n  /**\n   * The host or ip address to connect to.\n   *\n   * Does not distinguish between the protocol and hostname.\n   */\n  address: string;\n\n  /**\n   * The optional port to connect on.\n   *\n   * If this is falsy, then it is up to the implementation\n   * taking this object to properly default the value.\n   */\n  port?: number;\n\n  /**\n   * The optional username.\n   *\n   * Falsy usually implies guest access.\n   */\n  username?: string;\n\n  /**\n   * The user's password to connect with.\n   *\n   * If username is not supplied, then this generally has no meaning.\n   */\n  password?: string;\n}\n\n/**\n * Represents a builder for a server object.\n */\nexport class ZServerBuilder {\n  private _server: IZServer;\n\n  /**\n   * Initializes a new instance of this object.\n   */\n  public constructor() {\n    this._server = {\n      address: ''\n    };\n  }\n\n  /**\n   * The server ip address or hostname.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public address(val: string): this {\n    this._server.address = val;\n    return this;\n  }\n\n  /**\n   * Sets the optional port to connect on.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public port(val: number): this {\n    this._server.port = val;\n    return this;\n  }\n\n  /**\n   * Sets the optional username to connect on.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public username(val: string): this {\n    this._server.username = val;\n    return this;\n  }\n\n  /**\n   * Sets the password to connect on.\n   *\n   * @param val -\n   *        The value to set.\n   *\n   * @returns\n   *        This object.\n   */\n  public password(val: string): this {\n    this._server.password = val;\n    return this;\n  }\n\n  /**\n   * Assigns all truthy properties in other to this object.\n   *\n   * @param other -\n   *        The server object to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public assign(other: Partial<IZServer>): this {\n    this._server = Object.assign({}, this._server, other);\n    return this;\n  }\n\n  /**\n   * Copies all properties in other to this object.\n   *\n   * @param other -\n   *        The server object to copy.\n   *\n   * @returns\n   *        This object.\n   */\n  public copy(other: IZServer): this {\n    this._server = JSON.parse(JSON.stringify(other));\n    return this;\n  }\n\n  /**\n   * Returns a copy of the built object.\n   *\n   * @returns\n   *        A copy of the built object.\n   */\n  public build(): IZServer {\n    return JSON.parse(JSON.stringify(this._server));\n  }\n}\n"],"names":["ZCookieBuilder","_cookie","this","immortal","expires","bind","undefined","lax","sameSite","strict","name","value","_proto","prototype","val","domain","toJSON","expiresTomorrow","Date","now","MillisecondsOneDay","secure","allowCrossSite","httpOnly","authentication","token","builder","build","_extends","ZEmailEnvelopeBuilder","_envelope","from","to","push","tos","cc","ccs","bcc","bccs","assign","other","Object","JSON","parse","stringify","copy","ZEmailBuilder","_email","envelope","subject","message","ZEmailContactBuilder","_contact","address","type","display","ZEmailContactAddressBuilder","_addresses","_delimiter","addresses","slice","delimiter","map","ct","filter","join","ZServerBuilder","_server","port","username","password"],"mappings":"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"}

package/dist/types/cookie/cookie.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Represents a generic cookie.
+ */
+export interface IZCookie {
+    /**
+     * The cookie name.
+     */
+    name: string;
+    /**
+     * The cookie value.
+     */
+    value: string;
+    /**
+     * The scope domain attached to the cookie.
+     */
+    domain?: string;
+    /**
+     * The utc formatted date at which the cookie expires
+     */
+    expires?: string;
+    /**
+     * A flag that determines if this is a secure cookie.
+     */
+    secure?: boolean;
+    /**
+     * A flag that determines if this cookie can be ready by javascript.
+     */
+    httpOnly?: boolean;
+    /**
+     * A value that determines how the cookie is sent by the browser.
+     */
+    sameSite?: 'lax' | 'strict' | 'none';
+}
+/**
+ * Represents a builder for an IZCookie object.
+ */
+export declare class ZCookieBuilder {
+    static readonly MillisecondsOneDay = 86400000;
+    private _cookie;
+    /**
+     * Initializes a new instance of this object.
+     */
+    constructor();
+    /**
+     * Sets the cookie name.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    name(val: string): this;
+    /**
+     * Sets the cookie value.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    value(val: string): this;
+    /**
+     * Sets the cookie domain.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    domain(val: string | undefined): this;
+    /**
+     * Sets the cookie expiration date.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    expires(val: Date | string | undefined): this;
+    /**
+     * Sets the cookie expiration date to one day from the moment this is invoked.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    expiresTomorrow(): this;
+    /**
+     * Removes the cookie expiration.
+     *
+     * @returns
+     *        This object.
+     */
+    immortal: () => this;
+    /**
+     * Sets the cookie secure flag.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    secure(val?: boolean): this;
+    /**
+     * Sets the cookie same site policy.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    sameSite(val: 'lax' | 'strict' | 'none'): this;
+    /**
+     * Sets the same site policy to 'lax'
+     *
+     * @returns
+     *        This object.
+     */
+    lax: () => this;
+    /**
+     * Sets the same site polity to 'strict'
+     *
+     * @returns
+     *        This object.
+     */
+    strict: () => this;
+    /**
+     * Sets the same site policy to 'none' and turns on the secure flag.
+     *
+     * @returns
+     *        This object.
+     */
+    allowCrossSite(): this;
+    /**
+     * Sets the cookie http only flag.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    httpOnly(val?: boolean): this;
+    /**
+     * Creates a token based authentication cookie.
+     *
+     * @param token -
+     *        The token value for the cookie.  You
+     *        can leave this as undefined to set it
+     *        later.
+     *
+     * @returns
+     *        This object.
+     */
+    authentication(token?: string): this;
+    /**
+     * Returns a copy of the built instance of the cookie.
+     *
+     * @returns
+     *        A shallow copy of the current cookie object.
+     */
+    build(): IZCookie;
+}

package/dist/types/email/email-contact-address.d.ts

@@ -0,0 +1,49 @@
+import { IZEmailContact } from './email-contact';
+/**
+ * Represents a builder that will build a comma separated
+ * list of addresses for an email message.
+ */
+export declare class ZEmailContactAddressBuilder {
+    private _addresses;
+    private _delimiter;
+    /**
+     * Adds an address to the list to builder.
+     *
+     * @param val -
+     *        The address to add. This can be the empty string,
+     *        null, or undefined.
+     *
+     * @returns
+     *        This object.
+     */
+    address(val: string | IZEmailContact): this;
+    /**
+     * Sets the addresses to build from.
+     *
+     * @param val -
+     *        The address to set.
+     *
+     * @returns
+     *        This object.
+     */
+    addresses(val: Array<string | IZEmailContact>): this;
+    /**
+     * Sets the delimiter to split the addresses with.
+     *
+     * The default is a comma with a space.
+     *
+     * @param val -
+     *        The delimiter to set.
+     *
+     * @returns
+     *        This object.
+     */
+    delimiter(val: string): this;
+    /**
+     * Builds the delimiters separated list of addresses.
+     *
+     * @returns
+     *        The delimited separated list of addresses.
+     */
+    build(): string;
+}

package/dist/types/email/email-contact.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Represents an email contact.
+ */
+export interface IZEmailContact {
+    /**
+     * The email address of the contact.
+     */
+    address: string;
+    /**
+     * The type of contact.
+     *
+     * This can be anything you want.  In the end, this has no bearing
+     * on the final sent message.  It's just a descriptor to determine what this contact
+     * represents if needed.
+     */
+    type?: string;
+    /**
+     * The display name of the contact.
+     *
+     * If this is falsy, then you can consider the
+     * address as the display.
+     */
+    display?: string;
+}
+/**
+ * Represents a builder for an email contact.
+ */
+export declare class ZEmailContactBuilder {
+    private _contact;
+    /**
+     * Initializes a new instance of this object.
+     */
+    constructor();
+    /**
+     * Sets the address of the contact.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    address(val: string): this;
+    /**
+     * Sets the type of the contact.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    type(val: string): this;
+    /**
+     * Sets the display of the contact.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    display(val: string): this;
+    /**
+     * Assigns the values in other to this object.
+     *
+     * @param other -
+     *        The value to partial copy.
+     *
+     * @returns
+     *        This object.
+     */
+    assign(other: Partial<IZEmailContact>): this;
+    /**
+     * Copies another object.
+     *
+     * @param other -
+     *        The value to copy.
+     *
+     * @returns
+     *        This object.
+     */
+    copy(other: IZEmailContact): this;
+    /**
+     * Returns a copy of the built object.
+     *
+     * @returns
+     *        A copy of the built email contact.
+     */
+    build(): IZEmailContact;
+}

package/dist/types/email/email-envelope.d.ts

@@ -0,0 +1,135 @@
+import { IZEmailContact } from './email-contact';
+/**
+ * Represents an email envelope of information about who the email is from and where it's going to.
+ */
+export interface IZEmailEnvelope {
+    /**
+     * Who the email is from.
+     *
+     * This can be the full contact or just the address.
+     */
+    from: IZEmailContact | string;
+    /**
+     * Where the email is going.
+     *
+     * This can be falsy if cc is filled out.
+     */
+    to?: Array<IZEmailContact | string>;
+    /**
+     * Who is receiving a carbon copy of the email.
+     *
+     * This can be falsy if to is filled out.
+     */
+    cc?: Array<IZEmailContact | string>;
+    /**
+     * Who is receiving a blind carbon copy of an email.
+     */
+    bcc?: Array<IZEmailContact | string>;
+}
+/**
+ * Represents a builder for an email envelope.
+ */
+export declare class ZEmailEnvelopeBuilder {
+    private _envelope;
+    /**
+     * Initializes a new instance of this object.
+     */
+    constructor();
+    /**
+     * Sets the from field.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    from(val: IZEmailContact | string): this;
+    /**
+     * Adds a value to the 'to' field.
+     *
+     * @param val -
+     *        The value to add.
+     *
+     * @returns
+     *        This object.
+     */
+    to(val: IZEmailContact | string): this;
+    /**
+     * Sets the to field.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    tos(val: Array<IZEmailContact | string>): this;
+    /**
+     * Adds a value to the cc field.
+     *
+     * @param val -
+     *        The value to add.
+     *
+     * @returns
+     *        This object.
+     */
+    cc(val: IZEmailContact | string): this;
+    /**
+     * Sets the cc field.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    ccs(val: Array<IZEmailContact | string>): this;
+    /**
+     * Adds a value to the bcc field.
+     *
+     * @param val -
+     *        The value to add.
+     *
+     * @returns
+     *        This object.
+     */
+    bcc(val: IZEmailContact | string): this;
+    /**
+     * Sets the bcc field.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    bccs(val: Array<IZEmailContact | string>): this;
+    /**
+     * Assigns another partial email envelope to this object.
+     *
+     * @param other -
+     *        The value to partial copy.
+     *
+     * @returns
+     *        This object.
+     */
+    assign(other: Partial<IZEmailEnvelope>): this;
+    /**
+     * Copies another email envelope to this object.
+     *
+     * @param other -
+     *        The value to copy.
+     *
+     * @returns
+     *        This object.
+     */
+    copy(other: IZEmailEnvelope): this;
+    /**
+     * Returns a copy of the built envelope.
+     *
+     * @returns
+     *        A copy of the currently built up envelope object.
+     */
+    build(): IZEmailEnvelope;
+}

package/dist/types/email/email.d.ts

@@ -0,0 +1,87 @@
+import { IZEmailEnvelope } from './email-envelope';
+/**
+ * Represents an email message.
+ */
+export interface IZEmail {
+    /**
+     * The email envelope of where the email is going to.
+     */
+    envelope: IZEmailEnvelope;
+    /**
+     * The subject (title) of the email.
+     */
+    subject?: string;
+    /**
+     * The message to send.
+     */
+    message?: string;
+}
+/**
+ * Represents a builder for an email.
+ */
+export declare class ZEmailBuilder {
+    private _email;
+    /**
+     * Initializes a new instance of this object.
+     */
+    constructor();
+    /**
+     * Sets the envelope of where the email is going.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    envelope(val: IZEmailEnvelope): this;
+    /**
+     * Sets the subject line of the email.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    subject(val: string): this;
+    /**
+     * Sets the message of the email.
+     *
+     * The message can be raw text or html.
+     *
+     * @param val -
+     *        A html enabled formatted message to set.
+     *
+     * @returns
+     *        This object.
+     */
+    message(val: string): this;
+    /**
+     * Assigns the other object to the current email object.
+     *
+     * @param other -
+     *        The object to copy.
+     *
+     * @returns
+     *        This object.
+     */
+    assign(other: Partial<IZEmail>): this;
+    /**
+     * Copies another email into the builder.
+     *
+     * @param other -
+     *        The object to copy.
+     *
+     * @returns
+     *        This object.
+     */
+    copy(other: IZEmail): this;
+    /**
+     * Returns a copy of the built object.
+     *
+     * @returns
+     *        A copy of the built object.
+     */
+    build(): IZEmail;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export * from './cookie/cookie';
+export * from './email/email';
+export * from './email/email-contact';
+export * from './email/email-contact-address';
+export * from './email/email-envelope';
+export * from './server/server';

package/dist/types/server/server.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Represents an abstract server connection.
+ */
+export interface IZServer {
+    /**
+     * The host or ip address to connect to.
+     *
+     * Does not distinguish between the protocol and hostname.
+     */
+    address: string;
+    /**
+     * The optional port to connect on.
+     *
+     * If this is falsy, then it is up to the implementation
+     * taking this object to properly default the value.
+     */
+    port?: number;
+    /**
+     * The optional username.
+     *
+     * Falsy usually implies guest access.
+     */
+    username?: string;
+    /**
+     * The user's password to connect with.
+     *
+     * If username is not supplied, then this generally has no meaning.
+     */
+    password?: string;
+}
+/**
+ * Represents a builder for a server object.
+ */
+export declare class ZServerBuilder {
+    private _server;
+    /**
+     * Initializes a new instance of this object.
+     */
+    constructor();
+    /**
+     * The server ip address or hostname.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    address(val: string): this;
+    /**
+     * Sets the optional port to connect on.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    port(val: number): this;
+    /**
+     * Sets the optional username to connect on.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    username(val: string): this;
+    /**
+     * Sets the password to connect on.
+     *
+     * @param val -
+     *        The value to set.
+     *
+     * @returns
+     *        This object.
+     */
+    password(val: string): this;
+    /**
+     * Assigns all truthy properties in other to this object.
+     *
+     * @param other -
+     *        The server object to copy.
+     *
+     * @returns
+     *        This object.
+     */
+    assign(other: Partial<IZServer>): this;
+    /**
+     * Copies all properties in other to this object.
+     *
+     * @param other -
+     *        The server object to copy.
+     *
+     * @returns
+     *        This object.
+     */
+    copy(other: IZServer): this;
+    /**
+     * Returns a copy of the built object.
+     *
+     * @returns
+     *        A copy of the built object.
+     */
+    build(): IZServer;
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@zthun/helpful-internet",
+  "version": "0.21.0",
+  "description": "Helpful objects that represents internet base entities",
+  "author": "Anthony Bonta",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zthun/helpful",
+    "directory": "packages/helpful-internet"
+  },
+  "main": "./dist/lib/index.js",
+  "module": "./dist/lib/index.esm.js",
+  "types": "./dist/types/index.d.ts",
+  "scripts": {
+    "build": "microbundle --format esm,cjs --tsconfig tsconfig.prod.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@zthun/helpful-fn": "^0.21.0",
+    "microbundle": "^0.15.1",
+    "vite": "^4.4.7",
+    "vitest": "^0.33.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "gitHead": "ee5bff46d3b9574b6b9c3fafd42127356eb95930"
+}