@origostudio/origo-design 0.0.0

package/packages/core/src/schemas/capability.schema.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://origo.design/schemas/v1/capability.schema.json",
+  "title": "Capability",
+  "description": "BADL Capability Definition",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "name": {
+      "type": "string",
+      "enum": ["Create", "Read", "Update", "Delete", "List"],
+      "description": "Strict vocabulary of core capability verbs"
+    },
+    "description": {
+      "type": "string"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["Command", "Query"]
+    },
+    "entityId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Target entity for this capability"
+    },
+    "outcome_ref": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "preconditions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "postconditions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "permissions": {
+      "type": "array",
+      "items": {
+        "$ref": "permission.schema.json"
+      }
+    },
+    "risk_level": {
+      "type": "string",
+      "enum": ["low", "medium", "high", "critical"]
+    },
+    "interaction_contract_ref": {
+      "type": "string"
+    },
+    "async": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "id",
+    "name",
+    "description",
+    "type",
+    "entityId",
+    "outcome_ref",
+    "preconditions",
+    "postconditions",
+    "permissions",
+    "risk_level",
+    "async"
+  ],
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "name": { "enum": ["Create", "Update", "Delete"] }
+        }
+      },
+      "then": {
+        "properties": {
+          "type": { "const": "Command" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "name": { "enum": ["Read", "List"] }
+        }
+      },
+      "then": {
+        "properties": {
+          "type": { "const": "Query" }
+        }
+      }
+    }
+  ]
+}

package/packages/core/src/schemas/contract.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://origo.design/schemas/v1/contract.schema.json",
+  "title": "Contract",
+  "description": "BADL Contract Definition",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "requiredFields": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string",
+            "enum": ["string", "boolean", "date", "number", "array", "object"]
+          }
+        },
+        "required": ["name", "type"],
+        "additionalProperties": false
+      }
+    },
+    "requiredCapabilities": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "enum": ["Create", "Read", "Update", "Delete", "List"]
+          },
+          "type": {
+            "type": "string",
+            "enum": ["Command", "Query"]
+          }
+        },
+        "required": ["name", "type"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": ["id", "name", "requiredFields", "requiredCapabilities"],
+  "additionalProperties": false
+}

package/packages/core/src/schemas/domain.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://origo.design/schemas/v1/domain.schema.json",
+  "title": "Domain",
+  "description": "BADL Domain Definition",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "version": {
+      "type": "string"
+    },
+    "domain": {
+      "type": "string"
+    },
+    "entities": {
+      "type": "array",
+      "items": {
+        "$ref": "entity.schema.json"
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "items": {
+        "$ref": "capability.schema.json"
+      }
+    },
+    "contracts": {
+      "type": "array",
+      "items": {
+        "$ref": "contract.schema.json"
+      }
+    },
+    "extensions": {
+      "type": "array",
+      "items": {
+        "$ref": "extension.schema.json"
+      }
+    }
+  },
+  "required": ["id", "name", "version", "domain", "entities"],
+  "additionalProperties": false
+}

package/packages/core/src/schemas/entity.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://origo.design/schemas/v1/entity.schema.json",
+  "title": "Entity",
+  "description": "BADL Entity Definition",
+  "type": "object",
+  "$defs": {
+    "field": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["string", "boolean", "date", "number", "array", "object"]
+        },
+        "itemType": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "references": {
+          "type": "string"
+        },
+        "validation": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "metadata_path": {
+          "type": "string"
+        },
+        "fields": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/field"
+          }
+        }
+      },
+      "required": ["id", "name", "type", "label", "validation", "metadata_path"],
+      "additionalProperties": false
+    }
+  },
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "implements": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "fields": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/field"
+      }
+    }
+  },
+  "required": ["id", "name", "fields"],
+  "additionalProperties": false
+}

package/packages/core/src/schemas/extension.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://origo.design/schemas/v1/extension.schema.json",
+  "title": "Extension",
+  "description": "BADL Extension Definition",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[a-zA-Z0-9_-]+$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "extension_type": {
+      "type": "string",
+      "minLength": 1
+    },
+    "implements": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1
+    },
+    "plugin_version_range": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": ["id", "name", "version", "extension_type", "implements", "plugin_version_range"],
+  "additionalProperties": false
+}

package/packages/core/src/schemas/permission.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://origo.design/schemas/v1/permission.schema.json",
+  "title": "Permission",
+  "description": "BADL Role-Based Permission Definition",
+  "type": "object",
+  "properties": {
+    "role": {
+      "type": "string",
+      "description": "The role required for this permission",
+      "minLength": 1
+    },
+    "access": {
+      "type": "string",
+      "enum": ["grant", "deny"],
+      "default": "grant"
+    }
+  },
+  "required": ["role"],
+  "additionalProperties": false
+}

package/packages/core/src/types/ast.ts

@@ -0,0 +1,20 @@
+import { Domain } from './domain';
+
+export interface CanonicalAST {
+  schemaVersion: string;
+  domains: Domain[];
+}
+
+export interface ASTNode {
+  id: string;
+  type: string;
+  props?: Record<string, unknown>;
+  children?: ASTNode[];
+}
+
+export interface InteractionContract<TProps = Record<string, unknown>> {
+  id: string;
+  type: string;
+  props: TProps;
+  children?: InteractionContract[];
+}

package/packages/core/src/types/domain.ts

@@ -0,0 +1,105 @@
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run json-schema-to-typescript to regenerate this file.
+ */
+
+/**
+ * BADL Capability Definition
+ */
+export type Capability = Capability1 & Capability2;
+export type Capability1 = {
+  [k: string]: unknown;
+};
+
+/**
+ * BADL Domain Definition
+ */
+export interface Domain {
+  id: string;
+  name: string;
+  version: string;
+  domain: string;
+  entities: Entity[];
+  capabilities?: Capability[];
+  contracts?: Contract[];
+  extensions?: Extension[];
+}
+/**
+ * BADL Entity Definition
+ */
+export interface EntityField {
+  id: string;
+  name: string;
+  type: 'string' | 'boolean' | 'date' | 'number' | 'array' | 'object';
+  itemType?: string;
+  label: string;
+  references?: string;
+  validation: string[];
+  metadata_path: string;
+  fields?: EntityField[];
+}
+
+export interface Entity {
+  id: string;
+  name: string;
+  implements?: string[];
+  fields: EntityField[];
+}
+export interface Capability2 {
+  id: string;
+  /**
+   * Strict vocabulary of core capability verbs
+   */
+  name: 'Create' | 'Read' | 'Update' | 'Delete' | 'List';
+  description: string;
+  type: 'Command' | 'Query';
+  /**
+   * Target entity for this capability
+   */
+  entityId: string;
+  outcome_ref: string[];
+  preconditions: string[];
+  postconditions: string[];
+  permissions: Permission[];
+  risk_level: 'low' | 'medium' | 'high' | 'critical';
+  interaction_contract_ref?: string;
+  async: boolean;
+}
+/**
+ * BADL Role-Based Permission Definition
+ */
+export interface Permission {
+  /**
+   * The role required for this permission
+   */
+  role: string;
+  access?: 'grant' | 'deny';
+}
+/**
+ * BADL Contract Definition
+ */
+export interface Contract {
+  id: string;
+  name: string;
+  requiredFields: {
+    name: string;
+    type: 'string' | 'boolean' | 'date' | 'number' | 'array' | 'object';
+  }[];
+  requiredCapabilities: {
+    name: 'Create' | 'Read' | 'Update' | 'Delete' | 'List';
+    type: 'Command' | 'Query';
+  }[];
+}
+
+/**
+ * BADL Extension Definition
+ */
+export interface Extension {
+  id: string;
+  name: string;
+  version: string;
+  extension_type: string;
+  implements: string[];
+  plugin_version_range: string;
+}

package/packages/core/src/types/validation.ts

@@ -0,0 +1,29 @@
+export interface ValidationError {
+  type: string;
+  message: string;
+  path?: string;
+  line?: number;
+  column?: number;
+}
+
+export type ASTErrorType =
+  | 'CONTRACT_BREACH'
+  | 'INVALID_PERMISSION'
+  | 'UNSECURED_CAPABILITY'
+  | 'MISSING_MANIFEST_VERSION'
+  | 'VERSION_MISMATCH';
+
+export class ASTValidationError extends Error {
+  public errors: ValidationError[];
+
+  constructor(errors: ValidationError[], message = 'AST Validation Failed') {
+    const detailedMessage =
+      errors.length > 0 ? `${message}: ${errors.map(e => e.message).join(' | ')}` : message;
+    super(detailedMessage);
+    this.name = 'ASTValidationError';
+    this.errors = errors;
+
+    // Fix prototype chain for instanceof when extending built-in Error in TS
+    Object.setPrototypeOf(this, ASTValidationError.prototype);
+  }
+}