Version 0.5.3

Author: 3n-mb

.angular-cli.json

@@ -0,0 +1,34 @@
+module.exports = {
+  plugins: ['stylelint-scss'],
+  extends: ['stylelint-config-standard', 'stylelint-config-recommended-scss', 'stylelint-config-recommended-vue'],
+  ignoreFiles: ['/app/assets/**/*.css'],
+
+  rules: {
+    'length-zero-no-unit': null,
+    'at-rule-empty-line-before': [
+      'always',
+      {
+        ignore: ['after-comment'],
+        except: ['inside-block', 'after-same-name'],
+      },
+    ],
+    'no-empty-source': null,
+    'no-descending-specificity': null,
+    'color-function-notation': null,
+    'selector-class-pattern': null,
+    'alpha-value-notation': 'number',
+    'import-notation': 'string',
+    'media-feature-name-no-unknown': [
+      true,
+      {
+        ignoreMediaFeatureNames: ['/^prefers-/'],
+      },
+    ],
+    'at-rule-no-unknown': [
+      true,
+      {
+        ignoreAtRules: ['include', 'function', 'return', 'mixin', 'if', 'else', 'for', 'extend', 'each', 'content'],
+      },
+    ],
+  },
+};

.gitignore

@@ -1,5 +1,5 @@
 /*
- Copyright (C) 2016, 2020, 2022 3NSoft Inc.
+ Copyright (C) 2016, 2020, 2022, 2024 3NSoft Inc.
 
  This program is free software: you can redistribute it and/or modify it under
  the terms of the GNU General Public License as published by the Free Software
@@ -36,19 +36,28 @@ declare namespace web3n.asmail {
 
 	interface DeliveryProgress {
 		notConnected?: true;
-		allDone: boolean;
+		allDone?: 'all-ok' | 'with-errors';
 		msgSize: number;
 		localMeta?: any;
 		recipients: {
 			[address: string]: {
 				done: boolean;
 				idOnDelivery?: string;
-				err?: any;
+				deliveryTS?: number;
+				err?: DeliveryException | RuntimeException | Error;
 				bytesSent: number;
+				// XXX
+				awaitingRetry?: boolean;
+				failedAttempts?: {
+					attemptTS: number;
+					err: any;
+				}[];
 			}
 		};
 	}
 
+	type DeliveryException = ASMailSendException | ServLocException | ASMailSendException;
+
 	interface DeliveryOptions {
 		/**
 		 * sendImmediately flag forces immediate delivery with true value.
@@ -60,6 +69,14 @@ declare namespace web3n.asmail {
 		 * associated with particular delivery.
 		 */
 		localMeta?: any;
+
+		// XXX
+		
+		retryRecipient?: {
+			numOfAttempts: number;
+			// XXX default client says "ASAP" => core applies own sane default
+			timeBetweenAttempts?: number;
+		};
 	}
 
 	interface DeliveryService {
@@ -200,18 +217,21 @@ declare namespace web3n.asmail {
 		 * from event source, or if next throws something, although it must
 		 * handle its own stuff.
 		 */
-		subscribe(event: 'message', observer: Observer<IncomingMessage>):
+		subscribe(event: InboxEventType, observer: Observer<IncomingMessage>):
 			() => void;
 
 	}
 
+	type InboxEventType = 'message';
+
 	interface MsgStruct {
 		/**
 		 * Message type can be
-		 * (a) "mail" for messages that better be viewed in mail styly UI,
-		 * (b) "chat" for messages that better be viewed in chat style UI,
-		 * (c) "app:<app-domain>" for application messages, for example, messages
-		 * for app with domain app.com should have type "app:app.com".
+		 * - "mail" for messages that better be viewed in mail styly UI,
+		 * - "chat" for messages that better be viewed in chat style UI,
+		 * - "app:<app-domain>" for application messages, for example, messages
+		 *   with type "app:app.example.com" is for app.example.com app,
+		 * - "webrtc-signaling" for WebRTC off band signalling.
 		 */
 		msgType: string;
 		subject?: string;
@@ -221,24 +241,25 @@ declare namespace web3n.asmail {
 		carbonCopy?: string[];
 		recipients?: string[];
 	}
-	
+
 	interface MsgInfo {
 		msgId: string;
 		msgType: string;
 		deliveryTS: number;
 	}
-	
+
 	interface IncomingMessage extends MsgInfo, MsgStruct {
 		sender: string;
 		establishedSenderKeyChain: boolean;
 		attachments?: files.ReadonlyFS;
+		// XXX info if not from the first attempt
 	}
-	
+
 	interface OutgoingMessage extends MsgStruct {
 		msgId?: string;
 		attachments?: AttachmentsContainer;
 	}
-	
+
 	/**
 	 * This container is for entities that will be present in attachments
 	 * fs/folder of recipient's incoming message.
@@ -251,7 +272,7 @@ declare namespace web3n.asmail {
 			[name: string]: files.FS;
 		};
 	}
-	
+
 	interface InboxException extends RuntimeException {
 		type: "inbox";
 		msgId: string;
@@ -260,14 +281,23 @@ declare namespace web3n.asmail {
 		objId?: string;
 		msgIsBroken?: true;
 	}
-	
+
 	interface ServLocException extends RuntimeException {
 		type: 'service-locating';
 		address: string;
+
+		/**
+		 * domainNotFound flag indicates that domain in the address doesn't exist.
+		 */
 		domainNotFound?: true;
+
+		/**
+		 * noServiceRecord flag indicates that 3NWeb services are not set at
+		 * domain in the address.
+		 */
 		noServiceRecord?: true;
 	}
-	
+
 	interface ASMailSendException extends RuntimeException {
 		type: 'asmail-delivery';
 		address?: string;
@@ -288,5 +318,5 @@ declare namespace web3n.asmail {
 		// errors that are due to this side
 		msgCancelled?: true;
 	}
-	
+
 }

.stylelint.config.cjs

@@ -32,7 +32,7 @@ declare namespace web3n.caps.common {
 		mail?: MailCAPSetting;
 		storage?: StorageCAPSetting;
 		mailerid?: true;
-		log?: LogCAPSetting;
+		logToPlatform?: true;
 	}
 
 	interface StorageCAPSetting {
@@ -65,12 +65,10 @@ declare namespace web3n.caps.common {
 		receivingFrom?: 'all' | { whitelist: string[]; };
 	}
 
-	type LogCAPSetting = 'all';
-
 	interface W3N {
+		log: Logger;
 		mail?: asmail.Service;
 		storage?: storage.Service;
-		log?: Logger;
 		mailerid?: mailerid.Service;
 	}
 

src/typings/core-defs/asmail.d.ts renamed to @types/core-defs/asmail.d.ts

@@ -22,6 +22,7 @@ declare namespace web3n.files {
 		type: 'file';
 		code: string|undefined;
 		path: string;
+		fsEtityType?: 'file' | 'link' | 'folder';
 	}
 
 	interface FileExceptionFlag {

src/typings/core-defs/common-caps.d.ts renamed to @types/core-defs/common-caps.d.ts

@@ -1,5 +1,5 @@
 /*
- Copyright (C) 2016 - 2017, 2020 3NSoft Inc.
+ Copyright (C) 2016 - 2017, 2020, 2023 3NSoft Inc.
 
  This program is free software: you can redistribute it and/or modify it under
  the terms of the GNU General Public License as published by the Free Software
@@ -23,7 +23,19 @@ declare namespace web3n.startup {
 	 * functionality, when user creates new account in 3NWeb domains.
 	 */
 	interface SignUpService {
-		
+
+		/**
+		 * @param serviceUrl of 3NWeb signup service url.
+		 */
+		setSignUpServer(serviceUrl: string): Promise<void>;
+
+		/**
+		 * @param signupToken
+		 * @return a promise, resolvable to an array of available domains for
+		 * creation of a new account.
+		 */
+		getAvailableDomains(signupToken?: string): Promise<string[]>;
+
 		/**
 		 * @param name is a part of address that comes before @domain
 		 * @param signupToken