@seeka-labs/cli-apps 1.1.23 → 1.1.25

package/dist/init-templates/aws-lambda/.example.gitignore

@@ -1,49 +1,49 @@
-bin
-obj
-csx
-.vs
-edge
-Publish
-deploy.zip
-
-*.user
-*.suo
-*.cscfg
-*.Cache
-project.lock.json
-
-/packages
-/TestResults
-
-/tools/NuGet.exe
-/App_Data
-/secrets
-/data
-.secrets
-appsettings.json
-local.settings.json
-
-node_modules
-dist
-
-# Local python packages
-.python_packages/
-
-# Python Environments
-.env
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
-
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[cod]
-*$py.class
-
-# Azurite artifacts
-__blobstorage__
-__queuestorage__
+bin
+obj
+csx
+.vs
+edge
+Publish
+deploy.zip
+
+*.user
+*.suo
+*.cscfg
+*.Cache
+project.lock.json
+
+/packages
+/TestResults
+
+/tools/NuGet.exe
+/App_Data
+/secrets
+/data
+.secrets
+appsettings.json
+local.settings.json
+
+node_modules
+dist
+
+# Local python packages
+.python_packages/
+
+# Python Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Azurite artifacts
+__blobstorage__
+__queuestorage__
 __azurite_db*__.json

package/dist/init-templates/aws-lambda/.nvmrc

@@ -1 +1 @@
-v18
+v20

package/dist/init-templates/aws-lambda/README.md

@@ -1,77 +1,77 @@
-# Seeka app - AWS lambda
-
-## Development
-- `yarn install`
-- `yarn watch:debug` or use VsCode debugging for "Debug Seeka App" configuration
-
-### Debugging
-Supports VSCode debugging via the debugger and utilisation of breakpoints. 
-Use "Debug Seeka App" configuration to compile, watch and start app.
-This is only tested on Linux but may work on Windows. 
-If using Windows, WSL coupled with an Ubuntu distro will provide support for attaching the VS code debugger.
-
-### Live urls
-You can expose your app locally to the internet via Ngrok to test your app before deploying.
-
-#### Setup
-1. Sign up for a Ngrok account
-2. Get your auth token
-3. `yarn ngrok config add-authtoken [auth token here]` replacing `[auth token]` with the auth token retrieved from your Ngrok dashboard
-
-#### Running
-1. `yarn start` OR start debugging in VSCode
-2. In separate terminal window run `yarn tunnel` and observe the log entry that starts with `Live url exposed`.
-3. Input the URL into your Seeka app configuration as the "Webook URL" via the Seeka UI.
-
-## Logging
-Centralised logging handled by [Winston](https://www.npmjs.com/package/winston). Winston is installed in this template and is also used in the Seeka SDK NPM packages.
-
-[Seq](https://datalust.co/seq) Winston transport is installed in this template (optional).
-
-To configure Seq options, see `_SEQ_` environment variables.
-
-To install Seq on your development machine
-1. Run `docker run --name seq -d --restart=always -e ACCEPT_EULA=Y -p 5341:80 datalust/seq:2024.2`
-2. Update your `LOGGING_SEQ_SERVERURL` environment variable to `http://localhost:5341` or `http://[YOUR MACHINE NAME].local:5341` if using WSL.
-
-If creating an API key for Seq, only permission that is required is `Ingest`.
- 
-
-## State management
-Installations of your app and other state required for your app to function is stored in Redis. Another state provider can be swapped out for Redis, see `src/lib/state/seeka/installations.ts` for the file that manages the state of the installations.
-
-### Upstash (optional)
-If you dont want to use Upstash for Redis then you can swap out the connection strings with your Redis instance. 
-
-> If using Upstash then create a database before following the below guide to deploying your AWS lambda function.
-
-> When choosing a region, consider the AWS region that the lambda function is running from to reduce latency between the function and the Redis database. 
-
-## Deployment
-1. [Install the aws lambda CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html#getting-started-install-instructions)
-1. Create a function via the AWS console with following settings
-    - Mode: Author from scratch
-    - function name: `seeka-app-example-name`
-    - runtime: `Node.js 18.x`
-    - architecture: `arm64`
-    - Advanced settings:
-        - Enable code signing: unchecked
-        - Enable function URL: checked
-        - Auth type: `NONE` - Calls to your function from Seeka will be verified by SHA256 signatures
-        - Invoke mode: Buffered
-        - Configure cross-origin resource sharing: unchecked
-        - Enable VPC: unchecked
-    - All other settings leave as defaults
-3. Add environment variables to the function in AWS by clicking 'Configuration' and then 'Environment varables'. Use the `.env` file in this project as a reference to what variables are required by to be set in the AWS Lambda.
-4. [Authenticate the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-authentication-short-term.html)
-2. `yarn deploy`
-
-    > At this point you may wish to [configure concurrency](https://docs.aws.amazon.com/lambda/latest/dg/scaling-behavior.html) of the AWS lambda function depending on the amount of concurrent requests you forecast your function handling.
-
-6. Update your `Webhook URL` in you Seeka app configuration to point to the AWS Lambda function URL. This URL can be found in your viewing your Lambda via the AWS console and copying the "Function URL". It should look something like `https://prragnghaaupodlqte6hkvo446acc.lambda-url.ap-southeast-2.on.aws/`. Ensure to append `api/webhook/seeka/app` onto this URL so the complete example to update your Seeka app configuration with will look like `https://prragnghaaupodlqte6hkvo446acc.lambda-url.ap-southeast-2.on.aws/api/webhook/seeka/app`
-
-### Continuous delivery
-This template includes a GitLab CD pipeline that can be used to trigger deployments of your app when changes are pushed to your Git repository.
-
-## References
+# Seeka app - AWS lambda
+
+## Development
+- `yarn install`
+- `yarn watch:debug` or use VsCode debugging for "Debug Seeka App" configuration
+
+### Debugging
+Supports VSCode debugging via the debugger and utilisation of breakpoints. 
+Use "Debug Seeka App" configuration to compile, watch and start app.
+This is only tested on Linux but may work on Windows. 
+If using Windows, WSL coupled with an Ubuntu distro will provide support for attaching the VS code debugger.
+
+### Live urls
+You can expose your app locally to the internet via Ngrok to test your app before deploying.
+
+#### Setup
+1. Sign up for a Ngrok account
+2. Get your auth token
+3. `yarn ngrok config add-authtoken [auth token here]` replacing `[auth token]` with the auth token retrieved from your Ngrok dashboard
+
+#### Running
+1. `yarn start` OR start debugging in VSCode
+2. In separate terminal window run `yarn tunnel` and observe the log entry that starts with `Live url exposed`.
+3. Input the URL into your Seeka app configuration as the "Webook URL" via the Seeka UI.
+
+## Logging
+Centralised logging handled by [Winston](https://www.npmjs.com/package/winston). Winston is installed in this template and is also used in the Seeka SDK NPM packages.
+
+[Seq](https://datalust.co/seq) Winston transport is installed in this template (optional).
+
+To configure Seq options, see `_SEQ_` environment variables.
+
+To install Seq on your development machine
+1. Run `docker run --name seq -d --restart=always -e ACCEPT_EULA=Y -p 5341:80 datalust/seq:2024.2`
+2. Update your `LOGGING_SEQ_SERVERURL` environment variable to `http://localhost:5341` or `http://[YOUR MACHINE NAME].local:5341` if using WSL.
+
+If creating an API key for Seq, only permission that is required is `Ingest`.
+ 
+
+## State management
+Installations of your app and other state required for your app to function is stored in Redis. Another state provider can be swapped out for Redis, see `src/lib/state/seeka/installations.ts` for the file that manages the state of the installations.
+
+### Upstash (optional)
+If you dont want to use Upstash for Redis then you can swap out the connection strings with your Redis instance. 
+
+> If using Upstash then create a database before following the below guide to deploying your AWS lambda function.
+
+> When choosing a region, consider the AWS region that the lambda function is running from to reduce latency between the function and the Redis database. 
+
+## Deployment
+1. [Install the aws lambda CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html#getting-started-install-instructions)
+1. Create a function via the AWS console with following settings
+    - Mode: Author from scratch
+    - function name: `seeka-app-example-name`
+    - runtime: `Node.js 18.x`
+    - architecture: `arm64`
+    - Advanced settings:
+        - Enable code signing: unchecked
+        - Enable function URL: checked
+        - Auth type: `NONE` - Calls to your function from Seeka will be verified by SHA256 signatures
+        - Invoke mode: Buffered
+        - Configure cross-origin resource sharing: unchecked
+        - Enable VPC: unchecked
+    - All other settings leave as defaults
+3. Add environment variables to the function in AWS by clicking 'Configuration' and then 'Environment varables'. Use the `.env` file in this project as a reference to what variables are required by to be set in the AWS Lambda.
+4. [Authenticate the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-authentication-short-term.html)
+2. `yarn deploy`
+
+    > At this point you may wish to [configure concurrency](https://docs.aws.amazon.com/lambda/latest/dg/scaling-behavior.html) of the AWS lambda function depending on the amount of concurrent requests you forecast your function handling.
+
+6. Update your `Webhook URL` in you Seeka app configuration to point to the AWS Lambda function URL. This URL can be found in your viewing your Lambda via the AWS console and copying the "Function URL". It should look something like `https://prragnghaaupodlqte6hkvo446acc.lambda-url.ap-southeast-2.on.aws/`. Ensure to append `api/webhook/seeka/app` onto this URL so the complete example to update your Seeka app configuration with will look like `https://prragnghaaupodlqte6hkvo446acc.lambda-url.ap-southeast-2.on.aws/api/webhook/seeka/app`
+
+### Continuous delivery
+This template includes a GitLab CD pipeline that can be used to trigger deployments of your app when changes are pushed to your Git repository.
+
+## References
 - https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lambda/index.html#available-commands

package/dist/init-templates/aws-lambda/jest.config.js

@@ -1,5 +1,5 @@
-/** @type {import('ts-jest').JestConfigWithTsJest} */
-module.exports = {
-    preset: 'ts-jest',
-    testEnvironment: 'node',
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+    preset: 'ts-jest',
+    testEnvironment: 'node',
 };

package/dist/init-templates/aws-lambda/package.json

@@ -1,55 +1,52 @@
-{
-  "name": "seeka-app-example-name",
-  "version": "0.0.1",
-  "description": "Seeka example app for hosting on AWS lambda functions",
-  "author": "Seeka <platform@seeka.co>",
-  "license": "MIT",
-  "main": "./index.js",
-  "private": true,
-  "engines": {
-    "node": ">=18.14.0"
-  },
-  "scripts": {
-    "lint": "eslint",
-    "build": "esbuild src/index.ts --bundle --minify --sourcemap --platform=node --target=node18 --outfile=dist/index.js",
-    "watch": "tsc -w",
-    "test": "yarn jest",
-    "clean": "<packageManagerRunPrefix> rimraf dist && <packageManagerRunPrefix> rimraf deploy.zip",
-    "start": "node --require dotenv/config dist/index.js",
-    "dev": "<packageManagerRunPrefix> clean && <packageManagerRunPrefix> build && node --require dotenv/config dist/index.js",
-    "tunnel": "node scripts/ngrok.js seeka-app-example-name-localdev",
-    "build:aws": "<packageManagerRunPrefix> clean && <packageManagerRunPrefix> build && cd dist && zip -r ../deploy.zip . && cd ..",
-    "deploy": "<packageManagerRunPrefix> build:aws && aws lambda update-function-code --function-name seeka-app-example-name --zip-file fileb://deploy.zip && rm deploy.zip",
-    "watch:debug": "nodemon --inspect=5858 -e ts --exec node -r ts-node/register --require dotenv/config ./src/index.ts"
-  },
-  "dependencies": {
-    "@datalust/winston-seq": "^2.0.0",
-    "@seeka-labs/sdk-apps-server": "^1.1.7",
-    "axios": "^1.6.7",
-    "express": "^4.18.2",
-    "lodash-es": "^4.17.21",
-    "openid-client": "^5.6.4",
-    "redis": "^4.6.12",
-    "serverless-http": "^3.2.0",
-    "winston": "^3.11.0"
-  },
-  "devDependencies": {
-    "@jest/globals": "^29.7.0",
-    "@types/aws-lambda": "^8.10.133",
-    "@types/express": "^4.17.21",
-    "@types/lodash-es": "^4.17.12",
-    "@types/node": "^18",
-    "@typescript-eslint/eslint-plugin": "^6.19.1",
-    "@typescript-eslint/parser": "^6.19.1",
-    "dotenv": "^16.4.4",
-    "esbuild": "^0.24.0",
-    "eslint": "^8",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.5",
-    "ngrok": "^5.0.0-beta.2",
-    "nodemon": "^3.0.3",
-    "rimraf": "^5.0.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.4.2"
-  }
+{
+  "name": "seeka-app-example-name",
+  "version": "0.0.1",
+  "description": "Seeka example app for hosting on AWS lambda functions",
+  "author": "Seeka <platform@seeka.co>",
+  "license": "MIT",
+  "main": "./index.js",
+  "private": true,
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "lint": "eslint",
+    "build": "esbuild src/index.ts --bundle --minify --sourcemap --platform=node --target=node18 --outfile=dist/index.js",
+    "watch": "tsc -w",
+    "test": "yarn jest",
+    "clean": "<packageManagerRunPrefix> rimraf dist && <packageManagerRunPrefix> rimraf deploy.zip",
+    "start": "node --require dotenv/config dist/index.js",
+    "dev": "<packageManagerRunPrefix> clean && <packageManagerRunPrefix> build && node --require dotenv/config dist/index.js",
+    "tunnel": "node scripts/ngrok.js seeka-app-example-name-localdev",
+    "build:aws": "<packageManagerRunPrefix> clean && <packageManagerRunPrefix> build && cd dist && zip -r ../deploy.zip . && cd ..",
+    "deploy": "<packageManagerRunPrefix> build:aws && aws lambda update-function-code --function-name seeka-app-example-name --zip-file fileb://deploy.zip && rm deploy.zip",
+    "watch:debug": "nodemon --inspect=5858 -e ts --exec node -r ts-node/register --require dotenv/config ./src/index.ts"
+  },
+  "dependencies": {
+    "@datalust/winston-seq": "^2.0.0",
+    "@seeka-labs/sdk-apps-server": "^1.1.24",
+    "express": "^4.21.1",
+    "lodash-es": "^4.17.21",
+    "redis": "^4.7.0",
+    "serverless-http": "^3.2.0"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.7.0",
+    "@types/aws-lambda": "^8.10.146",
+    "@types/express": "^5.0.0",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "^20",
+    "@typescript-eslint/eslint-plugin": "^8.17.0",
+    "@typescript-eslint/parser": "^8.17.0",
+    "dotenv": "^16.4.7",
+    "esbuild": "^0.24.0",
+    "eslint": "^9",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "ngrok": "^5.0.0-beta.2",
+    "nodemon": "^3.1.7",
+    "rimraf": "^5.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.2"
+  }
 }

package/dist/init-templates/aws-lambda/src/index.test.ts

@@ -1,7 +1,7 @@
-import { describe, expect, test } from '@jest/globals';
-
-describe('test example module', () => {
-    test('should be false', () => {
-        expect(false).toBeFalsy();
-    });
+import { describe, expect, test } from '@jest/globals';
+
+describe('test example module', () => {
+    test('should be false', () => {
+        expect(false).toBeFalsy();
+    });
 });

package/dist/init-templates/aws-lambda/src/lib/logging/index.ts

@@ -1,88 +1,88 @@
-import { Context } from 'aws-lambda';
-import * as winston from 'winston';
-
-import { SeqTransport } from '@datalust/winston-seq';
-
-import * as packageJson from '../../../package.json';
-
-import type {
-    SeekaWebhookPayload, SeekaWebhookPayloadOfSeekaAppWebhookContext
-} from '@seeka-labs/sdk-apps-server';
-
-const loggerTransports: winston.transport[] = [
-    new winston.transports.Console({
-        level: process.env.LOGGING_LEVEL,
-        format: winston.format.combine(
-            winston.format.errors({ stack: true }),
-            winston.format.cli(),
-            winston.format.splat(),
-        ),
-        handleExceptions: true,
-        handleRejections: true,
-    }),
-]
-if (process.env.LOGGING_SEQ_SERVERURL) {
-    loggerTransports.push(
-        new SeqTransport({
-            level: process.env.LOGGING_LEVEL,
-            serverUrl: process.env.LOGGING_SEQ_SERVERURL,
-            apiKey: process.env.LOGGING_SEQ_APIKEY,
-            onError: ((e: any) => { console.error('Failed to configure Seq logging transport', e) }),
-            format: winston.format.combine(
-                winston.format.errors({ stack: true }),
-                winston.format.json(),
-            ),
-            handleExceptions: true,
-            handleRejections: true,
-        })
-    )
-}
-
-let logger: winston.Logger | null = null;
-
-const createLogger = () => winston.createLogger({
-    level: process.env.LOGGING_LEVEL,
-    defaultMeta: {
-        seekaAppId: process.env.SEEKA_APP_ID,
-        Hosting_Provider: 'aws',
-        Release_Version: `v${packageJson.version}`,
-        Hosting_Region: process.env.AWS_REGION,
-        Aws_Xray_TraceId: process.env._X_AMZN_TRACE_ID,
-        Aws_Lambda_FunctionName: process.env.AWS_LAMBDA_FUNCTION_NAME,
-        Service: `app/${packageJson.name}`,
-    },
-    transports: loggerTransports,
-    exitOnError: false,
-});
-
-export const getLogger = () => {
-    if (!logger || logger.closed) {
-        // If the AWS lambda host is reused then the logger will be closed and we need to recreate it
-        logger = createLogger();
-    }
-
-    return logger;
-};
-
-export const childLogger = (meta: object) => getLogger().child(meta);
-
-export const webhookLogger = (payload: SeekaWebhookPayload, functionContext: Context) => {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const meta: any = {
-        seekaWebhookType: payload.type,
-        seekaWebhookIsTest: payload.isTest,
-        RequestId: payload.requestId,
-        AwsLambda_RequestId: functionContext.awsRequestId,
-        CausationId: payload.causationId,
-        CorrelationId: payload.causationId,
-    }
-
-    const context = (payload as SeekaWebhookPayloadOfSeekaAppWebhookContext).context;
-    if (context) {
-        meta.seekaAppInstallId = context.applicationInstallId;
-        meta.seekaAppInstallOrganisationBrandId = context.organisationBrandId;
-        meta.seekaAppInstallOrganisationId = context.organisationId;
-    }
-
-    return childLogger(meta)
+import { Context } from 'aws-lambda';
+import * as winston from 'winston';
+
+import { SeqTransport } from '@datalust/winston-seq';
+
+import * as packageJson from '../../../package.json';
+
+import type {
+    SeekaWebhookPayload, SeekaWebhookPayloadOfSeekaAppWebhookContext
+} from '@seeka-labs/sdk-apps-server';
+
+const loggerTransports: winston.transport[] = [
+    new winston.transports.Console({
+        level: process.env.LOGGING_LEVEL,
+        format: winston.format.combine(
+            winston.format.errors({ stack: true }),
+            winston.format.cli(),
+            winston.format.splat(),
+        ),
+        handleExceptions: true,
+        handleRejections: true,
+    }),
+]
+if (process.env.LOGGING_SEQ_SERVERURL) {
+    loggerTransports.push(
+        new SeqTransport({
+            level: process.env.LOGGING_LEVEL,
+            serverUrl: process.env.LOGGING_SEQ_SERVERURL,
+            apiKey: process.env.LOGGING_SEQ_APIKEY,
+            onError: ((e: any) => { console.error('Failed to configure Seq logging transport', e) }),
+            format: winston.format.combine(
+                winston.format.errors({ stack: true }),
+                winston.format.json(),
+            ),
+            handleExceptions: true,
+            handleRejections: true,
+        })
+    )
+}
+
+let logger: winston.Logger | null = null;
+
+const createLogger = () => winston.createLogger({
+    level: process.env.LOGGING_LEVEL,
+    defaultMeta: {
+        seekaAppId: process.env.SEEKA_APP_ID,
+        Hosting_Provider: 'aws',
+        Release_Version: `v${packageJson.version}`,
+        Hosting_Region: process.env.AWS_REGION,
+        Aws_Xray_TraceId: process.env._X_AMZN_TRACE_ID,
+        Aws_Lambda_FunctionName: process.env.AWS_LAMBDA_FUNCTION_NAME,
+        Service: `app/${packageJson.name}`,
+    },
+    transports: loggerTransports,
+    exitOnError: false,
+});
+
+export const getLogger = () => {
+    if (!logger || logger.closed) {
+        // If the AWS lambda host is reused then the logger will be closed and we need to recreate it
+        logger = createLogger();
+    }
+
+    return logger;
+};
+
+export const childLogger = (meta: object) => getLogger().child(meta);
+
+export const webhookLogger = (payload: SeekaWebhookPayload, functionContext: Context) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const meta: any = {
+        seekaWebhookType: payload.type,
+        seekaWebhookIsTest: payload.isTest,
+        RequestId: payload.requestId,
+        AwsLambda_RequestId: functionContext.awsRequestId,
+        CausationId: payload.causationId,
+        CorrelationId: payload.causationId,
+    }
+
+    const context = (payload as SeekaWebhookPayloadOfSeekaAppWebhookContext).context;
+    if (context) {
+        meta.seekaAppInstallId = context.applicationInstallId;
+        meta.seekaAppInstallOrganisationBrandId = context.organisationBrandId;
+        meta.seekaAppInstallOrganisationId = context.organisationId;
+    }
+
+    return childLogger(meta)
 }