[Dashboards as code] Add conversion functions from/to API filters interface and stored filters

.github/CODEOWNERS

@@ -410,6 +410,9 @@ src/platform/packages/private/kbn-validate-oas @elastic/kibana-core
 src/platform/packages/private/opentelemetry/kbn-metrics @elastic/kibana-core @elastic/stack-monitoring
 src/platform/packages/private/opentelemetry/kbn-metrics-config @elastic/kibana-core
 src/platform/packages/private/shared-ux/storybook/config @elastic/appex-sharedux
+src/platform/packages/shared/as-code/filters-constants @elastic/kibana-presentation
+src/platform/packages/shared/as-code/filters-schema @elastic/kibana-presentation
+src/platform/packages/shared/as-code/filters-transforms @elastic/kibana-presentation
 src/platform/packages/shared/chart-expressions-common @elastic/kibana-visualizations
 src/platform/packages/shared/chart-test-jest-helpers @elastic/kibana-visualizations
 src/platform/packages/shared/cloud @elastic/kibana-core

package.json

@@ -225,6 +225,9 @@
     "@kbn/apm-utils": "link:src/platform/packages/shared/kbn-apm-utils",
     "@kbn/app-link-test-plugin": "link:src/platform/test/plugin_functional/plugins/app_link_test",
     "@kbn/application-usage-test-plugin": "link:x-pack/platform/test/usage_collection/plugins/application_usage_test",
+    "@kbn/as-code-filters-constants": "link:src/platform/packages/shared/as-code/filters-constants",
+    "@kbn/as-code-filters-schema": "link:src/platform/packages/shared/as-code/filters-schema",
+    "@kbn/as-code-filters-transforms": "link:src/platform/packages/shared/as-code/filters-transforms",
     "@kbn/audit-log-plugin": "link:x-pack/platform/test/security_api_integration/plugins/audit_log",
     "@kbn/automatic-import-plugin": "link:x-pack/platform/plugins/shared/automatic_import",
     "@kbn/automatic-import-v2-plugin": "link:x-pack/platform/plugins/shared/automatic_import_v2",

src/platform/packages/shared/as-code/filters-constants/README.md

@@ -0,0 +1,3 @@
+# @kbn/as-code-filters-constants
+
+Constants that can be used by both `@kbn/as-code-filters-schema` and `@kbn/as-code-filters-transforms` packages to avoid circular references.

src/platform/packages/shared/as-code/filters-constants/index.ts

@@ -0,0 +1,12 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+export { ASCODE_FILTER_OPERATOR } from './src/constants';
+export { ASCODE_GROUPED_CONDITION_TYPE } from './src/constants';
+export { ASCODE_FILTER_TYPE } from './src/constants';

src/platform/packages/shared/as-code/filters-constants/jest.config.js

@@ -0,0 +1,14 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+module.exports = {
+  preset: '@kbn/test/jest_node',
+  rootDir: '../../../../../..',
+  roots: ['<rootDir>/src/platform/packages/shared/as-code/filters-constants'],
+};

src/platform/packages/shared/as-code/filters-constants/kibana.jsonc

@@ -0,0 +1,7 @@
+{
+  "type": "shared-common",
+  "id": "@kbn/as-code-filters-constants",
+  "owner": "@elastic/kibana-presentation",
+  "group": "platform",
+  "visibility": "shared"
+}

src/platform/packages/shared/as-code/filters-constants/moon.yml

@@ -0,0 +1,44 @@
+# This file is generated by the @kbn/moon package. Any manual edits will be erased!
+#  To extend this, write your extensions/overrides to 'moon.extend.yml'
+#  then regenerate this file with: 'node scripts/regenerate_moon_projects.js --update --filter @kbn/as-code-filters-constants'
+
+$schema: https://moonrepo.dev/schemas/project.json
+id: '@kbn/as-code-filters-constants'
+type: unknown
+owners:
+  defaultOwner: '@elastic/kibana-presentation'
+toolchain:
+  default: node
+language: typescript
+project:
+  name: '@kbn/as-code-filters-constants'
+  description: Moon project for @kbn/as-code-filters-constants
+  channel: ''
+  owner: '@elastic/kibana-presentation'
+  metadata:
+    sourceRoot: src/platform/packages/shared/as-code/filters-constants
+dependsOn: []
+tags:
+  - shared-common
+  - package
+  - prod
+  - group-platform
+  - shared
+  - jest-unit-tests
+fileGroups:
+  src:
+    - '**/*.ts'
+    - '!target/**/*'
+tasks:
+  jest:
+    args:
+      - '--config'
+      - $projectRoot/jest.config.js
+    inputs:
+      - '@group(src)'
+  jestCI:
+    args:
+      - '--config'
+      - $projectRoot/jest.config.js
+    inputs:
+      - '@group(src)'

src/platform/packages/shared/as-code/filters-constants/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@kbn/as-code-filters-constants",
+  "private": true,
+  "version": "1.0.0",
+  "license": "Elastic License 2.0 OR AGPL-3.0-only OR SSPL-1.0",
+  "sideEffects": false
+}

src/platform/packages/shared/as-code/filters-constants/src/constants.ts

@@ -0,0 +1,31 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+/**
+ * As Code Filter operator constants
+ * These operators are used in SimpleFilterCondition to specify how to match field values
+ */
+export const ASCODE_FILTER_OPERATOR = {
+  IS: 'is',
+  IS_ONE_OF: 'is_one_of',
+  EXISTS: 'exists',
+  RANGE: 'range',
+} as const;
+
+export const ASCODE_GROUPED_CONDITION_TYPE = {
+  AND: 'and',
+  OR: 'or',
+} as const;
+
+export const ASCODE_FILTER_TYPE = {
+  CONDITION: 'condition',
+  GROUP: 'group',
+  DSL: 'dsl',
+  SPATIAL: 'spatial',
+} as const;

src/platform/packages/shared/as-code/filters-constants/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "@kbn/tsconfig-base/tsconfig.json",
+  "compilerOptions": {
+    "outDir": "target/types",
+  },
+  "include": [
+    "**/*.ts",
+  ],
+  "exclude": [
+    "target/**/*"
+  ],
+  "kbn_references": []
+}

src/platform/packages/shared/as-code/filters-schema/README.md

@@ -0,0 +1,160 @@
+# @kbn/as-code-filters-schema
+
+Validation schemas and TypeScript types for the **Kibana As Code Filter Interface**.
+
+## Overview
+
+This package provides runtime validation schemas and corresponding TypeScript types for filters in the Kibana As Code API. It uses `@kbn/config-schema` for validation and is designed for server-side use in API route handlers.
+
+## Filter Structure
+
+The As Code filter interface supports three main filter types:
+
+### 1. Condition Filters
+
+Single field-value comparisons with type-safe operators:
+
+```typescript
+import {
+  asCodeConditionFilterSchema,
+  type AsCodeConditionFilter,
+} from '@kbn/as-code-filters-schema';
+
+// Examples of condition filters:
+const isFilter: AsCodeConditionFilter = {
+  condition: { field: 'status', operator: 'is', value: 'active' },
+};
+
+const isOneOfFilter: AsCodeConditionFilter = {
+  condition: { field: 'category', operator: 'is_one_of', value: ['A', 'B', 'C'] },
+};
+
+const rangeFilter: AsCodeConditionFilter = {
+  condition: { field: 'price', operator: 'range', value: { gte: 10, lte: 100 } },
+  negate: false, // Only range filters have negate property
+};
+
+const existsFilter: AsCodeConditionFilter = {
+  condition: { field: 'description', operator: 'exists' },
+};
+```
+
+**Operators:**
+
+- `is` / `is_not` - Single value comparison
+- `is_one_of` / `is_not_one_of` - Array value comparison
+- `range` - Numeric/date range (has `negate` property)
+- `exists` / `not_exists` - Field existence check
+
+### 2. Group Filters
+
+Logical combinations of conditions with AND/OR:
+
+```typescript
+import { asCodeGroupFilterSchema, type AsCodeGroupFilter } from '@kbn/as-code-filters-schema';
+
+const groupFilter: AsCodeGroupFilter = {
+  group: {
+    operator: 'and',
+    conditions: [
+      { field: 'status', operator: 'is', value: 'active' },
+      { field: 'priority', operator: 'range', value: { gte: 5 } },
+    ],
+  },
+  negate: false, // Can negate entire group
+};
+```
+
+Groups support nesting for complex logic:
+
+```typescript
+const nestedGroup: AsCodeGroupFilter = {
+  group: {
+    operator: 'or',
+    conditions: [
+      { field: 'region', operator: 'is', value: 'US' },
+      {
+        group: {
+          operator: 'and',
+          conditions: [
+            { field: 'region', operator: 'is', value: 'EU' },
+            { field: 'vip', operator: 'is', value: true },
+          ],
+        },
+      },
+    ],
+  },
+};
+```
+
+### 3. DSL Filters
+
+Raw Elasticsearch Query DSL for advanced queries:
+
+```typescript
+import { asCodeDSLFilterSchema, type AsCodeDSLFilter } from '@kbn/as-code-filters-schema';
+
+const dslFilter: AsCodeDSLFilter = {
+  dsl: {
+    match_phrase: {
+      message: 'quick brown fox',
+    },
+  },
+  negate: false,
+};
+```
+
+## Common Properties
+
+All filters support these optional metadata properties:
+
+```typescript
+interface CommonProperties {
+  disabled?: boolean; // Filter is disabled
+  controlledBy?: string; // Component managing this filter
+  dataViewId?: string; // Associated data view
+  label?: string; // Human-readable label
+  isMultiIndex?: boolean; // Applies to multiple indices
+
+  // Legacy compatibility (deprecated):
+  filterType?: string; // Legacy filter type
+  key?: string; // Legacy field name
+  value?: string; // Legacy value
+}
+```
+
+## Usage in API Routes
+
+```typescript
+import { asCodeFilterSchema, type AsCodeFilter } from '@kbn/as-code-filters-schema';
+
+router.post(
+  {
+    path: '/api/dashboards/{id}/filters',
+    validate: {
+      body: schema.object({
+        filters: schema.arrayOf(asCodeFilterSchema),
+      }),
+    },
+  },
+  async (context, request, response) => {
+    const { filters } = request.body;
+    // filters is typed as AsCodeFilter[]
+    // ... process filters
+  }
+);
+```
+
+## Exported Schemas
+
+- `asCodeFilterSchema` - Main discriminated union schema
+- `asCodeConditionFilterSchema` - Condition filter schema
+- `asCodeGroupFilterSchema` - Group filter schema
+- `asCodeDSLFilterSchema` - DSL filter schema
+
+## Exported Types Inferred from Schemas
+
+- `AsCodeFilter` - Main discriminated union type
+- `AsCodeConditionFilter` - Condition filter type
+- `AsCodeGroupFilter` - Group filter type
+- `AsCodeDSLFilter` - DSL filter type

src/platform/packages/shared/as-code/filters-schema/index.ts

@@ -0,0 +1,24 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+export {
+  asCodeFilterSchema,
+  asCodeConditionFilterSchema,
+  asCodeGroupFilterSchema,
+  asCodeDSLFilterSchema,
+  asCodeSpatialFilterSchema,
+} from './src/schemas/filter';
+
+export type {
+  AsCodeFilter,
+  AsCodeConditionFilter,
+  AsCodeGroupFilter,
+  AsCodeDSLFilter,
+  AsCodeSpatialFilter,
+} from './src/types';

src/platform/packages/shared/as-code/filters-schema/jest.config.js

@@ -0,0 +1,14 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the "Elastic License
+ * 2.0", the "GNU Affero General Public License v3.0 only", and the "Server Side
+ * Public License v 1"; you may not use this file except in compliance with, at
+ * your election, the "Elastic License 2.0", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+module.exports = {
+  preset: '@kbn/test/jest_node',
+  rootDir: '../../../../../..',
+  roots: ['<rootDir>/src/platform/packages/shared/as-code/filters-schema'],
+};

src/platform/packages/shared/as-code/filters-schema/kibana.jsonc

@@ -0,0 +1,7 @@
+{
+  "type": "shared-common",
+  "id": "@kbn/as-code-filters-schema",
+  "owner": "@elastic/kibana-presentation",
+  "group": "platform",
+  "visibility": "shared"
+}