neutrinos-cli 1.0.0

package/templates/component/.component.ts.hbs

@@ -0,0 +1,126 @@
+import { ATTRIBUTE_TYPE, AlphaAttribute, AlphaComponent, UI_TYPE, adoptAlphaCommonStyle } from '@jatahworx/alpha-annotations-lib';
+import { LitElement, html } from 'lit';
+import { property } from 'lit/decorators.js';
+import { componentStyles } from './{{componentSelector}}.styles.ts';
+
+@AlphaComponent({
+    componentName: '{{componentSelector}}',
+    componentVersion: '1.0.0',
+    label: '{{componentLabel}}',
+    selector: '{{componentSelectorPrefix}}-{{componentSelector}}',
+    category: 'Input',
+    icon: 'sample.png',
+})
+@adoptAlphaCommonStyle()
+export class {{componentClassName}} extends LitElement {
+    static styles = componentStyles;
+
+
+    /**
+     * @description 
+     *  Attribute for property for the component
+     * @param type -- ATTRIBUTE_TYPE.PROPERTY
+     * @param uiType -- type of the component by which the value can get to this property
+     * @param label -- Label on the editable component
+     * @param defaultValue -- Default value to the property
+     * @param placeholder -- placeholder on the editable component
+     * @param fieldMappings -- the value of this attribute will assign to the path/property name defined here
+     */
+    @AlphaAttribute({
+        type: ATTRIBUTE_TYPE.PROPERTY,
+        uiType: UI_TYPE.INPUT,
+        label: 'Initial Count',
+        defaultValue: 0,
+        placeholder: 'Enter label',
+        fieldMappings: 'value'
+    })
+    @property({ type: Number })
+    value = 0;
+
+    @AlphaAttribute({
+        uiType: UI_TYPE.TYPED_INPUT,
+        type: ATTRIBUTE_TYPE.PROPERTY,
+        label: 'Value',
+        category: 'Binding Variable',
+        options: [
+            { name: 'CO', value: 'co' },
+            { name: 'CMS', value: 'cms' },
+            { name: 'Case Instance', value: 'case_instance' },
+            { name: 'Task Instance', value: 'task_instance' },
+            { name: 'Local', value: 'local' },
+        ],
+        fieldMappings: {
+            type: 'options.mappingType',
+            value: 'options.modelPath',
+        },
+    })
+    options = {
+        mappingType: '',
+        modelPath: ''
+    }
+
+    @property({ type: Boolean })
+    disabled = false;
+
+    @property({ type: Boolean })
+    readonly = false;
+
+
+    render() {
+        return html`
+            <button @click=${this.increment}>+</button>
+            ${this.value || 0}
+            <button @click=${this.decrement}>-</button>
+        `;
+    }
+
+
+    /**
+     * @description 
+     *  Attribute for Event from the component
+     * @param type -- ATTRIBUTE_TYPE.EVENT
+     * @param label -- Label of the Event to show in the trigger list
+     * @param event -- Actual event name on which event listner will add
+     */
+    @AlphaAttribute({
+        type: ATTRIBUTE_TYPE.EVENT,
+        label: 'On Increment',
+        event: 'onIncrement',
+    })
+    increment(event) {
+        this.change(1);
+        const eventOptions = {
+            detail: {
+                event,
+                element: this,
+                value: this.value,
+            },
+            bubbles: true,
+            composed: true,
+        };
+        this.dispatchEvent(new CustomEvent('onIncrement', eventOptions));
+    }
+
+    @AlphaAttribute({
+        type: ATTRIBUTE_TYPE.EVENT,
+        label: 'On Decrement',
+        event: 'onDecrement',
+    })
+    decrement(event) {
+        this.change(-1);
+        const eventOptions = {
+            detail: {
+                event,
+                element: this,
+                value: this.value,
+            },
+            bubbles: true,
+            composed: true,
+        };
+        this.dispatchEvent(new CustomEvent('onDecrement', eventOptions));
+    }
+
+    private change(delta: number) {
+        this.value = Number(this.value) + delta;
+    }
+}

package/templates/component/.spec.ts.hbs

@@ -0,0 +1,15 @@
+import { expect, fixture } from '@open-wc/testing';
+import { html } from 'lit';
+import './{{componentSelector}}';
+import { {{componentClassName}} } from './{{componentSelector}}';
+
+describe('alpha-hue', () => {
+    beforeEach(async () => {
+        // Things to do before each test
+    });
+
+    it('should render', async () => {
+        const element: Hue = await fixture(html\`<{{componentSelector}}></{{componentSelector}}>\`);
+        expect(element).shadowDom.to.equalSnapshot();
+    });
+});

package/templates/component/.styles.ts.hbs

@@ -0,0 +1,2 @@
+import { css } from 'lit'; const style = css` :host { display: block; } `;
+export const componentStyles = [style];

package/templates/module/.module.js.hbs

@@ -0,0 +1,11 @@
+class {{pluginClassName}} {
+    init() {
+        console.log('initialosed');
+    }
+
+    onRegister() {
+        console.log(`Plugin registered and available as alpha['{{plginId}}']`);
+    }
+
+}
+alpha.registerPlugins('{{plginId}}', new {{pluginClassName}}());

package/templates/plugins-server/index.js

@@ -0,0 +1,18 @@
+import express from 'express';
+import { env } from 'node:process';
+
+const router = express.Router();
+const app = express();
+const port = env.PORT || 3000;
+const basePath = env.BASE_PATH || '';
+
+app.listen(port, () => {
+    console.log(`Server started at http://localhost:${port}${basePath}`);
+});
+
+router.get('/ping', (req, res) => {
+    res.send({ message: 'Hello World!' });
+});
+router.use('/plugins', express.static('plugins'));
+
+app.use(basePath, router);

package/templates/project/.vscode/extensions.json

@@ -0,0 +1,6 @@
+{
+    "recommendations": [
+        "runem.lit-plugin",
+        "bierner.markdown-preview-github-styles"
+    ]
+}

package/templates/project/ATTRIBUTE.md

@@ -0,0 +1,127 @@
+# Component Attributes
+
+This command provides functionality to manage attributes for components in a component. It allows adding various types of attributes to components with different UI types and field mappings.
+
+## Usage
+
+```sh
+    neutrinos generate attribute [componentName] [Options] | neutrinos g a [componentName] [Options]
+```
+
+### Arguments:
+
+- `[componentName]` Name of the component to generate an attribute
+
+### Options
+
+- `-t` , `--type <attributeType>` Type of attribute can be property, event, validation
+- `-u` , `--ui-type <uiType>` Ui-type of attribute can be ===> input, toggle, dropdown, multi-select, typed-input, range, color-picker,data-source, data-set, table-actions, data-mapping
+- `-l` , `--label <label>` Label for an attribute
+- `-e` , `--event <event>` Event name for an attribute if -t/--type is event
+- `-c` , `--category <category>` Category for an attribute
+- `-p` , `--placeholder <placeholder>` Placeholder for an attribute
+- `-d` , `--defaultValue <defaultValue>` DefaultValue for an attribute
+- `-o` , `--options <options...>` Options for an attribute
+- `-f` , `--fieldMappings <FieldMappings>` FieldMappings for package
+- `-n` , `--validation <validation>` Validation for an attribute
+
+## Attribute Inteface
+
+```ts
+    Interface AlphaAttribute {
+        type: 'property' | 'event' | 'validation',
+        uiType: 'input' | 'toggle ' | 'dropdown' |'multi-select' | 'typed-input' | 'range' |'color-picker' | 'data-source' | 'data-set' | 'table-actions' | 'data-mapping',
+        label: string;
+        event: string;
+        category: string;
+        placeholder: string;
+        defaultValue: boolean | string | number | any[] | object;
+        options:
+                Array<{
+                    displayText: string | number; value: string | number | boolean
+                }> |
+                Array<{
+                    name:'CMS' | 'CO' | 'Task Instance' | 'Case Instance' | 'String' | 'Language' | 'Local';
+                    value: 'cms' | 'co' | 'task_instance' | 'case_instance' | 'string' | 'lang' | 'local';
+                }> |
+                {
+                    minLabel: string;
+                    maxLabel: string;
+                    minRange: number;
+                    maxRange: number;
+                } |
+                {
+                    maxLength: number;
+                } |
+                {
+                    type: 'text' | 'number';
+                };
+        fieldMappings: string |
+                {
+                    type: string;
+                    value: string;
+                } |
+                {
+                    response: any;
+                    label: string;
+                    value: string;
+                } |
+                Record<string, string>;
+        validation: Record<string, any>;
+    }
+```
+
+## Attribute Types
+
+There are three main types of attributes:
+
+1. **property**: Regular attributes that define properties of a component.
+2. **event**: Attributes that define events for a component.
+3. **validation**: Attributes that define validation rules for a component.
+
+## UI Types
+
+The UI types specify the type of user interface element associated with an attribute. The following UI types are supported:
+
+- input
+- toggle
+- dropdown
+- multi-select
+- typed-input
+- range
+- color-picker
+- data-source
+- data-set
+- table-actions
+- data-mapping
+
+## Field Mappings
+
+Field mappings is the value of attribute assign to which property of component. These ui type will emmit these values;
+
+- **Data mapping**: `response`, `actions`, `columns`, `actionColumn`, `pagination`, `paginationData`
+- **Dataset**: `value`
+- **Datasource**: `response`, `label`, `value`
+- **Typed input**: `type`, `value`
+
+## Options
+
+Some UI types required options:
+
+- **Drop down**: Requires array of `displayText`, `value`,
+
+```ts
+Array<{
+    displayText: string;
+    value: string;
+}>;
+```
+
+- **Typed input**: Requires array of `name`, `value`
+
+```ts
+Array<{
+    name: string;
+    value: string;
+}>;
+```

package/templates/project/Dockerfile

@@ -0,0 +1,15 @@
+FROM node:22-alpine3.21
+
+WORKDIR /src
+
+RUN npm install -g npm@latest
+
+COPY ./plugins-server /src
+COPY ./package.json /src
+COPY .npmrc /src
+
+RUN npm install --omit=dev
+
+EXPOSE 3000
+
+CMD ["node", "index.js"]

package/templates/project/helmchart/.helmignore

@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/

package/templates/project/helmchart/Chart.yaml

@@ -0,0 +1,24 @@
+apiVersion: v2
+name: plugins-server
+description: A Helm chart for Kubernetes
+
+# A chart can be either an 'application' or a 'library' chart.
+#
+# Application charts are a collection of templates that can be packaged into versioned archives
+# to be deployed.
+#
+# Library charts provide useful utilities or functions for the chart developer. They're included as
+# a dependency of application charts to inject those utilities and functions into the rendering
+# pipeline. Library charts do not define any templates and therefore cannot be deployed.
+type: application
+
+# This is the chart version. This version number should be incremented each time you make changes
+# to the chart and its templates, including the app version.
+# Versions are expected to follow Semantic Versioning (https://semver.org/)
+version: 0.1.0
+
+# This is the version number of the application being deployed. This version number should be
+# incremented each time you make changes to the application. Versions are not expected to
+# follow Semantic Versioning. They should reflect the version the application is using.
+# It is recommended to use it with quotes.
+appVersion: '1.16.0'

package/templates/project/helmchart/templates/NOTES.txt

@@ -0,0 +1,22 @@
+1. Get the application URL by running these commands:
+{{- if .Values.ingress.enabled }}
+{{- range $host := .Values.ingress.hosts }}
+  {{- range .paths }}
+  http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ .path }}
+  {{- end }}
+{{- end }}
+{{- else if contains "NodePort" .Values.service.type }}
+  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "plugins-server.fullname" . }})
+  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
+  echo http://$NODE_IP:$NODE_PORT
+{{- else if contains "LoadBalancer" .Values.service.type }}
+     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
+           You can watch the status of by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "plugins-server.fullname" . }}'
+  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "plugins-server.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
+  echo http://$SERVICE_IP:{{ .Values.service.port }}
+{{- else if contains "ClusterIP" .Values.service.type }}
+  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "plugins-server.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
+  export CONTAINER_PORT=$(kubectl get pod --namespace {{ .Release.Namespace }} $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
+  echo "Visit http://127.0.0.1:8080 to use your application"
+  kubectl --namespace {{ .Release.Namespace }} port-forward $POD_NAME 8080:$CONTAINER_PORT
+{{- end }}

package/templates/project/helmchart/templates/_helpers.tpl

@@ -0,0 +1,62 @@
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "plugins-server.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
+If release name contains chart name it will be used as a full name.
+*/}}
+{{- define "plugins-server.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+{{- end }}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "plugins-server.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Common labels
+*/}}
+{{- define "plugins-server.labels" -}}
+helm.sh/chart: {{ include "plugins-server.chart" . }}
+{{ include "plugins-server.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{/*
+Selector labels
+*/}}
+{{- define "plugins-server.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "plugins-server.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "plugins-server.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create }}
+{{- default (include "plugins-server.fullname" .) .Values.serviceAccount.name }}
+{{- else }}
+{{- default "default" .Values.serviceAccount.name }}
+{{- end }}
+{{- end }}

package/templates/project/helmchart/templates/deployment.yaml

@@ -0,0 +1,69 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "plugins-server.fullname" . }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "plugins-server.labels" . | nindent 4 }}
+spec:
+  {{- if not .Values.autoscaling.enabled }}
+  replicas: {{ .Values.replicaCount }}
+  {{- end }}
+  selector:
+    matchLabels:
+      {{- include "plugins-server.selectorLabels" . | nindent 6 }}
+  template:
+    metadata:
+      {{- with .Values.podAnnotations }}
+      annotations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      labels:
+        {{- include "plugins-server.labels" . | nindent 8 }}
+        {{- with .Values.podLabels }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+    spec:
+      {{- with .Values.imagePullSecrets }}
+      imagePullSecrets:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      containers:
+        - name: {{ .Chart.Name }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.port }}
+              protocol: TCP
+          livenessProbe:
+            {{- toYaml .Values.livenessProbe | nindent 12 }}
+          readinessProbe:
+            {{- toYaml .Values.readinessProbe | nindent 12 }}
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          env:
+            {{- range .Values.env }}
+            - name: {{ .name }}
+              value: {{ .value | quote }}
+            {{- end }}
+          {{- with .Values.volumeMounts }}
+          volumeMounts:
+            {{- toYaml . | nindent 12 }}
+          {{- end }}
+      {{- with .Values.volumes }}
+      volumes:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.nodeSelector }}
+      nodeSelector:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.affinity }}
+      affinity:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.tolerations }}
+      tolerations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}

package/templates/project/helmchart/templates/ingress.yaml

@@ -0,0 +1,62 @@
+{{- if .Values.ingress.enabled -}}
+{{- $fullName := include "plugins-server.fullname" . -}}
+{{- $svcPort := .Values.service.port -}}
+{{- if and .Values.ingress.className (not (semverCompare ">=1.18-0" .Capabilities.KubeVersion.GitVersion)) }}
+  {{- if not (hasKey .Values.ingress.annotations "kubernetes.io/ingress.class") }}
+  {{- $_ := set .Values.ingress.annotations "kubernetes.io/ingress.class" .Values.ingress.className}}
+  {{- end }}
+{{- end }}
+{{- if semverCompare ">=1.19-0" .Capabilities.KubeVersion.GitVersion -}}
+apiVersion: networking.k8s.io/v1
+{{- else if semverCompare ">=1.14-0" .Capabilities.KubeVersion.GitVersion -}}
+apiVersion: networking.k8s.io/v1beta1
+{{- else -}}
+apiVersion: extensions/v1beta1
+{{- end }}
+kind: Ingress
+metadata:
+  name: {{ $fullName }}
+  namespace: {{ .Values.namespace }}
+  labels:
+    {{- include "plugins-server.labels" . | nindent 4 }}
+  {{- with .Values.ingress.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  {{- if and .Values.ingress.className (semverCompare ">=1.18-0" .Capabilities.KubeVersion.GitVersion) }}
+  ingressClassName: {{ .Values.ingress.className }}
+  {{- end }}
+  {{- if .Values.ingress.tls }}
+  tls:
+    {{- range .Values.ingress.tls }}
+    - hosts:
+        {{- range .hosts }}
+        - {{ . | quote }}
+        {{- end }}
+      secretName: {{ .secretName }}
+    {{- end }}
+  {{- end }}
+  rules:
+    {{- range .Values.ingress.hosts }}
+    - host: {{ .host | quote }}
+      http:
+        paths:
+          {{- range .paths }}
+          - path: {{ .path }}
+            {{- if and .pathType (semverCompare ">=1.18-0" $.Capabilities.KubeVersion.GitVersion) }}
+            pathType: {{ .pathType }}
+            {{- end }}
+            backend:
+              {{- if semverCompare ">=1.19-0" $.Capabilities.KubeVersion.GitVersion }}
+              service:
+                name: {{ $fullName }}
+                port:
+                  number: {{ $svcPort }}
+              {{- else }}
+              serviceName: {{ $fullName }}
+              servicePort: {{ $svcPort }}
+              {{- end }}
+          {{- end }}
+    {{- end }}
+{{- end }}

package/templates/project/helmchart/templates/service.yaml

@@ -0,0 +1,14 @@
+apiVersion: v1
+kind: Service
+metadata:
+    name: { { include "plugins-server.fullname" . } }
+    namespace: { { .Values.namespace } }
+    labels: { { - include "plugins-server.labels" . | nindent 4 } }
+spec:
+    type: { { .Values.service.type } }
+    ports:
+        - port: { { .Values.service.port } }
+          targetPort: { { .Values.service.targetPort } }
+          protocol: TCP
+          name: http
+    selector: { { - include "plugins-server.selectorLabels" . | nindent 4 } }

package/templates/project/helmchart/values.yaml

@@ -0,0 +1,74 @@
+namespace: alpha
+
+replicaCount: 1
+image:
+    repository: docker.neutrinos.co/plugins-server
+    pullPolicy: Always
+    tag: '1.0.0'
+
+imagePullSecrets:
+    - name: regcred
+
+nameOverride: 'plugins-service'
+fullnameOverride: 'plugins-service'
+podAnnotations: {}
+podLabels: {}
+
+service:
+    type: ClusterIP
+    port: 4000
+    targetPort: 4000
+
+ingress:
+    enabled: true
+    className: nginx
+    annotations: {}
+    hosts:
+        - host: alpha.neutrinos-apps.com
+          paths:
+              - path: /plugins-service
+                pathType: Prefix
+    tls: []
+
+env:
+    - name: PORT
+      value: '3000'
+
+resources:
+    limits:
+        cpu: '500m'
+        memory: '512Mi'
+    requests:
+        cpu: '250m'
+        memory: '256Mi'
+
+livenessProbe:
+    httpGet:
+        path: /plugins-service/ping
+        port: 3000
+    initialDelaySeconds: 20
+    periodSeconds: 10
+    timeoutSeconds: 5
+    successThreshold: 1
+    failureThreshold: 3
+readinessProbe:
+    httpGet:
+        path: /plugins-service/ping
+        port: 3000
+    initialDelaySeconds: 20
+    periodSeconds: 10
+    timeoutSeconds: 5
+    successThreshold: 1
+    failureThreshold: 3
+
+autoscaling:
+    enabled: false
+    minReplicas: 1
+    maxReplicas: 100
+    targetCPUUtilizationPercentage: 80
+
+volumes: []
+volumeMounts: []
+nodeSelector: {}
+tolerations: []
+affinity: {}