@plitzi/sdk-shared 0.30.19 → 0.31.1

package/dist/types/McpTypes/McpAdapters.d.ts

@@ -0,0 +1,455 @@
+import { AiContext, DisplayMode, Resource, StyleCategory, StyleItem, StyleVariableCategory, StyleVariableValue, TagType } from '../..';
+import { McpPlugin, McpSegment, McpStyleVariable } from '../McpTypes';
+import { DropPosition, Element, PageFolder, Schema, SchemaVariable } from '../SchemaTypes';
+import { Theme } from '../ThemeTypes';
+export type McpAdapter<R = any, T extends Record<string, any> = Record<string, any>> = (args: T, ctx: AiContext) => Promise<{
+    data: R;
+} | {
+    error: Error | string;
+}>;
+export type McpAdaptersSchema = {
+    applyPreview: McpAdapter<{
+        baseElementId: string;
+        targetParentId: string;
+        elementCount: number;
+    }, {
+        schema: {
+            flat: Record<string, Element>;
+        };
+        style?: Record<string, unknown>;
+        baseElementId: string;
+        targetParentId: string;
+        dropPosition?: DropPosition;
+    }>;
+};
+export type PageElementSummary = {
+    id: string;
+    label: string;
+    type: string;
+    parentId: string | null;
+    attributes: Record<string, unknown>;
+};
+export type McpAdaptersPages = {
+    getPage: McpAdapter<{
+        page: Element;
+        elements: PageElementSummary[];
+    } | undefined, {
+        pageId: string;
+    }>;
+    getPages: McpAdapter<Element[]>;
+    getPageBySlug: McpAdapter<Element | undefined, {
+        slug: string;
+    }>;
+    createPage: McpAdapter<Element, {
+        name: string;
+    }>;
+    updatePage: McpAdapter<Element, {
+        pageId: string;
+        updates: {
+            name?: string;
+            slug?: string;
+            default?: boolean;
+            folder?: string;
+        };
+    }>;
+    deletePage: McpAdapter<boolean, {
+        pageId: string;
+    }>;
+};
+export type McpAdaptersPageFolders = {
+    getPageFolder: McpAdapter<PageFolder | undefined, {
+        folderId: string;
+    }>;
+    getPageFolders: McpAdapter<PageFolder[]>;
+    createPageFolder: McpAdapter<PageFolder, {
+        name: string;
+        parentId?: string;
+    }>;
+    updatePageFolder: McpAdapter<PageFolder, {
+        id: string;
+        updates: Partial<Pick<PageFolder, 'name' | 'slug' | 'parentId'>>;
+    }>;
+    deletePageFolder: McpAdapter<boolean, {
+        id: string;
+    }>;
+};
+export type McpAdaptersElements = {
+    createElement: McpAdapter<Element | undefined, {
+        element: Element;
+        parentId?: string;
+        position?: number;
+    }>;
+    getElement: McpAdapter<Element | undefined, {
+        elementId: string;
+    }>;
+    getElements: McpAdapter<Element[], {
+        pageId?: string;
+        type?: string;
+        parentId?: string;
+    }>;
+    listElements: McpAdapter<{
+        id: string;
+        label: string;
+        type: string;
+        parentId?: string;
+        items?: string[];
+    }[], {
+        rootId?: string;
+        parentId?: string;
+        type?: string;
+    }>;
+    updateElement: McpAdapter<Element, Element>;
+    deleteElement: McpAdapter<boolean, {
+        elementId: string;
+    }>;
+    moveElement: McpAdapter<boolean, {
+        elementId: string;
+        toParentId: string;
+        dropPosition?: DropPosition;
+    }>;
+    cloneElement: McpAdapter<{
+        id: string;
+        label: string;
+        type: string;
+        parentId?: string;
+        items?: string[];
+    }[], {
+        elementId: string;
+        to: string;
+        dropPosition: DropPosition;
+    }>;
+};
+export type McpAdaptersSchemaVariables = {
+    getVariable: McpAdapter<SchemaVariable | undefined, {
+        name: string;
+    }>;
+    getVariables: McpAdapter<SchemaVariable[]>;
+    createSchemaVariable: McpAdapter<SchemaVariable, {
+        variable: Pick<SchemaVariable, 'name' | 'type' | 'value' | 'category'>;
+    }>;
+    updateSchemaVariable: McpAdapter<SchemaVariable, {
+        variable: Partial<SchemaVariable> & {
+            name: string;
+        };
+    }>;
+    deleteSchemaVariable: McpAdapter<boolean, {
+        name: string;
+    }>;
+};
+export type McpAdaptersStyles = {
+    getStyleVariables: McpAdapter<Record<string, Record<string, StyleVariableValue>>>;
+    getStyleVariable: McpAdapter<StyleVariableValue | undefined, {
+        category: StyleVariableCategory;
+        name: string;
+    }>;
+    getStyleSelectors: McpAdapter<Record<string, string[]>, {
+        displayMode?: string;
+    }>;
+    updateStyle: McpAdapter;
+    updateStyleSettings: McpAdapter;
+};
+export type McpAdaptersStylesVariables = {
+    createStyleVariable: McpAdapter<{
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }, McpStyleVariable>;
+    updateStyleVariable: McpAdapter<McpStyleVariable, {
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }>;
+    deleteStyleVariable: McpAdapter<boolean, {
+        category: StyleVariableCategory;
+        name: string;
+    }>;
+};
+export type McpAdaptersStylesSelectors = {
+    createStyleSelector: McpAdapter<StyleItem, {
+        displayMode: DisplayMode;
+        selector: string;
+        type: TagType;
+        path?: StyleCategory;
+        style?: StyleItem['attributes'];
+        params?: Record<string, unknown>;
+    }>;
+    updateStyleSelector: McpAdapter<StyleItem, {
+        displayMode: DisplayMode;
+        selector: string;
+        type: TagType;
+        path?: StyleCategory;
+        style?: StyleItem['attributes'];
+        params?: Record<string, unknown>;
+    }>;
+    deleteStyleSelector: McpAdapter<boolean, {
+        displayMode: DisplayMode;
+        selector: string;
+    }>;
+};
+export type McpAdaptersSegments = {
+    createSegment: McpAdapter<McpSegment, {
+        name: string;
+        description: string;
+    }>;
+    updateSegment: McpAdapter<McpSegment, {
+        segmentId: string;
+        updates: {
+            name?: string;
+            description?: string;
+        };
+    }>;
+    deleteSegment: McpAdapter<boolean, {
+        segmentId: string;
+    }>;
+    getSegment: McpAdapter<Record<string, unknown> | undefined, {
+        segmentId?: string;
+        identifier?: string;
+    }>;
+    getSegments: McpAdapter<Record<string, unknown>[], {
+        cursor?: string;
+        limit?: number;
+    }>;
+    createSegmentElement: McpAdapter<Element, {
+        segmentId: string;
+        element: {
+            type: string;
+            label: string;
+            props?: Record<string, unknown>;
+        };
+        parentId: string;
+    }>;
+    updateSegmentElement: McpAdapter<Element, {
+        segmentId: string;
+        elementId: string;
+        updates: {
+            label?: string;
+            props?: Record<string, unknown>;
+        };
+    }>;
+    moveSegmentElement: McpAdapter<boolean, {
+        segmentId: string;
+        elementId: string;
+        toParentId: string;
+        dropPosition?: DropPosition;
+    }>;
+    deleteSegmentElement: McpAdapter<boolean, {
+        segmentId: string;
+        elementId: string;
+    }>;
+    cloneSegmentElement: McpAdapter;
+    createSegmentVariable: McpAdapter<SchemaVariable, {
+        segmentId: string;
+        variable: Pick<SchemaVariable, 'name' | 'type' | 'value' | 'category'>;
+    }>;
+    updateSegmentVariable: McpAdapter<SchemaVariable, {
+        segmentId: string;
+        variable: Partial<SchemaVariable> & {
+            name: string;
+        };
+    }>;
+    deleteSegmentVariable: McpAdapter<boolean, {
+        segmentId: string;
+        name: string;
+    }>;
+    createSegmentStyleVariable: McpAdapter<McpStyleVariable, {
+        segmentId: string;
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }>;
+    updateSegmentStyleVariable: McpAdapter<McpStyleVariable, {
+        segmentId: string;
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }>;
+    deleteSegmentStyleVariable: McpAdapter<boolean, {
+        segmentId: string;
+        category: StyleVariableCategory;
+        name: string;
+    }>;
+    addSegmentStyleSelector: McpAdapter<StyleItem, {
+        segmentId: string;
+        displayMode: DisplayMode;
+        selector: string;
+        type: TagType;
+        path?: StyleCategory;
+        style?: StyleItem['attributes'];
+        params: Record<string, unknown>;
+    }>;
+    updateSegmentStyleSelector: McpAdapter<StyleItem, {
+        segmentId: string;
+        displayMode: DisplayMode;
+        selector: string;
+        path?: StyleCategory;
+        style?: StyleItem['attributes'];
+        params: Record<string, unknown>;
+    }>;
+    deleteSegmentStyleSelector: McpAdapter<boolean, {
+        segmentId: string;
+        displayMode: DisplayMode;
+        selector: string;
+    }>;
+    addSegmentStyleSelectorVariable: McpAdapter<{
+        displayMode: DisplayMode;
+        selector: string;
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }, {
+        segmentId: string;
+        displayMode: DisplayMode;
+        selector: string;
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }>;
+    updateSegmentStyleSelectorVariable: McpAdapter<{
+        displayMode: DisplayMode;
+        selector: string;
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }, {
+        segmentId: string;
+        displayMode: DisplayMode;
+        selector: string;
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }>;
+    removeSegmentStyleSelectorVariable: McpAdapter<boolean, {
+        segmentId: string;
+        displayMode: DisplayMode;
+        selector: string;
+        category: StyleVariableCategory;
+        name: string;
+    }>;
+    addSegmentSelectorVariable: McpAdapter<{
+        displayMode: DisplayMode;
+        selector: string;
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }, {
+        segmentId: string;
+        displayMode: DisplayMode;
+        selector: string;
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }>;
+    updateSegmentSelectorVariable: McpAdapter<{
+        displayMode: DisplayMode;
+        selector: string;
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }, {
+        segmentId: string;
+        displayMode: DisplayMode;
+        selector: string;
+        category: StyleVariableCategory;
+        name: string;
+        value: StyleVariableValue;
+    }>;
+    removeSegmentSelectorVariable: McpAdapter<boolean, {
+        segmentId: string;
+        displayMode: DisplayMode;
+        selector: string;
+        category: StyleVariableCategory;
+        name: string;
+    }>;
+};
+export type McpAdaptersPlugins = {
+    listPlugins: McpAdapter<McpPlugin[]>;
+    addPlugin: McpAdapter<{
+        type: string;
+        resource: string;
+        settings: Record<string, unknown>;
+    }, {
+        pluginType: string;
+        resource: string;
+        override?: boolean;
+    }>;
+    updatePlugin: McpAdapter<{
+        type: string;
+        resource: string;
+        settings: Record<string, unknown>;
+    }, {
+        pluginType: string;
+        resource: string;
+    }>;
+    removePlugin: McpAdapter<boolean, {
+        pluginType: string;
+    }>;
+};
+export type McpAdaptersCollections = {
+    getCollections: McpAdapter<Record<string, unknown>[], Record<string, unknown>>;
+    getCollection: McpAdapter<Record<string, unknown> | undefined, {
+        collectionId: string;
+    }>;
+    createCollection: McpAdapter;
+    updateCollection: McpAdapter;
+    deleteCollection: McpAdapter<boolean, any>;
+    getCollectionRecords: McpAdapter;
+    getCollectionRecord: McpAdapter;
+    createCollectionRecord: McpAdapter;
+    updateCollectionRecord: McpAdapter;
+    deleteCollectionRecord: McpAdapter<boolean, {
+        collectionId: string;
+        recordId: string;
+    }>;
+};
+export type McpAdaptersResources = {
+    getResources: McpAdapter;
+    getResource: McpAdapter<Resource | undefined, {
+        identifier: string;
+        cdnIdentifier: string;
+    }>;
+    addResource: McpAdapter<Resource | undefined, {
+        url: string;
+        cdnIdentifier: string;
+        filename?: string;
+        type?: string;
+        prefix?: string;
+        compression?: string;
+    }>;
+    moveResource: McpAdapter<Resource | undefined, {
+        identifier: string;
+        cdnIdentifier: string;
+        prefix: string;
+    }>;
+    removeResource: McpAdapter<{
+        id: string;
+    } | undefined, {
+        identifier: string;
+        cdnIdentifier: string;
+    }>;
+};
+export type McpAdaptersSpace = {
+    getSpaceSettings: McpAdapter<Schema['settings'] | undefined>;
+    updateSpaceSettings: McpAdapter<Schema['settings'], {
+        path?: string;
+        value?: string | number | boolean;
+    }>;
+};
+export type McpAdapters = {
+    getBuilderContext: McpAdapter<{
+        currentPageId?: string;
+        selectedElementId?: string;
+        cssVariables: Record<string, {
+            default: string;
+            light?: string;
+            dark?: string;
+        }> | undefined;
+        elementDefaults: any;
+        elements: {
+            id: string;
+            label: string;
+            type: string;
+            parentId?: string;
+        }[];
+        theme?: Exclude<Theme, 'system'>;
+    } | undefined>;
+} & McpAdaptersSchema & McpAdaptersPages & McpAdaptersPageFolders & McpAdaptersElements & McpAdaptersSchemaVariables & McpAdaptersStyles & McpAdaptersStylesVariables & McpAdaptersStylesSelectors & McpAdaptersSegments & McpAdaptersPlugins & McpAdaptersCollections & McpAdaptersResources & McpAdaptersSpace;

package/dist/types/McpTypes/index.d.ts

@@ -0,0 +1,96 @@
+import { AiContext, AiMode, PromptRole } from '../AITypes';
+import { StyleVariableCategory, StyleVariableValue } from '../StyleTypes';
+import { McpAdapters } from './McpAdapters';
+import { ToolAnnotations } from '@modelcontextprotocol/sdk/types';
+import { ZodType } from 'zod';
+export * from './McpAdapters';
+export type McpPlugin = {
+    name: string;
+    version?: string;
+    description?: string;
+};
+export type McpStyleVariable = {
+    category: StyleVariableCategory;
+    name: string;
+    value: StyleVariableValue;
+};
+export type McpSegment = {
+    id?: string;
+    identifier: string;
+    definition: {
+        name: string;
+        description: string;
+        baseElementId: string;
+    };
+};
+export type ToolOperationType = 'read' | 'write';
+export type McpPromptHandlerResult = {
+    messages: {
+        role: Exclude<PromptRole, 'system'>;
+        content: {
+            type: 'text';
+            text: string;
+        };
+    }[];
+};
+export type McpPromptHandler = (args: Record<string, any>, ctx: AiContext) => Promise<McpPromptHandlerResult>;
+export type McpPrompt = {
+    name: string;
+    definition: {
+        title: string;
+        description: string;
+        argsSchema?: Record<string, any>;
+    };
+    handler: McpPromptHandler;
+};
+export type McpResource = {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    content: string;
+};
+export type McpToolHandlerResult = {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    data?: unknown;
+    structuredContent?: Record<string, unknown>;
+    isError?: true;
+};
+export type ToolCallEvent = {
+    name: string;
+    args: Record<string, unknown>;
+    result: unknown;
+};
+export type McpToolLifecycleHooks = {
+    can?: (name: string, args: Record<string, unknown>, ctx?: AiContext) => boolean | Promise<boolean>;
+    before?: (name: string, args: Record<string, unknown>, ctx?: AiContext) => boolean | undefined | Promise<boolean> | Promise<undefined>;
+    after?: (name: string, args: Record<string, unknown>, result: McpToolHandlerResult, ctx?: AiContext) => void | Promise<void>;
+    onError?: (name: string, args: Record<string, unknown>, error: Error, ctx?: AiContext) => void | Promise<void>;
+};
+export type McpToolHandler<T extends Record<string, unknown> = any> = (args: T, ctx: AiContext) => Promise<McpToolHandlerResult> | McpToolHandlerResult;
+export type McpTool = {
+    name: string;
+    mcpDefinition: {
+        title?: string;
+        description: string;
+        inputSchema?: ZodType<any, any, any>;
+        outputSchema?: ZodType<any, any, any>;
+        annotations?: ToolAnnotations;
+    };
+    definition: {
+        allowedModes: AiMode[];
+    };
+    adapterName?: keyof McpAdapters;
+    handler?: McpToolHandler;
+};
+export type McpServerConfig = {
+    enabled?: boolean;
+    path?: string;
+    adapters: Partial<McpAdapters>;
+    tools?: McpTool[];
+    prompts?: McpPrompt[];
+    resources?: McpResource[];
+};

package/dist/types/SchemaTypes.d.ts

@@ -51,7 +51,8 @@ export type ElementDefinition = {
     items?: Element['id'][];
     styleSelectors: {
         base: string;
-    } & Omit<Record<string, string>, 'base'>;
+        [selector: string]: string;
+    };
     bindings?: Partial<Record<BindingCategory, ElementBinding[]>>;
     interactions?: Record<string, ElementInteraction>;
     initialState?: {
@@ -65,25 +66,24 @@ export type ElementDefinition = {
     /** Controls when the element is loaded/rendered. */
     loadStrategy?: ElementLoadStrategy;
 };
-export type Element<TAttributes extends Record<string, unknown> = Omit<{
-    [key: string]: unknown;
-}, 'subType'>> = {
+export type Element<TAttributes extends Record<string, unknown> = Record<string, unknown>> = {
     id: string;
     attributes: TAttributes & {
         subType?: string;
     };
     definition: ElementDefinition;
 };
-export type SchemaVariable = {
+type SchemaVariableBase<TType extends string, TValue> = {
     name: string;
     category: string;
-    type: 'text' | 'number' | 'email' | 'password' | 'select' | 'select2' | 'checkbox' | 'textarea' | 'color' | 'switch';
-    value: string;
+    type: TType;
+    value: TValue;
     subValues: {
         when: RuleGroup;
-        value: string;
+        value: TValue;
     }[];
 };
+export type SchemaVariable = SchemaVariableBase<'number', number> | SchemaVariableBase<'checkbox' | 'switch', boolean> | SchemaVariableBase<'text' | 'email' | 'password' | 'select' | 'select2' | 'textarea' | 'color', string>;
 export type PageFolder = {
     id: string;
     name: string;
@@ -150,3 +150,4 @@ export type SchemaRaw = {
     pages: Element['id'][];
     pageFolders: PageFolder[];
 };
+export {};

package/dist/types/StateTypes.d.ts

@@ -2,6 +2,6 @@ import { Dispatch, SetStateAction } from 'react';
 export type StateManagerContextValue = {
     state: Record<string, unknown>;
     setState: Dispatch<SetStateAction<Record<string, unknown>>>;
-    setStateByKey: (key: string, value: unknown, storeMode?: string) => void;
-    clearCache: (storeMode?: string) => void;
+    setStateByKey: (key: string, value: unknown, storeMode?: 'localStorage' | 'sessionStorage') => void;
+    clearCache: (storeMode?: 'localStorage' | 'sessionStorage') => void;
 };

package/dist/types/StoreTypes.d.ts

@@ -1,12 +1,26 @@
+import { Source } from './DataSourceTypes';
 import { Schema, Element } from './SchemaTypes';
 import { Segment } from './SegmentTypes';
 import { DisplayMode, Style, StyleState } from './StyleTypes';
+export type RuntimeSourceValues = {
+    variables?: Record<string, unknown>;
+    navigation?: {
+        routeParams: Record<string, unknown>;
+        queryParams: Record<string, unknown>;
+    };
+    auth?: Record<string, unknown>;
+    page?: Record<string, unknown>;
+};
 export type CommonState = {
     prevSchema?: Schema;
     schema: Schema;
     pageDefinitions: Record<string, Element>;
     style: Style;
     segments: Record<string, Segment>;
+    runtime?: {
+        sources?: RuntimeSourceValues & Record<string, unknown>;
+    };
+    sources?: Record<string, Source>;
 };
 export type BuilderState = CommonState & {
     displayMode: DisplayMode;

package/dist/types/index.d.ts

@@ -21,3 +21,4 @@ export * from './StoreTypes';
 export * from './ThemeTypes';
 export * from './McpTypes';
 export * from './ServerTypes';
+export * from './AITypes';

package/eslint.config.mjs

@@ -69,8 +69,8 @@ export default tsEslint.config({
       {
         groups: ['builtin', 'external', 'internal', ['parent', 'sibling', 'index'], 'type'],
         pathGroups: [
-          { pattern: '@plitzi/sdk-*/**', group: 'internal' },
-          { pattern: '@plitzi/sdk-*', group: 'internal' }
+          { pattern: '@plitzi/+(sdk-*|nexus)/**', group: 'internal' },
+          { pattern: '@plitzi/+(sdk-*|nexus)', group: 'internal' }
           // { pattern: '@icons/**', group: 'internal' },
           // { pattern: '@components/**', group: 'internal' },
           // { pattern: '@hooks/**', group: 'internal' },