@seeka-labs/cli-apps 3.6.7 → 3.7.0

package/dist/init-template/.github/workflows/deploy-azurefunc.yml

@@ -0,0 +1,198 @@
+name: Deploy Azure Function
+
+on:
+  push:
+    branches:
+      - main
+      - staging
+  workflow_dispatch:
+
+permissions:
+  id-token: write
+  contents: read
+  actions: read
+
+concurrency:
+  group: deploy-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: ${{ github.ref_name == 'main' && 'prod' || 'stag' }}
+    env:
+      # Use a project-local Yarn cache that we can persist between runs
+      YARN_ENABLE_GLOBAL_CACHE: "false"
+      YARN_CACHE_FOLDER: .yarn/cache
+
+      # Constants / computed
+      NODE_OPTIONS: --max-old-space-size=8192
+      DEPLOY_ENVIRONMENT_NAME: ${{ github.ref_name == 'main' && 'prod' || 'stag' }}
+
+      # Repo variable (plain text)
+      AZURE_FUNC_RESOURCE_NAME: ${{ vars.AZURE_FUNC_RESOURCE_NAME }}
+
+      # GitHub Environment variables (plain text)
+      AZURE_FUNC_SLOT_NAME: ${{ vars.AZURE_FUNC_SLOT_NAME }}
+      AZURE_FUNC_RESOURCE_GROUP_NAME: ${{ vars.AZURE_FUNC_RESOURCE_GROUP_NAME }}
+      VITE_BASE_URL: ${{ vars.VITE_BASE_URL }}
+      VITE_URLS_SEEKA_API_CORE: ${{ vars.VITE_URLS_SEEKA_API_CORE }}
+      VITE_URLS_SEEKA_APP_CORE_ORIGIN: ${{ vars.VITE_URLS_SEEKA_APP_CORE_ORIGIN }}
+      HOSTING_REGION_NAME: ${{ vars.HOSTING_REGION_NAME }}
+      HOSTING_ENV_NAME: ${{ vars.HOSTING_ENV_NAME }}
+      SEEKA_APP_SETTINGS: ${{ vars.SEEKA_APP_SETTINGS }}
+
+      # GitHub Environment secrets
+      SEEKA_APP_CFG_DATA_ENCRYPTION_KEY: ${{ secrets.SEEKA_APP_CFG_DATA_ENCRYPTION_KEY }}
+      SEEKA_APP_CFG_OTEL_EXPORTER_OTLP_LOGS_HEADERS: ${{ secrets.SEEKA_APP_CFG_OTEL_EXPORTER_OTLP_LOGS_HEADERS }}
+      SEEKA_APP_CFG_REDIS_CONNECTION_PASSWORD: ${{ secrets.SEEKA_APP_CFG_REDIS_CONNECTION_PASSWORD }}
+      SEEKA_APP_CFG_SEEKA_APP_SECRET: ${{ secrets.SEEKA_APP_CFG_SEEKA_APP_SECRET }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Install Azure CLI
+        run: curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash
+
+      - name: Azure login (OIDC)
+        uses: azure/login@v2
+        with:
+          client-id: ${{ vars.AZURE_CLIENT_ID_SEEKA_APP_DEPLOYMENT }}
+          tenant-id: ${{ vars.AZURE_TENANT_ID }}
+          subscription-id: ${{ vars.AZURE_SUBSCRIPTION_ID }}
+      #          enable-AzPSSession: true
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Setup Node
+        uses: actions/setup-node@v6
+        with:
+          cache-dependency-path: 'yarn.lock'
+          node-version: 22
+          cache: yarn
+
+      - name: Restore Corepack/Yarn caches
+        uses: actions/cache@v5
+        with:
+          path: |
+            .corepack
+            .yarn/cache
+            node_modules
+          key: ${{ runner.os }}-npm-${{ hashFiles('yarn.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-npm-
+
+      - name: Compute VITE_RELEASE_TAG
+        shell: bash
+        run: |
+          set -euo pipefail
+          echo "VITE_RELEASE_TAG=$(git rev-parse --short HEAD)" >> "$GITHUB_ENV"
+
+      - name: Install dependencies
+        run: yarn install --immutable
+
+      - name: Build
+        run: yarn clean && yarn build
+
+      - name: Update Azure Function App settings
+        shell: bash
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+
+          seeka_basesettings_json="$(jq -n \
+            --arg NODE_OPTIONS "$NODE_OPTIONS" \
+            --arg VITE_RELEASE_TAG "$VITE_RELEASE_TAG" \
+            --arg VITE_BASE_URL "$VITE_BASE_URL" \
+            --arg VITE_URLS_SEEKA_API_CORE "$VITE_URLS_SEEKA_API_CORE" \
+            --arg VITE_URLS_SEEKA_APP_CORE_ORIGIN "$VITE_URLS_SEEKA_APP_CORE_ORIGIN" \
+            --arg HOSTING_REGION_NAME "$HOSTING_REGION_NAME" \
+            --arg HOSTING_ENV_NAME "$HOSTING_ENV_NAME" \
+            '{
+              NODE_OPTIONS: $NODE_OPTIONS,
+              VITE_RELEASE_TAG: $VITE_RELEASE_TAG,
+              VITE_BASE_URL: $VITE_BASE_URL,
+              VITE_URLS_SEEKA_API_CORE: $VITE_URLS_SEEKA_API_CORE,
+              VITE_URLS_SEEKA_APP_CORE_ORIGIN: $VITE_URLS_SEEKA_APP_CORE_ORIGIN,
+              HOSTING_REGION_NAME: $HOSTING_REGION_NAME,
+              HOSTING_ENV_NAME: $HOSTING_ENV_NAME
+            }')"
+
+          seeka_appsettings_json="{}"
+          if [[ -n "${SEEKA_APP_SETTINGS:-}" ]]; then
+            seeka_appsettings_json="$(echo "$SEEKA_APP_SETTINGS" | jq -c '.')"
+          fi
+
+          # Read any explicitly-mapped SEEKA_APP_CFG_* environment variables
+          seeka_app_cfg_json="$(jq -n '{}')"
+          for name in $(compgen -e); do
+            if [[ "$name" == SEEKA_APP_CFG_* ]]; then
+              key="${name#SEEKA_APP_CFG_}"
+              value="${!name}"
+              seeka_app_cfg_json="$(jq -c --arg k "$key" --arg v "$value" '. + {($k): $v}' <<<"$seeka_app_cfg_json")"
+            fi
+          done
+
+          final_json="$(jq -c -s 'reduce .[] as $i ({}; . * $i)' \
+            <(echo "$seeka_basesettings_json") \
+            <(echo "$seeka_appsettings_json") \
+            <(echo "$seeka_app_cfg_json"))"
+
+          echo "$final_json" > appsettings.json
+
+          if [[ -n "${AZURE_FUNC_SLOT_NAME:-}" ]]; then
+            az functionapp config appsettings set \
+              --name "$AZURE_FUNC_RESOURCE_NAME" \
+              --slot "$AZURE_FUNC_SLOT_NAME" \
+              --resource-group "$AZURE_FUNC_RESOURCE_GROUP_NAME" \
+              --settings @appsettings.json \
+              1>/dev/null
+          else
+            az functionapp config appsettings set \
+              --name "$AZURE_FUNC_RESOURCE_NAME" \
+              --resource-group "$AZURE_FUNC_RESOURCE_GROUP_NAME" \
+              --settings @appsettings.json \
+              1>/dev/null
+          fi
+
+      - name: Populate app/server/node_modules for deployment
+        run: |
+          echo "nodeLinker: node-modules" > .yarnrc.yml
+          echo -n "nmHoistingLimits: workspaces" >> .yarnrc.yml
+          cd app/server
+          yarn workspaces focus --production
+
+      - name: Package Azure Function as zip
+        working-directory: app/server
+        run: |
+          zip -r ../function-app.zip dist node_modules host.json package.json
+
+      - name: Upload function app package as artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: function-app-package
+          path: app/function-app.zip
+          retention-days: 30
+
+      - name: Deploy Azure Function
+        shell: bash
+        run: |
+          if [[ -n "${AZURE_FUNC_SLOT_NAME:-}" ]]; then
+            az functionapp deployment source config-zip \
+              --src "app/function-app.zip" \
+              --build-remote false \
+              --name "$AZURE_FUNC_RESOURCE_NAME" \
+              --slot "$AZURE_FUNC_SLOT_NAME" \
+              --resource-group "$AZURE_FUNC_RESOURCE_GROUP_NAME"
+          else
+            az functionapp deployment source config-zip \
+              --src "app/function-app.zip" \
+              --build-remote false \
+              --name "$AZURE_FUNC_RESOURCE_NAME" \
+              --resource-group "$AZURE_FUNC_RESOURCE_GROUP_NAME"
+          fi

package/dist/init-template/.gitlab-ci.yml

@@ -2,7 +2,7 @@ stages:
   - deploy
 
 variables:
-  AZURE_FUNC_RESOURCE_NAME: example-app-name
+  AZURE_FUNC_RESOURCE_NAME: seeka-app-example-app-name
   CI_DEBUG_TRACE: "true"
   NODE_OPTIONS: --max-old-space-size=8192
   VITE_RELEASE_TAG: "$CI_COMMIT_SHORT_SHA"
@@ -57,7 +57,7 @@ azure_func:
     - az account set --subscription "$AZURE_SUBSCRIPTION_ID"
     - corepack enable
   script:
-    - echo "deploying azure func $AZURE_FUNC_RESOURCE_NAME to slot $AZURE_FUNC_SLOT from branch $CI_COMMIT_BRANCH"
+    - echo "deploying azure func $AZURE_FUNC_RESOURCE_NAME to slot $AZURE_FUNC_SLOT_NAME from branch $CI_COMMIT_BRANCH"
     - yarn install --immutable
     - yarn clean && yarn build
     - cd app/server

package/dist/init-template/README.md

@@ -25,3 +25,37 @@ yarn up "@seeka-labs/*" --mode=update-lockfile && yarn
 cd repo root
 npx npm-check-updates@latest -i --workspaces --target minor && npx npm-check-updates@latest -i --workspaces --target minor --dep peer && npx npm-check-updates@latest -i --workspaces --target latest && npx npm-check-updates@latest -i --workspaces --target latest --dep peer
 ```
+
+## Deploy (GitHub Actions)
+
+This repo deploys to Azure Functions via `.github/workflows/deploy-azurefunc.yml` on pushes to `main` and `staging`.
+
+### Required GitHub secrets (for Azure OIDC)
+
+Create an Azure federated credential for this repo/environment, then set:
+
+- `AZURE_CLIENT_ID`
+- `AZURE_TENANT_ID`
+- `AZURE_SUBSCRIPTION_ID`
+
+### Required GitHub variables
+
+Repository variable:
+
+- `AZURE_FUNC_RESOURCE_NAME`
+
+GitHub Environment variables (define in environments `prod` and `stag`):
+
+- `AZURE_FUNC_SLOT_NAME`
+- `VITE_BASE_URL`
+- `VITE_URLS_SEEKA_API_CORE`
+- `VITE_URLS_SEEKA_APP_CORE_ORIGIN`
+- `HOSTING_REGION_NAME`
+- `HOSTING_ENV_NAME`
+- `SEEKA_APP_SETTINGS` (JSON object string like `{ "SETTING1": "production" }`)
+
+### GitHub action authenticating to Azure
+- create app registration in entra called devops-github-seeka-developer-apps
+    - for service principal: resource group > IAM > add role assignment > Website contributor
+    - for service principal: subscription > IAM > add role assignment > Reader
+- Assign federated identity to the service principal for GitHub actions at Certificates and Secrets > Federated Identity > Add credential > GitHub actions

package/dist/init-template/app/browser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@example-org-name/example-app-name-browser",
-  "version": "3.6.7",
+  "version": "3.7.0",
   "description": "Seeka app browser plugin example-app-name",
   "author": "Seeka company <support@seeka.co>",
   "private": true,
@@ -32,6 +32,5 @@
     "rimraf": "^6",
     "typescript": "^5",
     "watch": "^1"
-  },
-  "gitHead": "7bdfa73d8fd888cf89d5469f161dd4109172f39a"
+  }
 }

package/dist/init-template/app/lib/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@example-org-name/example-app-name-lib",
-  "version": "3.6.7",
+  "version": "3.7.0",
   "description": "Seeka app library for example-app-name",
   "author": "Seeka <administrator@seeka.co>",
   "license": "MIT",

package/dist/init-template/app/lib/src/validation/index.ts

@@ -1,14 +1,14 @@
-import type {Logger} from "winston";
-import {ExampleAppAppInstallSettings} from "../models";
-
-// TODO: Use Zod
-export const validateInstallationSettings = async (installSettings: ExampleAppAppInstallSettings, logger: Logger): Promise<string | null> => {
-    // Returning an error message string here will block the installation request or settings update request by the user installing the app
-
-    if(!installSettings) return null;
-
-    if(installSettings.exampleInstallSetting2 && installSettings.exampleInstallSetting2 < 2) return 'Example install setting 2 must be greater than 2';
-
-
-    return null;
+import type {Logger} from "winston";
+import {ExampleAppAppInstallSettings} from "../models";
+
+// TODO: Use Zod
+export const validateInstallationSettings = async (installSettings: ExampleAppAppInstallSettings, logger: Logger): Promise<string | null> => {
+    // Returning an error message string here will block the installation request or settings update request by the user installing the app
+
+    if(!installSettings) return null;
+
+    if(installSettings.exampleInstallSetting2 && installSettings.exampleInstallSetting2 < 2) return 'Example install setting 2 must be greater than 2';
+
+
+    return null;
 }

package/dist/init-template/app/server-azurefunc/.funcignore

@@ -6,6 +6,7 @@ src/
 README.md
 tsconfig.json
 .eslintrc.cjs
+.yarn
 
 node_modules/@types/
 node_modules/@typescript-eslint/eslint-plugin/

package/dist/init-template/app/server-azurefunc/local.settings.template.json

@@ -4,9 +4,6 @@
     "CORS": "*"
   },
   "Values": {
-    "FUNCTIONS_WORKER_RUNTIME": "node",
-    "FUNCTIONS_EXTENSION_VERSION": "~4",
-    "AzureWebJobsFeatureFlags": "EnableWorkerIndexing",
     "SEEKA_DEBUG_ENABLED": "true",
     "NODE_TLS_REJECT_UNAUTHORIZED": "0",
     "REDIS_CONNECTION_USER": "default",
@@ -16,12 +13,11 @@
     "SEEKA_ISSUER_URL": "",
     "SEEKA_APP_ID": "",
     "SEEKA_APP_SECRET": "",
-    "REDIS_CONNECTION_HOST": "",
+    "REDIS_CONNECTION_HOST": "localhost",
     "REDIS_CONNECTION_PASSWORD": "",
-    "AzureWebJobsStorage": "",
     "SEEKA_TELEMETRY_URL": "",
     "REDIS_CONNECTION_PORT": "6379",
-    "REDIS_CONNECTION_TLS": "true",
+    "REDIS_CONNECTION_TLS": "false",
     "OTEL_LOG_LEVEL": "info",
     "LOGGING_LEVEL": "silly",
     "SELF_HOST_BASEURL": "",

package/dist/init-template/app/server-azurefunc/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@example-org-name/example-app-name-server-azurefunc",
-  "version": "3.6.7",
+  "version": "3.7.0",
   "description": "Seeka Azure Serverless function app example-app-name",
   "author": "Seeka <administrator@seeka.co>",
   "license": "MIT",

package/dist/init-template/app/server-azurefunc/src/app/models/index.ts

@@ -1,12 +1,12 @@
-
-import {SeekaActivityAcceptedWebhookContent} from "@seeka-labs/sdk-apps-server";
-import { BackgroundJobRequestContext } from "@seeka-labs/sdk-apps-server-host";
-
-export type TrackExampleAppActivityQueueItem = BackgroundJobRequestContext<TrackSeekaExampleAppActivityPayload> & {
-
-}
-
-export type TrackSeekaExampleAppActivityPayload = {
-    seekaActivity: SeekaActivityAcceptedWebhookContent
-}
-
+
+import {SeekaActivityAcceptedWebhookContent} from "@seeka-labs/sdk-apps-server";
+import { BackgroundJobRequestContext } from "@seeka-labs/sdk-apps-server-host";
+
+export type TrackExampleAppActivityQueueItem = BackgroundJobRequestContext<TrackSeekaExampleAppActivityPayload> & {
+
+}
+
+export type TrackSeekaExampleAppActivityPayload = {
+    seekaActivity: SeekaActivityAcceptedWebhookContent
+}
+

package/dist/init-template/app/server-azurefunc/src/app/services/activites.ts

@@ -1,8 +1,8 @@
-
-import {Logger} from "winston";
-import {TrackSeekaExampleAppActivityPayload} from "../models";
-import {SeekaAppInstallContext} from "@seeka-labs/sdk-apps-core";
-
-export const sendActivityToAnotherSoftware = async (payload: TrackSeekaExampleAppActivityPayload, installation: SeekaAppInstallContext<any>, causationId: string, correlationId: string, logger: Logger): Promise<void> => {
- // Anything
-}
+
+import {Logger} from "winston";
+import {TrackSeekaExampleAppActivityPayload} from "../models";
+import {SeekaAppInstallContext} from "@seeka-labs/sdk-apps-core";
+
+export const sendActivityToAnotherSoftware = async (payload: TrackSeekaExampleAppActivityPayload, installation: SeekaAppInstallContext<any>, causationId: string, correlationId: string, logger: Logger): Promise<void> => {
+ // Anything
+}

package/dist/init-template/app/ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@example-org-name/example-app-name-ui",
-  "version": "3.6.7",
+  "version": "3.7.0",
   "description": "Seeka app UI for example-app-name",
   "author": "Seeka <administrator@seeka.co>",
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seeka-labs/cli-apps",
-  "version": "3.6.7",
+  "version": "3.7.0",
   "description": "Seeka - Apps CLI",
   "author": "SEEKA <platform@seeka.co>",
   "license": "MIT",
@@ -50,7 +50,7 @@
     "extract-zip": "^2.0.1",
     "glob": "^13",
     "ignore": "^7",
-    "inquirer": "^9.2.23",
+    "inquirer": "^13.2.0",
     "jest": "^30",
     "jsonpath-plus": "^10.3.0",
     "jszip": "^3.10.1",
@@ -58,6 +58,5 @@
     "source-map-support": "^0",
     "ts-jest": "^29",
     "typescript": "^5"
-  },
-  "gitHead": "23b0a7d1cbbc48db77f207bcecb87c9cce9b1a95"
+  }
 }

package/README.md

@@ -1 +0,0 @@
-# Seeka Apps CLI

package/dist/init-template/app/ui/.env

@@ -1,7 +0,0 @@
-PORT=3000
-EXTEND_ESLINT=TRUE
-REACT_APP_RELEASE_TAG=dev
-VITE_BASE_URL=/app/
-
-PROD_VITE_URLS_SEEKA_API_CORE=https://api.seeka.services
-PROD_VITE_URLS_SEEKA_APP_CORE_ORIGIN=https://seeka.app