@farm.js/core 0.1.0-beta.0

package/package.json

@@ -0,0 +1,523 @@
+{
+  "name": "@farm.js/core",
+  "version": "0.1.0-beta.0",
+  "description": "Core Farm.js framework - A modern React meta-framework",
+  "keywords": [
+    "@farm.js/core",
+    "framework",
+    "react",
+    "rsc",
+    "server-components",
+    "ssr",
+    "vite"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/farming-labs/farm.js",
+    "directory": "packages/farm"
+  },
+  "files": [
+    "dist",
+    "types"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "middleware": [
+        "./types/middleware.d.ts",
+        "./dist/middleware.d.ts"
+      ],
+      "router": [
+        "./dist/router.d.ts"
+      ],
+      "routes": [
+        "./dist/routes.d.ts"
+      ],
+      "storage": [
+        "./dist/storage.d.ts"
+      ],
+      "integrations": [
+        "./dist/integrations.d.ts"
+      ],
+      "cache": [
+        "./dist/cache.d.ts"
+      ],
+      "deferred": [
+        "./dist/deferred.d.ts"
+      ],
+      "after": [
+        "./dist/after.d.ts"
+      ],
+      "navigation": [
+        "./dist/navigation.d.ts"
+      ],
+      "headers": [
+        "./dist/headers.d.ts"
+      ],
+      "docs": [
+        "./dist/docs.d.ts"
+      ],
+      "markdown": [
+        "./dist/markdown.d.ts"
+      ],
+      "app-markdown": [
+        "./dist/app-markdown.d.ts"
+      ],
+      "observability": [
+        "./dist/observability.d.ts"
+      ],
+      "workflows": [
+        "./dist/workflows.d.ts"
+      ],
+      "cron": [
+        "./dist/cron.d.ts"
+      ],
+      "server-fn": [
+        "./dist/server-fn.d.ts"
+      ],
+      "server-fn/client": [
+        "./dist/server-fn-client.d.ts"
+      ],
+      "server-action-security": [
+        "./dist/server-action-security.d.ts"
+      ],
+      "deployment": [
+        "./dist/deployment.d.ts"
+      ],
+      "env": [
+        "./dist/env.d.ts"
+      ],
+      "env-types": [
+        "./dist/env-types.d.ts"
+      ],
+      "environment": [
+        "./dist/environment.d.ts"
+      ],
+      "environment/vite": [
+        "./dist/environment/vite.d.ts"
+      ],
+      "testing": [
+        "./dist/testing.d.ts"
+      ],
+      "agent-runtime": [
+        "./dist/agent-runtime.d.ts"
+      ],
+      "image": [
+        "./dist/image.d.ts"
+      ],
+      "image/server": [
+        "./dist/image/server.d.ts"
+      ],
+      "image/sharp": [
+        "./dist/image/sharp.d.ts"
+      ],
+      "i18n": [
+        "./dist/i18n/index.d.ts"
+      ],
+      "i18n/server": [
+        "./dist/i18n/server.d.ts"
+      ],
+      "i18n/client": [
+        "./dist/i18n/client.d.ts"
+      ],
+      "internal/production-runtime": [
+        "./dist/internal/production-runtime.d.ts"
+      ],
+      "internal/client-runtime": [
+        "./dist/internal/client-runtime.d.ts"
+      ],
+      "internal/build-runtime": [
+        "./dist/internal/build-runtime.d.ts"
+      ],
+      "internal/config-runtime": [
+        "./dist/internal/config-runtime.d.ts"
+      ],
+      "internal/production-node-env": [
+        "./dist/internal/production-node-env.d.ts"
+      ],
+      "config": [
+        "./dist/config.d.ts"
+      ],
+      "api": [
+        "./types/api.d.ts",
+        "./dist/api.d.ts"
+      ],
+      "api/route-manager": [
+        "./dist/api/route-manager.d.ts"
+      ],
+      "api/runtime": [
+        "./dist/api/runtime.d.ts"
+      ],
+      "request": [
+        "./dist/request.d.ts"
+      ],
+      "client": [
+        "./types/client.d.ts",
+        "./dist/client.d.ts"
+      ],
+      "server": [
+        "./dist/server.d.ts"
+      ],
+      "vite": [
+        "./dist/vite.d.ts"
+      ],
+      "plugin": [
+        "./dist/plugin.d.ts"
+      ],
+      "query": [
+        "./dist/query/index.d.ts"
+      ],
+      "*": [
+        "./dist/*.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.mjs",
+      "require": "./dist/config.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.cjs"
+    },
+    "./client": {
+      "types": "./types/client.d.ts",
+      "import": "./dist/client.mjs",
+      "require": "./dist/client.cjs"
+    },
+    "./storage": {
+      "types": "./dist/storage.d.ts",
+      "import": "./dist/storage.mjs",
+      "require": "./dist/storage.cjs"
+    },
+    "./integrations": {
+      "types": "./dist/integrations.d.ts",
+      "import": "./dist/integrations.mjs",
+      "require": "./dist/integrations.cjs"
+    },
+    "./cache": {
+      "types": "./dist/cache.d.ts",
+      "import": "./dist/cache.mjs",
+      "require": "./dist/cache.cjs"
+    },
+    "./deferred": {
+      "types": "./dist/deferred.d.ts",
+      "import": "./dist/deferred.mjs",
+      "require": "./dist/deferred.cjs"
+    },
+    "./after": {
+      "types": "./dist/after.d.ts",
+      "import": "./dist/after.mjs",
+      "require": "./dist/after.cjs"
+    },
+    "./navigation": {
+      "types": "./dist/navigation.d.ts",
+      "import": "./dist/navigation.mjs",
+      "require": "./dist/navigation.cjs"
+    },
+    "./headers": {
+      "types": "./dist/headers.d.ts",
+      "import": "./dist/headers.mjs",
+      "require": "./dist/headers.cjs"
+    },
+    "./docs": {
+      "types": "./dist/docs.d.ts",
+      "import": "./dist/docs.mjs",
+      "require": "./dist/docs.cjs"
+    },
+    "./markdown": {
+      "types": "./dist/markdown.d.ts",
+      "import": "./dist/markdown.mjs",
+      "require": "./dist/markdown.cjs"
+    },
+    "./app-markdown": {
+      "types": "./dist/app-markdown.d.ts",
+      "import": "./dist/app-markdown.mjs",
+      "require": "./dist/app-markdown.cjs"
+    },
+    "./observability": {
+      "types": "./dist/observability.d.ts",
+      "import": "./dist/observability.mjs",
+      "require": "./dist/observability.cjs"
+    },
+    "./workflows": {
+      "types": "./dist/workflows.d.ts",
+      "import": "./dist/workflows.mjs",
+      "require": "./dist/workflows.cjs"
+    },
+    "./cron": {
+      "types": "./dist/cron.d.ts",
+      "import": "./dist/cron.mjs",
+      "require": "./dist/cron.cjs"
+    },
+    "./server-fn": {
+      "types": "./dist/server-fn.d.ts",
+      "import": "./dist/server-fn.mjs",
+      "require": "./dist/server-fn.cjs"
+    },
+    "./server-fn/client": {
+      "types": "./dist/server-fn-client.d.ts",
+      "import": "./dist/server-fn-client.mjs",
+      "require": "./dist/server-fn-client.cjs"
+    },
+    "./server-query": {
+      "types": "./dist/server-query.d.ts",
+      "import": "./dist/server-query.mjs",
+      "require": "./dist/server-query.cjs"
+    },
+    "./server-query/client": {
+      "types": "./dist/server-query-client.d.ts",
+      "import": "./dist/server-query-client.mjs",
+      "require": "./dist/server-query-client.cjs"
+    },
+    "./server-action-security": {
+      "types": "./dist/server-action-security.d.ts",
+      "import": "./dist/server-action-security.mjs",
+      "require": "./dist/server-action-security.cjs"
+    },
+    "./deployment": {
+      "types": "./dist/deployment.d.ts",
+      "import": "./dist/deployment.mjs",
+      "require": "./dist/deployment.cjs"
+    },
+    "./env": {
+      "types": "./dist/env.d.ts",
+      "import": "./dist/env.mjs",
+      "require": "./dist/env.cjs"
+    },
+    "./env-types": {
+      "types": "./dist/env-types.d.ts",
+      "import": "./dist/env-types.mjs",
+      "require": "./dist/env-types.cjs"
+    },
+    "./environment": {
+      "types": "./dist/environment.d.ts",
+      "import": "./dist/environment.mjs",
+      "require": "./dist/environment.cjs"
+    },
+    "./environment/vite": {
+      "types": "./dist/environment/vite.d.ts",
+      "import": "./dist/environment/vite.mjs",
+      "require": "./dist/environment/vite.cjs"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.mjs",
+      "require": "./dist/vite.cjs"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.mjs",
+      "require": "./dist/plugin.cjs"
+    },
+    "./plugin/server": {
+      "types": "./dist/server-plugins.d.ts",
+      "import": "./dist/server-plugins.mjs",
+      "require": "./dist/server-plugins.cjs"
+    },
+    "./plugin/client": {
+      "types": "./dist/client-plugins.d.ts",
+      "import": "./dist/client-plugins.mjs",
+      "require": "./dist/client-plugins.cjs"
+    },
+    "./query": {
+      "types": "./dist/query/index.d.ts",
+      "import": "./dist/query/index.mjs",
+      "require": "./dist/query/index.cjs"
+    },
+    "./query/parsers": {
+      "types": "./dist/query/parsers.d.ts",
+      "import": "./dist/query/parsers.mjs",
+      "require": "./dist/query/parsers.cjs"
+    },
+    "./query/client": {
+      "types": "./dist/query/client.d.ts",
+      "import": "./dist/query/client.mjs",
+      "require": "./dist/query/client.cjs"
+    },
+    "./query/server": {
+      "types": "./dist/query/server.d.ts",
+      "import": "./dist/query/server.mjs",
+      "require": "./dist/query/server.cjs"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.mjs",
+      "require": "./dist/middleware.cjs"
+    },
+    "./api": {
+      "types": "./dist/api.d.ts",
+      "import": "./dist/api.mjs",
+      "require": "./dist/api.cjs"
+    },
+    "./api/route-manager": {
+      "types": "./dist/api/route-manager.d.ts",
+      "import": "./dist/api/route-manager.mjs",
+      "require": "./dist/api/route-manager.cjs"
+    },
+    "./api/runtime": {
+      "types": "./dist/api/runtime.d.ts",
+      "import": "./dist/api/runtime.mjs",
+      "require": "./dist/api/runtime.cjs"
+    },
+    "./request": {
+      "types": "./dist/request.d.ts",
+      "import": "./dist/request.mjs",
+      "require": "./dist/request.cjs"
+    },
+    "./router": {
+      "types": "./dist/router.d.ts",
+      "import": "./dist/router.mjs",
+      "require": "./dist/router.cjs"
+    },
+    "./routes": {
+      "types": "./dist/routes.d.ts",
+      "import": "./dist/routes.mjs",
+      "require": "./dist/routes.cjs"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.mjs",
+      "require": "./dist/testing.cjs"
+    },
+    "./agent-runtime": {
+      "types": "./dist/agent-runtime.d.ts",
+      "import": "./dist/agent-runtime.mjs",
+      "require": "./dist/agent-runtime.cjs"
+    },
+    "./image": {
+      "types": "./dist/image.d.ts",
+      "import": "./dist/image.mjs",
+      "require": "./dist/image.cjs"
+    },
+    "./image/server": {
+      "types": "./dist/image/server.d.ts",
+      "import": "./dist/image/server.mjs",
+      "require": "./dist/image/server.cjs"
+    },
+    "./image/sharp": {
+      "types": "./dist/image/sharp.d.ts",
+      "import": "./dist/image/sharp.mjs",
+      "require": "./dist/image/sharp.cjs"
+    },
+    "./i18n": {
+      "types": "./dist/i18n/index.d.ts",
+      "import": "./dist/i18n/index.mjs",
+      "require": "./dist/i18n/index.cjs"
+    },
+    "./i18n/server": {
+      "types": "./dist/i18n/server.d.ts",
+      "import": "./dist/i18n/server.mjs",
+      "require": "./dist/i18n/server.cjs"
+    },
+    "./i18n/client": {
+      "types": "./dist/i18n/client.d.ts",
+      "import": "./dist/i18n/client.mjs",
+      "require": "./dist/i18n/client.cjs"
+    },
+    "./internal/production-runtime": {
+      "types": "./dist/internal/production-runtime.d.ts",
+      "import": "./dist/internal/production-runtime.mjs",
+      "require": "./dist/internal/production-runtime.cjs"
+    },
+    "./internal/client-runtime": {
+      "types": "./dist/internal/client-runtime.d.ts",
+      "import": "./dist/internal/client-runtime.mjs",
+      "require": "./dist/internal/client-runtime.cjs"
+    },
+    "./internal/build-runtime": {
+      "types": "./dist/internal/build-runtime.d.ts",
+      "import": "./dist/internal/build-runtime.mjs",
+      "require": "./dist/internal/build-runtime.cjs"
+    },
+    "./internal/config-runtime": {
+      "types": "./dist/internal/config-runtime.d.ts",
+      "import": "./dist/internal/config-runtime.mjs",
+      "require": "./dist/internal/config-runtime.cjs"
+    },
+    "./internal/production-node-env": {
+      "types": "./dist/internal/production-node-env.d.ts",
+      "import": "./dist/internal/production-node-env.mjs",
+      "require": "./dist/internal/production-node-env.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@farming-labs/docs": "^0.2.44",
+    "@farming-labs/orm": "0.0.62",
+    "@farming-labs/orm-runtime": "0.0.62",
+    "@formatjs/icu-messageformat-parser": "3.5.15",
+    "@mdx-js/mdx": "^3.1.1",
+    "@scalar/api-reference": "^1.38.1",
+    "@scalar/openapi-parser": "^0.22.3",
+    "@tailwindcss/vite": "4.1.18",
+    "@vitejs/plugin-react": "^4.2.1",
+    "better-call": "^1.0.19",
+    "db0": "^0.3.4",
+    "esbuild": "^0.28.0",
+    "fast-glob": "^3.3.2",
+    "h3": "2.0.1-rc.5",
+    "image-size": "^2.0.2",
+    "intl-messageformat": "11.2.12",
+    "marked": "^12.0.2",
+    "nitro": "3.0.1-alpha.0",
+    "pg": "^8.20.0",
+    "picocolors": "^1.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-server-dom-webpack": "^18.3.0-canary-670c8dfb8-20231204",
+    "remark-gfm": "^4.0.1",
+    "sirv": "^2.0.4",
+    "sugar-high": "^0.9.5",
+    "supports-color": "^10.2.2",
+    "tailwindcss": "4.1.18",
+    "unstorage": "^2.0.0-alpha.3",
+    "vite": "^5.0.10",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@clerk/react": "^6.1.0",
+    "@types/react": "^18.2.45",
+    "@types/react-dom": "^18.2.18",
+    "@vitest/coverage-v8": "^1.1.0",
+    "jsdom": "^25.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.3.3",
+    "vitest": "^1.1.0"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0",
+    "react-dom": "^18.2.0 || ^19.0.0"
+  },
+  "optionalDependencies": {
+    "rolldown": "1.2.0",
+    "sharp": "^0.34.5",
+    "vite-rolldown": "npm:vite@8.1.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:runtime": "tsup --config tsup.runtime.config.ts",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:coverage": "vitest --coverage",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "format": "biome format --write .",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/types/api.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Type declarations for @farm.js/core/api
+ *
+ * These provide stable type definitions that don't depend on build hashes.
+ */
+
+declare module "@farm.js/core/api" {
+  import type { z } from "zod";
+
+  /**
+   * HTTP methods supported by API routes
+   */
+  export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+
+  /**
+   * API endpoint context
+   */
+  export interface EndpointContext<TBody = unknown, TQuery = unknown, TParams = unknown> {
+    /** Request body (parsed) */
+    body: TBody;
+    /** Query parameters */
+    query: TQuery;
+    /** URL path parameters */
+    params: TParams;
+    /** Request headers */
+    headers: Headers;
+    /** Raw request object */
+    request: Request;
+  }
+
+  /**
+   * API endpoint handler
+   */
+  export type EndpointHandler<
+    TContext extends EndpointContext = EndpointContext,
+    TResponse = unknown,
+  > = (ctx: TContext) => TResponse | Promise<TResponse>;
+
+  /**
+   * API endpoint configuration
+   */
+  export interface EndpointConfig<
+    TBody = unknown,
+    TQuery = unknown,
+    TParams = unknown,
+    TResponse = unknown,
+  > {
+    /** HTTP method */
+    method?: HttpMethod;
+    /** Request body schema (Zod) */
+    body?: z.ZodType<TBody>;
+    /** Query parameters schema (Zod) */
+    query?: z.ZodType<TQuery>;
+    /** URL parameters schema (Zod) */
+    params?: z.ZodType<TParams>;
+    /** Response schema (Zod) */
+    response?: z.ZodType<TResponse>;
+    /** Endpoint handler */
+    handler: EndpointHandler<EndpointContext<TBody, TQuery, TParams>, TResponse>;
+  }
+
+  /**
+   * Create an API endpoint
+   */
+  export function endpoint<
+    TBody = unknown,
+    TQuery = unknown,
+    TParams = unknown,
+    TResponse = unknown,
+  >(
+    config: EndpointConfig<TBody, TQuery, TParams, TResponse>,
+  ): EndpointConfig<TBody, TQuery, TParams, TResponse>;
+
+  /**
+   * API route manager
+   */
+  export class APIRouteManager {
+    constructor(options?: { srcDir?: string; debug?: boolean });
+    discover(root: string): Promise<void>;
+    getRoutes(): Map<string, unknown>;
+    handle(request: Request): Promise<Response | null>;
+  }
+
+  /**
+   * Farm API plugin for Vite
+   */
+  export function farmApiPlugin(options?: { srcDir?: string; debug?: boolean }): unknown;
+}