@fc3/mmcadi 0.1.0

package/src/client/page.ts

@@ -0,0 +1,128 @@
+import {getFirstValue} from 'lib/array';
+
+import KeyCode from 'client/enum/key-code';
+
+abstract class Page {
+	private shift_pressed: boolean;
+	private previous_key_code: KeyCode | null;
+
+	public constructor() {
+		this.shift_pressed = false;
+		this.previous_key_code = null;
+	}
+
+	public start(): void {
+		this.logStarting();
+		this.initEvents();
+		this.bindLoadEvent();
+		this.logStarted();
+	}
+
+	private bindLoadEvent(): void {
+		window.addEventListener('load', () => {
+			this.initView();
+		});
+	}
+
+	protected initEvents(): void {
+		window.addEventListener('keydown', (event) => {
+			const key_code = event.keyCode || event.charCode;
+
+			this.shift_pressed = event.shiftKey;
+			this.handleKey(key_code);
+
+			if (key_code !== KeyCode.SHIFT) {
+				this.previous_key_code = key_code;
+			}
+		});
+	}
+
+	protected initView(): void {
+		// Noop by default; override on child classes.
+	}
+
+	protected handleKey(key_code: KeyCode): void {
+		// Noop by default; override on child classes.
+	}
+
+	protected getPreviousKeyCode(): KeyCode | null {
+		return this.previous_key_code;
+	}
+
+	protected shiftIsPressed(): boolean {
+		return this.shift_pressed;
+	}
+
+	protected focusElement(element: Element): void {
+		const rectangle = element.getBoundingClientRect();
+		const headers = Array.from(document.getElementsByTagName('header'));
+		const header = getFirstValue(headers);
+		const header_offset = header === undefined ? 0 : header.clientHeight;
+
+		if (rectangle.top < header_offset) {
+			if (header_offset === 0) {
+				window.scrollBy(0, rectangle.top);
+			} else {
+				window.scrollBy(0, -1 * (header_offset - rectangle.top));
+			}
+		} else if (rectangle.bottom > window.innerHeight) {
+			if (rectangle.height < window.innerHeight) {
+				window.scrollBy(0, rectangle.bottom - window.innerHeight);
+			}
+		}
+	}
+
+	protected getNumericQueryParameter(key: string, fallback: number): number {
+		const parameter = this.getQueryParameter(key);
+
+		if (parameter === undefined) {
+			return fallback;
+		}
+
+		const parsed_value = parseInt(parameter);
+
+		if (isNaN(parsed_value)) {
+			return fallback;
+		}
+
+		return parsed_value;
+	}
+
+	protected getQueryParameter(key: string): string | undefined {
+		const params = new URLSearchParams(window.location.search);
+		const value = params.get(key);
+
+		if (value === null) {
+			return undefined;
+		}
+
+		return value;
+	}
+
+	protected setQueryParameter(key: string, value: string | number): void {
+		const url = new URL(window.location.href);
+
+		url.searchParams.set(key, value.toString());
+		url.searchParams.delete('toast_message');
+		url.searchParams.delete('toast_color');
+		window.location.href = url.toString();
+	}
+
+	private logStarting(): void {
+		const name = this.getName();
+
+		console.log(`[${name}] starting...`);
+	}
+
+	private logStarted(): void {
+		const name = this.getName();
+
+		console.log(`[${name}] started.`);
+	}
+
+	private getName(): string {
+		return this.constructor.name;
+	}
+}
+
+export default Page;

package/src/client/shim/execute.ts

@@ -0,0 +1,5 @@
+function execute(command: string): void {
+	console.log(`Executing: ${command}`);
+}
+
+export default execute;

package/src/client/shim/logger.ts

@@ -0,0 +1,44 @@
+import {LogLevel} from 'lib/logger';
+import {InvariantViolation} from 'lib/errors';
+
+class ClientLogger {
+	public setUniqueId(_unique_id: string): void {
+		// Noop.
+	}
+
+	public writeMessage(message: string, log_level: LogLevel): void {
+		switch (log_level) {
+			case LogLevel.INFO:
+				return this.info(message);
+			case LogLevel.SUCCESS:
+				return this.success(message);
+			case LogLevel.WARNING:
+				return this.warn(message);
+			case LogLevel.ERROR:
+				return this.error(message);
+
+			default:
+				throw new InvariantViolation(`
+					Invalid log level: ${log_level}
+				`);
+		}
+	}
+
+	public info(...args: any[]): void {
+		console.log(...args);
+	}
+
+	public success(...args: any[]): void {
+		console.log(...args);
+	}
+
+	public warn(...args: any[]): void {
+		console.warn(...args);
+	}
+
+	public error(...args: any[]): void {
+		console.error(...args);
+	}
+}
+
+export default ClientLogger;

package/src/client/utility/get-meta-value.ts

@@ -0,0 +1,23 @@
+import {InvariantViolation} from 'lib/errors';
+
+function getMetaValue(name: string): string {
+	const element = document.querySelector(`meta[name="${name}"]`);
+
+	if (element === null) {
+		throw new InvariantViolation(`
+			Tried to read ${name} meta tag, but it was not set
+		`);
+	}
+
+	if (!(element instanceof HTMLMetaElement)) {
+		throw new InvariantViolation(`
+			Got wrong element for ${name} meta tag: ${element.tagName}
+		`);
+	}
+
+	const meta_tag = element as HTMLMetaElement;
+
+	return meta_tag.content;
+}
+
+export default getMetaValue;

package/src/common/builder/block/background.ts

@@ -0,0 +1,25 @@
+import {InvalidError} from 'lib/errors';
+
+import WhitespaceBlock from 'type/block/background';
+import Color from 'enum/color';
+import BlockType from 'enum/block-type';
+
+function background(raw_color: string): WhitespaceBlock {
+	const color = raw_color as Color;
+	const colors = Object.values(Color);
+
+	if (!colors.includes(color)) {
+		throw new InvalidError(`
+			Invalid color: ${color}
+		`);
+	}
+
+	return {
+		block_type: BlockType.BACKGROUND,
+		color,
+		created_at: Date.now(),
+		show_time: false
+	};
+}
+
+export default background;

package/src/common/builder/block/folder.ts

@@ -0,0 +1,43 @@
+import {InvalidError} from 'lib/errors';
+
+import FolderBlock from 'type/block/folder';
+import Emoji from 'enum/emoji';
+import Color from 'enum/color';
+import BlockType from 'enum/block-type';
+
+type FolderInput = {
+	readonly title: string;
+	readonly subtitle?: string;
+	readonly emoji: string;
+	readonly color: string;
+};
+
+function folder(input: FolderInput): FolderBlock {
+	const {
+		title,
+		subtitle: raw_subtitle,
+		emoji: raw_emoji,
+		color: raw_color
+	} = input;
+
+	const emoji = raw_emoji as Emoji;
+	const subtitle = raw_subtitle || '';
+	const color = raw_color as Color;
+	const colors = Object.values(Color);
+
+	if (!colors.includes(color)) {
+		throw new InvalidError(`Invalid color: ${color}`);
+	}
+
+	return {
+		block_type: BlockType.FOLDER,
+		title,
+		emoji,
+		subtitle,
+		color,
+		created_at: Date.now(),
+		show_time: false
+	};
+}
+
+export default folder;

package/src/common/builder/block/header.ts

@@ -0,0 +1,15 @@
+import HeaderBlock from 'type/block/header';
+import BlockType from 'enum/block-type';
+import HeaderSize from 'enum/header-size';
+
+function header(title: string): HeaderBlock {
+	return {
+		block_type: BlockType.HEADER,
+		title,
+		size: HeaderSize.MEDIUM,
+		created_at: Date.now(),
+		show_time: false
+	};
+}
+
+export default header;

package/src/common/builder/block/link.ts

@@ -0,0 +1,32 @@
+import {InvalidError} from 'lib/errors';
+
+import LinkBlock from 'type/block/link';
+import Color from 'enum/color';
+import BlockType from 'enum/block-type';
+
+type LinkInput = {
+	readonly href: string;
+	readonly label: string;
+	readonly color: string;
+};
+
+function link(input: LinkInput): LinkBlock {
+	const {href, label, color: raw_color} = input;
+	const color = raw_color as Color;
+	const colors = Object.values(Color);
+
+	if (!colors.includes(color)) {
+		throw new InvalidError(`Invalid color: ${color}`);
+	}
+
+	return {
+		block_type: BlockType.LINK,
+		href,
+		label,
+		color,
+		created_at: Date.now(),
+		show_time: false
+	};
+}
+
+export default link;

package/src/common/builder/block/multicolumn.ts

@@ -0,0 +1,16 @@
+import Block from 'type/block';
+import BlockType from 'enum/block-type';
+import MultiColumnBlock from 'type/block/multi-column';
+
+function multicolumn(max_columns: number, children: Block[]): MultiColumnBlock {
+	return {
+		block_type: BlockType.MULTI_COLUMN,
+		max_columns,
+		children,
+		created_at: Date.now(),
+		show_place: false,
+		show_time: false
+	};
+}
+
+export default multicolumn;

package/src/common/builder/block/note.ts

@@ -0,0 +1,13 @@
+import NoteBlock from 'type/block/note';
+import BlockType from 'enum/block-type';
+
+function note(text: string): NoteBlock {
+	return {
+		block_type: BlockType.NOTE,
+		text,
+		created_at: Date.now(),
+		show_time: false
+	};
+}
+
+export default note;

package/src/common/builder/block/whitespace.ts

@@ -0,0 +1,13 @@
+import WhitespaceBlock from 'type/block/whitespace';
+import BlockType from 'enum/block-type';
+
+function whitespace(line_count: number): WhitespaceBlock {
+	return {
+		block_type: BlockType.WHITESPACE,
+		line_count,
+		created_at: Date.now(),
+		show_time: false
+	};
+}
+
+export default whitespace;

package/src/common/utility/get-parent-path.ts

@@ -0,0 +1,29 @@
+import validatePath from 'server/utility/validate-path';
+
+function getParentPath(source_path: string): string {
+	validatePath(source_path);
+
+	const query_index = source_path.indexOf('?');
+
+	if (query_index !== -1) {
+		source_path = source_path.slice(0, query_index);
+	}
+
+	if (source_path.endsWith('/')) {
+		source_path = source_path.slice(0, -1);
+	}
+
+	const parts = source_path.split('/').filter((part) => {
+		return part !== '';
+	});
+
+	parts.pop();
+
+	if (parts.length === 0) {
+		return '/';
+	}
+
+	return '/' + parts.join('/');
+}
+
+export default getParentPath;

package/src/constant/month-names.ts

@@ -0,0 +1,16 @@
+const MonthNames = [
+	'january',
+	'february',
+	'march',
+	'april',
+	'may',
+	'june',
+	'july',
+	'august',
+	'september',
+	'october',
+	'november',
+	'december'
+];
+
+export default MonthNames;

package/src/enum/action-type.ts

@@ -0,0 +1,11 @@
+enum ActionType {
+	ADD_BLOCK = 'add_block',
+	DELETE_BLOCK = 'delete_block',
+	PROMOTE_BLOCK = 'promote_block',
+	DEMOTE_BLOCK = 'demote_block',
+	EDIT_BLOCK = 'edit_block',
+	CREATE_PAGE = 'create_page',
+	COMPLETE_BLOCK = 'complete_block'
+}
+
+export default ActionType;

package/src/enum/block-type.ts

@@ -0,0 +1,18 @@
+enum BlockType {
+	HEADER = 'header',
+	NOTE = 'note',
+	IMAGE = 'image',
+	AUDIO = 'audio',
+	EPHEMERAL = 'ephemeral',
+	CALENDAR = 'calendar',
+	DIRECTORY = 'directory',
+	FOLDER = 'folder',
+	MULTI_COLUMN = 'multi_column',
+	LINK = 'link',
+	TODO = 'todo',
+	LIST = 'list',
+	BACKGROUND = 'background',
+	WHITESPACE = 'whitespace'
+}
+
+export default BlockType;

package/src/enum/calendar-view-mode.ts

@@ -0,0 +1,9 @@
+
+enum CalendarViewMode {
+	YEAR = 'year',
+	MONTH = 'month',
+	WEEK = 'week',
+	DAY = 'day'
+}
+
+export default CalendarViewMode;

package/src/enum/color.ts

@@ -0,0 +1,15 @@
+enum Color {
+	BLUE = 'blue',
+	YELLOW = 'yellow',
+	FUSCHIA = 'fuschia',
+	RED = 'red',
+	MAROON = 'maroon',
+	ORANGE = 'orange',
+	PURPLE = 'purple',
+	BLACK = 'black',
+	WHITE = 'white',
+	GREY = 'grey',
+	GREEN = 'green'
+}
+
+export default Color;

package/src/enum/default-role.ts

@@ -0,0 +1,6 @@
+enum DefaultRole {
+	CREATOR = 'creator',
+	PUBLIC = 'public'
+}
+
+export default DefaultRole;

package/src/enum/directory-item-type.ts

@@ -0,0 +1,6 @@
+enum DirectoryItemType {
+	DIRECTORY = 'directory',
+	GENERIC_FILE = 'generic_file'
+}
+
+export default DirectoryItemType;

package/src/enum/emoji.ts

@@ -0,0 +1,94 @@
+
+enum Emoji {
+	BAR_CHART = '📊',
+	FOLDER = '🗂️',
+	FILE = '📄',
+	HOUSE = '🏠',
+	NONE = '🚫',
+	WHITE_SQUARE = '⬜',
+	GRID_GLOBE = '🌐',
+	SATELLITE_DISH = '📡',
+	COMPLETED_CHECKMARK = '✅',
+	CLOCK = '🕒',
+	SUNSHINE = '🔆',
+	ALARM_CLOCK = '⏰',
+	MAGNIFYING_GLASS = '🔎',
+	MAGIC_WAND = '🪄',
+	CALENDAR = '📅',
+	LOCKED = '🔒',
+	UNLOCKED = '🔓',
+	NORTHWEST_ARROW = '↖️',
+	RIGHT_ARROW = '➡️',
+	LEFT_ARROW = '⬅️',
+	UP_ARROW = '⬆️',
+	LEFT_ARROW_UNICODE = '◄',
+	UP_ARROW_UNICODE = '▲',
+	RIGHT_ARROW_UNICODE = '►',
+	DOWN_ARROW_UNICODE = '▼',
+	BACK_ARROW = '⬅️',
+	BRICK = '🧱',
+	SWORD = '🗡️',
+	PEACE_SIGN = '✌️',
+	SIGN = '🪧',
+	CONSTRUCTION = '🏗️',
+	CAMERA = '📷',
+	PAINTING = '🖼️',
+	PALETTE = '🎨',
+	MICROPHONE = '🎙️',
+	NOTEPAD = '📝',
+	GEAR = '⚙️',
+	SNOWMAN = '☃️',
+  SNOWFLAKE = '❄️',
+  SNOW_CLOUD = '🌨️',
+  SCARF = '🧣',
+  GLOVES = '🧤',
+  CANDLE = '🕯️',
+  CHRISTMAS_TREE = '🎄',
+  SOCKS = '🧦',
+  COLD_FACE = '🥶',
+	EYE = '👁️',
+	CHAINS = '⛓️',
+
+  SEEDLING = '🌱',
+  TULIP = '🌷',
+  BEE = '🐝',
+  HATCHING_CHICK = '🐣',
+  NEST_WITH_EGGS = '🪺',
+  BLOSSOM = '🌼',
+  UMBRELLA = '☔',
+  RAINBOW = '🌈',
+  PICNIC_BASKET = '🧺',
+
+  SUN_WITH_FACE = '🌞',
+  BEACH_UMBRELLA = '🏖️',
+  WATERMELON = '🍉',
+  SUNGLASSES = '🕶️',
+  ICE_CREAM = '🍦',
+  SUNFLOWER = '🌻',
+  CAMPING = '🏕️',
+  JUICE_BOX = '🧃',
+  PARASOL = '⛱️',
+
+  MAPLE_LEAF = '🍁',
+  FALLEN_LEAF = '🍂',
+  TURKEY = '🦃',
+  JACK_O_LANTERN = '🎃',
+  PIE = '🥧',
+  LOG = '🪵',
+  SPIDER_WEB = '🕸️',
+  BACKPACK = '🎒',
+  CHESTNUT = '🌰',
+
+	PLACARD = '🪧',
+	RECEIPT = '🧾',
+	DOCUMENT = '📄',
+	SPARKLES = '✨',
+	BOOKS = '📚',
+	SHOPPING_BAGS = '🛍️',
+	LINK = '🔗',
+	GREEN_ASTERISK = '✳️',
+	RADIO_BUTTON = '🔘',
+	WINDOW = '🪟'
+}
+
+export default Emoji;

package/src/enum/field-type.ts

@@ -0,0 +1,8 @@
+export enum FieldType {
+	TEXT = 'text',
+	PRICE = 'price',
+	ENUM = 'enum',
+	DATE = 'date'
+}
+
+export default FieldType;

package/src/enum/header-size.ts

@@ -0,0 +1,7 @@
+enum HeaderSize {
+	SMALL = 'small',
+	MEDIUM = 'medium',
+	LARGE = 'large'
+}
+
+export default HeaderSize;

package/src/enum/permission-type.ts

@@ -0,0 +1,8 @@
+enum PermissionType {
+	CREATE = 'create',
+	READ = 'read',
+	UPDATE = 'update',
+	DELETE = 'delete'
+};
+
+export default PermissionType;

package/src/enum/time-place-visibility.ts

@@ -0,0 +1,8 @@
+enum TimePlaceVisibility {
+	NONE = 'none',
+	TIME = 'time',
+	PLACE = 'place',
+	BOTH = 'both'
+}
+
+export default TimePlaceVisibility;

package/src/enum/tool-type.ts

@@ -0,0 +1,14 @@
+
+enum ToolType {
+	LOCK = 'lock',
+	HOME = 'home',
+	TODAY = 'today',
+	SETTINGS = 'settings',
+	FOLDER = 'folder',
+	TODO = 'todo',
+	NOTE = 'note',
+	AUDIO = 'audio',
+	IMAGE = 'image'
+}
+
+export default ToolType;

package/src/index.ts

@@ -0,0 +1,8 @@
+export {default as createServer} from 'bootstrap/start';
+export {default as header} from 'common/builder/block/header';
+export {default as folder} from 'common/builder/block/folder';
+export {default as note} from 'common/builder/block/note';
+export {default as link} from 'common/builder/block/link';
+export {default as multicolumn} from 'common/builder/block/multicolumn';
+export {default as background} from 'common/builder/block/background';
+export {default as whitespace} from 'common/builder/block/whitespace';

package/src/interface/hydration-callback.ts

@@ -0,0 +1,7 @@
+import Resource from 'type/resource';
+
+interface HydrationCallback {
+	(data_source: string): Resource[];
+}
+
+export default HydrationCallback;

package/src/interface/provider.ts

@@ -0,0 +1,8 @@
+import Block from 'type/block';
+
+interface Provider {
+	readonly path: string;
+	readonly handler: (path: string) => Block[] | Promise<Block[]>;
+}
+
+export default Provider;

package/src/interface/repository.ts

@@ -0,0 +1,12 @@
+import {Session} from 'lib/execution-context';
+import Account from 'type/account';
+
+interface Repository {
+	createSessionForAccount(account: Account): Promise<Session>;
+	getAccountForUsername(username: string): Promise<Account | undefined>;
+	saveAccount(account: Account): Promise<void>;
+	findSession(session_id: string): Promise<Session>;
+	destroySession(session_id: string): Promise<void>;
+}
+
+export default Repository;