eoas 1.0.1

package/.eslintignore

@@ -0,0 +1 @@
+node_modules

package/.eslintrc.js

@@ -0,0 +1,73 @@
+module.exports = {
+  root: true,
+  extends: ['universe/node'],
+  plugins: ['node'],
+  ignorePatterns: ['bin/'],
+  rules: {
+    'no-console': 'warn',
+    'no-constant-condition': ['warn', { checkLoops: false }],
+    'sort-imports': [
+      'warn',
+      {
+        ignoreDeclarationSort: true,
+      },
+    ],
+    curly: 'warn',
+    'import/no-cycle': 'error',
+    'import/no-extraneous-dependencies': [
+      'error',
+      { devDependencies: ['**/__tests__/**/*', '**/__mocks__/**/*'] },
+    ],
+    'import/no-relative-packages': 'error',
+    'no-restricted-imports': [
+      'error',
+      {
+        paths: [
+          {
+            name: 'lodash',
+            message: "Don't use lodash, it's heavy!",
+          },
+        ],
+      },
+    ],
+    'no-underscore-dangle': ['error', { allow: ['__typename'] }],
+    'node/no-sync': 'error',
+  },
+  overrides: [
+    {
+      files: ['*.ts', '*.d.ts'],
+      parserOptions: {
+        project: './tsconfig.json',
+      },
+      rules: {
+        '@typescript-eslint/explicit-function-return-type': [
+          'warn',
+          {
+            allowExpressions: true,
+          },
+        ],
+        '@typescript-eslint/prefer-nullish-coalescing': ['warn', { ignorePrimitives: true }],
+        '@typescript-eslint/no-confusing-void-expression': 'warn',
+        '@typescript-eslint/await-thenable': 'error',
+        '@typescript-eslint/no-misused-promises': [
+          'error',
+          {
+            checksVoidReturn: false,
+          },
+        ],
+        '@typescript-eslint/no-floating-promises': 'error',
+        'no-void': ['warn', { allowAsStatement: true }],
+        'no-return-await': 'off',
+        '@typescript-eslint/return-await': ['error', 'always'],
+        '@typescript-eslint/no-confusing-non-null-assertion': 'warn',
+        '@typescript-eslint/no-extra-non-null-assertion': 'warn',
+        '@typescript-eslint/prefer-as-const': 'warn',
+        '@typescript-eslint/prefer-includes': 'warn',
+        '@typescript-eslint/prefer-readonly': 'warn',
+        '@typescript-eslint/prefer-string-starts-ends-with': 'warn',
+        '@typescript-eslint/prefer-ts-expect-error': 'warn',
+        '@typescript-eslint/no-unnecessary-type-assertion': 'warn',
+      },
+    },
+  ],
+};

package/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "singleQuote": true,
+  "bracketSameLine": true,
+  "trailingComma": "es5",
+  "arrowParens": "avoid",
+  "endOfLine": "auto"
+}

package/README.md

@@ -0,0 +1,17 @@
+# EOAS (Expo-Open-OTA Support)
+
+EOAS (Expo-Open-OTA Support) is a powerful helper package designed to simplify the setup and update publication process for the [expo-open-ota](https://github.com/axelmarciano/expo-open-ota) project.
+
+## Quick Start
+
+To get started with EOAS, check out the official documentation:
+[EOAS Official Documentation](https://axelmarciano.github.io/expo-open-ota/)
+
+## Learn More
+For detailed information and to explore the core functionalities of expo-open-ota, visit the main repository:
+[expo-open-ota on GitHub](https://github.com/axelmarciano/expo-open-ota)
+
+---
+
+Feel free to contribute, raise issues, or share feedback to help us improve EOAS!
+

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// eslint-disable-next-line node/shebang, unicorn/prefer-top-level-await
+(async () => {
+  const oclif = await import('@oclif/core');
+  await oclif.execute({ development: true, dir: __dirname });
+})();

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+// eslint-disable-next-line unicorn/prefer-top-level-await
+(async () => {
+  const oclif = await import('@oclif/core')
+  await oclif.execute({dir: __dirname})
+})()

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "eoas",
+  "version": "1.0.1",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "watch": "tsc --project tsconfig.json --watch",
+    "lint": "eslint ."
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "homepage": "https://github.com/axelmarciano/expo-open-ota/tree/main/eoas",
+  "keywords": [
+    "expo-open-ota",
+    "expo",
+    "eas",
+    "cli"
+  ],
+  "author": "Axel Marciano",
+  "license": "MIT",
+  "description": "A CLI tool to manage publishing and OTA updates for expo-open-OTA self-hosted server. This is not an official tool from Expo but an open-source project (https://github.com/axelmarciano/expo-open-ota)",
+  "repository": "axelmarciano/expo-open-ota",
+  "dependencies": {
+    "@expo/code-signing-certificates": "^0.0.5",
+    "@expo/config": "10.0.6",
+    "@expo/config-plugins": "9.0.12",
+    "@expo/eas-build-job": "1.0.165",
+    "@expo/fingerprint": "^0.11.7",
+    "@expo/package-manager": "1.7.0",
+    "@expo/spawn-async": "1.7.2",
+    "@oclif/core": "^4.2.4",
+    "@types/node-fetch": "^2.6.12",
+    "@urql/core": "4.0.11",
+    "@urql/exchange-retry": "1.2.0",
+    "better-opn": "3.0.2",
+    "chalk": "4.1.2",
+    "fast-glob": "3.3.2",
+    "figures": "3.2.0",
+    "file-type": "^20.0.0",
+    "form-data": "^4.0.1",
+    "fs-extra": "11.2.0",
+    "getenv": "1.0.0",
+    "graphql": "16.8.1",
+    "graphql-tag": "^2.12.6",
+    "https-proxy-agent": "5.0.1",
+    "ignore": "5.3.0",
+    "joi": "17.11.0",
+    "jscodeshift": "^17.1.2",
+    "mime": "3.0.0",
+    "node-fetch": "^2.6.7",
+    "ora": "^5.1.0",
+    "prompts": "^2.4.2",
+    "recast": "^0.23.9",
+    "resolve-from": "5.0.0",
+    "semver": "7.5.4",
+    "tar": "6.2.1",
+    "terminal-link": "2.1.1",
+    "uuid": "9.0.1",
+    "eslint": "^8.57.1",
+    "prettier": "3.1.1",
+    "log-symbols": "^4.0.0"
+  },
+  "devDependencies": {
+    "@babel/parser": "^7.26.7",
+    "@babel/types": "^7.26.7",
+    "@tsconfig/node18": "^18.2.4",
+    "@types/fs-extra": "11.0.4",
+    "@types/getenv": "^1.0.0",
+    "@types/jscodeshift": "^0.12.0",
+    "@types/mime": "^3.0.4",
+    "@types/node": "^18.19.74",
+    "@types/prompts": "^2.4.9",
+    "@types/semver": "7.5.6",
+    "@types/tar": "6.1.10",
+    "@types/uuid": "9.0.7",
+    "eslint-config-universe": "^14.0.0",
+    "eslint-plugin-async-protect": "^3.1.0",
+    "eslint-plugin-node": "^11.1.0",
+    "ts-node": "10.9.2",
+    "typescript": "5.3.3"
+  },
+  "bin": {
+    "eoas": "./bin/run.js"
+  },
+  "oclif": {
+    "bin": "eoas",
+    "commands": "./dist/commands",
+    "dirname": "eoas",
+    "topicSeparator": ":"
+  }
+}

package/src/commands/generate-certs.ts

@@ -0,0 +1,95 @@
+import {
+  convertCertificateToCertificatePEM,
+  convertKeyPairToPEM,
+  generateKeyPair,
+  generateSelfSignedCodeSigningCertificate,
+} from '@expo/code-signing-certificates';
+import { Command } from '@oclif/core';
+import { ensureDirSync, writeFile } from 'fs-extra';
+import path from 'path';
+
+import Log from '../lib/log';
+import { promptAsync } from '../lib/prompts';
+
+export default class GenerateCerts extends Command {
+  static override args = {};
+  static override description = 'Generate private & public certificates for code signing';
+  static override examples = ['<%= config.bin %> <%= command.id %>'];
+  static override flags = {};
+  public async run(): Promise<void> {
+    const { certificateOutputDir } = await promptAsync({
+      message:
+        'In which directory would you like to store your code signing certificate (used by your expo app)?',
+      name: 'certificateOutputDir',
+      type: 'text',
+      initial: './keysStore',
+      validate: v => {
+        try {
+          // eslint-disable-next-line
+          ensureDirSync(path.join(process.cwd(), v));
+          return true;
+        } catch {
+          return false;
+        }
+      },
+    });
+    const { keyOutputDir } = await promptAsync({
+      message:
+        'In which directory would you like to store your key pair (used by your OTA Server) ?. ⚠️ Those keysStore are sensitive and should be kept private.',
+      name: 'keyOutputDir',
+      type: 'text',
+      initial: './keysStore',
+      validate: v => {
+        try {
+          // eslint-disable-next-line
+          ensureDirSync(path.join(process.cwd(), v));
+          return true;
+        } catch {
+          return false;
+        }
+      },
+    });
+    const { certificateCommonName } = await promptAsync({
+      message: 'Please enter your Organization name',
+      name: 'certificateCommonName',
+      type: 'text',
+      initial: 'Your Organization Name',
+      validate: v => {
+        return !!v;
+      },
+    });
+    const { certificateValidityDurationYears } = await promptAsync({
+      message: 'How many years should the certificate be valid for?',
+      name: 'certificateValidityDurationYears',
+      type: 'number',
+      initial: 10,
+      validate: v => {
+        return v > 0 && Number.isInteger(v);
+      },
+    });
+    const validityDurationYears = Math.floor(Number(certificateValidityDurationYears));
+    const certificateOutput = path.resolve(process.cwd(), certificateOutputDir);
+    const keyOutput = path.resolve(process.cwd(), keyOutputDir);
+    const validityNotBefore = new Date();
+    const validityNotAfter = new Date();
+    validityNotAfter.setFullYear(validityNotAfter.getFullYear() + validityDurationYears);
+    const keyPair = generateKeyPair();
+    const certificate = generateSelfSignedCodeSigningCertificate({
+      keyPair,
+      validityNotBefore,
+      validityNotAfter,
+      commonName: certificateCommonName,
+    });
+    const keyPairPEM = convertKeyPairToPEM(keyPair);
+    const certificatePEM = convertCertificateToCertificatePEM(certificate);
+    await Promise.all([
+      writeFile(path.join(keyOutput, 'public-key.pem'), keyPairPEM.publicKeyPEM),
+      writeFile(path.join(keyOutput, 'private-key.pem'), keyPairPEM.privateKeyPEM),
+      writeFile(path.join(certificateOutput, 'certificate.pem'), certificatePEM),
+    ]);
+    Log.succeed(
+      `Generated public and private keys output in ${keyOutputDir}. Please follow the documentation to securely store them and do not commit them to your repository.`
+    );
+    Log.succeed(`Generated code signing certificate output in ${certificateOutputDir}.`);
+  }
+}

package/src/commands/init.ts

@@ -0,0 +1,117 @@
+import { Command } from '@oclif/core';
+import fs from 'fs-extra';
+import path from 'path';
+
+import {
+  createOrModifyExpoConfigAsync,
+  getExpoConfigUpdateUrl,
+  getPrivateExpoConfigAsync,
+} from '../lib/expoConfig';
+import Log from '../lib/log';
+import { ora } from '../lib/ora';
+import { isExpoInstalled } from '../lib/package';
+import { confirmAsync, promptAsync } from '../lib/prompts';
+import { isValidUpdateUrl } from '../lib/utils';
+
+export default class Init extends Command {
+  static override args = {};
+  static override description = 'Configure your existing expo project with Expo Open OTA';
+  static override examples = ['<%= config.bin %> <%= command.id %>'];
+  static override flags = {};
+  public async run(): Promise<void> {
+    const projectDir = process.cwd();
+    const hasExpo = isExpoInstalled(projectDir);
+    if (!hasExpo) {
+      Log.error('Expo is not installed in this project. Please install Expo first.');
+      return;
+    }
+    const config = await getPrivateExpoConfigAsync(projectDir);
+    if (!config) {
+      Log.error(
+        'Could not find Expo config in this project. Please make sure you have an Expo config.'
+      );
+      return;
+    }
+    const { updateUrl: promptedUrl } = await promptAsync({
+      message: 'Enter the URL of your update server (ex: https://customota.com)',
+      name: 'updateUrl',
+      type: 'text',
+      initial: getExpoConfigUpdateUrl(config),
+      validate: v => {
+        return !!v && isValidUpdateUrl(v);
+      },
+    });
+    let manifestEndpoint = `${promptedUrl}/manifest`;
+    const updateUrl = getExpoConfigUpdateUrl(config);
+    if (updateUrl && !updateUrl.includes('expo.dev')) {
+      const confirmed = await confirmAsync({
+        message: `Expo config already has an update URL set to ${updateUrl}. Do you want to replace it?`,
+        name: 'replace',
+        type: 'confirm',
+      });
+      if (!confirmed) {
+        manifestEndpoint = updateUrl;
+      }
+    }
+    const confirmed = await confirmAsync({
+      message: 'Do you have already generated your certificates and keysStore for code signing?',
+      name: 'certificates',
+      type: 'confirm',
+    });
+    if (!confirmed) {
+      Log.fail('You need to generate your certificates first by using npx eoas generate-keysStore');
+      return;
+    }
+    const { codeSigningCertificatePath } = await promptAsync({
+      message: 'Enter the path to your code signing certificate (ex: ./keysStore/certificate.pem)',
+      name: 'codeSigningCertificatePath',
+      type: 'text',
+      initial: './keysStore/certificate.pem',
+      validate: v => {
+        try {
+          const fullPath = path.resolve(projectDir, v);
+          // eslint-disable-next-line
+          const fileExists = fs.existsSync(fullPath);
+          if (!fileExists) {
+            Log.newLine();
+            Log.error('File does not exist');
+            return false;
+          }
+          // eslint-disable-next-line
+          const key = fs.readFileSync(fullPath, 'utf8');
+          if (!key) {
+            Log.error('Empty key');
+            return false;
+          }
+          return true;
+        } catch {
+          return false;
+        }
+      },
+    });
+    const newUpdateConfig = {
+      url: manifestEndpoint,
+      codeSigningMetadata: {
+        keyid: 'main',
+        alg: 'rsa-v1_5-sha256' as const,
+      },
+      codeSigningCertificate: codeSigningCertificatePath,
+      enabled: true,
+      requestHeaders: {
+        'expo-channel-name': 'process.env.RELEASE_CHANNEL',
+      },
+    };
+    const updateConfigSpinner = ora('Updating Expo config').start();
+    try {
+      await createOrModifyExpoConfigAsync(projectDir, {
+        updates: newUpdateConfig,
+      });
+      updateConfigSpinner.succeed(
+        'Expo config successfully updated do not forget to format the file with prettier or eslint'
+      );
+    } catch (e) {
+      updateConfigSpinner.fail('Failed to update Expo config');
+      Log.error(e);
+    }
+  }
+}