@flui-cloud/cli 0.0.1

package/lib/src/modules/applications/entities/app-resource.entity.d.ts

@@ -0,0 +1,24 @@
+import { ApplicationEntity } from './application.entity';
+import { ApplicationResourceKind } from '../enums/application-resource-kind.enum';
+import { ApplicationResourceStatus } from '../enums/application-resource-status.enum';
+import { ReconciliationStatus } from '../../infrastructure/shared/enums/reconciliation-status.enum';
+export declare class AppResourceEntity {
+    id: string;
+    generateId(): void;
+    applicationId: string;
+    application: ApplicationEntity;
+    kind: ApplicationResourceKind;
+    name: string;
+    namespace: string;
+    apiVersion: string;
+    status: ApplicationResourceStatus;
+    desiredHash?: string;
+    actualHash?: string;
+    desiredManifest?: string;
+    reconciliationStatus: ReconciliationStatus;
+    lastObservedAt?: Date;
+    errorMessage?: string;
+    metadata?: Record<string, string>;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/lib/src/modules/applications/entities/app-resource.entity.js

@@ -0,0 +1,117 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppResourceEntity = void 0;
+const typeorm_1 = require("typeorm");
+const uuid_1 = require("uuid");
+const application_entity_1 = require("./application.entity");
+const application_resource_kind_enum_1 = require("../enums/application-resource-kind.enum");
+const application_resource_status_enum_1 = require("../enums/application-resource-status.enum");
+const reconciliation_status_enum_1 = require("../../infrastructure/shared/enums/reconciliation-status.enum");
+let AppResourceEntity = class AppResourceEntity {
+    generateId() {
+        if (!this.id) {
+            this.id = (0, uuid_1.v4)();
+        }
+    }
+};
+exports.AppResourceEntity = AppResourceEntity;
+__decorate([
+    (0, typeorm_1.PrimaryColumn)('uuid'),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.BeforeInsert)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], AppResourceEntity.prototype, "generateId", null);
+__decorate([
+    (0, typeorm_1.Column)('uuid'),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "applicationId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => application_entity_1.ApplicationEntity, (app) => app.appResources, {
+        onDelete: 'CASCADE',
+    }),
+    (0, typeorm_1.JoinColumn)({ name: 'applicationId' }),
+    __metadata("design:type", application_entity_1.ApplicationEntity)
+], AppResourceEntity.prototype, "application", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: application_resource_kind_enum_1.ApplicationResourceKind,
+    }),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "kind", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 255 }),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "name", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 100 }),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "namespace", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 255 }),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "apiVersion", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: application_resource_status_enum_1.ApplicationResourceStatus,
+        default: application_resource_status_enum_1.ApplicationResourceStatus.PENDING,
+    }),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 64, nullable: true }),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "desiredHash", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 64, nullable: true }),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "actualHash", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "desiredManifest", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: reconciliation_status_enum_1.ReconciliationStatus,
+        default: reconciliation_status_enum_1.ReconciliationStatus.PENDING,
+    }),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "reconciliationStatus", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'timestamptz', nullable: true }),
+    __metadata("design:type", Date)
+], AppResourceEntity.prototype, "lastObservedAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", String)
+], AppResourceEntity.prototype, "errorMessage", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', nullable: true }),
+    __metadata("design:type", Object)
+], AppResourceEntity.prototype, "metadata", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)({ type: 'timestamptz' }),
+    __metadata("design:type", Date)
+], AppResourceEntity.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.UpdateDateColumn)({ type: 'timestamptz' }),
+    __metadata("design:type", Date)
+], AppResourceEntity.prototype, "updatedAt", void 0);
+exports.AppResourceEntity = AppResourceEntity = __decorate([
+    (0, typeorm_1.Entity)('app_resources')
+], AppResourceEntity);

package/lib/src/modules/applications/entities/app-revision.entity.d.ts

@@ -0,0 +1,29 @@
+import { ApplicationEntity } from './application.entity';
+import { ApplicationStatus } from '../enums/application-status.enum';
+import { ApplicationSourceConfig, ApplicationEnvVar, ApplicationResources } from '../interfaces/source-config.interface';
+import { AppEventType, AppEventActor } from '../enums/app-event-type.enum';
+export declare class AppRevisionEntity {
+    id: string;
+    generateId(): void;
+    applicationId: string;
+    application: ApplicationEntity;
+    eventType: AppEventType;
+    actor: AppEventActor | null;
+    changeMetadata: Record<string, unknown>;
+    revisionNumber: number | null;
+    imageRef?: string;
+    commitSha?: string;
+    chartVersion?: string;
+    sourceConfigSnapshot: ApplicationSourceConfig;
+    envSnapshot: ApplicationEnvVar[];
+    resourcesSnapshot: ApplicationResources;
+    replicas?: number;
+    status: ApplicationStatus;
+    errorMessage?: string;
+    deployedBy?: string;
+    operationId?: string;
+    buildId: string | null;
+    k8sResourceHashes: Record<string, string>;
+    rollbackReason?: string;
+    createdAt: Date;
+}

package/lib/src/modules/applications/entities/app-revision.entity.js

@@ -0,0 +1,133 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppRevisionEntity = void 0;
+const typeorm_1 = require("typeorm");
+const uuid_1 = require("uuid");
+const application_entity_1 = require("./application.entity");
+const application_status_enum_1 = require("../enums/application-status.enum");
+const app_event_type_enum_1 = require("../enums/app-event-type.enum");
+let AppRevisionEntity = class AppRevisionEntity {
+    generateId() {
+        if (!this.id) {
+            this.id = (0, uuid_1.v4)();
+        }
+    }
+};
+exports.AppRevisionEntity = AppRevisionEntity;
+__decorate([
+    (0, typeorm_1.PrimaryColumn)('uuid'),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.BeforeInsert)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], AppRevisionEntity.prototype, "generateId", null);
+__decorate([
+    (0, typeorm_1.Column)('uuid'),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "applicationId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => application_entity_1.ApplicationEntity, (app) => app.revisions, {
+        onDelete: 'CASCADE',
+    }),
+    (0, typeorm_1.JoinColumn)({ name: 'applicationId' }),
+    __metadata("design:type", application_entity_1.ApplicationEntity)
+], AppRevisionEntity.prototype, "application", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: app_event_type_enum_1.AppEventType,
+        default: app_event_type_enum_1.AppEventType.DEPLOY,
+    }),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "eventType", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', nullable: true }),
+    __metadata("design:type", Object)
+], AppRevisionEntity.prototype, "actor", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', default: '{}' }),
+    __metadata("design:type", Object)
+], AppRevisionEntity.prototype, "changeMetadata", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int', nullable: true }),
+    __metadata("design:type", Number)
+], AppRevisionEntity.prototype, "revisionNumber", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 255, nullable: true }),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "imageRef", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 255, nullable: true }),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "commitSha", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 255, nullable: true }),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "chartVersion", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', default: '{}' }),
+    __metadata("design:type", Object)
+], AppRevisionEntity.prototype, "sourceConfigSnapshot", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', default: '[]' }),
+    __metadata("design:type", Array)
+], AppRevisionEntity.prototype, "envSnapshot", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', default: '{}' }),
+    __metadata("design:type", Object)
+], AppRevisionEntity.prototype, "resourcesSnapshot", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int', nullable: true }),
+    __metadata("design:type", Number)
+], AppRevisionEntity.prototype, "replicas", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: application_status_enum_1.ApplicationStatus,
+        default: application_status_enum_1.ApplicationStatus.PENDING,
+    }),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "errorMessage", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "deployedBy", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "operationId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'uuid', nullable: true }),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "buildId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'json', default: '{}' }),
+    __metadata("design:type", Object)
+], AppRevisionEntity.prototype, "k8sResourceHashes", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", String)
+], AppRevisionEntity.prototype, "rollbackReason", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)({ type: 'timestamptz' }),
+    __metadata("design:type", Date)
+], AppRevisionEntity.prototype, "createdAt", void 0);
+exports.AppRevisionEntity = AppRevisionEntity = __decorate([
+    (0, typeorm_1.Entity)('app_revisions')
+], AppRevisionEntity);

package/lib/src/modules/applications/entities/application.entity.d.ts

@@ -0,0 +1,121 @@
+import { ClusterEntity } from '../../infrastructure/clusters/entities/cluster.entity';
+import { AppRevisionEntity } from './app-revision.entity';
+import { AppResourceEntity } from './app-resource.entity';
+import { ApplicationCategory } from '../enums/application-category.enum';
+import { ApplicationKind } from '../enums/application-kind.enum';
+import { ApplicationSourceType } from '../enums/application-source-type.enum';
+import { ApplicationStatus } from '../enums/application-status.enum';
+import { ApplicationExposure } from '../enums/application-exposure.enum';
+import { ReconciliationStatus } from '../../infrastructure/shared/enums/reconciliation-status.enum';
+import { ApplicationSourceConfig, ApplicationEnvVar, ApplicationResources, ApplicationScaling, ApplicationHealthProbe, ApplicationVolume } from '../interfaces/source-config.interface';
+export declare class ApplicationEntity {
+    id: string;
+    generateId(): void;
+    name: string;
+    slug: string;
+    description?: string;
+    category: ApplicationCategory;
+    kind: ApplicationKind;
+    sourceType: ApplicationSourceType;
+    clusterId: string;
+    cluster: ClusterEntity;
+    k8sNamespace: string;
+    status: ApplicationStatus;
+    reconciliationStatus: ReconciliationStatus;
+    lastReconciliationAt?: Date;
+    reconciliationError?: string;
+    sourceConfig: ApplicationSourceConfig;
+    env: ApplicationEnvVar[];
+    resources: ApplicationResources;
+    scaling: ApplicationScaling;
+    healthProbe?: ApplicationHealthProbe;
+    volumes: ApplicationVolume[];
+    workloadKind: 'Deployment' | 'StatefulSet' | 'DaemonSet';
+    replicas: number;
+    port?: number;
+    currentRevisionId?: string;
+    imageRef?: string;
+    startCommand?: string;
+    userId?: string;
+    systemProtected: boolean;
+    autoDeploy: boolean;
+    /**
+     * Controls how the app is reached. `public` generates Ingress + Certificate
+     * + DNS on a public hostname. `internal` skips all public exposure: only
+     * Deployment + Service ClusterIP are created; the app is reachable only
+     * from the Flui dashboard via the ForwardAuth proxy.
+     */
+    exposure: ApplicationExposure;
+    labels: Record<string, string>;
+    metadata: Record<string, string>;
+    preDeploySnapshotEnabled: boolean;
+    preDeploySnapshotPolicy: 'required' | 'best_effort';
+    preDeployRetention: {
+        maxCopies: number;
+        days: number;
+    };
+    lastDeployedAt?: Date;
+    /** GitHub Actions V2 build path fields */
+    buildPath?: 'github-actions' | 'railpack' | 'dockerfile' | 'image';
+    workflowRunId?: string;
+    /**
+     * Fully-qualified HTML URL of the workflow run on GitHub, cached at commit
+     * time so the frontend can link to it without re-resolving owner/repo.
+     * Populated in generateAndCommitWorkflow[V3] once the run is visible.
+     */
+    workflowRunUrl?: string;
+    /**
+     * Timestamp at which the app entered AWAITING_BUILD. Used by the background
+     * build watcher to enforce a timeout: if we stay in AWAITING_BUILD past
+     * this timestamp + BUILD_TIMEOUT_MS, we transition to FAILED with a clear
+     * error instead of lingering forever.
+     */
+    buildStartedAt?: Date;
+    /**
+     * Snapshot of the GitHub Actions workflow run status from the last watcher
+     * tick (or from /workflow-status polls). Cached so that GET /applications/:id
+     * can return up-to-date build info without hitting the GitHub API.
+     * Values mirror {@link WorkflowRunStatus.status}: queued | in_progress | completed
+     */
+    lastBuildStatus?: string;
+    /**
+     * Cached conclusion of the last completed workflow run. Null while the
+     * build is still queued or in progress. Values mirror
+     * {@link WorkflowRunStatus.conclusion}: success | failure | cancelled | null
+     */
+    lastBuildConclusion?: string;
+    webhookToken?: string;
+    frameworkConfirmed?: string;
+    isFluiManaged: boolean;
+    /**
+     * Placement strategy for the app's PersistentVolumeClaims.
+     *
+     * - `shared` (default): pods can run anywhere; PVCs land on the cluster
+     *   flui-shared (NFS) layer. Safe for stateless apps and light file I/O.
+     * - `dedicated`: pods pin to the master node so writes hit the backing
+     *   Volume directly (no NFS hop). Required for databases (Postgres,
+     *   MariaDB, MongoDB, …) where NFS breaks fsync/locking semantics.
+     *
+     * Source: catalog manifest `spec.persistence.scope`, defaulting to
+     * `shared` when missing.
+     */
+    persistenceScope: 'shared' | 'dedicated';
+    /**
+     * Target node for `persistenceScope=dedicated` workloads.
+     *
+     * - `null` (default) → pinned to the master node via the standard
+     *   `node-role.kubernetes.io/control-plane` selector + tolerations.
+     * - explicit kubernetes node name → pinned to that specific worker via
+     *   `kubernetes.io/hostname=<name>`. The node hosting at least one
+     *   dedicated app is considered "locked" by the cluster scaling
+     *   primitives (cannot be drained nor scale-downed).
+     *
+     * Ignored when `persistenceScope=shared`.
+     */
+    dedicatedNodeName?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date;
+    revisions: AppRevisionEntity[];
+    appResources: AppResourceEntity[];
+}