@objectstack/spec 0.6.1 → 0.7.2

package/dist/system/manifest.zod.d.ts

@@ -246,13 +246,13 @@ export declare const ManifestSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             name: string;
             description?: string | undefined;
-            args?: string[] | undefined;
             returnType?: string | undefined;
+            args?: string[] | undefined;
         }, {
             name: string;
             description?: string | undefined;
-            args?: string[] | undefined;
             returnType?: string | undefined;
+            args?: string[] | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         events?: string[] | undefined;
@@ -295,8 +295,8 @@ export declare const ManifestSchema: z.ZodObject<{
         functions?: {
             name: string;
             description?: string | undefined;
-            args?: string[] | undefined;
             returnType?: string | undefined;
+            args?: string[] | undefined;
         }[] | undefined;
     }, {
         events?: string[] | undefined;
@@ -339,8 +339,8 @@ export declare const ManifestSchema: z.ZodObject<{
         functions?: {
             name: string;
             description?: string | undefined;
-            args?: string[] | undefined;
             returnType?: string | undefined;
+            args?: string[] | undefined;
         }[] | undefined;
     }>>;
     /**
@@ -360,6 +360,491 @@ export declare const ManifestSchema: z.ZodObject<{
         records: Record<string, any>[];
         mode?: "insert" | "upsert" | "ignore" | undefined;
     }>, "many">>;
+    /**
+     * Plugin Capability Manifest.
+     * Declares protocols implemented, interfaces provided, dependencies, and extension points.
+     * This enables plugin interoperability and automatic discovery.
+     */
+    capabilities: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            protocol: z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                version: z.ZodObject<{
+                    major: z.ZodNumber;
+                    minor: z.ZodNumber;
+                    patch: z.ZodNumber;
+                }, "strip", z.ZodTypeAny, {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                }, {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                }>;
+                specification: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                label: string;
+                version: {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                };
+                id: string;
+                description?: string | undefined;
+                specification?: string | undefined;
+            }, {
+                label: string;
+                version: {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                };
+                id: string;
+                description?: string | undefined;
+                specification?: string | undefined;
+            }>;
+            conformance: z.ZodDefault<z.ZodEnum<["full", "partial", "experimental", "deprecated"]>>;
+            implementedFeatures: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            features: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                sinceVersion: z.ZodOptional<z.ZodString>;
+                deprecatedSince: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                enabled: boolean;
+                name: string;
+                description?: string | undefined;
+                sinceVersion?: string | undefined;
+                deprecatedSince?: string | undefined;
+            }, {
+                name: string;
+                enabled?: boolean | undefined;
+                description?: string | undefined;
+                sinceVersion?: string | undefined;
+                deprecatedSince?: string | undefined;
+            }>, "many">>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            certified: z.ZodDefault<z.ZodBoolean>;
+            certificationDate: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            protocol: {
+                label: string;
+                version: {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                };
+                id: string;
+                description?: string | undefined;
+                specification?: string | undefined;
+            };
+            conformance: "partial" | "full" | "deprecated" | "experimental";
+            certified: boolean;
+            metadata?: Record<string, any> | undefined;
+            implementedFeatures?: string[] | undefined;
+            features?: {
+                enabled: boolean;
+                name: string;
+                description?: string | undefined;
+                sinceVersion?: string | undefined;
+                deprecatedSince?: string | undefined;
+            }[] | undefined;
+            certificationDate?: string | undefined;
+        }, {
+            protocol: {
+                label: string;
+                version: {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                };
+                id: string;
+                description?: string | undefined;
+                specification?: string | undefined;
+            };
+            metadata?: Record<string, any> | undefined;
+            conformance?: "partial" | "full" | "deprecated" | "experimental" | undefined;
+            implementedFeatures?: string[] | undefined;
+            features?: {
+                name: string;
+                enabled?: boolean | undefined;
+                description?: string | undefined;
+                sinceVersion?: string | undefined;
+                deprecatedSince?: string | undefined;
+            }[] | undefined;
+            certified?: boolean | undefined;
+            certificationDate?: string | undefined;
+        }>, "many">>;
+        provides: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            version: z.ZodObject<{
+                major: z.ZodNumber;
+                minor: z.ZodNumber;
+                patch: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                major: number;
+                minor: number;
+                patch: number;
+            }, {
+                major: number;
+                minor: number;
+                patch: number;
+            }>;
+            methods: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodString;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    type: string;
+                    required: boolean;
+                    name: string;
+                    description?: string | undefined;
+                }, {
+                    type: string;
+                    name: string;
+                    required?: boolean | undefined;
+                    description?: string | undefined;
+                }>, "many">>;
+                returnType: z.ZodOptional<z.ZodString>;
+                async: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                async: boolean;
+                description?: string | undefined;
+                parameters?: {
+                    type: string;
+                    required: boolean;
+                    name: string;
+                    description?: string | undefined;
+                }[] | undefined;
+                returnType?: string | undefined;
+            }, {
+                name: string;
+                description?: string | undefined;
+                async?: boolean | undefined;
+                parameters?: {
+                    type: string;
+                    name: string;
+                    required?: boolean | undefined;
+                    description?: string | undefined;
+                }[] | undefined;
+                returnType?: string | undefined;
+            }>, "many">;
+            events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                payload: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                description?: string | undefined;
+                payload?: string | undefined;
+            }, {
+                name: string;
+                description?: string | undefined;
+                payload?: string | undefined;
+            }>, "many">>;
+            stability: z.ZodDefault<z.ZodEnum<["stable", "beta", "alpha", "experimental"]>>;
+        }, "strip", z.ZodTypeAny, {
+            methods: {
+                name: string;
+                async: boolean;
+                description?: string | undefined;
+                parameters?: {
+                    type: string;
+                    required: boolean;
+                    name: string;
+                    description?: string | undefined;
+                }[] | undefined;
+                returnType?: string | undefined;
+            }[];
+            name: string;
+            version: {
+                major: number;
+                minor: number;
+                patch: number;
+            };
+            id: string;
+            stability: "experimental" | "stable" | "beta" | "alpha";
+            description?: string | undefined;
+            events?: {
+                name: string;
+                description?: string | undefined;
+                payload?: string | undefined;
+            }[] | undefined;
+        }, {
+            methods: {
+                name: string;
+                description?: string | undefined;
+                async?: boolean | undefined;
+                parameters?: {
+                    type: string;
+                    name: string;
+                    required?: boolean | undefined;
+                    description?: string | undefined;
+                }[] | undefined;
+                returnType?: string | undefined;
+            }[];
+            name: string;
+            version: {
+                major: number;
+                minor: number;
+                patch: number;
+            };
+            id: string;
+            description?: string | undefined;
+            events?: {
+                name: string;
+                description?: string | undefined;
+                payload?: string | undefined;
+            }[] | undefined;
+            stability?: "experimental" | "stable" | "beta" | "alpha" | undefined;
+        }>, "many">>;
+        requires: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            pluginId: z.ZodString;
+            version: z.ZodString;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            reason: z.ZodOptional<z.ZodString>;
+            requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            version: string;
+            pluginId: string;
+            optional: boolean;
+            reason?: string | undefined;
+            requiredCapabilities?: string[] | undefined;
+        }, {
+            version: string;
+            pluginId: string;
+            optional?: boolean | undefined;
+            reason?: string | undefined;
+            requiredCapabilities?: string[] | undefined;
+        }>, "many">>;
+        extensionPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            type: z.ZodEnum<["action", "hook", "widget", "provider", "transformer", "validator", "decorator"]>;
+            contract: z.ZodOptional<z.ZodObject<{
+                input: z.ZodOptional<z.ZodString>;
+                output: z.ZodOptional<z.ZodString>;
+                signature: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                signature?: string | undefined;
+                input?: string | undefined;
+                output?: string | undefined;
+            }, {
+                signature?: string | undefined;
+                input?: string | undefined;
+                output?: string | undefined;
+            }>>;
+            cardinality: z.ZodDefault<z.ZodEnum<["single", "multiple"]>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "provider" | "widget" | "action" | "hook" | "transformer" | "validator" | "decorator";
+            name: string;
+            id: string;
+            cardinality: "multiple" | "single";
+            description?: string | undefined;
+            contract?: {
+                signature?: string | undefined;
+                input?: string | undefined;
+                output?: string | undefined;
+            } | undefined;
+        }, {
+            type: "provider" | "widget" | "action" | "hook" | "transformer" | "validator" | "decorator";
+            name: string;
+            id: string;
+            description?: string | undefined;
+            contract?: {
+                signature?: string | undefined;
+                input?: string | undefined;
+                output?: string | undefined;
+            } | undefined;
+            cardinality?: "multiple" | "single" | undefined;
+        }>, "many">>;
+        extensions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            targetPluginId: z.ZodString;
+            extensionPointId: z.ZodString;
+            implementation: z.ZodString;
+            priority: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            priority: number;
+            implementation: string;
+            targetPluginId: string;
+            extensionPointId: string;
+        }, {
+            implementation: string;
+            targetPluginId: string;
+            extensionPointId: string;
+            priority?: number | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        implements?: {
+            protocol: {
+                label: string;
+                version: {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                };
+                id: string;
+                description?: string | undefined;
+                specification?: string | undefined;
+            };
+            conformance: "partial" | "full" | "deprecated" | "experimental";
+            certified: boolean;
+            metadata?: Record<string, any> | undefined;
+            implementedFeatures?: string[] | undefined;
+            features?: {
+                enabled: boolean;
+                name: string;
+                description?: string | undefined;
+                sinceVersion?: string | undefined;
+                deprecatedSince?: string | undefined;
+            }[] | undefined;
+            certificationDate?: string | undefined;
+        }[] | undefined;
+        provides?: {
+            methods: {
+                name: string;
+                async: boolean;
+                description?: string | undefined;
+                parameters?: {
+                    type: string;
+                    required: boolean;
+                    name: string;
+                    description?: string | undefined;
+                }[] | undefined;
+                returnType?: string | undefined;
+            }[];
+            name: string;
+            version: {
+                major: number;
+                minor: number;
+                patch: number;
+            };
+            id: string;
+            stability: "experimental" | "stable" | "beta" | "alpha";
+            description?: string | undefined;
+            events?: {
+                name: string;
+                description?: string | undefined;
+                payload?: string | undefined;
+            }[] | undefined;
+        }[] | undefined;
+        requires?: {
+            version: string;
+            pluginId: string;
+            optional: boolean;
+            reason?: string | undefined;
+            requiredCapabilities?: string[] | undefined;
+        }[] | undefined;
+        extensionPoints?: {
+            type: "provider" | "widget" | "action" | "hook" | "transformer" | "validator" | "decorator";
+            name: string;
+            id: string;
+            cardinality: "multiple" | "single";
+            description?: string | undefined;
+            contract?: {
+                signature?: string | undefined;
+                input?: string | undefined;
+                output?: string | undefined;
+            } | undefined;
+        }[] | undefined;
+        extensions?: {
+            priority: number;
+            implementation: string;
+            targetPluginId: string;
+            extensionPointId: string;
+        }[] | undefined;
+    }, {
+        implements?: {
+            protocol: {
+                label: string;
+                version: {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                };
+                id: string;
+                description?: string | undefined;
+                specification?: string | undefined;
+            };
+            metadata?: Record<string, any> | undefined;
+            conformance?: "partial" | "full" | "deprecated" | "experimental" | undefined;
+            implementedFeatures?: string[] | undefined;
+            features?: {
+                name: string;
+                enabled?: boolean | undefined;
+                description?: string | undefined;
+                sinceVersion?: string | undefined;
+                deprecatedSince?: string | undefined;
+            }[] | undefined;
+            certified?: boolean | undefined;
+            certificationDate?: string | undefined;
+        }[] | undefined;
+        provides?: {
+            methods: {
+                name: string;
+                description?: string | undefined;
+                async?: boolean | undefined;
+                parameters?: {
+                    type: string;
+                    name: string;
+                    required?: boolean | undefined;
+                    description?: string | undefined;
+                }[] | undefined;
+                returnType?: string | undefined;
+            }[];
+            name: string;
+            version: {
+                major: number;
+                minor: number;
+                patch: number;
+            };
+            id: string;
+            description?: string | undefined;
+            events?: {
+                name: string;
+                description?: string | undefined;
+                payload?: string | undefined;
+            }[] | undefined;
+            stability?: "experimental" | "stable" | "beta" | "alpha" | undefined;
+        }[] | undefined;
+        requires?: {
+            version: string;
+            pluginId: string;
+            optional?: boolean | undefined;
+            reason?: string | undefined;
+            requiredCapabilities?: string[] | undefined;
+        }[] | undefined;
+        extensionPoints?: {
+            type: "provider" | "widget" | "action" | "hook" | "transformer" | "validator" | "decorator";
+            name: string;
+            id: string;
+            description?: string | undefined;
+            contract?: {
+                signature?: string | undefined;
+                input?: string | undefined;
+                output?: string | undefined;
+            } | undefined;
+            cardinality?: "multiple" | "single" | undefined;
+        }[] | undefined;
+        extensions?: {
+            implementation: string;
+            targetPluginId: string;
+            extensionPointId: string;
+            priority?: number | undefined;
+        }[] | undefined;
+    }>>;
     /**
      * Extension points contributed by this package.
      * Allows packages to extend UI components, add functionality, etc.
@@ -368,17 +853,98 @@ export declare const ManifestSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "app" | "module" | "plugin" | "driver" | "objectql" | "gateway" | "adapter";
     name: string;
-    id: string;
     version: string;
+    id: string;
     description?: string | undefined;
-    objects?: string[] | undefined;
+    dependencies?: Record<string, string> | undefined;
     data?: {
         object: string;
         mode: "insert" | "upsert" | "ignore";
         records: Record<string, any>[];
     }[] | undefined;
-    dependencies?: Record<string, string> | undefined;
+    capabilities?: {
+        implements?: {
+            protocol: {
+                label: string;
+                version: {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                };
+                id: string;
+                description?: string | undefined;
+                specification?: string | undefined;
+            };
+            conformance: "partial" | "full" | "deprecated" | "experimental";
+            certified: boolean;
+            metadata?: Record<string, any> | undefined;
+            implementedFeatures?: string[] | undefined;
+            features?: {
+                enabled: boolean;
+                name: string;
+                description?: string | undefined;
+                sinceVersion?: string | undefined;
+                deprecatedSince?: string | undefined;
+            }[] | undefined;
+            certificationDate?: string | undefined;
+        }[] | undefined;
+        provides?: {
+            methods: {
+                name: string;
+                async: boolean;
+                description?: string | undefined;
+                parameters?: {
+                    type: string;
+                    required: boolean;
+                    name: string;
+                    description?: string | undefined;
+                }[] | undefined;
+                returnType?: string | undefined;
+            }[];
+            name: string;
+            version: {
+                major: number;
+                minor: number;
+                patch: number;
+            };
+            id: string;
+            stability: "experimental" | "stable" | "beta" | "alpha";
+            description?: string | undefined;
+            events?: {
+                name: string;
+                description?: string | undefined;
+                payload?: string | undefined;
+            }[] | undefined;
+        }[] | undefined;
+        requires?: {
+            version: string;
+            pluginId: string;
+            optional: boolean;
+            reason?: string | undefined;
+            requiredCapabilities?: string[] | undefined;
+        }[] | undefined;
+        extensionPoints?: {
+            type: "provider" | "widget" | "action" | "hook" | "transformer" | "validator" | "decorator";
+            name: string;
+            id: string;
+            cardinality: "multiple" | "single";
+            description?: string | undefined;
+            contract?: {
+                signature?: string | undefined;
+                input?: string | undefined;
+                output?: string | undefined;
+            } | undefined;
+        }[] | undefined;
+        extensions?: {
+            priority: number;
+            implementation: string;
+            targetPluginId: string;
+            extensionPointId: string;
+        }[] | undefined;
+    } | undefined;
+    objects?: string[] | undefined;
     permissions?: string[] | undefined;
+    extensions?: Record<string, any> | undefined;
     datasources?: string[] | undefined;
     configuration?: {
         properties: Record<string, {
@@ -432,25 +998,105 @@ export declare const ManifestSchema: z.ZodObject<{
         functions?: {
             name: string;
             description?: string | undefined;
-            args?: string[] | undefined;
             returnType?: string | undefined;
+            args?: string[] | undefined;
         }[] | undefined;
     } | undefined;
-    extensions?: Record<string, any> | undefined;
 }, {
     type: "app" | "module" | "plugin" | "driver" | "objectql" | "gateway" | "adapter";
     name: string;
-    id: string;
     version: string;
+    id: string;
     description?: string | undefined;
-    objects?: string[] | undefined;
+    dependencies?: Record<string, string> | undefined;
     data?: {
         object: string;
         records: Record<string, any>[];
         mode?: "insert" | "upsert" | "ignore" | undefined;
     }[] | undefined;
-    dependencies?: Record<string, string> | undefined;
+    capabilities?: {
+        implements?: {
+            protocol: {
+                label: string;
+                version: {
+                    major: number;
+                    minor: number;
+                    patch: number;
+                };
+                id: string;
+                description?: string | undefined;
+                specification?: string | undefined;
+            };
+            metadata?: Record<string, any> | undefined;
+            conformance?: "partial" | "full" | "deprecated" | "experimental" | undefined;
+            implementedFeatures?: string[] | undefined;
+            features?: {
+                name: string;
+                enabled?: boolean | undefined;
+                description?: string | undefined;
+                sinceVersion?: string | undefined;
+                deprecatedSince?: string | undefined;
+            }[] | undefined;
+            certified?: boolean | undefined;
+            certificationDate?: string | undefined;
+        }[] | undefined;
+        provides?: {
+            methods: {
+                name: string;
+                description?: string | undefined;
+                async?: boolean | undefined;
+                parameters?: {
+                    type: string;
+                    name: string;
+                    required?: boolean | undefined;
+                    description?: string | undefined;
+                }[] | undefined;
+                returnType?: string | undefined;
+            }[];
+            name: string;
+            version: {
+                major: number;
+                minor: number;
+                patch: number;
+            };
+            id: string;
+            description?: string | undefined;
+            events?: {
+                name: string;
+                description?: string | undefined;
+                payload?: string | undefined;
+            }[] | undefined;
+            stability?: "experimental" | "stable" | "beta" | "alpha" | undefined;
+        }[] | undefined;
+        requires?: {
+            version: string;
+            pluginId: string;
+            optional?: boolean | undefined;
+            reason?: string | undefined;
+            requiredCapabilities?: string[] | undefined;
+        }[] | undefined;
+        extensionPoints?: {
+            type: "provider" | "widget" | "action" | "hook" | "transformer" | "validator" | "decorator";
+            name: string;
+            id: string;
+            description?: string | undefined;
+            contract?: {
+                signature?: string | undefined;
+                input?: string | undefined;
+                output?: string | undefined;
+            } | undefined;
+            cardinality?: "multiple" | "single" | undefined;
+        }[] | undefined;
+        extensions?: {
+            implementation: string;
+            targetPluginId: string;
+            extensionPointId: string;
+            priority?: number | undefined;
+        }[] | undefined;
+    } | undefined;
+    objects?: string[] | undefined;
     permissions?: string[] | undefined;
+    extensions?: Record<string, any> | undefined;
     datasources?: string[] | undefined;
     configuration?: {
         properties: Record<string, {
@@ -504,11 +1150,10 @@ export declare const ManifestSchema: z.ZodObject<{
         functions?: {
             name: string;
             description?: string | undefined;
-            args?: string[] | undefined;
             returnType?: string | undefined;
+            args?: string[] | undefined;
         }[] | undefined;
     } | undefined;
-    extensions?: Record<string, any> | undefined;
 }>;
 /**
  * TypeScript type inferred from the ManifestSchema.