devops-plugin-kit 0.1.0

package/@danieli-automation/devops-plugin-core/src/core/types/instance/InstanceRowType.ts

@@ -0,0 +1,18 @@
+type ListBoxItem = {
+    id?: string;
+    text?: string;
+    [key: string]: unknown;
+};
+
+type DropdownSelection = unknown;
+
+export type InstanceRowType = {
+    id: string;
+    selectedProjectKey?: string;
+    projectName?: string;
+    selectedTeamKey?: string;
+    teamName?: string;
+    teams: ListBoxItem[];
+    projectSelection: DropdownSelection;
+    teamSelection: DropdownSelection;
+};

package/@danieli-automation/devops-plugin-core/src/core/types/instance/UpdateInstanceInputType.ts

@@ -0,0 +1,10 @@
+import { SelectedProjectType } from "core/types/SelectedProjectType";
+
+export type UpdateInstanceInput = {
+    id: string;
+    name?: string;
+    description?: string;
+    projectTeamPairs?: SelectedProjectType[];
+    owners?: string[];
+    isDefault?: boolean;
+};

package/@danieli-automation/devops-plugin-core/src/core/types/taskOrder/TaskOrderMapType.ts

@@ -0,0 +1,3 @@
+import { TaskOrderType } from "./TaskOrderType";
+
+export type TaskOrderMapType = Record<string, TaskOrderType[]>;

package/@danieli-automation/devops-plugin-core/src/core/types/taskOrder/TaskOrderType.ts

@@ -0,0 +1 @@
+export type TaskOrderType = { id: number; parentId: number; order: number };

package/@danieli-automation/devops-plugin-core/src/core/types/workItemOrder/WorkItemOrderMapType.ts

@@ -0,0 +1,3 @@
+import { WorkItemOrderType } from "./WorkItemOrderType";
+
+export type WorkItemOrderMapType = Record<string, WorkItemOrderType[]>;

package/@danieli-automation/devops-plugin-core/src/core/types/workItemOrder/WorkItemOrderType.ts

@@ -0,0 +1 @@
+export type WorkItemOrderType = { id: number; order: number };

package/@danieli-automation/devops-plugin-core/src/index.ts

@@ -0,0 +1 @@
+export * from "./pluginCore.js";

package/@danieli-automation/devops-plugin-core/src/pluginCore.ts

@@ -0,0 +1,12 @@
+export interface PluginConfig {
+  extensionId: string;
+  projectName?: string;
+  organizationUrl?: string;
+}
+
+export function createPluginContext(config: PluginConfig) {
+  return {
+    ...config,
+    createdAt: new Date().toISOString()
+  };
+}

package/@danieli-automation/devops-plugin-core/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "noImplicitAny": false,
+    "baseUrl": ".",
+    "paths": {
+      "core/*": ["src/core/*"]
+    }
+  },
+  "include": ["src"],
+  "exclude": ["**/__tests__/**"]
+}

package/@danieli-automation/devops-plugin-features/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@danieli-automation/devops-plugin-features",
+  "version": "0.1.0",
+  "description": "Shared feature-level state, hooks, and helpers for Azure DevOps plugins",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "Remove-Item -Recurse -Force dist -ErrorAction SilentlyContinue",
+    "lint": "echo lint not configured",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  }
+}

package/@danieli-automation/devops-plugin-features/src/app/stores/useUIStore.ts

@@ -0,0 +1,12 @@
+export type UIUser = {
+  id?: string;
+  descriptor?: string;
+} | null;
+
+/**
+ * Temporary package-level UI store hook.
+ * Consumers can replace or wrap this with application-specific state.
+ */
+export function useUIStore(): { currentUser: UIUser } {
+  return { currentUser: null };
+}

package/@danieli-automation/devops-plugin-features/src/app/utils/date.ts

@@ -0,0 +1,9 @@
+/**
+ * Converts a date-like input to YYYY-MM-DD string.
+ */
+export function toIsoDate(value: string | Date | null | undefined): string {
+  if (!value) return "";
+  const date = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(date.getTime())) return "";
+  return date.toISOString().slice(0, 10);
+}

package/@danieli-automation/devops-plugin-features/src/app/utils/global.ts

@@ -0,0 +1,9 @@
+/**
+ * Extracts the first path segment as project name.
+ */
+export function extractProjectFromPath(pathValue: string | null | undefined): string {
+  if (!pathValue) return "";
+  const normalized = pathValue.replace(/\\/g, "/");
+  const [project] = normalized.split("/");
+  return project ?? "";
+}

package/@danieli-automation/devops-plugin-features/src/core/azureClients.ts

@@ -0,0 +1,12 @@
+import { getClient } from "azure-devops-extension-api";
+import { CoreRestClient } from "azure-devops-extension-api/Core";
+import { GitRestClient } from "azure-devops-extension-api/Git";
+import { GraphRestClient } from "azure-devops-extension-api/Graph";
+import { WorkRestClient } from "azure-devops-extension-api/Work";
+import { WorkItemTrackingRestClient } from "azure-devops-extension-api/WorkItemTracking";
+
+export const coreClient = () => getClient(CoreRestClient);
+export const witClient = () => getClient(WorkItemTrackingRestClient);
+export const workClient = () => getClient(WorkRestClient);
+export const gitClient = () => getClient(GitRestClient);
+export const graphClient = () => getClient(GraphRestClient);

package/@danieli-automation/devops-plugin-features/src/features/instances/constants/InstanceConstant.ts

@@ -0,0 +1,5 @@
+export default {
+    OWNERS_FIELD_MAX_LEN: 5,
+    TITLE_FIELD_MAX_LEN: 100,
+    DESCRIPTION_FIELD_MAX_LEN: 300,
+}

package/@danieli-automation/devops-plugin-features/src/features/instances/hooks/useInstancePermission.ts

@@ -0,0 +1,127 @@
+import { useUIStore } from "app/stores/useUIStore";
+import { GraphGroup } from "azure-devops-extension-api/Graph";
+import { graphClient } from "core/azureClients";
+import { useInstanceStore } from "features/instances/stores/useInstanceStore";
+import * as React from "react";
+
+type RoleState = {
+    isAdmin: boolean;
+    isJM: boolean;
+    groups: string[];
+    loading: boolean;
+};
+
+/**
+ * Centralized permission logic for instances.
+ * - canReorder = true  -> user can drag & drop backlog order
+ * - canReorder = false -> instance is active and user is NOT a JM
+ */
+export function useInstancePermission() {
+    const { currentInstance } = useInstanceStore();
+    const { currentUser } = useUIStore();
+    const isInstanceMode = !!currentInstance?.id;
+
+    const [roles, setRoles] = React.useState<RoleState>({
+        isAdmin: false,
+        isJM: false,
+        groups: [],
+        loading: false,
+    });
+
+    /*React.useEffect(() => {
+        if (!currentUser) return;
+
+        let mounted = true;
+
+        (async () => {
+            const result = await resolveUserRoles(currentUser);
+            if (mounted) setRoles({ ...result, loading: false });
+        })();
+
+        return () => {
+            mounted = false;
+        };
+    }, [currentUser]);*/
+
+    // Owner logic is **instance-specific**
+
+    const canEditInstance = React.useMemo(() => {
+        if (!isInstanceMode || !currentUser) return false;
+        const currentDescriptor = currentUser?.descriptor;
+        const createdByDescriptor = currentInstance.createdBy?.descriptor;
+        return currentInstance.createdBy.id === currentUser.id ||
+            (!!currentDescriptor && createdByDescriptor === currentDescriptor);
+    }, [isInstanceMode, currentInstance, currentUser]);
+
+    const canReorder = React.useMemo(() => {
+        if (!isInstanceMode) return true; // Personal Board Mode -> can reorder
+        const currentId = currentUser?.id;
+        const currentDescriptor = currentUser?.descriptor;
+        const isOwner =
+            currentInstance.createdBy.id === currentId ||
+            (!!currentDescriptor && currentInstance.createdBy?.descriptor === currentDescriptor);
+
+        const isInOwners =
+            (!!currentId && currentInstance.owners.includes(currentId)) ||
+            (!!currentDescriptor && currentInstance.owners.includes(currentDescriptor));
+
+        return isInOwners || isOwner;
+    }, [isInstanceMode, currentInstance, currentUser]);
+
+    return {
+        isInstanceMode,
+        canEditInstance,  //roles.isAdmin || roles.isJM || isInstanceOwner,
+        canReorder,
+        currentUser,
+        loading: roles.loading,
+        groups: roles.groups,
+        /*
+        ----------------------------------------------------------------------------------------- 
+        @IMPORTANT: as SPM-HUB does not have public api and endpoint to verify the permissions,
+         we are going to bypass the permissions for now (meeting: 28.11.2025 - w/Luca)
+        ----------------------------------------------------------------------------------------- 
+        */
+        isAdmin: true,//roles.isAdmin,
+        isJM: true, // roles.isJM,
+        canCreateInstance: true, //roles.isAdmin || roles.isJM
+    };
+}
+
+//#region Private Functions
+async function resolveUserRoles(user: any) {
+    try {
+        const descriptor = user.descriptor;
+        if (!descriptor) {
+            return { isAdmin: false, isJM: false, groups: [] as string[] };
+        }
+        const gClient = graphClient();
+        const memberships = await gClient.listMemberships(descriptor);
+
+        const roles = {
+            isAdmin: false,
+            isJM: false,
+            groups: [] as string[],
+        };
+
+        for (const m of memberships) {
+            const group = await gClient.getGroup(m.containerDescriptor) as GraphGroup;
+            const name = group?.displayName?.toLowerCase() ?? "";
+
+            roles.groups.push(name);
+
+            if (name.includes("project administrators") || name.includes("collection administrators")) {
+                roles.isAdmin = true;
+            }
+
+            if (name.includes("jm") || name.includes("owner")) {
+                roles.isJM = true;
+            }
+        }
+
+        return roles;
+    } catch (err) {
+        console.warn("resolveUserRoles error:", err);
+        return { isAdmin: false, isJM: false, groups: [] };
+    }
+}
+//#endregion

package/@danieli-automation/devops-plugin-features/src/features/instances/stores/__tests__/useInstanceStore.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, it } from "vitest";
+import { useInstanceStore } from "../useInstanceStore";
+
+describe("useInstanceStore", () => {
+    //#region currentInstance
+    it("currentInstance: has correct initial state", () => {
+        expect(useInstanceStore.getState().currentInstance).toEqual(null);
+    });
+
+    it("setCurrentInstance: sets instance as current iteration.", () => {
+        const instance = {
+            id: "1",
+            name: "Instance Name",
+            org: "demo-org",
+            createdBy: { id: "u1" },
+            owners: [],
+            projectTeamPairs: [],
+            createdAt: "2025-01-01T00:00:00.000Z",
+            updatedAt: "2025-01-01T00:00:00.000Z"
+        };
+        useInstanceStore.getState().setCurrentInstance(instance);
+        expect(useInstanceStore.getState().currentInstance).toEqual(instance);
+    });
+    //#endregion
+});

package/@danieli-automation/devops-plugin-features/src/features/instances/stores/types/InstanceStoreType.ts

@@ -0,0 +1,7 @@
+import { CrossSprintInstanceType } from "features/instances/types/CrossSprintInstanceType";
+
+export type InstanceStoreType = {
+    currentInstance: CrossSprintInstanceType | null;
+
+    setCurrentInstance: (instance: CrossSprintInstanceType | null) => void;
+};

package/@danieli-automation/devops-plugin-features/src/features/instances/stores/useInstanceStore.ts

@@ -0,0 +1,9 @@
+import { CrossSprintInstanceType } from "features/instances/types/CrossSprintInstanceType";
+import { InstanceStoreType } from "features/instances/stores/types/InstanceStoreType";
+import { create } from "zustand";
+
+export const useInstanceStore = create<InstanceStoreType>((set) => ({
+    currentInstance: null,
+
+    setCurrentInstance: (instance: CrossSprintInstanceType | null) => set({ currentInstance: instance }),
+}));

package/@danieli-automation/devops-plugin-features/src/features/instances/types/CrossSprintInstanceType.ts

@@ -0,0 +1,20 @@
+import { SelectedProjectType } from "features/teams/types/SelectedProjectType";
+
+export type CrossSprintInstanceType = {
+    id: string;
+    name: string;
+    description?: string;
+
+    org: string;
+    createdBy: any;
+    owners: string[];
+
+    projectTeamPairs: SelectedProjectType[];
+
+    createdAt: string;
+    updatedAt: string;
+
+    isDefault?: boolean;
+};
+
+export type CrossSprintInstanceMap = Record<string, CrossSprintInstanceType>;

package/@danieli-automation/devops-plugin-features/src/features/instances/utils/instance.ts

@@ -0,0 +1,55 @@
+import { CrossSprintInstanceType } from "features/instances/types/CrossSprintInstanceType";
+import { TeamMember } from "features/teams/types/TeamMemberType";
+
+/**
+ * Checks whether a user is owner-level for the instance (owner list or creator).
+ *
+ * @param inst Cross-sprint instance.
+ * @param user Current user.
+ * @returns `true` when user is owner or creator.
+ */
+export function isInstanceOwner(inst: CrossSprintInstanceType, user: TeamMember) {
+    const uid = user?.id;
+    const descriptor = user?.descriptor;
+    if (!uid && !descriptor) return false;
+
+    const inOwners = (!!uid && inst.owners?.includes(uid)) || (!!descriptor && inst.owners?.includes(descriptor));
+
+    return inOwners || isInstanceCreator(inst, user);
+}
+
+/**
+ * Checks whether an instance is explicitly shared with a user but not created by them.
+ *
+ * @param inst Cross-sprint instance.
+ * @param user Current user.
+ * @returns `true` when user is in owners list and is not creator.
+ */
+export function isInstanceSharedWithMe(inst: CrossSprintInstanceType, user: TeamMember) {
+    const uid = user?.id;
+    const descriptor = user?.descriptor;
+    if (!uid && !descriptor) return false;
+
+    const inOwners =
+        (!!uid && inst.owners?.includes(uid)) ||
+        (!!descriptor && inst.owners?.includes(descriptor));
+
+    return inOwners && !isInstanceCreator(inst, user);
+}
+
+/**
+ * Checks whether a user is the creator of the given instance.
+ *
+ * @param inst Cross-sprint instance.
+ * @param user Current user.
+ * @returns `true` when created-by identity matches user id or descriptor.
+ */
+export function isInstanceCreator(inst: CrossSprintInstanceType, user: TeamMember) {
+    const uid = user?.id;
+    const descriptor = user?.descriptor;
+
+    return (
+        (!!uid && inst.createdBy?.id === uid) ||
+        (!!descriptor && inst.createdBy?.descriptor === descriptor)
+    );
+}