@ossy/app 1.0.8 → 1.1.0

package/cli/build.js

@@ -11,12 +11,10 @@ import nodeExternals from 'rollup-plugin-node-externals'
 import copy from 'rollup-plugin-copy';
 import replace from '@rollup/plugin-replace';
 import arg from 'arg'
-import { ensureBuildStubs } from '../scripts/ensure-build-stubs.mjs'
-import { createRequire } from 'node:module'
 
-const PAGE_FILE_PATTERN = /\.page\.(jsx?|tsx?)$/
-const API_FILE_PATTERN = /\.api\.(mjs|cjs|js)$/
-const TASK_FILE_PATTERN = /\.task\.(mjs|cjs|js)$/
+export const PAGE_FILE_PATTERN = /\.page\.(jsx?|tsx?)$/
+export const API_FILE_PATTERN = /\.api\.(mjs|cjs|js)$/
+export const TASK_FILE_PATTERN = /\.task\.(mjs|cjs|js)$/
 const RESOURCE_TEMPLATE_FILE_PATTERN = /\.resource\.js$/
 
 /** Written next to `*.resource.js` under `src/resource-templates/` when that dir exists. */
@@ -57,6 +55,11 @@ export const OSSY_GEN_PAGES_BASENAME = 'pages.generated.jsx'
 export const OSSY_GEN_API_BASENAME = 'api.generated.js'
 export const OSSY_GEN_TASKS_BASENAME = 'tasks.generated.js'
 
+/** Bundled Node entries consumed by copied `build/server.js` / `build/worker.js`. */
+export const OSSY_PAGES_SERVER_BUNDLE = 'pages.bundle.js'
+export const OSSY_API_SERVER_BUNDLE = 'api.bundle.js'
+export const OSSY_TASKS_SERVER_BUNDLE = 'tasks.bundle.js'
+
 /** Per-page client entries: `hydrate-<pageId>.jsx` under `.ossy/` */
 const HYDRATE_STUB_PREFIX = 'hydrate-'
 const HYDRATE_STUB_SUFFIX = '.jsx'
@@ -144,65 +147,55 @@ export function writeResourceTemplatesBarrelIfPresent ({ cwd = process.cwd(), lo
 }
 
 /**
- * Shared Rollup plugins (virtual path replaces, resolve, JSX).
- * Server builds pass `nodeExternals: true` so `dependencies` stay importable from Node at runtime.
+ * Rollup plugins for Node-side bundles (pages / API / tasks): externals + Babel JSX.
  */
-export function createOssyRollupPlugins ({
-  pagesGeneratedPath,
-  apiSourcePath,
-  middlewareSourcePath,
-  configSourcePath,
-  nodeEnv,
-  preferBuiltins = true,
-  copyPublicFrom,
-  buildPath,
-}) {
-  const plugins = [
-    replace({
-      preventAssignment: true,
-      delimiters: ['%%', '%%'],
-      '@ossy/pages/source-file': pagesGeneratedPath,
-    }),
+export function createOssyAppBundlePlugins ({ nodeEnv }) {
+  return [
     replace({
       preventAssignment: true,
-      delimiters: ['%%', '%%'],
-      '@ossy/api/source-file': apiSourcePath,
+      'process.env.NODE_ENV': JSON.stringify(nodeEnv),
     }),
-    replace({
-      preventAssignment: true,
-      delimiters: ['%%', '%%'],
-      '@ossy/middleware/source-file': middlewareSourcePath,
+    json(),
+    nodeExternals({
+      deps: true,
+      devDeps: false,
+      peerDeps: true,
+      packagePath: path.join(process.cwd(), 'package.json'),
     }),
-    replace({
-      preventAssignment: true,
-      delimiters: ['%%', '%%'],
-      '@ossy/config/source-file': configSourcePath,
+    resolveCommonJsDependencies(),
+    resolveDependencies({ preferBuiltins: true }),
+    babel({
+      babelHelpers: 'bundled',
+      extensions: ['.jsx', '.tsx'],
+      presets: ['@babel/preset-react'],
     }),
+  ]
+}
+
+/**
+ * Rollup plugins for browser hydrate bundles.
+ */
+export function createOssyClientRollupPlugins ({ nodeEnv, copyPublicFrom, buildPath }) {
+  const plugins = [
     replace({
       preventAssignment: true,
       'process.env.NODE_ENV': JSON.stringify(nodeEnv),
     }),
     json(),
-  ]
-
-  plugins.push(
     nodeExternals({
       deps: true,
       devDeps: false,
       peerDeps: true,
       packagePath: path.join(process.cwd(), 'package.json'),
-    })
-  )
-
-  plugins.push(
+    }),
     resolveCommonJsDependencies(),
-    resolveDependencies({ preferBuiltins }),
+    resolveDependencies({ preferBuiltins: false }),
     babel({
       babelHelpers: 'bundled',
       extensions: ['.jsx', '.tsx'],
       presets: ['@babel/preset-react'],
-    })
-  )
+    }),
+  ]
   if (copyPublicFrom && fs.existsSync(copyPublicFrom)) {
     plugins.push(
       copy({
@@ -213,25 +206,43 @@ export function createOssyRollupPlugins ({
   return plugins
 }
 
-export function discoverApiFiles(srcDir) {
-  const dir = path.resolve(srcDir)
-  if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) {
-    return []
-  }
-  const files = []
-  const walk = (d) => {
-    const entries = fs.readdirSync(d, { withFileTypes: true })
-    for (const e of entries) {
-      const full = path.join(d, e.name)
-      if (e.isDirectory()) walk(full)
-      else if (API_FILE_PATTERN.test(e.name)) files.push(full)
-    }
+/** Bundles a single Node ESM file (inline dynamic imports) for SSR / API / tasks. */
+export async function bundleOssyNodeEntry ({ inputPath, outputFile, nodeEnv }) {
+  const bundle = await rollup({
+    input: inputPath,
+    plugins: createOssyAppBundlePlugins({ nodeEnv }),
+  })
+  await bundle.write({
+    file: outputFile,
+    format: 'esm',
+    inlineDynamicImports: true,
+  })
+  await bundle.close()
+}
+
+/**
+ * Copies framework runtime into `build/`: server, worker entry, middleware & config snapshots.
+ * `build/server.js` imports `./middleware.js`, `./config.js`, `./.ossy/*.bundle.js` next to it.
+ */
+export function copyOssyAppRuntime ({
+  scriptDir,
+  buildPath,
+  middlewareSourcePath,
+  configSourcePath,
+}) {
+  for (const name of ['server.js', 'proxy-internal.js']) {
+    fs.copyFileSync(path.join(scriptDir, name), path.join(buildPath, name))
   }
-  walk(dir)
-  return files.sort()
+  fs.copyFileSync(middlewareSourcePath, path.join(buildPath, 'middleware.js'))
+  fs.copyFileSync(configSourcePath, path.join(buildPath, 'config.js'))
+  fs.copyFileSync(path.join(scriptDir, 'worker-entry.js'), path.join(buildPath, 'worker.js'))
+  fs.copyFileSync(path.join(scriptDir, 'worker-runtime.js'), path.join(buildPath, 'worker-runtime.js'))
 }
 
-export function discoverTaskFiles(srcDir) {
+/**
+ * Recursively lists files under `srcDir` whose basename matches `filePattern` (e.g. `/\.api\.js$/`).
+ */
+export function discoverFilesByPattern (srcDir, filePattern) {
   const dir = path.resolve(srcDir)
   if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) {
     return []
@@ -242,7 +253,7 @@ export function discoverTaskFiles(srcDir) {
     for (const e of entries) {
       const full = path.join(d, e.name)
       if (e.isDirectory()) walk(full)
-      else if (TASK_FILE_PATTERN.test(e.name)) files.push(full)
+      else if (filePattern.test(e.name)) files.push(full)
     }
   }
   walk(dir)
@@ -294,7 +305,7 @@ export function generateApiModule ({ generatedPath, apiFiles }) {
 export function resolveApiSource ({ srcDir, buildPath }) {
   ensureOssyGeneratedDir(buildPath)
   const generatedPath = path.join(ossyGeneratedDir(buildPath), OSSY_GEN_API_BASENAME)
-  const apiFiles = discoverApiFiles(srcDir)
+  const apiFiles = discoverFilesByPattern(srcDir, API_FILE_PATTERN)
   fs.writeFileSync(
     generatedPath,
     generateApiModule({ generatedPath, apiFiles })
@@ -336,43 +347,20 @@ export function generateTaskModule ({ generatedPath, taskFiles }) {
 }
 
 /**
- * Resolves the Rollup entry for @ossy/tasks/source-file and which files to list in the worker build overview.
+ * Writes `build/.ossy/tasks.generated.js` and returns its path (stable Rollup input; empty when no task files).
  */
-export function resolveTaskSource ({ srcDir, scriptDir, buildPath }) {
-  const defaultStub = path.resolve(scriptDir, 'tasks.js')
+export function resolveTaskSource ({ srcDir, buildPath }) {
   ensureOssyGeneratedDir(buildPath)
   const generatedPath = path.join(ossyGeneratedDir(buildPath), OSSY_GEN_TASKS_BASENAME)
-
-  const taskFiles = discoverTaskFiles(srcDir)
-  if (taskFiles.length > 0) {
-    fs.writeFileSync(
+  const taskFiles = discoverFilesByPattern(srcDir, TASK_FILE_PATTERN)
+  fs.writeFileSync(
+    generatedPath,
+    generateTaskModule({
       generatedPath,
-      generateTaskModule({
-        generatedPath,
-        taskFiles,
-      })
-    )
-    return { taskSourcePath: generatedPath, taskOverviewFiles: taskFiles, usedGenerated: true }
-  }
-
-  return { taskSourcePath: defaultStub, taskOverviewFiles: [], usedGenerated: false }
-}
-
-export function discoverPageFiles(srcDir) {
-  if (!fs.existsSync(srcDir) || !fs.statSync(srcDir).isDirectory()) {
-    return []
-  }
-  const files = []
-  const walk = (d) => {
-    const entries = fs.readdirSync(d, { withFileTypes: true })
-    for (const e of entries) {
-      const full = path.join(d, e.name)
-      if (e.isDirectory()) walk(full)
-      else if (PAGE_FILE_PATTERN.test(e.name)) files.push(full)
-    }
-  }
-  walk(srcDir)
-  return files.sort()
+      taskFiles,
+    })
+  )
+  return { taskSourcePath: generatedPath, taskOverviewFiles: taskFiles }
 }
 
 export function filePathToRoute(filePath, srcDir) {
@@ -510,65 +498,6 @@ export function generatePagesModule (pageFiles, srcDir, generatedPath) {
   return lines.join('\n')
 }
 
-export async function discoverModulePageFiles({ configPath }) {
-  if (!configPath || !fs.existsSync(configPath)) return []
-  try {
-    // Try a cheap static parse first so we don't depend on the config file being
-    // importable (configs often import theme/template modules that may not be
-    // resolvable in the build-time node context).
-    const cfgSource = fs.readFileSync(configPath, 'utf8')
-    const modules = []
-
-    // pagesModules: ['a', "b"]
-    const arrMatch = cfgSource.match(/pagesModules\s*:\s*\[([^\]]*)\]/m)
-    if (arrMatch?.[1]) {
-      const body = arrMatch[1]
-      const re = /['"]([^'"]+)['"]/g
-      let m
-      while ((m = re.exec(body)) !== null) modules.push(m[1])
-    }
-
-    // pagesModule: 'a'
-    if (modules.length === 0) {
-      const singleMatch = cfgSource.match(/pagesModule\s*:\s*['"]([^'"]+)['"]/m)
-      if (singleMatch?.[1]) modules.push(singleMatch[1])
-    }
-
-    if (modules.length) {
-      const req = createRequire(path.resolve(process.cwd(), 'package.json'))
-      const files = []
-      for (const name of modules) {
-        const pkgJsonPath = req.resolve(`${name}/package.json`)
-        const pkgDir = path.dirname(pkgJsonPath)
-        const modulePagesDir = path.join(pkgDir, 'src', 'pages')
-        files.push(...discoverPageFiles(modulePagesDir))
-      }
-      return files
-    }
-
-    const mod = await import(url.pathToFileURL(configPath))
-    const cfg = mod?.default ?? mod ?? {}
-    const modules2 = Array.isArray(cfg.pagesModules)
-      ? cfg.pagesModules
-      : (typeof cfg.pagesModule === 'string' ? [cfg.pagesModule] : [])
-
-    if (!modules2.length) return []
-
-    const req = createRequire(path.resolve(process.cwd(), 'package.json'))
-    const files = []
-    for (const name of modules2) {
-      const pkgJsonPath = req.resolve(`${name}/package.json`)
-      const pkgDir = path.dirname(pkgJsonPath)
-      const modulePagesDir = path.join(pkgDir, 'src', 'pages')
-      files.push(...discoverPageFiles(modulePagesDir))
-    }
-    return files
-  } catch (e) {
-    console.warn('[@ossy/app][build] pagesModules config could not be loaded; continuing without modules')
-    return []
-  }
-}
-
 export function parsePagesFromSource(filePath) {
   try {
     const content = fs.readFileSync(filePath, 'utf8')
@@ -665,8 +594,7 @@ export const build = async (cliArgs) => {
     const buildPath = path.resolve('build')
     const srcDir = path.resolve('src')
     const configPath = path.resolve(options['--config'] || 'src/config.js');
-    const pageFiles = discoverPageFiles(srcDir)
-    const modulePageFiles = await discoverModulePageFiles({ configPath })
+    const pageFiles = discoverFilesByPattern(srcDir, PAGE_FILE_PATTERN)
 
     resetOssyBuildDir(buildPath)
 
@@ -674,14 +602,13 @@ export const build = async (cliArgs) => {
 
     const pagesGeneratedPath = path.join(ossyGeneratedDir(buildPath), OSSY_GEN_PAGES_BASENAME)
 
-    const allPageFiles = [...pageFiles, ...modulePageFiles]
     fs.writeFileSync(
       pagesGeneratedPath,
-      generatePagesModule(allPageFiles, srcDir, pagesGeneratedPath)
+      generatePagesModule(pageFiles, srcDir, pagesGeneratedPath)
     )
     const ossyDir = ossyGeneratedDir(buildPath)
-    writePageHydrateStubs(allPageFiles, srcDir, ossyDir)
-    const clientHydrateInput = buildClientHydrateInput(allPageFiles, srcDir, ossyDir)
+    writePageHydrateStubs(pageFiles, srcDir, ossyDir)
+    const clientHydrateInput = buildClientHydrateInput(pageFiles, srcDir, ossyDir)
 
     const {
       apiSourcePath: resolvedApi,
@@ -694,8 +621,6 @@ export const build = async (cliArgs) => {
     let middlewareSourcePath = path.resolve('src/middleware.js');
     const publicDir = path.resolve('public')
 
-    const inputServer = path.resolve(scriptDir, 'server.js')
-
     printBuildOverview({
       pagesSourcePath: pagesGeneratedPath,
       apiSourcePath,
@@ -712,40 +637,38 @@ export const build = async (cliArgs) => {
       ? configPath
       : path.resolve(scriptDir, 'default-config.js')
 
-    const sharedPluginOpts = {
-      pagesGeneratedPath,
-      apiSourcePath,
-      middlewareSourcePath,
-      configSourcePath,
-      nodeEnv: 'production',
-      buildPath,
-    }
+    const pagesBundlePath = path.join(ossyDir, OSSY_PAGES_SERVER_BUNDLE)
+    const apiBundlePath = path.join(ossyDir, OSSY_API_SERVER_BUNDLE)
+    const tasksBundlePath = path.join(ossyDir, OSSY_TASKS_SERVER_BUNDLE)
 
-    const serverPlugins = createOssyRollupPlugins({
-      ...sharedPluginOpts,
-      preferBuiltins: true,
-      copyPublicFrom: publicDir,
+    await bundleOssyNodeEntry({
+      inputPath: pagesGeneratedPath,
+      outputFile: pagesBundlePath,
+      nodeEnv: 'production',
     })
-
-    const serverBundle = await rollup({
-      input: { server: inputServer },
-      plugins: serverPlugins,
+    await bundleOssyNodeEntry({
+      inputPath: apiSourcePath,
+      outputFile: apiBundlePath,
+      nodeEnv: 'production',
     })
-    await serverBundle.write({
-      dir: buildPath,
-      format: 'esm',
-      preserveModules: true,
-      preserveModulesRoot: path.dirname(inputServer),
-      entryFileNames ({ name }) {
-        return name === 'server' ? 'server.js' : '[name].js'
-      },
-      assetFileNames: '[name][extname]',
+    const { taskSourcePath } = resolveTaskSource({ srcDir, buildPath })
+    await bundleOssyNodeEntry({
+      inputPath: taskSourcePath,
+      outputFile: tasksBundlePath,
+      nodeEnv: 'production',
     })
-    await serverBundle.close()
 
-    const clientPlugins = createOssyRollupPlugins({
-      ...sharedPluginOpts,
-      preferBuiltins: false,
+    copyOssyAppRuntime({
+      scriptDir,
+      buildPath,
+      middlewareSourcePath,
+      configSourcePath,
+    })
+
+    const clientPlugins = createOssyClientRollupPlugins({
+      nodeEnv: 'production',
+      copyPublicFrom: publicDir,
+      buildPath,
     })
 
     if (Object.keys(clientHydrateInput).length > 0) {
@@ -769,7 +692,5 @@ export const build = async (cliArgs) => {
       await clientBundle.close()
     }
 
-    ensureBuildStubs(buildPath)
-
     console.log('[@ossy/app][build] Finished');
 };

package/cli/dev.js

@@ -3,18 +3,26 @@ import url from 'url';
 import fs from 'fs';
 import {
   printBuildOverview,
-  discoverPageFiles,
+  discoverFilesByPattern,
+  PAGE_FILE_PATTERN,
   generatePagesModule,
-  discoverModulePageFiles,
   resolveApiSource,
+  resolveTaskSource,
   resetOssyBuildDir,
-  createOssyRollupPlugins,
+  bundleOssyNodeEntry,
+  copyOssyAppRuntime,
+  createOssyAppBundlePlugins,
+  createOssyClientRollupPlugins,
   writePageHydrateStubs,
   buildClientHydrateInput,
   clientHydrateIdForPage,
   ossyGeneratedDir,
   OSSY_GEN_PAGES_BASENAME,
   OSSY_GEN_API_BASENAME,
+  OSSY_GEN_TASKS_BASENAME,
+  OSSY_PAGES_SERVER_BUNDLE,
+  OSSY_API_SERVER_BUNDLE,
+  OSSY_TASKS_SERVER_BUNDLE,
   writeResourceTemplatesBarrelIfPresent,
   resourceTemplatesDir,
   OSSY_RESOURCE_TEMPLATES_OUT,
@@ -37,23 +45,20 @@ export const dev = async (cliArgs) => {
     const buildPath = path.resolve('build')
     const srcDir = path.resolve('src')
     const configPath = path.resolve(options['--config'] || 'src/config.js');
-    const pageFiles = discoverPageFiles(srcDir)
-    const modulePageFiles = await discoverModulePageFiles({ configPath })
+    const pageFiles = discoverFilesByPattern(srcDir, PAGE_FILE_PATTERN)
 
     resetOssyBuildDir(buildPath)
 
     writeResourceTemplatesBarrelIfPresent({ cwd: process.cwd(), log: true })
 
-    const allPageFiles = [...pageFiles, ...modulePageFiles]
     const pagesGeneratedPath = path.join(ossyGeneratedDir(buildPath), OSSY_GEN_PAGES_BASENAME)
     fs.writeFileSync(
       pagesGeneratedPath,
-      generatePagesModule(allPageFiles, srcDir, pagesGeneratedPath)
+      generatePagesModule(pageFiles, srcDir, pagesGeneratedPath)
     )
-    const effectivePagesSource = pagesGeneratedPath
     const ossyDir = ossyGeneratedDir(buildPath)
-    writePageHydrateStubs(allPageFiles, srcDir, ossyDir)
-    const clientHydrateInput = buildClientHydrateInput(allPageFiles, srcDir, ossyDir)
+    writePageHydrateStubs(pageFiles, srcDir, ossyDir)
+    const clientHydrateInput = buildClientHydrateInput(pageFiles, srcDir, ossyDir)
 
     const {
       apiSourcePath: resolvedApi,
@@ -63,13 +68,12 @@ export const dev = async (cliArgs) => {
       buildPath,
     })
     let apiSourcePath = resolvedApi
+    resolveTaskSource({ srcDir, buildPath })
     let middlewareSourcePath = path.resolve(options['--middleware-source'] || 'src/middleware.js');
     const publicDir = path.resolve('public')
 
-    const inputServer = path.resolve(scriptDir, 'server.js')
-
     printBuildOverview({
-      pagesSourcePath: effectivePagesSource,
+      pagesSourcePath: pagesGeneratedPath,
       apiSourcePath,
       apiOverviewFiles,
       configPath,
@@ -84,37 +88,43 @@ export const dev = async (cliArgs) => {
       ? configPath
       : path.resolve(scriptDir, 'default-config.js')
 
-    const sharedPluginOpts = {
-      pagesGeneratedPath: effectivePagesSource,
-      apiSourcePath,
-      middlewareSourcePath,
-      configSourcePath,
-      nodeEnv: 'development',
-      buildPath,
+    const pagesBundlePath = path.join(ossyDir, OSSY_PAGES_SERVER_BUNDLE)
+    const apiBundlePath = path.join(ossyDir, OSSY_API_SERVER_BUNDLE)
+    const tasksBundlePath = path.join(ossyDir, OSSY_TASKS_SERVER_BUNDLE)
+    const tasksGeneratedPath = path.join(ossyDir, OSSY_GEN_TASKS_BASENAME)
+
+    const runNodeBundles = async () => {
+      await bundleOssyNodeEntry({
+        inputPath: pagesGeneratedPath,
+        outputFile: pagesBundlePath,
+        nodeEnv: 'development',
+      })
+      await bundleOssyNodeEntry({
+        inputPath: apiSourcePath,
+        outputFile: apiBundlePath,
+        nodeEnv: 'development',
+      })
+      await bundleOssyNodeEntry({
+        inputPath: tasksGeneratedPath,
+        outputFile: tasksBundlePath,
+        nodeEnv: 'development',
+      })
+      copyOssyAppRuntime({
+        scriptDir,
+        buildPath,
+        middlewareSourcePath,
+        configSourcePath,
+      })
     }
 
-    const serverPlugins = createOssyRollupPlugins({
-      ...sharedPluginOpts,
-      preferBuiltins: true,
-      copyPublicFrom: publicDir,
-    })
+    await runNodeBundles()
 
-    const clientPlugins = createOssyRollupPlugins({
-      ...sharedPluginOpts,
-      preferBuiltins: false,
+    const clientPlugins = createOssyClientRollupPlugins({
+      nodeEnv: 'development',
+      copyPublicFrom: publicDir,
+      buildPath,
     })
 
-    const serverOutput = {
-      dir: buildPath,
-      format: 'esm',
-      preserveModules: true,
-      preserveModulesRoot: path.dirname(inputServer),
-      entryFileNames ({ name }) {
-        return name === 'server' ? 'server.js' : '[name].js'
-      },
-      assetFileNames: '[name][extname]',
-    }
-
     const clientOutput = {
       dir: buildPath,
       format: 'esm',
@@ -169,12 +179,37 @@ export const dev = async (cliArgs) => {
       }
     }
 
+    const nodeWatchOpts = { watch: { clearScreen: false } }
     const watchConfigs = [
       {
-        input: { server: inputServer },
-        output: serverOutput,
-        plugins: serverPlugins,
-        watch: { clearScreen: false },
+        input: pagesGeneratedPath,
+        output: {
+          file: pagesBundlePath,
+          format: 'esm',
+          inlineDynamicImports: true,
+        },
+        plugins: createOssyAppBundlePlugins({ nodeEnv: 'development' }),
+        ...nodeWatchOpts,
+      },
+      {
+        input: apiSourcePath,
+        output: {
+          file: apiBundlePath,
+          format: 'esm',
+          inlineDynamicImports: true,
+        },
+        plugins: createOssyAppBundlePlugins({ nodeEnv: 'development' }),
+        ...nodeWatchOpts,
+      },
+      {
+        input: tasksGeneratedPath,
+        output: {
+          file: tasksBundlePath,
+          format: 'esm',
+          inlineDynamicImports: true,
+        },
+        plugins: createOssyAppBundlePlugins({ nodeEnv: 'development' }),
+        ...nodeWatchOpts,
       },
     ]
     if (Object.keys(clientHydrateInput).length > 0) {
@@ -198,11 +233,17 @@ export const dev = async (cliArgs) => {
         console.log(`[@ossy/app][dev] Built in ${event.duration}ms`)
       }
       if (event.code === 'END') {
+        copyOssyAppRuntime({
+          scriptDir,
+          buildPath,
+          middlewareSourcePath,
+          configSourcePath,
+        })
         scheduleRestart()
       }
     })
 
-    const regenApiBundle = () => {
+    const regenApiGenerated = () => {
       if (options['--api-source']) return
       resolveApiSource({
         srcDir,
@@ -214,23 +255,33 @@ export const dev = async (cliArgs) => {
       }
     }
 
+    const regenTasksGenerated = () => {
+      resolveTaskSource({ srcDir, buildPath })
+      if (fs.existsSync(tasksGeneratedPath) && typeof watcher?.invalidate === 'function') {
+        watcher.invalidate(tasksGeneratedPath)
+      }
+    }
+
     fs.watch(srcDir, { recursive: true }, (eventType, filename) => {
       if (!filename) return
       if (/\.page\.(jsx?|tsx?)$/.test(filename)) {
-        const combined = [...discoverPageFiles(srcDir), ...modulePageFiles]
+        const refreshedPageFiles = discoverFilesByPattern(srcDir, PAGE_FILE_PATTERN)
         const regenPath = path.join(ossyGeneratedDir(buildPath), OSSY_GEN_PAGES_BASENAME)
-        fs.writeFileSync(regenPath, generatePagesModule(combined, srcDir, regenPath))
-        writePageHydrateStubs(combined, srcDir, ossyDir)
+        fs.writeFileSync(regenPath, generatePagesModule(refreshedPageFiles, srcDir, regenPath))
+        writePageHydrateStubs(refreshedPageFiles, srcDir, ossyDir)
         if (typeof watcher?.invalidate === 'function') {
           watcher.invalidate(regenPath)
-          for (const f of combined) {
+          for (const f of refreshedPageFiles) {
             const hid = clientHydrateIdForPage(f, srcDir)
             watcher.invalidate(path.join(ossyDir, `hydrate-${hid}.jsx`))
           }
         }
       }
       if (/\.api\.(mjs|cjs|js)$/.test(filename)) {
-        regenApiBundle()
+        regenApiGenerated()
+      }
+      if (/\.task\.(mjs|cjs|js)$/.test(filename)) {
+        regenTasksGenerated()
       }
       const norm = filename.replace(/\\/g, '/')
       if (/\.resource\.js$/.test(norm) && norm.includes('resource-templates/')) {

package/cli/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { build } from './build.js'
+import { dev } from './dev.js'
+
+const [,, command, ...restArgs] = process.argv
+
+if (!command) {
+  console.error(
+    '[@ossy/app] No command provided. Usage: app dev | build'
+  )
+  process.exit(1)
+}
+
+const run = async () => {
+  if (command === 'dev') {
+    await dev(restArgs)
+    return
+  }
+  if (command === 'build') {
+    await build(restArgs)
+    return
+  }
+  console.error(`[@ossy/app] Unknown command: ${command}`)
+  process.exit(1)
+}
+
+run().catch((err) => {
+  console.error(err)
+  process.exit(1)
+})

package/cli/server.js

@@ -8,14 +8,14 @@ import { prerenderToNodeStream } from 'react-dom/static'
 import { ProxyInternal } from './proxy-internal.js'
 import cookieParser from 'cookie-parser'
 
-import pages from '%%@ossy/pages/source-file%%'
-import ApiRoutes from '%%@ossy/api/source-file%%'
-import Middleware from '%%@ossy/middleware/source-file%%'
-import configModule from '%%@ossy/config/source-file%%'
+import pages from './.ossy/pages.bundle.js'
+import ApiRoutes from './.ossy/api.bundle.js'
+import Middleware from './middleware.js'
+import configModule from './config.js'
 
 const buildTimeConfig = configModule?.default ?? configModule ?? {}
 
-/** `api.generated.js` is always present; default may still be empty. */
+/** API bundle default may be an empty array. */
 const apiRouteList = ApiRoutes ?? []
 const pageList = pages ?? []
 

package/cli/worker-entry.js

@@ -1,5 +1,5 @@
 import 'dotenv/config'
-import taskHandlers from '%%@ossy/tasks/source-file%%'
+import taskHandlers from './.ossy/tasks.bundle.js'
 import { runWorkerScheduler } from './worker-runtime.js'
 
 runWorkerScheduler(taskHandlers)

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@ossy/app",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "description": "",
   "source": "./src/index.js",
   "main": "./src/index.js",
   "type": "module",
+  "bin": {
+    "app": "./cli/index.js"
+  },
   "scripts": {
     "build": "echo Building not required",
     "test": "node --experimental-vm-modules ../node_modules/jest/bin/jest.js --verbose",
@@ -24,14 +27,14 @@
     "@babel/eslint-parser": "^7.15.8",
     "@babel/preset-react": "^7.26.3",
     "@babel/register": "^7.25.9",
-    "@ossy/connected-components": "^1.0.8",
-    "@ossy/design-system": "^1.0.8",
-    "@ossy/pages": "^1.0.8",
-    "@ossy/router": "^1.0.8",
-    "@ossy/router-react": "^1.0.8",
-    "@ossy/sdk": "^1.0.8",
-    "@ossy/sdk-react": "^1.0.8",
-    "@ossy/themes": "^1.0.8",
+    "@ossy/connected-components": "^1.1.0",
+    "@ossy/design-system": "^1.1.0",
+    "@ossy/pages": "^1.1.0",
+    "@ossy/router": "^1.1.0",
+    "@ossy/router-react": "^1.1.0",
+    "@ossy/sdk": "^1.1.0",
+    "@ossy/sdk-react": "^1.1.0",
+    "@ossy/themes": "^1.1.0",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-babel": "6.1.0",
     "@rollup/plugin-commonjs": "^29.0.0",
@@ -64,5 +67,5 @@
     "README.md",
     "tsconfig.json"
   ],
-  "gitHead": "1a757e16ac932fbf234e8257e2393be1e2a80c60"
+  "gitHead": "5977a77f97776131077a848081098ab6ec4cf837"
 }