@n-dx/core 0.1.0

package/packages/rex/dist/store/file-adapter.js

@@ -0,0 +1,150 @@
+import { readFile, writeFile, appendFile, mkdir, rename, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { validateDocument, validateConfig, validateLogEntry } from "../schema/validate.js";
+import { toCanonicalJSON } from "../core/canonical.js";
+import { findItem, insertChild, updateInTree, removeFromTree } from "../core/tree.js";
+import { loadProjectOverrides, mergeWithOverrides } from "./project-config.js";
+import { atomicWriteJSON } from "./atomic-write.js";
+export class FileStore {
+    rexDir;
+    constructor(rexDir) {
+        this.rexDir = rexDir;
+    }
+    path(file) {
+        return join(this.rexDir, file);
+    }
+    async loadDocument() {
+        const raw = await readFile(this.path("prd.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        const result = validateDocument(parsed);
+        if (!result.ok) {
+            throw new Error(`Invalid prd.json: ${result.errors.message}`);
+        }
+        return result.data;
+    }
+    async saveDocument(doc) {
+        const result = validateDocument(doc);
+        if (!result.ok) {
+            throw new Error(`Invalid document: ${result.errors.message}`);
+        }
+        await atomicWriteJSON(this.path("prd.json"), doc, toCanonicalJSON);
+    }
+    async getItem(id) {
+        const doc = await this.loadDocument();
+        const entry = findItem(doc.items, id);
+        return entry ? entry.item : null;
+    }
+    async addItem(item, parentId) {
+        const doc = await this.loadDocument();
+        if (parentId) {
+            const inserted = insertChild(doc.items, parentId, item);
+            if (!inserted) {
+                throw new Error(`Parent "${parentId}" not found`);
+            }
+        }
+        else {
+            doc.items.push(item);
+        }
+        await this.saveDocument(doc);
+    }
+    async updateItem(id, updates) {
+        const doc = await this.loadDocument();
+        const updated = updateInTree(doc.items, id, updates);
+        if (!updated) {
+            throw new Error(`Item "${id}" not found`);
+        }
+        await this.saveDocument(doc);
+    }
+    async removeItem(id) {
+        const doc = await this.loadDocument();
+        const removed = removeFromTree(doc.items, id);
+        if (!removed) {
+            throw new Error(`Item "${id}" not found`);
+        }
+        await this.saveDocument(doc);
+    }
+    async loadConfig() {
+        const raw = await readFile(this.path("config.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        const result = validateConfig(parsed);
+        if (!result.ok) {
+            throw new Error(`Invalid config.json: ${result.errors.message}`);
+        }
+        // Merge project-level .n-dx.json overrides (project config takes precedence)
+        const overrides = await loadProjectOverrides(this.rexDir, "rex");
+        return mergeWithOverrides(result.data, overrides);
+    }
+    async saveConfig(config) {
+        await writeFile(this.path("config.json"), toCanonicalJSON(config), "utf-8");
+    }
+    async appendLog(entry) {
+        const result = validateLogEntry(entry);
+        if (!result.ok) {
+            throw new Error(`Invalid log entry: ${result.errors.message}`);
+        }
+        // Truncate detail to prevent huge log entries
+        const MAX_DETAIL_LENGTH = 2000;
+        const sanitizedEntry = entry.detail && entry.detail.length > MAX_DETAIL_LENGTH
+            ? { ...entry, detail: entry.detail.slice(0, MAX_DETAIL_LENGTH) + "..." }
+            : entry;
+        const logPath = this.path("execution-log.jsonl");
+        // Rotate if the log exceeds the size threshold (1 MB default).
+        // The rotated file is kept as a single backup; older backups are discarded.
+        await this.maybeRotateLog(logPath);
+        await appendFile(logPath, JSON.stringify(sanitizedEntry) + "\n", "utf-8");
+    }
+    /** Rotate execution-log.jsonl when it exceeds MAX_LOG_BYTES. */
+    async maybeRotateLog(logPath) {
+        const MAX_LOG_BYTES = 1_048_576; // 1 MB
+        try {
+            const info = await stat(logPath);
+            if (info.size < MAX_LOG_BYTES)
+                return;
+            // Rotate: current → .1 (overwrites any previous .1)
+            await rename(logPath, logPath.replace(".jsonl", ".1.jsonl"));
+        }
+        catch {
+            // File doesn't exist yet or stat/rename failed — skip rotation
+        }
+    }
+    async readLog(limit) {
+        let raw;
+        try {
+            raw = await readFile(this.path("execution-log.jsonl"), "utf-8");
+        }
+        catch {
+            return [];
+        }
+        const lines = raw.trim().split("\n").filter(Boolean);
+        const entries = [];
+        for (const line of lines) {
+            try {
+                entries.push(JSON.parse(line));
+            }
+            catch {
+                // Skip malformed lines (e.g., from truncated writes or unescaped newlines)
+            }
+        }
+        if (limit !== undefined && limit > 0) {
+            return entries.slice(-limit);
+        }
+        return entries;
+    }
+    async loadWorkflow() {
+        return readFile(this.path("workflow.md"), "utf-8");
+    }
+    async saveWorkflow(content) {
+        await writeFile(this.path("workflow.md"), content, "utf-8");
+    }
+    capabilities() {
+        return {
+            adapter: "file",
+            supportsTransactions: false,
+            supportsWatch: false,
+        };
+    }
+}
+export async function ensureRexDir(rexDir) {
+    await mkdir(rexDir, { recursive: true });
+}
+//# sourceMappingURL=file-adapter.js.map

package/packages/rex/dist/store/file-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-adapter.js","sourceRoot":"","sources":["../../src/store/file-adapter.ts"],"names":[],"mappings":"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"}

package/packages/rex/dist/store/index.d.ts

@@ -0,0 +1,67 @@
+export type { PRDStore, StoreCapabilities } from "./contracts.js";
+export { FileStore, ensureRexDir } from "./file-adapter.js";
+export { NotionStore, ensureNotionRexDir } from "./notion-adapter.js";
+export type { NotionClient, NotionAdapterConfig } from "./notion-client.js";
+export { LiveNotionClient } from "./notion-client.js";
+export { SyncEngine } from "../core/sync-engine.js";
+export type { SyncDirection, SyncReport, SyncOptions } from "../core/sync-engine.js";
+export { AdapterRegistry, getDefaultRegistry, resetDefaultRegistry, isRedactedField, } from "./adapter-registry.js";
+export type { AdapterDefinition, AdapterFactory, AdapterConfig, AdapterConfigField, AdapterInfo, } from "./adapter-registry.js";
+export { validateField, validateConfig, registerIntegrationSchema, getIntegrationSchema, listIntegrationSchemas, resetIntegrationSchemas, toAdapterConfigSchema, } from "./integration-schema.js";
+export type { FieldInputType, FieldValidationRule, FieldSelectOption, IntegrationFieldSchema, IntegrationSchema, IntegrationFieldGroup, FieldValidationResult, } from "./integration-schema.js";
+export { registerBuiltInSchemas, ensureSchemas, } from "./integration-schemas/index.js";
+export { notionIntegrationSchema } from "./integration-schemas/notion.js";
+export { jiraIntegrationSchema } from "./integration-schemas/jira.js";
+import type { PRDStore } from "./contracts.js";
+import type { NotionAdapterConfig } from "./notion-client.js";
+/**
+ * Create a PRDStore for the given adapter name.
+ *
+ * Uses the default {@link AdapterRegistry} to resolve the adapter.
+ * For adapters that require configuration (e.g. Notion), pass additional
+ * config via `createStoreWithConfig` or use the registry directly.
+ */
+export declare function createStore(adapter: string, rexDir: string): PRDStore;
+/**
+ * Create a PRDStore with explicit adapter configuration.
+ *
+ * Validates config against the adapter's schema before creating the store.
+ */
+export declare function createStoreWithConfig(adapter: string, rexDir: string, config: Record<string, unknown>): PRDStore;
+/**
+ * Create a Notion-backed store.
+ *
+ * Requires a NotionAdapterConfig with token and databaseId.
+ * The rexDir is still used for config, logs, and workflow files.
+ */
+export declare function createNotionStore(rexDir: string, config: NotionAdapterConfig): PRDStore;
+/**
+ * Resolve the local PRDStore for a `.rex/` directory.
+ *
+ * Always returns a FileStore. Remote adapters (e.g. Notion) are accessed
+ * only during explicit sync operations via {@link resolveRemoteStore}.
+ *
+ * This is the preferred way to obtain a store in CLI commands and tools.
+ *
+ * @param rexDir  Path to the `.rex/` directory.
+ * @returns A FileStore instance.
+ *
+ * @example
+ * ```ts
+ * const store = await resolveStore(join(dir, ".rex"));
+ * const doc = await store.loadDocument();
+ * ```
+ */
+export declare function resolveStore(rexDir: string): Promise<PRDStore>;
+/**
+ * Resolve a remote PRDStore for sync operations.
+ *
+ * Reads the adapter configuration from `adapters.json` via the adapter
+ * registry. If no adapter name is provided, defaults to `"notion"`.
+ *
+ * @param rexDir       Path to the `.rex/` directory.
+ * @param adapterName  Adapter to resolve (default: `"notion"`).
+ * @returns A PRDStore instance for the remote adapter.
+ * @throws If the adapter is not configured or unknown.
+ */
+export declare function resolveRemoteStore(rexDir: string, adapterName?: string): Promise<PRDStore>;

package/packages/rex/dist/store/index.js

@@ -0,0 +1,78 @@
+export { FileStore, ensureRexDir } from "./file-adapter.js";
+export { NotionStore, ensureNotionRexDir } from "./notion-adapter.js";
+export { LiveNotionClient } from "./notion-client.js";
+export { SyncEngine } from "../core/sync-engine.js";
+export { AdapterRegistry, getDefaultRegistry, resetDefaultRegistry, isRedactedField, } from "./adapter-registry.js";
+// ---- Integration schema system -----------------------------------------------
+export { validateField, validateConfig, registerIntegrationSchema, getIntegrationSchema, listIntegrationSchemas, resetIntegrationSchemas, toAdapterConfigSchema, } from "./integration-schema.js";
+export { registerBuiltInSchemas, ensureSchemas, } from "./integration-schemas/index.js";
+export { notionIntegrationSchema } from "./integration-schemas/notion.js";
+export { jiraIntegrationSchema } from "./integration-schemas/jira.js";
+import { FileStore } from "./file-adapter.js";
+import { NotionStore } from "./notion-adapter.js";
+import { LiveNotionClient } from "./notion-client.js";
+import { getDefaultRegistry } from "./adapter-registry.js";
+/**
+ * Create a PRDStore for the given adapter name.
+ *
+ * Uses the default {@link AdapterRegistry} to resolve the adapter.
+ * For adapters that require configuration (e.g. Notion), pass additional
+ * config via `createStoreWithConfig` or use the registry directly.
+ */
+export function createStore(adapter, rexDir) {
+    return getDefaultRegistry().create(adapter, rexDir, {});
+}
+/**
+ * Create a PRDStore with explicit adapter configuration.
+ *
+ * Validates config against the adapter's schema before creating the store.
+ */
+export function createStoreWithConfig(adapter, rexDir, config) {
+    return getDefaultRegistry().create(adapter, rexDir, config);
+}
+/**
+ * Create a Notion-backed store.
+ *
+ * Requires a NotionAdapterConfig with token and databaseId.
+ * The rexDir is still used for config, logs, and workflow files.
+ */
+export function createNotionStore(rexDir, config) {
+    const client = new LiveNotionClient(config.token);
+    return new NotionStore(rexDir, client, config);
+}
+/**
+ * Resolve the local PRDStore for a `.rex/` directory.
+ *
+ * Always returns a FileStore. Remote adapters (e.g. Notion) are accessed
+ * only during explicit sync operations via {@link resolveRemoteStore}.
+ *
+ * This is the preferred way to obtain a store in CLI commands and tools.
+ *
+ * @param rexDir  Path to the `.rex/` directory.
+ * @returns A FileStore instance.
+ *
+ * @example
+ * ```ts
+ * const store = await resolveStore(join(dir, ".rex"));
+ * const doc = await store.loadDocument();
+ * ```
+ */
+export async function resolveStore(rexDir) {
+    return new FileStore(rexDir);
+}
+/**
+ * Resolve a remote PRDStore for sync operations.
+ *
+ * Reads the adapter configuration from `adapters.json` via the adapter
+ * registry. If no adapter name is provided, defaults to `"notion"`.
+ *
+ * @param rexDir       Path to the `.rex/` directory.
+ * @param adapterName  Adapter to resolve (default: `"notion"`).
+ * @returns A PRDStore instance for the remote adapter.
+ * @throws If the adapter is not configured or unknown.
+ */
+export async function resolveRemoteStore(rexDir, adapterName = "notion") {
+    const registry = getDefaultRegistry();
+    return registry.createFromConfig(rexDir, adapterName);
+}
+//# sourceMappingURL=index.js.map

package/packages/rex/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAS/B,iFAAiF;AACjF,OAAO,EACL,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAUjC,OAAO,EACL,sBAAsB,EACtB,aAAa,GACd,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAI3D;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,MAAc;IACzD,OAAO,kBAAkB,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,MAAc,EACd,MAA+B;IAE/B,OAAO,kBAAkB,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,MAA2B;IAE3B,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc;IAC/C,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,cAAsB,QAAQ;IAE9B,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IACtC,OAAO,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACxD,CAAC"}

package/packages/rex/dist/store/integration-schema.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Integration schema system for extensible adapter configuration.
+ *
+ * Extends the base {@link AdapterConfigField} with richer field definitions
+ * that support dynamic UI generation: input types, validation rules,
+ * help text, documentation links, and select options.
+ *
+ * The schema system is additive — every {@link IntegrationFieldSchema}
+ * is a valid {@link AdapterConfigField}, maintaining backward compatibility
+ * with existing adapter registration and validation.
+ *
+ * @module store/integration-schema
+ */
+import type { AdapterConfigField } from "./adapter-registry.js";
+/**
+ * Supported input types for integration configuration fields.
+ *
+ * Maps directly to HTML input types plus `select` and `textarea`.
+ */
+export type FieldInputType = "text" | "password" | "url" | "email" | "number" | "checkbox" | "select" | "textarea";
+/**
+ * Validation rule for a configuration field.
+ *
+ * Rules are evaluated in order. The first failing rule produces
+ * the error message shown to the user.
+ */
+export interface FieldValidationRule {
+    /** Rule type. */
+    type: "pattern" | "minLength" | "maxLength" | "min" | "max" | "custom";
+    /**
+     * Regex pattern string (for `type: "pattern"`).
+     * Evaluated with `new RegExp(pattern)`.
+     */
+    pattern?: string;
+    /** Minimum string length (for `type: "minLength"`). */
+    minLength?: number;
+    /** Maximum string length (for `type: "maxLength"`). */
+    maxLength?: number;
+    /** Minimum numeric value (for `type: "min"`). */
+    min?: number;
+    /** Maximum numeric value (for `type: "max"`). */
+    max?: number;
+    /**
+     * Custom validator function name.
+     *
+     * For `type: "custom"`, this names a well-known validator that the
+     * UI can resolve. Examples: `"notionApiKey"`, `"notionDatabaseId"`.
+     * The server validates these server-side; the client can also run them
+     * for immediate feedback.
+     */
+    validator?: string;
+    /** Error message shown when this rule fails. */
+    message: string;
+}
+/** A single option for `select` input type fields. */
+export interface FieldSelectOption {
+    /** Display label. */
+    label: string;
+    /** Stored value. */
+    value: string;
+    /** Optional description shown as help text for this option. */
+    description?: string;
+}
+/**
+ * Rich field schema for integration configuration.
+ *
+ * Extends {@link AdapterConfigField} with UI-generation metadata.
+ * Every `IntegrationFieldSchema` satisfies the `AdapterConfigField`
+ * contract, so existing adapter registration code works unchanged.
+ */
+export interface IntegrationFieldSchema extends AdapterConfigField {
+    /** Display label for the field (defaults to the field key if omitted). */
+    label?: string;
+    /** Input type for UI rendering. Defaults to `"text"`. */
+    inputType?: FieldInputType;
+    /** Placeholder text shown in the input. */
+    placeholder?: string;
+    /** Extended help text shown below the input. */
+    helpText?: string;
+    /**
+     * URL to documentation for this field.
+     * Rendered as a clickable link in the help text area.
+     */
+    docUrl?: string;
+    /** Label for the documentation link. Defaults to `"Learn more"`. */
+    docLabel?: string;
+    /** Default value for the field. */
+    defaultValue?: string | number | boolean;
+    /**
+     * Validation rules evaluated in order.
+     * The first failing rule produces the error message.
+     */
+    validationRules?: FieldValidationRule[];
+    /** Options for `select` input type. */
+    options?: FieldSelectOption[];
+    /**
+     * Display group for organizing fields in the UI.
+     * Fields with the same group are rendered together under a heading.
+     */
+    group?: string;
+    /**
+     * Display order within the group (lower = earlier).
+     * Fields without an explicit order are appended at the end.
+     */
+    order?: number;
+}
+/**
+ * Complete schema for an integration type.
+ *
+ * Defines the metadata, fields, and UI hints for a specific integration
+ * (e.g., Notion, Jira, Linear). The schema drives both server-side
+ * validation and client-side form generation.
+ */
+export interface IntegrationSchema {
+    /** Integration identifier (matches the adapter name). */
+    id: string;
+    /** Display name for the integration. */
+    name: string;
+    /** Short description shown in the integration list. */
+    description: string;
+    /** Icon identifier or emoji for the integration. */
+    icon?: string;
+    /** URL to the integration's homepage or documentation. */
+    docsUrl?: string;
+    /**
+     * Setup guide steps shown in the UI.
+     * Each string is one step (supports basic markdown-like formatting).
+     */
+    setupGuide?: string[];
+    /** Field schemas keyed by field name. */
+    fields: Record<string, IntegrationFieldSchema>;
+    /**
+     * Groups for organizing fields in the UI.
+     * Keys are group identifiers matching `IntegrationFieldSchema.group`.
+     */
+    groups?: Record<string, IntegrationFieldGroup>;
+    /**
+     * Whether this integration supports connection testing.
+     * When `true`, the UI shows a "Test Connection" button.
+     */
+    supportsConnectionTest?: boolean;
+    /**
+     * Whether this integration supports schema validation
+     * (like Notion's database property checks).
+     */
+    supportsSchemaValidation?: boolean;
+    /** Whether this is a built-in integration (vs. user-registered). */
+    builtIn?: boolean;
+}
+/**
+ * A group of fields in the integration configuration UI.
+ */
+export interface IntegrationFieldGroup {
+    /** Display label for the group. */
+    label: string;
+    /** Optional icon or emoji. */
+    icon?: string;
+    /** Display order (lower = earlier). */
+    order?: number;
+    /** Optional description shown below the group heading. */
+    description?: string;
+}
+/** Result of validating a single field value. */
+export interface FieldValidationResult {
+    /** Whether the field value is valid. */
+    valid: boolean;
+    /** Error message if invalid. */
+    error?: string;
+}
+/**
+ * Validate a field value against its schema's validation rules.
+ *
+ * Returns the first failing rule's error message, or `{ valid: true }`
+ * if all rules pass.
+ */
+export declare function validateField(value: unknown, schema: IntegrationFieldSchema): FieldValidationResult;
+/**
+ * Validate all fields in a config against an integration schema.
+ *
+ * @returns Map of field name to validation result (only invalid fields included).
+ */
+export declare function validateConfig(config: Record<string, unknown>, schema: IntegrationSchema): Record<string, FieldValidationResult>;
+/**
+ * Register an integration schema.
+ *
+ * @throws If a schema with the same ID is already registered.
+ */
+export declare function registerIntegrationSchema(schema: IntegrationSchema): void;
+/** Get a registered integration schema by ID. */
+export declare function getIntegrationSchema(id: string): IntegrationSchema | undefined;
+/** List all registered integration schemas. */
+export declare function listIntegrationSchemas(): IntegrationSchema[];
+/**
+ * Reset the schema registry (for testing only).
+ * @internal
+ */
+export declare function resetIntegrationSchemas(): void;
+/**
+ * Extract the base {@link AdapterConfigField} map from an integration schema.
+ *
+ * This allows an `IntegrationSchema` to be used anywhere an
+ * `AdapterDefinition.configSchema` is expected, preserving backward
+ * compatibility.
+ */
+export declare function toAdapterConfigSchema(schema: IntegrationSchema): Record<string, AdapterConfigField>;

package/packages/rex/dist/store/integration-schema.js

@@ -0,0 +1,136 @@
+/**
+ * Integration schema system for extensible adapter configuration.
+ *
+ * Extends the base {@link AdapterConfigField} with richer field definitions
+ * that support dynamic UI generation: input types, validation rules,
+ * help text, documentation links, and select options.
+ *
+ * The schema system is additive — every {@link IntegrationFieldSchema}
+ * is a valid {@link AdapterConfigField}, maintaining backward compatibility
+ * with existing adapter registration and validation.
+ *
+ * @module store/integration-schema
+ */
+/**
+ * Validate a field value against its schema's validation rules.
+ *
+ * Returns the first failing rule's error message, or `{ valid: true }`
+ * if all rules pass.
+ */
+export function validateField(value, schema) {
+    // Required check
+    if (schema.required) {
+        if (value === undefined || value === null || value === "") {
+            return { valid: false, error: `${schema.label ?? "This field"} is required` };
+        }
+    }
+    // Skip further validation for empty optional fields
+    if (value === undefined || value === null || value === "") {
+        return { valid: true };
+    }
+    const strValue = String(value);
+    if (!schema.validationRules)
+        return { valid: true };
+    for (const rule of schema.validationRules) {
+        switch (rule.type) {
+            case "pattern":
+                if (rule.pattern && !new RegExp(rule.pattern).test(strValue)) {
+                    return { valid: false, error: rule.message };
+                }
+                break;
+            case "minLength":
+                if (rule.minLength !== undefined && strValue.length < rule.minLength) {
+                    return { valid: false, error: rule.message };
+                }
+                break;
+            case "maxLength":
+                if (rule.maxLength !== undefined && strValue.length > rule.maxLength) {
+                    return { valid: false, error: rule.message };
+                }
+                break;
+            case "min":
+                if (rule.min !== undefined && Number(value) < rule.min) {
+                    return { valid: false, error: rule.message };
+                }
+                break;
+            case "max":
+                if (rule.max !== undefined && Number(value) > rule.max) {
+                    return { valid: false, error: rule.message };
+                }
+                break;
+            case "custom":
+                // Custom validators are resolved at runtime by the consumer.
+                // Server-side and client-side validators are registered separately.
+                break;
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Validate all fields in a config against an integration schema.
+ *
+ * @returns Map of field name to validation result (only invalid fields included).
+ */
+export function validateConfig(config, schema) {
+    const errors = {};
+    for (const [fieldName, fieldSchema] of Object.entries(schema.fields)) {
+        const result = validateField(config[fieldName], fieldSchema);
+        if (!result.valid) {
+            errors[fieldName] = result;
+        }
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// Schema registry
+// ---------------------------------------------------------------------------
+/** Registry of integration schemas, keyed by integration ID. */
+const schemas = new Map();
+/**
+ * Register an integration schema.
+ *
+ * @throws If a schema with the same ID is already registered.
+ */
+export function registerIntegrationSchema(schema) {
+    if (schemas.has(schema.id)) {
+        throw new Error(`Integration schema "${schema.id}" is already registered`);
+    }
+    schemas.set(schema.id, schema);
+}
+/** Get a registered integration schema by ID. */
+export function getIntegrationSchema(id) {
+    return schemas.get(id);
+}
+/** List all registered integration schemas. */
+export function listIntegrationSchemas() {
+    return Array.from(schemas.values());
+}
+/**
+ * Reset the schema registry (for testing only).
+ * @internal
+ */
+export function resetIntegrationSchemas() {
+    schemas.clear();
+}
+// ---------------------------------------------------------------------------
+// Utility: convert IntegrationSchema fields to AdapterConfigField map
+// ---------------------------------------------------------------------------
+/**
+ * Extract the base {@link AdapterConfigField} map from an integration schema.
+ *
+ * This allows an `IntegrationSchema` to be used anywhere an
+ * `AdapterDefinition.configSchema` is expected, preserving backward
+ * compatibility.
+ */
+export function toAdapterConfigSchema(schema) {
+    const result = {};
+    for (const [key, field] of Object.entries(schema.fields)) {
+        result[key] = {
+            required: field.required,
+            description: field.description,
+            sensitive: field.sensitive,
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=integration-schema.js.map

package/packages/rex/dist/store/integration-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-schema.js","sourceRoot":"","sources":["../../src/store/integration-schema.ts"],"names":[],"mappings":"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"}