@checkstack/ui 1.1.4 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @checkstack/ui
 
+## 1.2.0
+
+### Minor Changes
+
+- 23c80bc: ### Jira Data Center Support
+
+  Added support for on-premise Jira Data Center installations alongside existing Jira Cloud support:
+
+  - **Authentication mode switching**: New `authMode` field (`cloud` | `datacenter`) on connection configuration. Cloud uses Basic Auth (email + API token), Data Center uses Bearer Auth (Personal Access Token).
+  - **API version routing**: Automatically selects REST API v3 for Cloud and v2 for Data Center.
+  - **Description format**: Cloud uses Atlassian Document Format (ADF), Data Center uses plain text.
+  - **Connection schema v2**: Backward-compatible — defaults to `cloud` mode for existing connections.
+
+  ### DynamicForm `x-hidden-when` Conditional Visibility
+
+  New generic platform feature for conditionally hiding form fields based on sibling field values:
+
+  - Added `x-hidden-when` metadata extension to `ConfigMeta` and `JsonSchemaProperty`.
+  - DynamicForm automatically hides fields and skips their validation when conditions match.
+  - Used by Jira integration to hide the email field when `authMode` is `datacenter`.
+
+## 1.1.5
+
+### Patch Changes
+
+- 95aa716: Fix LDAP CA certificate input: The custom CA certificate field was rendered as a single-line password input, which stripped newlines from PEM certificates and caused TLS connection failures ("Failed to connect"). The field now renders as a multi-line secret textarea that properly preserves PEM format while still encrypting the value in storage.
+
 ## 1.1.4
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/ui",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "type": "module",
   "main": "src/index.ts",
   "dependencies": {

package/src/components/DynamicForm/DynamicForm.tsx

@@ -3,7 +3,7 @@ import React from "react";
 import { EmptyState } from "../../index";
 
 import type { DynamicFormProps } from "./types";
-import { extractDefaults, isValueEmpty } from "./utils";
+import { extractDefaults, isValueEmpty, isFieldHiddenByCondition } from "./utils";
 import { FormField } from "./FormField";
 
 /**
@@ -50,6 +50,13 @@ export const DynamicForm: React.FC<DynamicFormProps> = ({
       // Skip hidden fields - they are auto-populated
       if (propSchema["x-hidden"]) continue;
 
+      // Skip conditionally hidden fields - they are not visible
+      if (
+        propSchema["x-hidden-when"] &&
+        isFieldHiddenByCondition(propSchema["x-hidden-when"], value)
+      )
+        continue;
+
       if (isValueEmpty(value[key], propSchema)) {
         isValid = false;
         break;
@@ -79,7 +86,15 @@ export const DynamicForm: React.FC<DynamicFormProps> = ({
   return (
     <div className="space-y-6">
       {Object.entries(schema.properties)
-        .filter(([, propSchema]) => !propSchema["x-hidden"])
+        .filter(([, propSchema]) => {
+          if (propSchema["x-hidden"]) return false;
+          if (
+            propSchema["x-hidden-when"] &&
+            isFieldHiddenByCondition(propSchema["x-hidden-when"], value)
+          )
+            return false;
+          return true;
+        })
         .map(([key, propSchema]) => {
           const isRequired = schema.required?.includes(key);
           const label = key.charAt(0).toUpperCase() + key.slice(1);

package/src/components/DynamicForm/FormField.tsx

@@ -140,6 +140,20 @@ export const FormField: React.FC<FormFieldProps> = ({
       propSchema as JsonSchemaProperty & { "x-secret"?: boolean }
     )["x-secret"];
 
+    // Secret textarea fields (e.g., PEM certificates)
+    if (isTextarea && isSecret) {
+      return (
+        <SecretTextareaField
+          id={id}
+          label={label}
+          description={cleanDesc}
+          value={value as string}
+          isRequired={isRequired}
+          onChange={onChange}
+        />
+      );
+    }
+
     // Textarea fields
     if (isTextarea) {
       return (
@@ -577,6 +591,56 @@ export const FormField: React.FC<FormFieldProps> = ({
   return <></>;
 };
 
+/**
+ * Shared visibility toggle button for secret fields.
+ */
+const VisibilityToggle: React.FC<{
+  visible: boolean;
+  onToggle: () => void;
+}> = ({ visible, onToggle }) => (
+  <button
+    type="button"
+    onClick={onToggle}
+    className="absolute right-2 top-3 text-muted-foreground hover:text-foreground"
+  >
+    {visible ? (
+      <svg
+        className="h-5 w-5"
+        fill="none"
+        stroke="currentColor"
+        viewBox="0 0 24 24"
+      >
+        <path
+          strokeLinecap="round"
+          strokeLinejoin="round"
+          strokeWidth={2}
+          d="M13.875 18.825A10.05 10.05 0 0112 19c-4.478 0-8.268-2.943-9.543-7a9.97 9.97 0 011.563-3.029m5.858.908a3 3 0 114.243 4.243M9.878 9.878l4.242 4.242M9.88 9.88l-3.29-3.29m7.532 7.532l3.29 3.29M3 3l3.59 3.59m0 0A9.953 9.953 0 0112 5c4.478 0 8.268 2.943 9.543 7a10.025 10.025 0 01-4.132 5.411m0 0L21 21"
+        />
+      </svg>
+    ) : (
+      <svg
+        className="h-5 w-5"
+        fill="none"
+        stroke="currentColor"
+        viewBox="0 0 24 24"
+      >
+        <path
+          strokeLinecap="round"
+          strokeLinejoin="round"
+          strokeWidth={2}
+          d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"
+        />
+        <path
+          strokeLinecap="round"
+          strokeLinejoin="round"
+          strokeWidth={2}
+          d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"
+        />
+      </svg>
+    )}
+  </button>
+);
+
 /**
  * Secret field component with password visibility toggle.
  * Extracted to keep hooks at component top level.
@@ -612,47 +676,91 @@ const SecretField: React.FC<{
           placeholder={hasExistingValue ? "••••••••" : "Enter secret value"}
           className="pr-10"
         />
-        <button
-          type="button"
-          onClick={() => setShowPassword(!showPassword)}
-          className="absolute right-2 top-1/2 -translate-y-1/2 text-muted-foreground hover:text-foreground"
-        >
-          {showPassword ? (
-            <svg
-              className="h-5 w-5"
-              fill="none"
-              stroke="currentColor"
-              viewBox="0 0 24 24"
-            >
-              <path
-                strokeLinecap="round"
-                strokeLinejoin="round"
-                strokeWidth={2}
-                d="M13.875 18.825A10.05 10.05 0 0112 19c-4.478 0-8.268-2.943-9.543-7a9.97 9.97 0 011.563-3.029m5.858.908a3 3 0 114.243 4.243M9.878 9.878l4.242 4.242M9.88 9.88l-3.29-3.29m7.532 7.532l3.29 3.29M3 3l3.59 3.59m0 0A9.953 9.953 0 0112 5c4.478 0 8.268 2.943 9.543 7a10.025 10.025 0 01-4.132 5.411m0 0L21 21"
-              />
-            </svg>
-          ) : (
-            <svg
-              className="h-5 w-5"
-              fill="none"
-              stroke="currentColor"
-              viewBox="0 0 24 24"
-            >
-              <path
-                strokeLinecap="round"
-                strokeLinejoin="round"
-                strokeWidth={2}
-                d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"
-              />
-              <path
-                strokeLinecap="round"
-                strokeLinejoin="round"
-                strokeWidth={2}
-                d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"
-              />
-            </svg>
-          )}
-        </button>
+        <VisibilityToggle
+          visible={showPassword}
+          onToggle={() => setShowPassword(!showPassword)}
+        />
+      </div>
+      {hasExistingValue && currentValue === "" && (
+        <p className="text-xs text-muted-foreground">
+          Leave empty to keep existing value
+        </p>
+      )}
+    </div>
+  );
+};
+
+/**
+ * Secret textarea field for multi-line secrets (e.g., PEM certificates).
+ * Renders a textarea with a visibility toggle and secret-like behavior.
+ */
+const SecretTextareaField: React.FC<{
+  id: string;
+  label: string;
+  description?: string;
+  value: string;
+  isRequired?: boolean;
+  onChange: (val: unknown) => void;
+}> = ({ id, label, description, value, isRequired, onChange }) => {
+  const [showContent, setShowContent] = React.useState(false);
+  const currentValue = value || "";
+  const hasExistingValue = currentValue.length > 0;
+
+  return (
+    <div className="space-y-2">
+      <div>
+        <Label htmlFor={id}>
+          {label} {isRequired && "*"}
+        </Label>
+        {description && (
+          <p className="text-sm text-muted-foreground mt-0.5">{description}</p>
+        )}
+      </div>
+      <div className="relative">
+        {showContent ? (
+          <Textarea
+            id={id}
+            value={currentValue}
+            onChange={(e) => onChange(e.target.value)}
+            placeholder={
+              hasExistingValue ? "Leave empty to keep existing value" : "Paste content here"
+            }
+            rows={5}
+            className="pr-10 font-mono text-xs"
+          />
+        ) : (
+          <Textarea
+            id={id}
+            value={currentValue ? "••••••••••••••••••••" : ""}
+            onChange={(e) => {
+              // If user types/pastes into masked field, switch to visible mode
+              const newVal = e.target.value.replaceAll("•", "");
+              if (newVal) {
+                setShowContent(true);
+                onChange(newVal);
+              }
+            }}
+            onPaste={(e) => {
+              // On paste, switch to visible mode and use pasted content
+              e.preventDefault();
+              const pastedText = e.clipboardData.getData("text");
+              if (pastedText) {
+                setShowContent(true);
+                onChange(pastedText);
+              }
+            }}
+            placeholder={
+              hasExistingValue ? "Leave empty to keep existing value" : "Paste content here"
+            }
+            rows={3}
+            className="pr-10"
+            readOnly={!!currentValue}
+          />
+        )}
+        <VisibilityToggle
+          visible={showContent}
+          onToggle={() => setShowContent(!showContent)}
+        />
       </div>
       {hasExistingValue && currentValue === "" && (
         <p className="text-xs text-muted-foreground">

package/src/components/DynamicForm/types.ts

@@ -21,6 +21,7 @@ export interface JsonSchemaProperty extends JsonSchemaPropertyCore<JsonSchemaPro
   "x-hidden"?: boolean; // Field should be hidden in form (auto-populated)
   "x-searchable"?: boolean; // Shows search input for filtering dropdown options
   "x-editor-types"?: EditorType[]; // Available editor types for multi-type input
+  "x-hidden-when"?: Record<string, string[]>; // Conditionally hide based on sibling field values
 }
 
 /** Option returned by an options resolver */

package/src/components/DynamicForm/utils.test.ts

@@ -5,6 +5,7 @@ import {
   extractDefaults,
   getCleanDescription,
   isValueEmpty,
+  isFieldHiddenByCondition,
   NONE_SENTINEL,
   parseSelectValue,
   serializeFormData,
@@ -398,3 +399,71 @@ describe("detectEditorType", () => {
     });
   });
 });
+
+// =============================================================================
+// Conditional Visibility Tests
+// =============================================================================
+
+describe("isFieldHiddenByCondition", () => {
+  it("returns true when sibling value matches a value in the array", () => {
+    const conditions = { authMode: ["datacenter"] };
+    const formValues = { authMode: "datacenter" };
+    expect(isFieldHiddenByCondition(conditions, formValues)).toBe(true);
+  });
+
+  it("returns true when sibling value matches any value in the array", () => {
+    const conditions = { authMode: ["datacenter", "server"] };
+    const formValues = { authMode: "server" };
+    expect(isFieldHiddenByCondition(conditions, formValues)).toBe(true);
+  });
+
+  it("returns false when sibling value does not match", () => {
+    const conditions = { authMode: ["datacenter"] };
+    const formValues = { authMode: "cloud" };
+    expect(isFieldHiddenByCondition(conditions, formValues)).toBe(false);
+  });
+
+  it("returns false when sibling field is missing (coerces to empty string)", () => {
+    const conditions = { authMode: ["datacenter"] };
+    const formValues = {};
+    expect(isFieldHiddenByCondition(conditions, formValues)).toBe(false);
+  });
+
+  it("returns true when sibling field is missing and empty string is in the value list", () => {
+    const conditions = { authMode: [""] };
+    const formValues = {};
+    expect(isFieldHiddenByCondition(conditions, formValues)).toBe(true);
+  });
+
+  it("handles multiple conditions with OR semantics (any match hides)", () => {
+    const conditions = {
+      authMode: ["datacenter"],
+      environment: ["staging"],
+    };
+    // Only authMode matches
+    expect(
+      isFieldHiddenByCondition(conditions, {
+        authMode: "datacenter",
+        environment: "production",
+      }),
+    ).toBe(true);
+    // Only environment matches
+    expect(
+      isFieldHiddenByCondition(conditions, {
+        authMode: "cloud",
+        environment: "staging",
+      }),
+    ).toBe(true);
+    // Neither matches
+    expect(
+      isFieldHiddenByCondition(conditions, {
+        authMode: "cloud",
+        environment: "production",
+      }),
+    ).toBe(false);
+  });
+
+  it("returns false for empty conditions object", () => {
+    expect(isFieldHiddenByCondition({}, { authMode: "cloud" })).toBe(false);
+  });
+});

package/src/components/DynamicForm/utils.ts

@@ -72,6 +72,22 @@ export function isValueEmpty(
 /** Sentinel value used to represent "None" selection in Select components */
 export const NONE_SENTINEL = "__none__";
 
+/**
+ * Evaluate x-hidden-when conditions against current form values.
+ * Returns true if the field should be hidden.
+ *
+ * Each condition maps a sibling field name to values that trigger hiding.
+ * The field is hidden if ANY condition matches (OR semantics).
+ */
+export function isFieldHiddenByCondition(
+  conditions: Record<string, string[]>,
+  formValues: Record<string, unknown>,
+): boolean {
+  return Object.entries(conditions).some(([field, values]) =>
+    values.includes(String(formValues[field] ?? "")),
+  );
+}
+
 /**
  * Converts a select value to the actual form value.
  * Handles the "None" sentinel value by returning undefined.