@checkstack/backend-api 0.8.2 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @checkstack/backend-api
 
+## 0.10.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`.
+
+### Patch Changes
+
+- @checkstack/queue-api@0.2.9
+
+## 0.9.0
+
+### Minor Changes
+
+- c0c0ed2: Introduce generic "Login Flows" to allow authentication strategies to define their own interaction patterns (form, redirect, or oauth) during registration. This fixes an issue where LDAP login attempts were incorrectly routed through the standard social login flow by instead providing a dedicated credential collection form for LDAP.
+
+### Patch Changes
+
+- @checkstack/queue-api@0.2.8
+
 ## 0.8.2
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/backend-api",
-  "version": "0.8.2",
+  "version": "0.10.0",
   "type": "module",
   "main": "./src/index.ts",
   "scripts": {
@@ -9,10 +9,10 @@
     "lint:code": "eslint . --max-warnings 0"
   },
   "dependencies": {
-    "@checkstack/common": "0.6.3",
-    "@checkstack/healthcheck-common": "0.8.3",
-    "@checkstack/queue-api": "0.2.6",
-    "@checkstack/signal-common": "0.1.7",
+    "@checkstack/common": "0.6.4",
+    "@checkstack/healthcheck-common": "0.8.4",
+    "@checkstack/queue-api": "0.2.7",
+    "@checkstack/signal-common": "0.1.8",
     "@orpc/client": "^1.13.14",
     "@orpc/contract": "^1.13.14",
     "@orpc/openapi": "^1.13.2",
@@ -25,8 +25,8 @@
   },
   "devDependencies": {
     "@types/bun": "latest",
-    "@checkstack/tsconfig": "0.0.3",
-    "@checkstack/scripts": "0.1.1"
+    "@checkstack/tsconfig": "0.0.4",
+    "@checkstack/scripts": "0.1.2"
   },
   "peerDependencies": {
     "hono": "^4.12.14",

package/src/auth-strategy.ts

@@ -45,8 +45,32 @@ export interface AuthStrategy<Config = unknown> {
    * Displayed in the StrategyConfigCard before the configuration form.
    */
   adminInstructions?: string;
+
+  /**
+   * Defines how the frontend should interact with this strategy during login.
+   * If not provided, it defaults to 'oauth' for non-credential strategies.
+   */
+  clientFlow?: AuthClientFlow;
 }
 
+/**
+ * Defines the interaction pattern for the frontend during login.
+ */
+export type AuthClientFlow =
+  | { type: "oauth" } // Standard Better-Auth social flow
+  | { type: "redirect"; target: string } // Redirects user to a custom URL
+  | {
+      type: "form";
+      target: string;
+      fields: Array<{
+        name: string;
+        label: string;
+        type: "text" | "password";
+        placeholder?: string;
+      }>;
+    } // Custom credential collection form
+  | { type: "credential" }; // Native internal credential flow (internal only)
+
 /**
  * Registry for authentication strategies.
  * Allows plugins to register custom auth strategies.

package/src/schema-utils.ts

@@ -67,6 +67,9 @@ function addSchemaMetadata(
       if (meta["x-editor-types"]) {
         jsonField["x-editor-types"] = meta["x-editor-types"];
       }
+      if (meta["x-hidden-when"]) {
+        jsonField["x-hidden-when"] = meta["x-hidden-when"];
+      }
       if (meta["x-options-resolver"]) {
         jsonField["x-options-resolver"] = meta["x-options-resolver"];
         if (meta["x-depends-on"])

package/src/zod-config.ts

@@ -22,6 +22,13 @@ export interface ConfigMeta {
   "x-depends-on"?: string[];
   /** If true, renders a searchable/filterable dropdown */
   "x-searchable"?: boolean;
+  /**
+   * Conditionally hide this field based on sibling field values.
+   * Keys are sibling field names, values are arrays of values that trigger hiding.
+   * The field is hidden when any condition matches.
+   * @example { authMode: ["datacenter"] } — hides this field when authMode is "datacenter"
+   */
+  "x-hidden-when"?: Record<string, string[]>;
   /**
    * Available editor types for this field. Renders a dropdown to select editor mode.
    * When templateProperties are provided to DynamicForm, autocomplete works in all types.