mlcl 1.0.0

package/build/API/resource/molecule/index.js

@@ -0,0 +1,12 @@
+/**
+ * The `molecule` API resource.
+ *
+ * @module
+ */
+import { client } from '../../client.js';
+export * as types from './types.js';
+export const read = (id) => (client.get(`molecules/${id}`));
+export const readClone = (id) => (client.get(`molecules/${id}/clone`));
+export const create = (props) => (client.post(`molecules`, props));
+export const update = (id, props) => (client.patch(`molecules/${id}`, props));
+export const updatePlan = (id, { planKey, receipt, quantity }) => (client.patch(`molecules/${id}/plan`, { planKey, receipt, quantity }));

package/build/API/resource/molecule/types.js

@@ -0,0 +1,6 @@
+/**
+ * Molecule type definitions.
+ *
+ * @module
+ */
+export {};

package/build/API/resource/molecule/utilities/getPlan.js

@@ -0,0 +1,15 @@
+import { plans } from '../../payment/plans.js';
+/**
+ * Gets a molecule's current `plan`.
+ */
+export const getPlan = (molecule) => {
+    let plan = plans[''];
+    const planExpiresTime = (molecule.planExpiresAt && new Date(String(molecule.planExpiresAt)).getTime()) || 0;
+    if (molecule.planKey && plans[molecule.planKey] && (!planExpiresTime || (Date.now() < planExpiresTime))) {
+        plan = plans[molecule.planKey];
+    }
+    plan = {
+        ...plan,
+    };
+    return plan;
+};

package/build/API/resource/molecule/utilities/index.js

@@ -0,0 +1,6 @@
+/**
+ * Molecule resource utilities.
+ *
+ * @module
+ */
+export * from './getPlan.js';

package/build/API/resource/payment/index.js

@@ -0,0 +1,9 @@
+/**
+ * The `payment` resource properties.
+ *
+ * @module
+ */
+export * as platforms from './platforms/index.js';
+export * from './plans.js';
+export * from './platform.js';
+export * as types from './types.js';

package/build/API/resource/payment/plans.js

@@ -0,0 +1,28 @@
+import * as platforms from './platforms/index.js';
+const defaultPlan = {
+    planKey: ``,
+    platformKey: ``,
+    platformProductId: ``,
+    alias: ``,
+    period: ``,
+    price: ``,
+    title: `Free`,
+    description: `Certain features are limited. Upgrade your plan to unlock premium features.`,
+    shortDescription: `Limited features and usage.`,
+    capabilities: {},
+};
+/**
+ * A map of every available `planKey` to `plan`.
+ *
+ * Every plan key for every platform should be unique.
+ * E.g., `appleMonthly` and `appleYearly` vs `googleMonthly` and `googleYearly`.
+ *
+ * You'll need to customize the `Plan` type, adding properties and logic surrounding it
+ * as necessary for your particular application.
+ */
+export const plans = {
+    '': defaultPlan,
+    ...platforms.stripe.plans,
+    ...platforms.google.plans,
+    ...platforms.apple.plans,
+};

package/build/API/resource/payment/platform.js

@@ -0,0 +1,7 @@
+import * as platforms from './platforms/index.js';
+/**
+ * The payment platform for the current app platform.
+ */
+export const platform = Object.values(platforms).find(platform => (Array.isArray(platform.appPlatforms)
+    ? platform.appPlatforms.includes(process.env.APP_PLATFORM || undefined)
+    : (platform.appPlatforms || undefined) === (process.env.APP_PLATFORM || undefined)));

package/build/API/resource/payment/platforms/apple/index.js

@@ -0,0 +1,21 @@
+/**
+ * Properties and methods for handling payments through Apple.
+ *
+ * @module
+ */
+import * as plans from './plans/index.js';
+/**
+ * The Apple Pay payment platform.
+ */
+export const apple = {
+    /**
+     * An array of app platforms compatible with Apple Pay.
+     */
+    appPlatforms: [
+        `ios`,
+    ],
+    /**
+     * A map of Apple plan keys to plan properties.
+     */
+    plans,
+};

package/build/API/resource/payment/platforms/apple/plans/appleMonthly.js

@@ -0,0 +1,17 @@
+/**
+ * The monthly Apple Pay plan.
+ */
+export const appleMonthly = {
+    planKey: `appleMonthly`,
+    platformKey: `apple`,
+    platformProductId: `molecule_monthly_early_adopter`,
+    alias: `monthly`,
+    period: `month`,
+    price: `$5.99`,
+    autoRenews: true,
+    title: `Monthly`,
+    description: `Create and view attachments.`,
+    capabilities: {
+        attachments: true,
+    }
+};

package/build/API/resource/payment/platforms/apple/plans/appleYearly.js

@@ -0,0 +1,18 @@
+/**
+ * The yearly Apple Pay plan.
+ */
+export const appleYearly = {
+    planKey: `appleYearly`,
+    platformKey: `apple`,
+    platformProductId: `molecule_yearly_early_adopter`,
+    alias: `yearly`,
+    period: `year`,
+    price: `$64.99`,
+    autoRenews: true,
+    title: `Yearly`,
+    description: `Create and view attachments.`,
+    highlightedDescription: `Get one month free, every year.`,
+    capabilities: {
+        attachments: true,
+    }
+};

package/build/API/resource/payment/platforms/apple/plans/index.js

@@ -0,0 +1,7 @@
+/**
+ * Every available Apple Pay plan.
+ *
+ * @module
+ */
+export * from './appleMonthly.js';
+export * from './appleYearly.js';

package/build/API/resource/payment/platforms/google/index.js

@@ -0,0 +1,21 @@
+/**
+ * Properties and methods for handling payments through Google.
+ *
+ * @module
+ */
+import * as plans from './plans/index.js';
+/**
+ * The Google Pay payment platform.
+ */
+export const google = {
+    /**
+     * An array of app platforms compatible with Google Pay.
+     */
+    appPlatforms: [
+        `android`,
+    ],
+    /**
+     * A map of Google plan keys to plan properties.
+     */
+    plans,
+};

package/build/API/resource/payment/platforms/google/plans/googleMonthly.js

@@ -0,0 +1,17 @@
+/**
+ * The monthly Google Pay plan.
+ */
+export const googleMonthly = {
+    planKey: `googleMonthly`,
+    platformKey: `google`,
+    platformProductId: `monthly_early_adopter`,
+    alias: `monthly`,
+    period: `month`,
+    price: `$5.99`,
+    autoRenews: true,
+    title: `Monthly`,
+    description: `Create and view attachments.`,
+    capabilities: {
+        attachments: true,
+    }
+};

package/build/API/resource/payment/platforms/google/plans/googleYearly.js

@@ -0,0 +1,18 @@
+/**
+ * The yearly Google Pay plan.
+ */
+export const googleYearly = {
+    planKey: `googleYearly`,
+    platformKey: `google`,
+    platformProductId: `yearly_early_adopter`,
+    alias: `yearly`,
+    period: `year`,
+    price: `$64.99`,
+    autoRenews: true,
+    title: `Yearly`,
+    description: `Create and view attachments.`,
+    highlightedDescription: `Get one month free, every year.`,
+    capabilities: {
+        attachments: true,
+    }
+};

package/build/API/resource/payment/platforms/google/plans/index.js

@@ -0,0 +1,7 @@
+/**
+ * Every available Google Pay plan.
+ *
+ * @module
+ */
+export * from './googleMonthly.js';
+export * from './googleYearly.js';

package/build/API/resource/payment/platforms/index.js

@@ -0,0 +1,8 @@
+/**
+ * All available payment platforms.
+ *
+ * @module
+ */
+export * from './stripe/index.js';
+export * from './google/index.js';
+export * from './apple/index.js';

package/build/API/resource/payment/platforms/stripe/index.js

@@ -0,0 +1,25 @@
+/**
+ * Properties and methods for handling payments through Stripe.
+ *
+ * @module
+ */
+import * as plans from './plans/index.js';
+/**
+ * The Stripe payment platform.
+ */
+export const stripe = {
+    /**
+     * An array of app platforms compatible with Stripe.
+     */
+    appPlatforms: [
+        undefined,
+        `mac`,
+        `windows`,
+        `linux`,
+        `cli`
+    ],
+    /**
+     * A map of Stripe plan keys to plan properties.
+     */
+    plans,
+};

package/build/API/resource/payment/platforms/stripe/plans/index.js

@@ -0,0 +1,11 @@
+/**
+ * Every available Stripe plan.
+ *
+ * @module
+ */
+export * from './stripeBusinessMolecule.js';
+export * from './stripeMonthly.js';
+export * from './stripeMonthlyMolecule.js';
+export * from './stripeSingleUseMolecule.js';
+export * from './stripeUnlimitedUseMolecule.js';
+export * from './stripeYearly.js';

package/build/API/resource/payment/platforms/stripe/plans/stripeBusinessMolecule.js

@@ -0,0 +1,21 @@
+/**
+ * The business Stripe plan for molecules.
+ */
+export const stripeBusinessMolecule = {
+    planKey: `stripeBusinessMolecule`,
+    platformKey: `stripe`,
+    platformProductId: ``,
+    alias: `businessMolecule`,
+    period: ``,
+    price: `$449`,
+    allowMultiple: true,
+    minimumQuantity: 10,
+    autoRenews: false,
+    title: `Business Molecule`,
+    description: `Includes all of the core functionality available for full-stack applications.`,
+    capabilities: {
+        forMolecules: true,
+        premium: true,
+        attachments: true,
+    }
+};

package/build/API/resource/payment/platforms/stripe/plans/stripeMonthly.js

@@ -0,0 +1,18 @@
+/**
+ * The monthly Stripe plan.
+ */
+export const stripeMonthly = {
+    planKey: `stripeMonthly`,
+    platformKey: `stripe`,
+    platformProductId: ``,
+    alias: `monthly`,
+    period: `month`,
+    price: `$5`,
+    autoRenews: true,
+    title: `Monthly`,
+    description: `Create and view attachments.`,
+    capabilities: {
+        forUsers: true,
+        attachments: true,
+    }
+};

package/build/API/resource/payment/platforms/stripe/plans/stripeMonthlyMolecule.js

@@ -0,0 +1,18 @@
+/**
+ * The monthly Stripe plan for molecules.
+ */
+export const stripeMonthlyMolecule = {
+    planKey: `stripeMonthlyMolecule`,
+    platformKey: `stripe`,
+    platformProductId: ``,
+    alias: `monthlyMolecule`,
+    period: `month`,
+    price: `$19`,
+    autoRenews: true,
+    title: `Monthly Molecule`,
+    description: `Includes all of the core functionality you've selected for your full-stack application.`,
+    capabilities: {
+        forMolecules: true,
+        attachments: true,
+    }
+};

package/build/API/resource/payment/platforms/stripe/plans/stripeSingleUseMolecule.js

@@ -0,0 +1,19 @@
+/**
+ * The single use Stripe plan for molecules.
+ */
+export const stripeSingleUseMolecule = {
+    planKey: `stripeSingleUseMolecule`,
+    platformKey: `stripe`,
+    platformProductId: ``,
+    alias: `singleUseMolecule`,
+    period: ``,
+    price: `$499`,
+    autoRenews: false,
+    title: `Single Use Molecule`,
+    description: `Includes all of the core functionality you've selected for your full-stack application.`,
+    capabilities: {
+        forMolecules: true,
+        premium: true,
+        attachments: true,
+    }
+};

package/build/API/resource/payment/platforms/stripe/plans/stripeUnlimitedUseMolecule.js

@@ -0,0 +1,19 @@
+/**
+ * The unlimited use Stripe plan for molecules.
+ */
+export const stripeUnlimitedUseMolecule = {
+    planKey: `stripeUnlimitedUseMolecule`,
+    platformKey: `stripe`,
+    platformProductId: ``,
+    alias: `unlimitedUseMolecule`,
+    period: ``,
+    price: `$1499`,
+    autoRenews: false,
+    title: `Unlimited Use Molecule`,
+    description: `Includes all of the core functionality you've selected for your full-stack application.`,
+    capabilities: {
+        forMolecules: true,
+        premium: true,
+        attachments: true,
+    }
+};

package/build/API/resource/payment/platforms/stripe/plans/stripeYearly.js

@@ -0,0 +1,19 @@
+/**
+ * The yearly Stripe plan.
+ */
+export const stripeYearly = {
+    planKey: `stripeYearly`,
+    platformKey: `stripe`,
+    platformProductId: ``,
+    alias: `yearly`,
+    period: `year`,
+    price: `$55`,
+    autoRenews: true,
+    title: `Yearly`,
+    description: `Create and view attachments.`,
+    highlightedDescription: `Get one month free, every year.`,
+    capabilities: {
+        forUsers: true,
+        attachments: true,
+    }
+};

package/build/API/resource/payment/types.js

@@ -0,0 +1,6 @@
+/**
+ * Payment type definitions.
+ *
+ * @module
+ */
+export {};

package/build/API/resource/types.js

@@ -0,0 +1,6 @@
+/**
+ * Resource type definitions.
+ *
+ * @module
+ */
+export {};

package/build/API/resource/user/index.js

@@ -0,0 +1,15 @@
+/**
+ * The user API resource.
+ *
+ * @module
+ */
+import { client } from '../../client.js';
+import * as authorization from '../../authorization.js';
+export * as utilities from './utilities/index.js';
+export * as types from './types.js';
+export const logInCLI = ({ token, deviceIds, deviceName }) => (client.post(`users/log-in/cli`, { token, deviceIds, deviceName }));
+export const logOut = async () => {
+    authorization.removeHeader();
+    return null;
+};
+export const read = (id) => (client.get(`users/${id}`));

package/build/API/resource/user/types.js

@@ -0,0 +1,6 @@
+/**
+ * User type definitions.
+ *
+ * @module
+ */
+export {};

package/build/API/resource/user/utilities/getPlan.js

@@ -0,0 +1,12 @@
+import { plans } from '../../payment/plans.js';
+/**
+ * Gets a user's current `plan`.
+ */
+export const getPlan = (user) => {
+    const planKey = user.planKey || ``;
+    const planExpiresTime = (user.planExpiresAt && new Date(String(user.planExpiresAt)).getTime()) || 0;
+    if (plans[planKey] && Date.now() < planExpiresTime) {
+        return plans[planKey];
+    }
+    return plans[''];
+};

package/build/API/resource/user/utilities/index.js

@@ -0,0 +1,7 @@
+/**
+ * User resource utilities.
+ *
+ * @module
+ */
+export * from './getPlan.js';
+export * from './logIn.js';

package/build/API/resource/user/utilities/logIn.js

@@ -0,0 +1,60 @@
+import os from 'os';
+import open from 'open';
+import { logInCLI } from '../index.js';
+import { getUserIdsToDeviceIds } from '../../../authorization.js';
+import { logger } from '../../../../logger.js';
+import { getErrorMessage } from '../../../../utilities/getErrorMessage.js';
+import { userConfig } from '../../../../userConfig.js';
+import { writeUserConfig } from '../../../../utilities/writeUserConfig.js';
+const CHECK_AFTER = 3000; // 3 seconds
+const MAX_TRIES = 20;
+export const logIn = async () => {
+    const deviceIds = Object.values(getUserIdsToDeviceIds());
+    const deviceName = `CLI (${os.platform()})`;
+    let token = ``;
+    try {
+        token = (await logInCLI({ deviceIds, deviceName })).data.token || ``;
+        if (!token) {
+            logger.warn(`No token was returned by the API.`);
+            return;
+        }
+    }
+    catch (error) {
+        logger.warn(`Error fetching token: ${getErrorMessage(error)}`);
+        return;
+    }
+    logger.info(`Opening your browser and waiting for your allowance...`);
+    const url = `${process.env.WEB_ORIGIN}/#/allow-auth-token?token=${encodeURIComponent(token)}`;
+    const childProcess = await open(url);
+    childProcess.on(`error`, error => {
+        logger.warn(`Error opening the auth URL: ${getErrorMessage(error)}`);
+        logger.warn(`If your browser didn't open on its own, visit the following URL to continue logging in: ${url}`);
+    });
+    childProcess.on(`close`, code => {
+        if (code !== 0) {
+            logger.warn(`If your browser didn't open on its own, visit the following URL to continue logging in: ${url}`);
+        }
+    });
+    const check = async (tryCount = 0) => {
+        if (tryCount >= MAX_TRIES) {
+            logger.info(`Reached maximum number of tries.`);
+            return;
+        }
+        try {
+            await new Promise(resolve => setTimeout(resolve, CHECK_AFTER));
+            const user = (await logInCLI({ token, deviceIds, deviceName })).data.props;
+            if (user) {
+                logger.info(`Hello, ${user.name || user.username}!`);
+                userConfig.user = user;
+                writeUserConfig();
+            }
+            else {
+                await check(tryCount + 1);
+            }
+        }
+        catch (error) {
+            await check(tryCount + 1);
+        }
+    };
+    await check();
+};

package/build/cli.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Molecule.dev command line tools.
+ *
+ * @module
+ */
+import './environment.js';
+import { program } from 'commander';
+import { commands } from './index.js';
+for (const commandKey in commands) {
+    if (typeof commands[commandKey] === `function`) {
+        commands[commandKey](program);
+    }
+}
+program.parse();

package/build/commands/add-ssh-key.js

@@ -0,0 +1,24 @@
+import { userConfig } from '../userConfig.js';
+import { userLoggedIn } from '../utilities/userLoggedIn.js';
+import * as API from '../API/index.js';
+import { logger } from '../logger.js';
+/**
+ * Adds the `add-ssh-key` command to the program.
+ */
+export const addSshKey = (program) => {
+    program.command(`add-ssh-key`)
+        .description(`finds or creates \`~/.ssh/id_*.pub\` (using \`ssh-keygen\`) and adds it to your Molecule.dev account for your current CLI device`)
+        .argument(`[path]`, `specify the location of the SSH key`)
+        .action(async (sshKeyPath = ``) => {
+        const user = await userLoggedIn();
+        if (!user) {
+            return;
+        }
+        const deviceId = userConfig.userIdsToDeviceIds?.[user.id] || ``;
+        if (!deviceId) {
+            logger.warn(`No device ID for the current user. Try logging out and in again.`);
+            return;
+        }
+        await API.resource.device.utilities.sendSshKey(deviceId, user.username, sshKeyPath);
+    });
+};

package/build/commands/buy.js

@@ -0,0 +1,70 @@
+import open from 'open';
+import { Argument } from 'commander';
+import { userLoggedIn } from '../utilities/userLoggedIn.js';
+import { repoConfig } from '../repoConfig.js';
+import * as API from '../API/index.js';
+import { logger } from '../logger.js';
+import { getErrorMessage } from '../utilities/getErrorMessage.js';
+import { plans } from '../API/resource/payment/plans.js';
+/**
+ * Adds the `buy` command to the program.
+ */
+export const buy = (program) => {
+    program.command(`buy`)
+        .description(`purchase a license for your Molecule`)
+        .addArgument(new Argument(`[license]`, `the type of license`).choices([`single`, `unlimited`, `business`]))
+        .addArgument(new Argument(`[quantity]`, `the quantity for the business license (at least ${plans.stripeBusinessMolecule.minimumQuantity})`))
+        .action(async (license, quantity = 1) => {
+        if (!license) {
+            logger.info(`Usage:`);
+            logger.info(`  mlcl buy single - one app with this Molecule`);
+            logger.info(`  mlcl buy unlimited - unlimited apps with this Molecule`);
+            logger.info(`  mlcl buy business <quantity> - at least 10 apps with any Molecule`);
+            return;
+        }
+        const user = await userLoggedIn();
+        if (!user) {
+            return;
+        }
+        if (!repoConfig?.id) {
+            logger.warn(`Not within a Molecule repository or \`.mlclrc.json\` not found.`);
+            return;
+        }
+        const planKey = ({
+            single: `stripeSingleUseMolecule`,
+            unlimited: `stripeUnlimitedUseMolecule`,
+            business: `stripeBusinessMolecule`,
+        })[license || ``];
+        if (!planKey || !plans[planKey]) {
+            logger.warn(`Unknown license option.`);
+            return;
+        }
+        try {
+            quantity = Math.max(plans[planKey]?.minimumQuantity || 1, Math.round(Number(quantity) || 1));
+            const molecule = (await API.resource.molecule.read(repoConfig.id)).data.props;
+            if (!molecule) {
+                throw new Error(`Failed to fetch Molecule by ID ${repoConfig.id}.`);
+            }
+            const { checkoutUrl } = (await API.resource.molecule.updatePlan(molecule.id, { planKey, quantity })).data;
+            if (checkoutUrl) {
+                logger.info(`Opening your browser to complete checkout via Stripe...`);
+                const childProcess = await open(checkoutUrl);
+                childProcess.on(`error`, error => {
+                    logger.warn(`Error opening the checkout URL: ${getErrorMessage(error)}`);
+                    logger.warn(`If your browser didn't open on its own, visit the following URL: ${checkoutUrl}`);
+                });
+                childProcess.on(`close`, code => {
+                    if (code !== 0) {
+                        logger.warn(`If your browser didn't open on its own, visit the following URL: ${checkoutUrl}`);
+                    }
+                });
+            }
+            else {
+                throw new Error(`Unexpected response. Please contact developer-support@molecule.dev so we can fix this.`);
+            }
+        }
+        catch (error) {
+            logger.warn(`Something went wrong. ${getErrorMessage(error)}`);
+        }
+    });
+};