@silexlabs/silex 3.0.1-alpha.0 → 3.0.1

package/dist/plugins/server/server/connectors/connectors.d.ts

@@ -0,0 +1,86 @@
+import { Readable } from 'stream';
+import { ServerConfig } from '../config';
+import { JobStatus, JobData, ConnectorData, ConnectorId, WebsiteId, ConnectorType, ConnectorUser, WebsiteMeta, WebsiteMetaFileContent, WebsiteData, ConnectorOptions } from '../../types';
+import { JobManager } from '../jobs';
+/**
+ * @fileoverview define types for Silex connectors
+ * Bakends can provide storage for website data and assets, and/or hosting to publish the website online
+ */
+/**
+ * Connector data stored in the website meta file
+ */
+export type ConnectorFileContent = string | Buffer | Readable;
+/**
+ * Files are stored in connector as a File object
+ * @see types/ClientSideFile
+ * @see contentToString()
+ */
+export interface ConnectorFile {
+    path: string;
+    content: ConnectorFileContent;
+}
+/**
+ * Callback to update the publication status
+ */
+export type StatusCallback = ({ message, status }: {
+    message: string;
+    status: JobStatus;
+}) => Promise<void>;
+export type ConnectorSession = object;
+/**
+ * Connectors are the base interface for Storage and Hosting connectors
+ */
+export interface Connector<Session extends ConnectorSession = ConnectorSession> {
+    connectorId: ConnectorId;
+    connectorType: ConnectorType;
+    displayName: string;
+    icon: string;
+    disableLogout?: boolean;
+    color: string;
+    background: string;
+    getOAuthUrl(session: Session): Promise<string | null>;
+    getLoginForm(session: Session, redirectTo: string): Promise<string | null>;
+    getSettingsForm(session: Session, redirectTo: string): Promise<string | null>;
+    isLoggedIn(session: Session): Promise<boolean>;
+    setToken(session: Session, token: object): Promise<void>;
+    logout(session: Session): Promise<void>;
+    getUser(session: Session): Promise<ConnectorUser | null>;
+    getOptions(formData: object): ConnectorOptions;
+}
+/**
+ * Storage are used to store the website data and assets
+ * And possibly rename files and directories, and get the URL of a file
+ *
+ */
+export interface StorageConnector<Session extends ConnectorSession = ConnectorSession> extends Connector<Session> {
+    listWebsites(session: Session): Promise<WebsiteMeta[]>;
+    readWebsite(session: Session, websiteId: WebsiteId): Promise<WebsiteData | Readable>;
+    createWebsite(session: Session, data: WebsiteMetaFileContent): Promise<WebsiteId>;
+    updateWebsite(session: Session, websiteId: WebsiteId, data: WebsiteData): Promise<void>;
+    deleteWebsite(session: Session, websiteId: WebsiteId): Promise<void>;
+    duplicateWebsite(session: Session, websiteId: WebsiteId): Promise<void>;
+    writeAssets(session: Session, websiteId: WebsiteId, files: ConnectorFile[], status?: StatusCallback): Promise<string[] | void>;
+    readAsset(session: Session, websiteId: WebsiteId, fileName: string): Promise<ConnectorFileContent>;
+    deleteAssets(session: Session, websiteId: WebsiteId, fileNames: string[]): Promise<void>;
+    getWebsiteMeta(session: Session, websiteId: WebsiteId): Promise<WebsiteMeta>;
+    setWebsiteMeta(session: Session, websiteId: WebsiteId, data: WebsiteMetaFileContent): Promise<void>;
+}
+/**
+ * Hosting connectors are used to publish the website
+ */
+export interface HostingConnector<Session extends ConnectorSession = ConnectorSession> extends Connector<Session> {
+    publish(session: Session, websiteId: WebsiteId, files: ConnectorFile[], jobManager: JobManager): Promise<JobData>;
+    getUrl(session: Session, websiteId: WebsiteId): Promise<string>;
+}
+export declare function toConnectorEnum(type: string | ConnectorType): ConnectorType;
+/**
+ * Get a connector by id or by type
+ */
+export declare function getConnector<T extends Connector>(config: ServerConfig, session: any, type: ConnectorType, connectorId?: ConnectorId): Promise<T | undefined>;
+/**
+ * Convert a connector to a ConnectorData object to be sent to the frontend
+ */
+export declare function toConnectorData(session: any, connector: Connector): Promise<ConnectorData>;
+export declare function contentToString(content: ConnectorFileContent): Promise<string>;
+export declare function contentToBuffer(content: ConnectorFileContent): Promise<Buffer>;
+export declare function contentToReadable(content: ConnectorFileContent): Readable;

package/dist/plugins/server/server/connectors/connectors.js

@@ -0,0 +1,126 @@
+"use strict";
+/*
+ * Silex website builder, free/libre no-code tool for makers.
+ * Copyright (c) 2023 lexoyo and Silex Labs foundation
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toConnectorEnum = toConnectorEnum;
+exports.getConnector = getConnector;
+exports.toConnectorData = toConnectorData;
+exports.contentToString = contentToString;
+exports.contentToBuffer = contentToBuffer;
+exports.contentToReadable = contentToReadable;
+const stream_1 = require("stream");
+const types_1 = require("../../types");
+function toConnectorEnum(type) {
+    const result = types_1.ConnectorType[type.toString().toUpperCase()];
+    if (!result)
+        throw new Error(`Unknown connector type ${type}. It should be one of ${Object.keys(types_1.ConnectorType).join(', ')}`);
+    return result;
+}
+/**
+ * Get a connector by id or by type
+ */
+async function getConnector(config, session, type, connectorId) {
+    // Get the connectors for this type
+    const connectors = config.getConnectors(type);
+    // Find the connector by id
+    if (connectorId)
+        return connectors.find(s => s.connectorId === connectorId && s.connectorType === type);
+    // Find the first logged in connector
+    for (const connector of connectors) {
+        if (await connector.isLoggedIn(session)) {
+            return connector;
+        }
+    }
+    // Defaults to the first connector
+    return connectors[0];
+}
+/**
+ * Convert a connector to a ConnectorData object to be sent to the frontend
+ */
+async function toConnectorData(session, connector) {
+    return {
+        connectorId: connector.connectorId,
+        type: connector.connectorType,
+        displayName: connector.displayName,
+        icon: connector.icon,
+        disableLogout: !!connector.disableLogout,
+        isLoggedIn: await connector.isLoggedIn(session),
+        oauthUrl: await connector.getOAuthUrl(session),
+        color: connector.color,
+        background: connector.background,
+    };
+}
+async function contentToString(content) {
+    // String
+    if (typeof content === 'string')
+        return content;
+    // Buffer
+    if (Buffer.isBuffer(content))
+        return content.toString('utf8');
+    // Stream
+    return new Promise((resolve, reject) => {
+        let result = '';
+        content.on('data', (chunk) => {
+            result += chunk.toString('utf8');
+        });
+        content.on('error', (err) => {
+            reject(err);
+        });
+        content.on('end', () => {
+            resolve(result);
+        });
+    });
+}
+async function contentToBuffer(content) {
+    // String
+    if (typeof content === 'string')
+        return Buffer.from(content, 'utf8');
+    // Buffer
+    if (Buffer.isBuffer(content))
+        return content;
+    // Stream
+    if (content instanceof stream_1.Readable) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            content.on('data', (chunk) => {
+                chunks.push(chunk);
+            });
+            content.on('error', (err) => {
+                reject(err);
+            });
+            content.on('end', () => {
+                resolve(Buffer.concat(chunks));
+            });
+        });
+    }
+    // Unknown
+    throw new Error('Unknown content type');
+}
+function contentToReadable(content) {
+    // String
+    if (typeof content === 'string')
+        return stream_1.Readable.from([content]);
+    // Buffer
+    if (Buffer.isBuffer(content))
+        return stream_1.Readable.from([content]);
+    // Stream
+    if (content instanceof stream_1.Readable)
+        return content;
+    // Unknown
+    throw new Error('Unknown content type');
+}
+//# sourceMappingURL=connectors.js.map

package/dist/plugins/server/server/connectors/connectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.js","sourceRoot":"","sources":["../../../../../src/ts/server/connectors/connectors.ts"],"names":[],"mappings":"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"}

package/dist/plugins/server/server/events.d.ts

@@ -0,0 +1,26 @@
+import { ConnectorId, PublicationData, WebsiteData, WebsiteId } from '../types';
+import { ConnectorFile } from './connectors/connectors';
+export declare enum ServerEvent {
+    STARTUP_START = "startup-start",
+    STARTUP_END = "startup-end",
+    PUBLISH_START = "publish-start",
+    PUBLISH_END = "publish-end",
+    WEBSITE_STORE_START = "store-start",
+    WEBSITE_STORE_END = "store-end",
+    WEBSITE_ASSET_STORE_START = "asset-store-start",
+    WEBSITE_ASSET_STORE_END = "asset-store-end"
+}
+export type PublishStartEventType = PublicationData;
+export type PublishEndEventType = Error | null;
+export type WebsiteStoreStartEventType = {
+    websiteId: WebsiteId;
+    websiteData: WebsiteData;
+    connectorId: ConnectorId;
+};
+export type WebsiteStoreEndEventType = Error | null;
+export type WebsiteAssetStoreStartEventType = {
+    files: ConnectorFile[];
+    websiteId: WebsiteId;
+    connectorId: ConnectorId;
+};
+export type WebsiteAssetStoreEndEventType = Error | null;

package/dist/plugins/server/server/events.js

@@ -0,0 +1,31 @@
+"use strict";
+/*
+ * Silex website builder, free/libre no-code tool for makers.
+ * Copyright (c) 2023 lexoyo and Silex Labs foundation
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerEvent = void 0;
+var ServerEvent;
+(function (ServerEvent) {
+    ServerEvent["STARTUP_START"] = "startup-start";
+    ServerEvent["STARTUP_END"] = "startup-end";
+    ServerEvent["PUBLISH_START"] = "publish-start";
+    ServerEvent["PUBLISH_END"] = "publish-end";
+    ServerEvent["WEBSITE_STORE_START"] = "store-start";
+    ServerEvent["WEBSITE_STORE_END"] = "store-end";
+    ServerEvent["WEBSITE_ASSET_STORE_START"] = "asset-store-start";
+    ServerEvent["WEBSITE_ASSET_STORE_END"] = "asset-store-end";
+})(ServerEvent || (exports.ServerEvent = ServerEvent = {}));
+//# sourceMappingURL=events.js.map

package/dist/plugins/server/server/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../src/ts/server/events.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAKH,IAAY,WASX;AATD,WAAY,WAAW;IACrB,8CAA+B,CAAA;IAC/B,0CAA2B,CAAA;IAC3B,8CAA+B,CAAA;IAC/B,0CAA2B,CAAA;IAC3B,kDAAmC,CAAA;IACnC,8CAA+B,CAAA;IAC/B,8DAA+C,CAAA;IAC/C,0DAA2C,CAAA;AAC7C,CAAC,EATW,WAAW,2BAAX,WAAW,QAStB"}

package/dist/plugins/server/server/jobs.d.ts

@@ -0,0 +1,12 @@
+import { JobData, JobId } from '../types';
+export declare function startJob(message?: string): JobData;
+export declare function getJob(id: JobId): JobData | undefined;
+export declare function jobSuccess(id: JobId, message?: string): boolean;
+export declare function jobError(id: JobId, message?: string): boolean;
+export declare function killJob(job: JobData): void;
+export interface JobManager {
+    startJob: typeof startJob;
+    jobSuccess: typeof jobSuccess;
+    jobError: typeof jobError;
+}
+export declare const jobManager: JobManager;

package/dist/plugins/server/server/jobs.js

@@ -0,0 +1,79 @@
+"use strict";
+/*
+ * Silex website builder, free/libre no-code tool for makers.
+ * Copyright (c) 2023 lexoyo and Silex Labs foundation
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jobManager = void 0;
+exports.startJob = startJob;
+exports.getJob = getJob;
+exports.jobSuccess = jobSuccess;
+exports.jobError = jobError;
+exports.killJob = killJob;
+const types_1 = require("../types");
+// Delay after which the job is deleted from memory
+const TIME_TO_KEEP_AFTER_STOP = 60 * 10 * 1000; // 10 min
+// Store the jobs in memory
+const jobs = new Array();
+const timers = new WeakMap();
+// Key which will change on server restart
+const processKey = Math.ceil(Math.random() * 1000000);
+// Next id for the next job
+let nextJobId = 0;
+// Create a new job
+function startJob(message = '') {
+    const jobId = `${processKey}_${++nextJobId}`;
+    const job = {
+        jobId,
+        status: types_1.JobStatus.IN_PROGRESS,
+        message: message
+    };
+    jobs.push(job);
+    return job;
+}
+// Retriev a job if it exists
+function getJob(id) {
+    return jobs.find(job => job.jobId === id);
+}
+// End the job with success
+function jobSuccess(id, message = '') {
+    return end(id, types_1.JobStatus.SUCCESS, message);
+}
+// End the job with error
+function jobError(id, message = '') {
+    return end(id, types_1.JobStatus.ERROR, message);
+}
+// Remove a job from memory
+// This is also used in unit tests to avoid memory lea
+function killJob(job) {
+    clearTimeout(timers.get(job));
+    timers.delete(job);
+    jobs.splice(jobs.findIndex(j => job.jobId === j.jobId), 1);
+}
+// End the job
+function end(id, status, message = '') {
+    const job = getJob(id);
+    if (job) {
+        job.status = status;
+        if (message)
+            job.message = message;
+        timers.set(job, setTimeout(() => killJob(job), TIME_TO_KEEP_AFTER_STOP));
+        return true;
+    }
+    return false;
+}
+// Export the job manager
+exports.jobManager = { startJob, jobSuccess, jobError };
+//# sourceMappingURL=jobs.js.map

package/dist/plugins/server/server/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../../../src/ts/server/jobs.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAkBH,4BASC;AAGD,wBAEC;AAID,gCAEC;AAGD,4BAEC;AAID,0BAIC;AAjDD,oCAAoD;AAEpD,mDAAmD;AACnD,MAAM,uBAAuB,GAAG,EAAE,GAAC,EAAE,GAAC,IAAI,CAAA,CAAC,SAAS;AAEpD,2BAA2B;AAC3B,MAAM,IAAI,GAAG,IAAI,KAAK,EAAW,CAAA;AACjC,MAAM,MAAM,GAAG,IAAI,OAAO,EAA2B,CAAA;AAErD,0CAA0C;AAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAA;AAErD,2BAA2B;AAC3B,IAAI,SAAS,GAAG,CAAC,CAAA;AAEjB,mBAAmB;AACnB,SAAgB,QAAQ,CAAC,OAAO,GAAG,EAAE;IACnC,MAAM,KAAK,GAAG,GAAG,UAAU,IAAI,EAAE,SAAS,EAAE,CAAA;IAC5C,MAAM,GAAG,GAAY;QACnB,KAAK;QACL,MAAM,EAAE,iBAAS,CAAC,WAAW;QAC7B,OAAO,EAAE,OAAO;KACjB,CAAA;IACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACd,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,6BAA6B;AAC7B,SAAgB,MAAM,CAAC,EAAS;IAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAA;AAC3C,CAAC;AAGD,2BAA2B;AAC3B,SAAgB,UAAU,CAAC,EAAS,EAAE,OAAO,GAAG,EAAE;IAChD,OAAO,GAAG,CAAC,EAAE,EAAE,iBAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAC5C,CAAC;AAED,yBAAyB;AACzB,SAAgB,QAAQ,CAAC,EAAS,EAAE,OAAO,GAAG,EAAE;IAC9C,OAAO,GAAG,CAAC,EAAE,EAAE,iBAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;AAC1C,CAAC;AAED,2BAA2B;AAC3B,sDAAsD;AACtD,SAAgB,OAAO,CAAC,GAAY;IAClC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;IAC7B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED,cAAc;AACd,SAAS,GAAG,CAAC,EAAS,EAAE,MAAiB,EAAE,OAAO,GAAG,EAAE;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,CAAA;IACtB,IAAG,GAAG,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,GAAG,MAAM,CAAA;QACnB,IAAG,OAAO;YAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;QACjC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAA;QACxE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AASD,yBAAyB;AACZ,QAAA,UAAU,GAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAA"}

package/dist/plugins/server/server/utils/validation.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Throw an error if a parameter is missing
+ * @param value the value to check
+ * @param name the name of the parameter
+ * @throws Error if the parameter is missing
+ */
+export declare function requiredParam<T>(value: T | undefined, name: string, defaultValue?: T): NonNullable<T>;

package/dist/plugins/server/server/utils/validation.js

@@ -0,0 +1,37 @@
+"use strict";
+/*
+ * Silex website builder, free/libre no-code tool for makers.
+ * Copyright (c) 2023 lexoyo and Silex Labs foundation
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requiredParam = requiredParam;
+/**
+ * Throw an error if a parameter is missing
+ * @param value the value to check
+ * @param name the name of the parameter
+ * @throws Error if the parameter is missing
+ */
+function requiredParam(value, name, defaultValue) {
+    if (value === undefined) {
+        if (defaultValue !== undefined) {
+            return defaultValue;
+        }
+        const error = new Error(`Missing required parameter ${name}`);
+        console.error(`Missing required parameter ${name}`, error);
+        throw error;
+    }
+    return value;
+}
+//# sourceMappingURL=validation.js.map

package/dist/plugins/server/server/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../../src/ts/server/utils/validation.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AAQH,sCAUC;AAhBD;;;;;GAKG;AACH,SAAgB,aAAa,CAAI,KAAoB,EAAE,IAAY,EAAE,YAAgB;IACnF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,YAA8B,CAAA;QACvC,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAA;QAC7D,OAAO,CAAC,KAAK,CAAC,8BAA8B,IAAI,EAAE,EAAE,KAAK,CAAC,CAAA;QAC1D,MAAM,KAAK,CAAA;IACb,CAAC;IACD,OAAO,KAAuB,CAAA;AAChC,CAAC"}