@treeseed/core 0.4.2 → 0.4.5

package/dist/railway.js

@@ -0,0 +1,4 @@
+import { createRailwayTreeseedApiServer } from "./api/railway.js";
+export {
+  createRailwayTreeseedApiServer
+};

package/dist/scripts/build-dist.js

@@ -206,6 +206,13 @@ function emitTypeDeclarations() {
     const sourceFiles = [
         resolve(srcRoot, 'types/cloudflare.ts'),
         resolve(srcRoot, 'site-resources.ts'),
+        resolve(srcRoot, 'platform-resources.ts'),
+        resolve(srcRoot, 'api.ts'),
+        resolve(srcRoot, 'railway.ts'),
+        resolve(srcRoot, 'platform.ts'),
+        resolve(srcRoot, 'plugin-default.ts'),
+        resolve(srcRoot, 'index.ts'),
+        ...walkFiles(resolve(srcRoot, 'api')).filter((filePath) => filePath.endsWith('.ts') && !filePath.endsWith('.d.js')),
     ].filter((filePath) => existsSync(filePath));
     if (sourceFiles.length === 0) {
         return;

package/dist/scripts/dev-platform.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { runTreeseedIntegratedDev } from '../dev.js';
+const args = process.argv.slice(2);
+function readFlag(name) {
+    return args.includes(name);
+}
+function readOption(name) {
+    const index = args.indexOf(name);
+    if (index < 0) {
+        return undefined;
+    }
+    return args[index + 1];
+}
+function parseSurface(value) {
+    if (value === 'web' || value === 'api' || value === 'integrated') {
+        return value;
+    }
+    return 'integrated';
+}
+const exitCode = await runTreeseedIntegratedDev({
+    surface: parseSurface(readOption('--surface')),
+    watch: readFlag('--watch'),
+});
+process.exit(exitCode);

package/dist/scripts/patch-starlight-content-path.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import process from 'node:process';
-import { packageRoot } from './paths.js';
+import { packageRoot } from './package-tools.js';
 const legacyDocsRoot = path.resolve(packageRoot, '../..');
 const candidateStarlightRoots = [
     path.join(process.cwd(), 'node_modules/@astrojs/starlight'),

package/dist/scripts/workspace-bootstrap.js

@@ -9,7 +9,6 @@ const requiredPackages = [
     { name: '@treeseed/sdk', dir: 'packages/sdk', build: true },
     { name: '@treeseed/core', dir: 'packages/core', build: true },
     { name: '@treeseed/agent', dir: 'packages/agent', build: true },
-    { name: '@treeseed/api', dir: 'packages/api', build: true },
     { name: '@treeseed/cli', dir: 'packages/cli', build: true, binName: 'treeseed' },
 ];
 function packageState(root, entry) {
@@ -96,9 +95,23 @@ function resolvePackageBinary(packageName, binName = packageName, root = process
     }
     return resolve(dirname(packageJsonPath), relativePath);
 }
+function resolveInstalledCoreScript(root, scriptRelativePath) {
+    const { root: coreRoot } = installedPackageRoot(root, '@treeseed/core');
+    const scriptPath = resolve(coreRoot, scriptRelativePath);
+    if (!existsSync(scriptPath)) {
+        throw new Error(`Unable to resolve installed @treeseed/core script "${scriptRelativePath}" from "${root}".`);
+    }
+    return scriptPath;
+}
 function runStarlightPatchFromRegistry(root) {
-    const treeseedBin = resolvePackageBinary('@treeseed/cli', 'treeseed', root);
-    run(process.execPath, [treeseedBin, 'starlight:patch'], { cwd: root });
+    const workspacePatchScript = resolve(root, 'packages', 'core', 'scripts', 'patch-starlight-content-path.ts');
+    const workspaceRunner = resolve(root, 'packages', 'core', 'scripts', 'run-ts.mjs');
+    if (existsSync(workspacePatchScript) && existsSync(workspaceRunner)) {
+        run(process.execPath, [workspaceRunner, workspacePatchScript], { cwd: root });
+        return;
+    }
+    const patchScript = resolveInstalledCoreScript(root, 'dist/scripts/patch-starlight-content-path.js');
+    run(process.execPath, [patchScript], { cwd: root });
 }
 function runStarlightPatchFromWorkspace(root, packages) {
     const corePackage = packages.find((entry) => entry.name === '@treeseed/core');

package/dist/site-resources.d.ts

@@ -1,29 +1 @@
-import type { TreeseedDeployConfig, TreeseedTenantConfig } from '@treeseed/sdk/platform/contracts';
-import type { LoadedTreeseedPluginEntry } from '@treeseed/sdk/platform/plugins';
-export declare const TREESEED_SITE_RESOURCE_KINDS: readonly ["pages", "styles", "components"];
-export type TreeseedSiteResourceKind = (typeof TREESEED_SITE_RESOURCE_KINDS)[number];
-export type TreeseedSiteLayerDefinition = {
-    root: string;
-    kinds?: TreeseedSiteResourceKind[];
-};
-export type TreeseedSiteLayer = {
-    owner: string;
-    root: string;
-    kinds: TreeseedSiteResourceKind[];
-};
-type SiteLayerBuildContext = {
-    projectRoot: string;
-    tenantConfig: TreeseedTenantConfig;
-    siteConfig?: unknown;
-    deployConfig?: TreeseedDeployConfig;
-};
-type SiteLayerRuntime = {
-    plugins: LoadedTreeseedPluginEntry[];
-};
-export declare function buildTreeseedSiteLayers(pluginRuntime: SiteLayerRuntime, context: SiteLayerBuildContext & {
-    coreRoot: string;
-}): TreeseedSiteLayer[];
-export declare function resolveTreeseedSiteResource(layers: TreeseedSiteLayer[], kind: TreeseedSiteResourceKind, resourcePath: string): string;
-export declare function resolveTreeseedPageEntrypoint(layers: TreeseedSiteLayer[], resourcePath: string): string;
-export declare function resolveTreeseedStyleEntrypoint(layers: TreeseedSiteLayer[], resourcePath: string): string;
-export {};
+export { buildTreeseedSiteLayers, resolveTreeseedPageEntrypoint, resolveTreeseedSiteResource, resolveTreeseedStyleEntrypoint, TREESEED_SITE_RESOURCE_KINDS, type TreeseedSiteLayer, type TreeseedSiteLayerDefinition, type TreeseedSiteResourceKind, } from './platform-resources';

package/dist/site-resources.js

@@ -1,123 +1,10 @@
-import { existsSync } from "node:fs";
-import { resolve } from "node:path";
-const TREESEED_SITE_RESOURCE_KINDS = ["pages", "styles", "components"];
-const SITE_RESOURCE_KIND_SET = new Set(TREESEED_SITE_RESOURCE_KINDS);
-function normalizeKinds(kinds) {
-  if (!kinds || kinds.length === 0) {
-    return [...TREESEED_SITE_RESOURCE_KINDS];
-  }
-  const normalized = [...new Set(kinds)];
-  for (const kind of normalized) {
-    if (!SITE_RESOURCE_KIND_SET.has(kind)) {
-      throw new Error(`Unknown Treeseed site resource kind "${kind}".`);
-    }
-  }
-  return normalized;
-}
-function normalizeResourcePath(kind, resourcePath) {
-  const normalized = resourcePath.replace(/\\/g, "/").replace(/^\/+/, "");
-  return normalized.startsWith(`${kind}/`) ? normalized : `${kind}/${normalized}`;
-}
-function isKindSupported(layer, kind) {
-  return layer.kinds.includes(kind);
-}
-function getTenantRoot(tenantConfig, projectRoot) {
-  return tenantConfig.__tenantRoot ?? projectRoot;
-}
-function normalizeLayerDefinition(owner, baseRoot, layer) {
-  const kinds = normalizeKinds(layer.kinds);
-  const root = resolve(baseRoot, layer.root);
-  return {
-    owner,
-    root,
-    kinds
-  };
-}
-function getPluginLayers(entry, context) {
-  const plugin = entry.plugin;
-  const rawLayers = typeof plugin.siteLayers === "function" ? plugin.siteLayers({ ...context, pluginConfig: entry.config ?? {} }) : plugin.siteLayers;
-  if (!rawLayers?.length) {
-    return [];
-  }
-  return rawLayers.map((layer) => normalizeLayerDefinition(entry.package, entry.baseDir, layer));
-}
-function getTenantLayers(context) {
-  const tenantRoot = getTenantRoot(context.tenantConfig, context.projectRoot);
-  const overrides = context.tenantConfig.overrides;
-  if (!overrides) {
-    return [];
-  }
-  const layers = [];
-  if (overrides.pagesRoot) {
-    layers.push({
-      owner: "tenant",
-      root: resolve(tenantRoot, overrides.pagesRoot),
-      kinds: ["pages"]
-    });
-  }
-  if (overrides.stylesRoot) {
-    layers.push({
-      owner: "tenant",
-      root: resolve(tenantRoot, overrides.stylesRoot),
-      kinds: ["styles"]
-    });
-  }
-  if (overrides.componentsRoot) {
-    layers.push({
-      owner: "tenant",
-      root: resolve(tenantRoot, overrides.componentsRoot),
-      kinds: ["components"]
-    });
-  }
-  return layers;
-}
-function buildTreeseedSiteLayers(pluginRuntime, context) {
-  const layers = [
-    {
-      owner: "@treeseed/core",
-      root: context.coreRoot,
-      kinds: [...TREESEED_SITE_RESOURCE_KINDS]
-    }
-  ];
-  for (const entry of pluginRuntime.plugins) {
-    layers.push(...getPluginLayers(entry, context));
-  }
-  layers.push(...getTenantLayers(context));
-  return layers;
-}
-function resolveTreeseedSiteResource(layers, kind, resourcePath) {
-  const normalizedPath = normalizeResourcePath(kind, resourcePath);
-  for (let index = layers.length - 1; index >= 0; index -= 1) {
-    const layer = layers[index];
-    if (!layer || !isKindSupported(layer, kind)) {
-      continue;
-    }
-    const candidate = resolve(layer.root, normalizedPath);
-    if (existsSync(candidate)) {
-      return candidate;
-    }
-  }
-  return null;
-}
-function resolveTreeseedPageEntrypoint(layers, resourcePath) {
-  const hasExplicitExtension = /\.[A-Za-z0-9]+$/u.test(resourcePath);
-  const candidates = hasExplicitExtension ? [resourcePath, `${resourcePath}.astro`, `${resourcePath}.ts`, `${resourcePath}.js`, `${resourcePath}.mjs`] : [resourcePath, `${resourcePath}.astro`, `${resourcePath}.ts`, `${resourcePath}.js`, `${resourcePath}.mjs`];
-  for (const candidate of candidates) {
-    const resolved = resolveTreeseedSiteResource(layers, "pages", candidate);
-    if (resolved) {
-      return resolved;
-    }
-  }
-  const normalized = hasExplicitExtension ? normalizeResourcePath("pages", resourcePath) : normalizeResourcePath("pages", `${resourcePath}.astro`);
-  throw new Error(`Unable to resolve Treeseed page resource "${normalized}".`);
-}
-function resolveTreeseedStyleEntrypoint(layers, resourcePath) {
-  const resolved = resolveTreeseedSiteResource(layers, "styles", resourcePath);
-  if (!resolved) {
-    throw new Error(`Unable to resolve Treeseed style resource "${normalizeResourcePath("styles", resourcePath)}".`);
-  }
-  return resolved;
-}
+import {
+  buildTreeseedSiteLayers,
+  resolveTreeseedPageEntrypoint,
+  resolveTreeseedSiteResource,
+  resolveTreeseedStyleEntrypoint,
+  TREESEED_SITE_RESOURCE_KINDS
+} from "./platform-resources.js";
 export {
   TREESEED_SITE_RESOURCE_KINDS,
   buildTreeseedSiteLayers,

package/dist/site.js

@@ -1,4 +1,5 @@
 import { defineConfig, envField } from "astro/config";
+import cloudflare from "@astrojs/cloudflare";
 import { existsSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -230,7 +231,8 @@ function createTreeseedSite(tenantConfig, { starlight }) {
   const injectedDeployConfig = JSON.stringify(deployConfig);
   const resolvedGlobalCss = resolveTreeseedStyleEntrypoint(siteLayers, "styles/global.css");
   return defineConfig({
-    output: "static",
+    adapter: deployConfig.surfaces?.web?.provider === "cloudflare" || deployConfig.providers.deploy === "cloudflare" ? cloudflare() : void 0,
+    output: deployConfig.surfaces?.web?.provider === "cloudflare" || deployConfig.providers.deploy === "cloudflare" ? "server" : "static",
     site: siteConfig.site.siteUrl,
     vite: {
       define: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@treeseed/core",
-  "version": "0.4.2",
-  "description": "Treeseed Research Hub package for Astro, Starlight, knowledge-factory content, and forms.",
+  "version": "0.4.5",
+  "description": "Treeseed integrated platform starter for Astro/Starlight web runtimes and Hono API runtimes.",
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",
@@ -36,6 +36,10 @@
     "setup:ci": "npm ci",
     "build:dist": "node ./scripts/run-ts.mjs ./scripts/build-dist.ts",
     "prepack": "npm run build:dist",
+    "dev": "node ./scripts/run-ts.mjs ./scripts/dev-platform.ts",
+    "dev:web": "node ./scripts/run-ts.mjs ./scripts/dev-platform.ts --surface web",
+    "dev:api": "node ./scripts/run-ts.mjs ./scripts/dev-platform.ts --surface api",
+    "dev:watch": "node ./scripts/run-ts.mjs ./scripts/dev-platform.ts --watch",
     "starlight:patch": "node ./scripts/run-ts.mjs ./scripts/patch-starlight-content-path.ts",
     "precheck": "npm run starlight:patch",
     "check": "node ./scripts/run-ts.mjs ./scripts/run-fixture-astro-command.ts check",
@@ -58,7 +62,7 @@
     "release:publish": "node ./scripts/run-ts.mjs ./scripts/publish-package.ts"
   },
   "dependencies": {
-    "@treeseed/sdk": "^0.4.2",
+    "@treeseed/sdk": "^0.4.4",
     "@astrojs/check": "^0.9.8",
     "@astrojs/cloudflare": "^12.6.13",
     "@astrojs/sitemap": "3.7.0",
@@ -66,6 +70,7 @@
     "@tailwindcss/vite": "^4.1.4",
     "astro": "^5.6.1",
     "esbuild": "^0.28.0",
+    "hono": "^4.8.2",
     "katex": "^0.16.22",
     "nodemailer": "^8.0.4",
     "rehype-katex": "^7.0.1",
@@ -98,6 +103,26 @@
       "types": "./dist/config.d.ts",
       "default": "./dist/config.js"
     },
+    "./api": {
+      "types": "./dist/api.d.ts",
+      "default": "./dist/api.js"
+    },
+    "./railway": {
+      "types": "./dist/railway.d.ts",
+      "default": "./dist/railway.js"
+    },
+    "./platform": {
+      "types": "./dist/platform.d.ts",
+      "default": "./dist/platform.js"
+    },
+    "./dev": {
+      "types": "./dist/dev.d.ts",
+      "default": "./dist/dev.js"
+    },
+    "./plugin-default": {
+      "types": "./dist/plugin-default.d.ts",
+      "default": "./dist/plugin-default.js"
+    },
     "./content": {
       "types": "./dist/content.d.ts",
       "default": "./dist/content.js"
@@ -107,7 +132,16 @@
       "default": "./dist/content-config.js"
     },
     "./tenant": "./dist/tenant/bridge.js",
+    "./scripts/dev-platform": "./dist/scripts/dev-platform.js",
     "./scripts/workspace-bootstrap": "./dist/scripts/workspace-bootstrap.js",
+    "./api/app": {
+      "types": "./dist/api/app.d.ts",
+      "default": "./dist/api/app.js"
+    },
+    "./api/gateway": {
+      "types": "./dist/api/gateway.d.ts",
+      "default": "./dist/api/gateway.js"
+    },
     "./site-resources": {
       "types": "./dist/site-resources.d.ts",
       "default": "./dist/site-resources.js"