\n \n\n> [!WARNING]\n> This project is under active development and is not ready for production use. Please proceed with caution. Use at your own risk. \n\n📚 **Documentation:** [86d.app/docs/concepts/modules](https://86d.app/docs/concepts/modules)\n\n# Core\n\nCore types and utilities for building modules in the 86d module system. This package provides everything module authors need to create publishable, type-safe modules.\n\n## Installation\n\n```bash\nnpm install @86d-app/core\n# or\nbun add @86d-app/core\n```\n\n## Features\n\n- **Type-safe module definition** - Full TypeScript support for modules, endpoints, and capabilities\n- **Endpoint utilities** - Re-exports from `better-call` and `zod` for defining HTTP endpoints\n- **Client API** - Auto-generated React Query hooks for consuming module endpoints\n- **Capability kernel** - Versioned, schema-validated decisions across isolated modules\n- **Owner-scoped resources** - A module receives only its own data, controllers, and options\n\n## Creating a Module\n\nA module is a self-contained unit with endpoints, owner-local controllers, and optionally a database schema. Immediate decisions owned by another module cross a typed capability boundary.\n\n```typescript\nimport {\n acceptCapability,\n createEndpoint,\n createStoreEndpoint,\n productResolveCapability,\n z,\n type Module,\n type ModuleContext,\n} from \"@86d-app/core\";\n\n// Create endpoints\nconst getItems = createEndpoint(\n \"/items\",\n { method: \"GET\" },\n async (ctx) => {\n const context = ctx.context as ModuleContext;\n return { items: [] };\n }\n);\n\nconst createItem = createEndpoint(\n \"/items\",\n {\n method: \"POST\",\n body: z.object({\n name: z.string(),\n price: z.number().positive(),\n }),\n },\n async (ctx) => {\n const { body } = ctx;\n const context = ctx.context as ModuleContext;\n // Create item logic...\n return { id: \"123\", ...body };\n }\n);\n\nconst getProductPreview = createStoreEndpoint(\n \"/preview/:productId\",\n {\n method: \"GET\",\n params: z.object({ productId: z.string().min(1) }),\n },\n async (ctx) => {\n const result = await ctx.context.capabilities.invoke(\n productResolveCapability,\n { productId: ctx.params.productId },\n );\n\n if (!result.ok) {\n return { error: \"Product decision unavailable\", status: 503 };\n }\n\n return { product: result.decision.product };\n },\n);\n\n// Export module factory\nexport default function myModule(): Module {\n return {\n id: \"my-module\",\n version: \"1.0.0\",\n capabilities: {\n accepts: [acceptCapability(productResolveCapability)],\n },\n endpoints: {\n store: {\n \"/items\": createItem,\n \"/items/list\": getItems,\n \"/preview/:productId\": getProductPreview,\n },\n admin: {},\n },\n };\n}\n```\n\n## Inter-module Capabilities\n\nCapability definitions are pure, versioned schemas shared through `@86d-app/core`. The owner provides the decision and each consumer explicitly accepts the exact contract:\n\n```typescript\n// In the owner Module\ncapabilities: {\n provides: [provideCapability(productResolveCapability, resolveProduct)],\n}\n\n// In a consumer Module\ncapabilities: {\n accepts: [acceptCapability(productResolveCapability)],\n}\n```\n\nThe runtime will:\n\n- Resolve required capabilities before any adapter or module initialization effects\n- Reject missing, duplicate, malformed, owner-mismatched, or incompatible contracts\n- Validate requests, decisions, and failures against both sides of the boundary\n- Invoke providers with only the owner Module's scoped data, events, and options\n\nPass `{ optional: true }` to `acceptCapability` only when absence is a supported state. The legacy `exports` and `requires` declarations remain migration metadata and never grant cross-Module access.\n\nFor a contract with an `operation` discriminant, grant only the operations the consumer needs:\n\n```typescript\nacceptCapability(paymentIntentCapability, {\n operations: [\"list\"],\n optional: true,\n})\n```\n\nThe runtime rejects an invocation outside that allowlist before the provider runs.\n\n## Client API\n\nThe client package provides React Query integration for consuming module endpoints.\n\n### Setup\n\n```tsx\nimport { ModuleClientProvider } from \"@86d-app/core/client\";\nimport cart from \"@my-org/cart\";\nimport products from \"@my-org/products\";\n\nfunction App({ children }) {\n return (\n ({\n Authorization: `Bearer ${getToken()}`,\n })}\n >\n {children}\n \n );\n}\n```\n\n### Using Hooks\n\n```tsx\nimport { useModuleClient } from \"@86d-app/core/client\";\n\nfunction ProductList() {\n const client = useModuleClient();\n\n // GET endpoints become queries\n const { data, isLoading } = client\n .module(\"products\")\n .store[\"/products\"]\n .useQuery({ category: \"electronics\" });\n\n // POST/PUT/DELETE endpoints become mutations\n const addToCart = client.module(\"cart\").store[\"/cart\"].useMutation({\n onSuccess: () => {\n // Invalidate related queries\n client.module(\"cart\").store[\"/cart/get\"].invalidate();\n },\n });\n\n if (isLoading) return