haiku/headers/os/mail/E-mail.h

/*******************************************************************************
/
/	File:		E-mail.h
/
/	Description:	Mail attributes and BMailMessage class.
/
/	Copyright 1993-98, Be Incorporated, All Rights Reserved.
/
*******************************************************************************/

#ifndef _E_MAIL_H
#define _E_MAIL_H

#include <UTF8.h>

class BList;

/* -----------------------------------------------------------------------*/
/* 'E-Mail' attributes...*/

#define B_MAIL_ATTR_NAME		"MAIL:name"			/* indexed string*/
#define B_MAIL_ATTR_STATUS		"MAIL:status"		/* indexed string*/
#define B_MAIL_ATTR_PRIORITY	"MAIL:priority"		/* indexed string*/
#define B_MAIL_ATTR_TO			"MAIL:to"			/* indexed string*/
#define B_MAIL_ATTR_CC			"MAIL:cc"			/* indexed string*/
#define B_MAIL_ATTR_FROM		"MAIL:from"			/* indexed string*/
#define B_MAIL_ATTR_SUBJECT		"MAIL:subject"		/* indexed string*/
#define B_MAIL_ATTR_REPLY		"MAIL:reply"		/* indexed string*/
#define B_MAIL_ATTR_WHEN		"MAIL:when"			/* indexed time*/
#define B_MAIL_ATTR_FLAGS		"MAIL:flags"		/* indexed int32*/
#define B_MAIL_ATTR_RECIPIENTS	"MAIL:recipients"	/* string*/
#define B_MAIL_ATTR_MIME		"MAIL:mime"			/* string*/
#define B_MAIL_ATTR_HEADER		"MAIL:header_length"	/* int32*/
#define B_MAIL_ATTR_CONTENT		"MAIL:content_length"	/* int32*/


/* mail flags */
enum	mail_flags			{B_MAIL_PENDING	= 1,	/* waiting to be sent*/
							 B_MAIL_SENT	= 2,	/* has been sent*/
							 B_MAIL_SAVE	= 4};	/* save mail after sending*/

#define B_MAIL_TYPE			"text/x-email"			/* mime type*/

/* Everything past this point is deprecated. See MailMessage.h, mail_encoding.h
	and MailDaemon.h for alternatives. */

/* DEPRECATED -- DEPRECATED -- DEPRECATED -- DEPRECATED -- DEPRECATED */
/* DEPRECATED -- DEPRECATED -- DEPRECATED -- DEPRECATED -- DEPRECATED */

/* defines...*/

/* schedule days */
#define B_CHECK_NEVER			 0
#define B_CHECK_WEEKDAYS		 1
#define B_CHECK_DAILY			 2
#define B_CHECK_CONTINUOUSLY	 3
#define B_CHECK_CONTINUOSLY		 3

/* max. lengths */
#define B_MAX_USER_NAME_LENGTH	32
#define B_MAX_HOST_NAME_LENGTH	64

/* rfc822 header field types */
#define B_MAIL_TO			"To: "
#define B_MAIL_CC			"Cc: "
#define B_MAIL_BCC			"Bcc: "
#define B_MAIL_FROM			"From: "
#define B_MAIL_DATE			"Date: "
#define B_MAIL_REPLY		"Reply-To: "
#define B_MAIL_SUBJECT		"Subject: "
#define B_MAIL_PRIORITY		"Priority: "


/* -----------------------------------------------------------------------*/
/* structs...*/

typedef struct {
	char		pop_name[B_MAX_USER_NAME_LENGTH];
	char		pop_password[B_MAX_USER_NAME_LENGTH];
	char		pop_host[B_MAX_HOST_NAME_LENGTH];
	char		real_name[128];
	char		reply_to[128];
	int32		days;			/* see flags above*/
	int32		interval;		/* in seconds*/
	int32		begin_time;		/* in seconds*/
	int32		end_time;		/* in seconds*/
} mail_pop_account;

typedef struct {
	bool		alert;
	bool		beep;
} mail_notification;

/* -----------------------------------------------------------------------*/
/* global functions...*/

_IMPEXP_MAIL int32		count_pop_accounts(void);
_IMPEXP_MAIL status_t	get_pop_account(mail_pop_account*, int32 index = 0);
_IMPEXP_MAIL status_t	set_pop_account(mail_pop_account*, int32 index = 0,
							bool save = true);
_IMPEXP_MAIL status_t	get_smtp_host(char*);
_IMPEXP_MAIL status_t	set_smtp_host(char*, bool save = true);
_IMPEXP_MAIL status_t	get_mail_notification(mail_notification*);
_IMPEXP_MAIL status_t	set_mail_notification(mail_notification*, bool save = true);

_IMPEXP_MAIL status_t	check_for_mail(int32 *incoming_count = NULL);
_IMPEXP_MAIL status_t	send_queued_mail(void);
_IMPEXP_MAIL status_t	forward_mail(entry_ref*, const char* recipients, bool now = true);

_IMPEXP_MAIL ssize_t	decode_base64(char *out, char *in, off_t length,
							bool replace_cr = false);
_IMPEXP_MAIL ssize_t	encode_base64(char *out, char *in, off_t length);


/* -----------------------------------------------------------------------*/
/* class...*/

class BMailMessage {

public:
					BMailMessage(void);
					~BMailMessage(void);

		status_t	AddContent(const char *text, int32 length,
							   uint32 encoding = B_ISO1_CONVERSION,
							   bool clobber = false);
		status_t	AddContent(const char *text, int32 length,
							   const char *encoding, bool clobber = false);

		status_t	AddEnclosure(entry_ref *ref, bool clobber = false);
		status_t	AddEnclosure(const char *path, bool clobber = false);
		status_t	AddEnclosure(const char *MIME_type, void *data, int32 len,
								 bool clobber = false);

		status_t	AddHeaderField(uint32 encoding, const char *field_name, const char *str, 
								   bool clobber = false);
		status_t	AddHeaderField(const char *field_name, const char *str,
								   bool clobber = false);

		status_t	Send(bool send_now = false,
						 bool remove_when_I_have_completed_sending_this_message_to_your_preferred_SMTP_server = false);


/* -----------------------------------------------------------------------*/

private:
		BList*		fFields;
		bool		fMultiPart;

		int32		concatinate(char**, int32, char*);
		int32		count_fields(char *name = NULL);
		status_t	find_field(char*, type_code*, char**, void**, int32*, 
							   uint32*, char**, bool*, int32);
		BList*		find_field(const char*);
		status_t	get_field_name(char**, int32);
		status_t	set_field(const char*, type_code, const char*, const void*,
							  int32, uint32, const char*, bool);
};

#endif /* _MAIL_H */