firstly 0.0.11 → 0.0.12

package/esm/changeLog/index.d.ts

@@ -1,40 +1,4 @@
 import { type FieldRef, type FieldsRef, type LifecycleEvent } from 'remult';
-import type { Module } from '../api';
-/**
- * ## Default way
- * The easiest is to switch from `@Entity` to `@FF_Entity` to the entities where you want to log changes.
- *
- * ```ts
- * \@FF_Entity<User>('users', {
- *
- *   // Optional => To disable change logs
- *   // changeLog: false,
- *
- *   // Optional => To disable some columns from being logged
- *   // changeLog: {
- *   //   excludeColumns: (e) => {
- *   //     return [e.password]
- *   //   },
- *   // },
- * })
- * export class User {}
- * ```
- *
- * ## Manual way
- * If you want to go more manual, you can import these functions and call them in your entity's lifecycle events.
- * ```ts
- * \@Entity<User>('users', {
- *   saved: async (entity, e) => {
- *     await recordSaved(entity, e)
- *   },
- *   deleted: async (entity, e) => {
- *     await recordDeleted(entity, e)
- *   },
- * })
- * export class User {}
- * ```
- */
-export declare const changeLog: () => Module;
 export declare class ChangeLog {
     id: string;
     entity: string;

package/esm/changeLog/index.js

@@ -4,47 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { Entity, Fields, getEntityRef, IdEntity, isBackend, remult, } from 'remult';
-/**
- * ## Default way
- * The easiest is to switch from `@Entity` to `@FF_Entity` to the entities where you want to log changes.
- *
- * ```ts
- * \@FF_Entity<User>('users', {
- *
- *   // Optional => To disable change logs
- *   // changeLog: false,
- *
- *   // Optional => To disable some columns from being logged
- *   // changeLog: {
- *   //   excludeColumns: (e) => {
- *   //     return [e.password]
- *   //   },
- *   // },
- * })
- * export class User {}
- * ```
- *
- * ## Manual way
- * If you want to go more manual, you can import these functions and call them in your entity's lifecycle events.
- * ```ts
- * \@Entity<User>('users', {
- *   saved: async (entity, e) => {
- *     await recordSaved(entity, e)
- *   },
- *   deleted: async (entity, e) => {
- *     await recordDeleted(entity, e)
- *   },
- * })
- * export class User {}
- * ```
- */
-export const changeLog = () => {
-    return {
-        name: 'changeLog',
-        entities: [ChangeLog],
-    };
-};
+import { Entity, Fields, getEntityRef, IdEntity, isBackend, remult, repo, } from 'remult';
 let ChangeLog = class ChangeLog {
     id = '';
     entity = '';
@@ -120,7 +80,7 @@ export async function recordSaved(entity, e, options) {
             }
         }
         if (changes.length > 0) {
-            await remult.repo(ChangeLog).insert({
+            await repo(ChangeLog).insert({
                 changeDate,
                 changes,
                 entity: e.metadata.key,
@@ -153,7 +113,7 @@ export async function recordDeleted(entity, e, options) {
             throw err;
         }
     }
-    await remult.repo(ChangeLog).insert({
+    await repo(ChangeLog).insert({
         changeDate,
         changes,
         entity: e.metadata.key,

package/esm/changeLog/server/index.d.ts

@@ -0,0 +1,36 @@
+import { Module } from '../../api';
+/**
+ * ## Default way
+ * The easiest is to switch from `@Entity` to `@FF_Entity` to the entities where you want to log changes.
+ *
+ * ```ts
+ * \@FF_Entity<User>('users', {
+ *
+ *   // Optional => To disable change logs
+ *   // changeLog: false,
+ *
+ *   // Optional => To disable some columns from being logged
+ *   // changeLog: {
+ *   //   excludeColumns: (e) => {
+ *   //     return [e.password]
+ *   //   },
+ *   // },
+ * })
+ * export class User {}
+ * ```
+ *
+ * ## Manual way
+ * If you want to go more manual, you can import these functions and call them in your entity's lifecycle events.
+ * ```ts
+ * \@Entity<User>('users', {
+ *   saved: async (entity, e) => {
+ *     await recordSaved(entity, e)
+ *   },
+ *   deleted: async (entity, e) => {
+ *     await recordDeleted(entity, e)
+ *   },
+ * })
+ * export class User {}
+ * ```
+ */
+export declare const changeLog: () => Module;

package/esm/changeLog/server/index.js

@@ -0,0 +1,42 @@
+import { Module } from '../../api';
+import { ChangeLog } from '../index';
+/**
+ * ## Default way
+ * The easiest is to switch from `@Entity` to `@FF_Entity` to the entities where you want to log changes.
+ *
+ * ```ts
+ * \@FF_Entity<User>('users', {
+ *
+ *   // Optional => To disable change logs
+ *   // changeLog: false,
+ *
+ *   // Optional => To disable some columns from being logged
+ *   // changeLog: {
+ *   //   excludeColumns: (e) => {
+ *   //     return [e.password]
+ *   //   },
+ *   // },
+ * })
+ * export class User {}
+ * ```
+ *
+ * ## Manual way
+ * If you want to go more manual, you can import these functions and call them in your entity's lifecycle events.
+ * ```ts
+ * \@Entity<User>('users', {
+ *   saved: async (entity, e) => {
+ *     await recordSaved(entity, e)
+ *   },
+ *   deleted: async (entity, e) => {
+ *     await recordDeleted(entity, e)
+ *   },
+ * })
+ * export class User {}
+ * ```
+ */
+export const changeLog = () => {
+    return new Module({
+        name: 'changeLog',
+        entities: [ChangeLog],
+    });
+};

package/esm/cron/{index.d.ts → server/index.d.ts}

@@ -1,5 +1,5 @@
 import { CronJob } from 'cron';
-import type { Module } from '../api';
+import { Module } from '../../api';
 export declare const jobs: Record<string, {
     job: CronJob<null, unknown> | null;
     concurrentInProgress: number;

package/esm/cron/server/index.js

@@ -0,0 +1,103 @@
+import { CronJob } from 'cron';
+import { green, magenta, red, yellow } from '@kitql/helpers';
+import { Module } from '../../api';
+export const jobs = {};
+/**
+ * Link to a nice Cheatsheet TODO
+ */
+export const cronTime = {
+    /**
+     * Every morning is actually at 4 am and 7 minutes. (because I like this number!)
+     */
+    every_morning: '0 7 4 * * *',
+    /**
+     * Every second
+     */
+    every_second: '* * * * * *',
+    /**
+     * Every minute
+     */
+    every_minute: '0 * * * * *',
+    /**
+     * Every 10 minute
+     */
+    every_10_minute: '*/10 * * * *',
+    /**
+     * Every friday at 5:11 am
+     */
+    every_friday_morning: '11 5 * * 5',
+};
+/**
+ * usage:
+ *
+ * ```ts
+ * import { cron, cronTime } from 'firstly/cron'
+ *
+ * export const api = firstly({
+ *   modules: [
+ *     cron([{
+ *       topic: 'first_cron',
+ *       cronTime: cronTime.every_second,
+ *       onTick: () => { console.log('hello') },
+ *       start: !dev, // Start in production
+ *       // runOnInit: dev, // nice in dev environement
+ *     }])
+ *   ]
+ * })
+ * ```
+ *
+ * using [cron](https://www.npmjs.com/package/cron) library under the hood
+ */
+export const cron = (jobsInfos) => {
+    const m = new Module({
+        name: 'cron',
+    });
+    const logJobs = (topic, job, message, with_metadata = true, isSuccess = true) => {
+        const l = [];
+        l.push(magenta(`[${topic}]`));
+        l.push(message);
+        if (with_metadata) {
+            // If the job is "stopped", there will still be a next date, but it will not fire it. The job has to start.
+            l.push(`(${job.running ? green('running') : red('stopped')}, next at ${yellow(job.nextDate().toISO())})`);
+        }
+        if (isSuccess) {
+            m.log.success(l.join(' '));
+        }
+        else {
+            m.log.info(l.join(' '));
+        }
+    };
+    m.initApi = async () => {
+        jobsInfos.forEach((infos) => {
+            const { topic, runOnInit, logs, concurrent, ...params } = infos;
+            const concurrentToUse = concurrent ?? 1;
+            const onTickSaved = params.onTick;
+            const fullOnTick = async () => {
+                if (jobs[topic].concurrentInProgress < concurrentToUse) {
+                    jobs[topic].concurrentInProgress = jobs[topic].concurrentInProgress + 1;
+                    if (logs?.starting === undefined || logs?.starting === true) {
+                        logJobs(topic, job, 'starting...', false, false);
+                    }
+                    // @ts-ignore
+                    await onTickSaved();
+                    if (logs?.ended === undefined || logs?.ended === true) {
+                        logJobs(topic, job, 'done');
+                    }
+                    jobs[topic].concurrentInProgress = jobs[topic].concurrentInProgress - 1;
+                }
+                else {
+                    logJobs(topic, job, `skipped because of concurrent limit (${yellow(concurrentToUse.toString())})`, false, false);
+                }
+            };
+            params.onTick = fullOnTick;
+            const job = CronJob.from(params);
+            jobs[topic] = { job, concurrentInProgress: 0 };
+            logJobs(topic, job, 'setup done');
+            // If not it will be done too early
+            if (runOnInit) {
+                job.fireOnTick();
+            }
+        });
+    };
+    return m;
+};

package/esm/feedback/FeedbackController.js

@@ -4,13 +4,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { Allow, BackendMethod, remult } from 'remult';
+import { Allow, BackendMethod, EntityError, remult } from 'remult';
 import { stry } from '@kitql/helpers';
-import { FEEDBACK_OPTIONS } from '.';
+import { FEEDBACK_OPTIONS } from './server';
 const GITHUB_GRAPHQL_ENDPOINT = 'https://api.github.com/graphql';
 async function getGitHub(query, variables) {
     if (!FEEDBACK_OPTIONS.GITHUB_API_TOKEN) {
-        throw new Error('GITHUB_API_TOKEN not found in .env');
+        throw new EntityError({ message: 'GITHUB_API_TOKEN not found in .env' });
     }
     try {
         const headers = new Headers({

package/esm/feedback/index.d.ts

@@ -1,19 +1,3 @@
-import type { Module } from '../api';
 import { FeedbackController } from './FeedbackController';
 import { default as Feedback } from './ui/Feedback.svelte';
 export { FeedbackController, Feedback };
-type FeedbackOptions = {
-    GITHUB_API_TOKEN: string;
-    repo: {
-        owner: string;
-        name: string;
-    };
-    milestones?: {
-        title_filter?: string;
-        labels_filters?: string[];
-    };
-    highlight_label?: string;
-    create_label?: string;
-};
-export declare let FEEDBACK_OPTIONS: FeedbackOptions;
-export declare const feedback: (o: FeedbackOptions) => Module;

package/esm/feedback/index.js

@@ -1,14 +1,3 @@
 import { FeedbackController } from './FeedbackController';
 import { default as Feedback } from './ui/Feedback.svelte';
 export { FeedbackController, Feedback };
-export let FEEDBACK_OPTIONS = {
-    GITHUB_API_TOKEN: '',
-    repo: { owner: '', name: '' },
-};
-export const feedback = (o) => {
-    FEEDBACK_OPTIONS = o;
-    return {
-        name: 'feedback',
-        controllers: [FeedbackController],
-    };
-};

package/esm/feedback/server/index.d.ts

@@ -0,0 +1,17 @@
+import { Module } from '../../api';
+type FeedbackOptions = {
+    GITHUB_API_TOKEN: string;
+    repo: {
+        owner: string;
+        name: string;
+    };
+    milestones?: {
+        title_filter?: string;
+        labels_filters?: string[];
+    };
+    highlight_label?: string;
+    create_label?: string;
+};
+export declare let FEEDBACK_OPTIONS: FeedbackOptions;
+export declare const feedback: (o: FeedbackOptions) => Module;
+export {};

package/esm/feedback/server/index.js

@@ -0,0 +1,13 @@
+import { Module } from '../../api';
+import { FeedbackController } from '../FeedbackController';
+export let FEEDBACK_OPTIONS = {
+    GITHUB_API_TOKEN: '',
+    repo: { owner: '', name: '' },
+};
+export const feedback = (o) => {
+    FEEDBACK_OPTIONS = o;
+    return new Module({
+        name: 'feedback',
+        controllers: [FeedbackController],
+    });
+};

package/esm/helper.js

@@ -1,4 +1,4 @@
-import { getEntityRef, getValueList } from 'remult';
+import { EntityError, getEntityRef, getValueList } from 'remult';
 import { getRelationFieldInfo } from 'remult/internals';
 import { suffixWithS } from './formats/strings.js';
 export function isError(object) {
@@ -76,7 +76,7 @@ export const getFieldMetaType = (field) => {
             kind: 'enum',
             subKind: 'single',
             // @ts-ignore
-            values: field.options.valueConverter.values,
+            values: field.options.valueConverter.values.filter((v) => !v.hide),
             field,
         };
     }
@@ -147,7 +147,7 @@ export const onDelete = async (item, e, mode = 'prevent') => {
     if (nonEmptyRelations.length > 0) {
         if (mode === 'prevent') {
             const relationNames = nonEmptyRelations.map((r) => r.f.caption).join(', ');
-            throw Error(`Can't with existing: ${relationNames}`);
+            throw new EntityError({ message: `Can't with existing: ${relationNames}` });
         }
         else if (mode === 'cascade') {
             nonEmptyRelations.forEach(async (r) => {

package/esm/index.d.ts

@@ -1,10 +1,8 @@
-import type { RequestEvent } from '@sveltejs/kit';
 import type { FindOptionsBase } from 'remult';
 import { Log } from '@kitql/helpers';
 import type { BaseEnum, BaseItem, FF_Icon } from './BaseEnum.js';
 import type { CellsInput as CellsInput_ForExport } from './cellsBuildor.js';
 import type { ColumnDeciderArgs } from './changeLog/index.js';
-import { default as DefaultMail } from './mail/templates/DefaultMail.svelte';
 import { storeItem } from './storeItem.js';
 import { storeList } from './storeList.js';
 import { default as Button } from './ui/Button.svelte';
@@ -23,10 +21,10 @@ import { default as Link } from './ui/link/Link.svelte';
 import { default as LinkPlus } from './ui/link/LinkPlus.svelte';
 import { default as Loading } from './ui/Loading.svelte';
 import { default as Tooltip } from './ui/Tooltip.svelte';
-export { Field, FormEditAction, Grid, GridPaginate, FieldGroup, Icon, Link, LinkPlus, Loading, Button, Tooltip, DialogManagement, FieldContainer, SelectMelt, Clipboardable, DefaultMail, };
+export { Field, FormEditAction, Grid, GridPaginate, FieldGroup, Icon, Link, LinkPlus, Loading, Button, Tooltip, DialogManagement, FieldContainer, SelectMelt, Clipboardable, };
 export declare const ff_Log: Log;
 export declare const FF_Role: {
-    Admin: string;
+    readonly FF_Role_Admin: "FF_Role.Admin";
 };
 export type { BaseEnumOptions } from './BaseEnum.js';
 export type { BaseItem };
@@ -55,12 +53,6 @@ export { UIEntity } from './virtual/UIEntity.js';
 export { LibIcon_Empty, LibIcon_Forbidden, LibIcon_ChevronDown, LibIcon_ChevronUp, LibIcon_ChevronLeft, LibIcon_ChevronRight, LibIcon_Search, LibIcon_Check, LibIcon_MultiCheck, LibIcon_Add, LibIcon_MultiAdd, LibIcon_Edit, LibIcon_Delete, LibIcon_Cross, LibIcon_Save, LibIcon_Man, LibIcon_Woman, LibIcon_Send, LibIcon_Load, LibIcon_Settings, LibIcon_Sort, LibIcon_SortAsc, LibIcon_SortDesc, } from './ui/LibIcon.js';
 export type { FF_Icon };
 declare module 'remult' {
-    interface RemultContext {
-        url: URL;
-        setHeaders(headers: Record<string, string>): void;
-        setCookie(...args: Parameters<RequestEvent['cookies']['set']>): void;
-        deleteCookie(...args: Parameters<RequestEvent['cookies']['delete']>): void;
-    }
     interface FieldOptions<entityType, valueType> {
         placeholder?: string;
         suffix?: string;
@@ -90,10 +82,4 @@ declare module 'remult' {
         permissionApiUpdate?: BaseEnum[] | BaseEnum;
         changeLog?: false | ColumnDeciderArgs<entityType>;
     }
-    interface UserInfo {
-        session: {
-            id: string;
-            expiresAt: Date;
-        };
-    }
 }

package/esm/index.js

@@ -1,5 +1,4 @@
 import { Log } from '@kitql/helpers';
-import { default as DefaultMail } from './mail/templates/DefaultMail.svelte';
 import { storeItem } from './storeItem.js';
 import { storeList } from './storeList.js';
 import { default as Button } from './ui/Button.svelte';
@@ -20,13 +19,13 @@ import { default as Tooltip } from './ui/Tooltip.svelte';
 // ******************************
 // Svelte Components
 // ******************************
-export { Field, FormEditAction, Grid, GridPaginate, FieldGroup, Icon, Link, LinkPlus, Loading, Button, Tooltip, DialogManagement, FieldContainer, SelectMelt, Clipboardable, DefaultMail, };
+export { Field, FormEditAction, Grid, GridPaginate, FieldGroup, Icon, Link, LinkPlus, Loading, Button, Tooltip, DialogManagement, FieldContainer, SelectMelt, Clipboardable, };
 // ******************************
 // Objects
 // ******************************
 export const ff_Log = new Log('firstly');
 export const FF_Role = {
-    Admin: 'FF_Role.Admin',
+    FF_Role_Admin: 'FF_Role.Admin',
 };
 // ******************************
 // Helpers

package/esm/mail/index.d.ts

@@ -1,30 +1,2 @@
-import type * as typeNodemailer from 'nodemailer';
-import type JSONTransport from 'nodemailer/lib/json-transport';
-import type Mail from 'nodemailer/lib/mailer';
-import type SendmailTransport from 'nodemailer/lib/sendmail-transport';
-import type SESTransport from 'nodemailer/lib/ses-transport';
-import type SMTPPool from 'nodemailer/lib/smtp-pool';
-import type SMTPTransport from 'nodemailer/lib/smtp-transport';
-import type StreamTransport from 'nodemailer/lib/stream-transport';
-import type { ComponentProps, ComponentType, SvelteComponent } from 'svelte';
-import { DefaultMail } from '../';
-export type TransportTypes = SMTPTransport | SMTPTransport.Options | string | SMTPPool | SMTPPool.Options | SendmailTransport | SendmailTransport.Options | StreamTransport | StreamTransport.Options | JSONTransport | JSONTransport.Options | SESTransport | SESTransport.Options | typeNodemailer.Transport<any> | typeNodemailer.TransportOptions;
-export type DefaultOptions = SMTPTransport.Options | SMTPPool.Options | SendmailTransport.Options | StreamTransport.Options | JSONTransport.Options | SESTransport.Options | typeNodemailer.TransportOptions;
-export type MailOptions<ComponentTemplateDefault extends SvelteComponent> = {
-    from?: Mail.Options['from'];
-    template?: {
-        component?: ComponentType<ComponentTemplateDefault>;
-        brandColor?: string;
-    };
-    transport?: TransportTypes;
-    defaults?: DefaultOptions;
-    apiUrl?: Parameters<typeof typeNodemailer.createTestAccount>[0];
-};
-declare let transporter: ReturnType<typeof typeNodemailer.createTransport>;
-export declare const mailInit: (nodemailer: typeof typeNodemailer, o?: MailOptions<SvelteComponent>) => void;
-export declare const sendMail: <ComponentTemplateDefault extends SvelteComponent = DefaultMail>(
-/** usefull for logs, it has NO impact on the mail itself */
-topic: string, mailOptions: Parameters<typeof transporter.sendMail>[0] & {
-    templateProps?: ComponentProps<ComponentTemplateDefault> | undefined;
-}) => ReturnType<typeof transporter.sendMail>;
-export {};
+import { default as DefaultMail } from './templates/DefaultMail.svelte';
+export { DefaultMail };

package/esm/mail/index.js

@@ -1,79 +1,2 @@
-import { render } from 'svelty-email';
-import { cyan, green, Log, magenta, red, sleep, white } from '@kitql/helpers';
-import { DefaultMail } from '../';
-const log = new Log('firstly | mail');
-let nodemailerHolder;
-let transporter;
-let globalOptions;
-export const mailInit = async (nodemailer, o) => {
-    nodemailerHolder = nodemailer;
-    globalOptions = o;
-    if (o?.transport) {
-        transporter = nodemailerHolder.createTransport(o?.transport, o?.defaults);
-    }
-    else {
-        try {
-            nodemailer.createTestAccount(globalOptions?.apiUrl ?? '', (err, account) => {
-                if (account) {
-                    globalOptions = { ...globalOptions, from: account.user };
-                    transporter = nodemailer.createTransport({
-                        host: account.smtp.host,
-                        port: account.smtp.port,
-                        secure: account.smtp.secure,
-                        auth: {
-                            user: account.user,
-                            pass: account.pass,
-                        },
-                    });
-                }
-                else {
-                    log.error("Error nodemailer.createTestAccount() can't be done.");
-                }
-            });
-        }
-        catch (error) {
-            log.error("Error nodemailer.createTestAccount() can't be done.");
-        }
-    }
-};
-export const sendMail = async (topic, mailOptions) => {
-    // if the transporter is not ready, wait for it! (it can happen only if nothing is set...)
-    for (let i = 0; i < 30; i++) {
-        if (transporter !== undefined) {
-            break;
-        }
-        await sleep(100);
-    }
-    try {
-        if (!mailOptions.html) {
-            const template = globalOptions?.template?.component ?? DefaultMail;
-            const props = {
-                brandColor: globalOptions?.template?.brandColor ?? '#5B68DF',
-                ...mailOptions.templateProps,
-            };
-            mailOptions.text = render({ template, props, options: { plainText: true, pretty: true } });
-            mailOptions.html = render({ template, props, options: { plainText: false, pretty: true } });
-        }
-        const info = await transporter.sendMail({
-            ...mailOptions,
-            ...{ from: mailOptions.from ?? globalOptions?.from },
-        });
-        if (!globalOptions?.transport) {
-            log.error(`${magenta(`[${topic}]`)} - ⚠️  ${red(`mail not configured`)} ⚠️ 
-                 We are still nice and generated you an email preview link: 
-                 👉 ${cyan(String(nodemailerHolder.getTestMessageUrl(
-            // @ts-ignore
-            info)))}
-
-                 To really send mails, check out the doc ${white(`https://firstly.fun/modules/mail`)}. 
-      `);
-        }
-        else {
-            log.success(`${magenta(`[${topic}]`)} - Sent to ${typeof mailOptions.to === 'string' ? green(mailOptions.to) : mailOptions.to}`);
-        }
-        return info;
-    }
-    catch (error) {
-        log.error(`${magenta(`[${topic}]`)} - Error`, error);
-    }
-};
+import { default as DefaultMail } from './templates/DefaultMail.svelte';
+export { DefaultMail };

package/esm/mail/server/index.d.ts

@@ -0,0 +1,31 @@
+import type * as typeNodemailer from 'nodemailer';
+import type JSONTransport from 'nodemailer/lib/json-transport';
+import type Mail from 'nodemailer/lib/mailer';
+import type SendmailTransport from 'nodemailer/lib/sendmail-transport';
+import type SESTransport from 'nodemailer/lib/ses-transport';
+import type SMTPPool from 'nodemailer/lib/smtp-pool';
+import type SMTPTransport from 'nodemailer/lib/smtp-transport';
+import type StreamTransport from 'nodemailer/lib/stream-transport';
+import type { ComponentProps, ComponentType, SvelteComponent } from 'svelte';
+import { Module } from '../../api';
+import { default as DefaultMail } from '../templates/DefaultMail.svelte';
+export type TransportTypes = SMTPTransport | SMTPTransport.Options | string | SMTPPool | SMTPPool.Options | SendmailTransport | SendmailTransport.Options | StreamTransport | StreamTransport.Options | JSONTransport | JSONTransport.Options | SESTransport | SESTransport.Options | typeNodemailer.Transport<any> | typeNodemailer.TransportOptions;
+export type DefaultOptions = SMTPTransport.Options | SMTPPool.Options | SendmailTransport.Options | StreamTransport.Options | JSONTransport.Options | SESTransport.Options | typeNodemailer.TransportOptions;
+export type MailOptions<ComponentTemplateDefault extends SvelteComponent> = {
+    from?: Mail.Options['from'];
+    template?: {
+        component?: ComponentType<ComponentTemplateDefault>;
+        brandColor?: string;
+    };
+    transport?: TransportTypes;
+    defaults?: DefaultOptions;
+    apiUrl?: Parameters<typeof typeNodemailer.createTestAccount>[0];
+};
+declare let transporter: ReturnType<typeof typeNodemailer.createTransport>;
+export declare const sendMail: <ComponentTemplateDefault extends SvelteComponent = DefaultMail>(
+/** usefull for logs, it has NO impact on the mail itself */
+topic: string, mailOptions: Parameters<typeof transporter.sendMail>[0] & {
+    templateProps?: ComponentProps<ComponentTemplateDefault> | undefined;
+}) => ReturnType<typeof transporter.sendMail>;
+export declare const mail: (o?: MailOptions<SvelteComponent>) => Module;
+export {};