@hellocoop/quickstart 2.3.0 → 2.3.3

package/README.md

@@ -1,45 +1,15 @@
 # Hellō Quickstart
 
+This package starts a local web server and launches the Hellō Quickstart Web App to create or retrieve the `client_id` for a Hellō Application.
+
 ## CLI
 
-You can run the following command to create or retrieve the `client_id` for a Hellō Application. 
+If you have Node.js >= v18, you can run Quickstart with: 
 ```sh
 npx @hellocoop/quickstart@latest
 ```
 
-This will open up a browser window, where you will need to login with Hellō, and then choose to create a new app, or return the `client_id`.
-
-### Options
-
-- --provider_hint (-p) - space separated string of provider_hint 
-- --suffix (-x) - suffix to add to generated app name
-- --integration (-i) - integration name shown in console
-- --file (-f) - file to write out HELLO_CLIENT_ID
-- --secret (-s) - boolean to generate a HELLO_COOKIE_SECRET value
-- --wildcard (-w) - boolean to set the wildcard domain Development Redirect URI
-- --debug (-d) - output debug info
-
+This will prompt you to install the package if not already installed. It will then open up a browser window, where you will login with Hellō, and then choose to create a new app, or select an existing one, and then it will return the app's `client_id` to the console.
 
-## Import Package
+[Quickstart CLI and SDK Documentation](https://www.hello.dev/docs/sdks/quickstart)
 
-This package is useful for platform specific installers such as [Hellō Quickstart for Next.js](https://www.npmjs.com/package/@hellocoop/quickstart-nextjs)
-
-To install in another package
-
-```sh
-npm i --save-dev @hellocoop/quickstart
-```
-
-You can then use call Quickstart fom another configuration script
-
-```javascript
-import quickstart from '@hellocoop/quickstart';
-
-...
-const response_uri = 'http://localhost:8080'
-const client_id = await quickstart({
-    response_uri
-})
-
-```
-There are many options that can be passed to Quickstart. See the [Quickstart API](https://www.hello.dev/documentation/management-apis.html#quickstart-api) for details.

package/next.mjs

@@ -0,0 +1,108 @@
+// next.js quickstart
+
+import semver from 'semver';
+import  { statSync, appendFileSync } from 'fs'
+import chalk from 'chalk';
+import fs from 'fs-extra'
+import 'dotenv/config'
+import quickstart from './index.js';
+import { randomBytes } from 'crypto'
+
+const HELLO_CONFIG_FILE = 'hello.config.js'
+const HELLO_COOP_FILE = 'pages/api/hellocoop.js'
+const ENV_FILE = '.env.local'
+
+// check if @hellocoop/nextjs is installed
+
+
+const writeConfig = async (options) => {
+    const filePath = process.cwd()+'/'+HELLO_CONFIG_FILE
+    try {
+        statSync(filePath);
+        console.error(`${HELLO_CONFIG_FILE} already exists at:\n${filePath}\nSkipping getting client_id`)
+        return
+    } catch (err) {
+        if (err.code !== 'ENOENT') { // file does not exist
+            throw(err)
+        }
+    }
+    // file does not exist - let's get a client_id and write file
+    options.wildcard_domain=true
+    const client_id = await quickstart(options)
+    const config =`// ${HELLO_CONFIG_FILE}
+
+const config = {
+    client_id: '${client_id}',
+}
+export default config
+`
+    fs.outputFileSync( filePath, config)
+    console.log(`created ${filePath} with\nclient_id:${chalk.blueBright(client_id)}`)
+//     console.log(
+// `You can update the:
+//     - Application Logo
+//     - Application Name
+//     - Terms of Service URL
+//     - Privacy Policy URL
+//     - Redirect URIs
+// at the Hellō Developer Console https://console.hello.coop`)
+}
+
+const writeHelloCoop = async () => {
+    const filePath = process.cwd()+'/'+HELLO_COOP_FILE
+    try {
+        statSync(filePath);
+        console.error(`${HELLO_COOP_FILE} already exists at:\n${filePath}\nSkipping creating file`)
+        return
+    } catch (err) {
+        if (err.code !== 'ENOENT') { // file does not exist
+            throw(err)
+        }
+    }
+
+    const content = `// ${HELLO_COOP_FILE}
+
+import config from '../../hello.config.js'
+import { pageAuth } from '@hellocoop/nextjs'
+export default pageAuth(config)
+`
+    fs.outputFileSync( filePath, content )
+}
+
+
+const writeEnvLocal = async () => {
+    const existingSecret = process.env.HELLO_COOKIE_SECRET
+    if (existingSecret) {
+        console.error(`HELLO_COOKIE_SECRET already set to ${existingSecret}`)
+        return
+    } 
+
+    const secret = randomBytes(32).toString('hex')
+    const env = `
+# added by @hellocoop/quickstart --nextjs on ${(new Date()).toISOString()}
+HELLO_COOKIE_SECRET='${secret}'
+`
+    const outputFile = process.cwd()+'/'+ENV_FILE
+    appendFileSync(outputFile,env)
+    console.log(`\nUpdated ${outputFile} with:`)
+    console.log(chalk.blueBright(env))   
+}
+
+const next = async (options) => {
+    try {
+        await writeHelloCoop()
+        await writeEnvLocal()
+        await writeConfig(options)
+    } catch (e) {
+        console.error(e)
+        process.exit(1)
+    }
+}
+
+export default next
+
+
+
+
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hellocoop/quickstart",
-  "version": "2.3.0",
+  "version": "2.3.3",
   "description": "A CLI and module to start the Hello Quickstart web app and return a client_id",
   "main": "index.js",
   "bin": {
@@ -32,10 +32,11 @@
   "bugs": {
     "url": "https://github.com/hellocoop/packages/issues"
   },
-  "homepage": "https://github.com/hellocoop/packages#readme",
+  "homepage": "https://www.hello.dev/docs/sdk/quickstart",
   "dependencies": {
     "chalk": "^5.3.0",
     "dotenv": "^16.3.1",
+    "fs-extra": "^11.1.1",
     "get-port": "^7.0.0",
     "open": "^9.1.0",
     "semver": "^7.5.4"

package/quickstart.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
+
 import semver from 'semver';
-import * as fs from 'fs'
-import chalk from 'chalk';
+import next from './next.mjs'
 
 const requiredVersion = '>=18.3.0';
 
@@ -12,7 +12,6 @@ if (!semver.satisfies(process.versions.node, requiredVersion)) {
 
 // following are in Nodejs 18+
 import { parseArgs } from "node:util";
-import { randomBytes } from 'crypto'
 
 if (!process.stdout.isTTY) {
     const error = new Error('Not running on interactive terminal. Exiting Hellō Quickstart.')
@@ -42,107 +41,33 @@ let {
         short: "i",
         default: ''
     },
-    file: {
-        type: "string",
-        short: "f",
-    },
-    secret: {
-        type: "boolean",
-        short: "s",
-    },
     wildcard: {
         type: "boolean",
         short: "w",
-    },
-    debug: {
-        type: "boolean",
-        short: "d",
-    },
+    }
   },
 });
 
 import 'dotenv/config'
 import quickstart from './index.js';
 
-const existingClientId = process.env.HELLO_CLIENT_ID
-if (existingClientId) {
-    console.error(`HELLO_CLIENT_ID already set to ${existingClientId}`)
-    process.exit(0);
-} 
-
-if (nextjs) {
-    wildcard = true
-    secret = true
-    file = '.env'
-    provider_hint = 'github gitlab google email--'
-}
-
-
-const options = {}
-
-debug && console.log('Hellō Quickstart parameters:')
-if (provider_hint) {
-    options.provider_hint = provider_hint
-    debug && console.log(`  provider_hint="${provider_hint}"`)
-}
-if (suffix) {
-    options.suffix = suffix
-    debug && console.log(`  suffix="${suffix}"`)
-}
-if (integration) {
-    options.integration = integration
-    debug && console.log(`  integration="${integration}"`)
-}
-if (file) {
-    debug && console.log(`  writing output to "${file}"`)
-}
-if (wildcard) {
-    options.wildcard_domain = wildcard
-    debug && console.log(`  enable wildcard=${wildcard}\n`);    
-}    
-
-debug && console.log(`  generate secret=${secret}`);
-
-
 (async () => {
 
-    const output = {}
-    try {
-        output.client_id = await quickstart(options)
-    } catch(err) {
-        console.error(err)
-        process.exit(1)
-    }
-    if (secret)
-        output.secret = randomBytes(32).toString('hex')
-
-    if (file) {
-        let helloConfig = `
-# added by @hellocoop/quickstart-nextjs on ${(new Date()).toISOString()}
-HELLO_CLIENT_ID='${output.client_id}'`       
-        if (secret) {
-            helloConfig +=`
-HELLO_COOKIE_SECRET='${output.secret}'
-`
-        }
-        const outputFile = process.cwd()+'/'+file
-
-        try {
-            const err = fs.appendFileSync(outputFile,helloConfig)
-        } catch(err) {
-            console.err(err)
-            process.exit(1)
-        }
-        console.log(`\nUpdated ${outputFile} with:`)
-        console.log(chalk.blueBright(helloConfig))    
-        console.log(
-`You can update the:
-    - Application Logo
-    - Application Name
-    - Terms of Service URL
-    - Privacy Policy URL
-    - Redirect URIs
-at the Hellō Developer Console https://console.hello.coop`)
+    if (nextjs) {
+        await next({ provider_hint, suffix, integration })
+        process.exit(0)
     }
 
+    const options = {}
+    if (provider_hint) 
+        options.provider_hint = provider_hint
+    if (suffix) 
+        options.suffix = suffix
+    if (integration) 
+        options.integration = integration
+    if (wildcard) 
+        options.wildcard_domain = wildcard
+
+    const client_id = await quickstart(options)
+    console.log(`client_id=${client_id}`)
 })();