one 1.15.10 → 1.16.0

package/src/vite/plugins/criticalCSSPlugin.test.ts

@@ -1,5 +1,8 @@
+import { resolve } from 'node:path'
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 
+const PROJECT_ROOT = resolve('/project')
+
 describe('criticalCSSPlugin', () => {
   beforeEach(() => {
     vi.resetModules()
@@ -14,12 +17,12 @@ describe('criticalCSSPlugin', () => {
       const { criticalCSSPlugin } = await import('./criticalCSSPlugin')
       const plugin = criticalCSSPlugin()
 
-      ;(plugin.configResolved as any)({ root: '/project' })
+      ;(plugin.configResolved as any)({ root: PROJECT_ROOT })
 
       const result = await (plugin.resolveId as any).call(
         { resolve: vi.fn() },
         './styles.css',
-        '/project/src/App.tsx'
+        resolve('/project/src/App.tsx')
       )
       expect(result).toBeNull()
     })
@@ -28,12 +31,12 @@ describe('criticalCSSPlugin', () => {
       const { criticalCSSPlugin } = await import('./criticalCSSPlugin')
       const plugin = criticalCSSPlugin()
 
-      ;(plugin.configResolved as any)({ root: '/project' })
+      ;(plugin.configResolved as any)({ root: PROJECT_ROOT })
 
       const result = await (plugin.resolveId as any).call(
         { resolve: vi.fn() },
         './data.json',
-        '/project/src/App.tsx'
+        resolve('/project/src/App.tsx')
       )
       expect(result).toBeNull()
     })
@@ -42,25 +45,25 @@ describe('criticalCSSPlugin', () => {
       const { criticalCSSPlugin } = await import('./criticalCSSPlugin')
       const plugin = criticalCSSPlugin()
 
-      ;(plugin.configResolved as any)({ root: '/project' })
+      ;(plugin.configResolved as any)({ root: PROJECT_ROOT })
 
+      const resolvedCssPath = resolve('/project/src/styles.inline.css')
       const mockResolve = vi.fn().mockResolvedValue({
-        id: '/project/src/styles.inline.css',
+        id: resolvedCssPath,
       })
 
+      const importerPath = resolve('/project/src/App.tsx')
       const result = await (plugin.resolveId as any).call(
         { resolve: mockResolve },
         './styles.inline.css',
-        '/project/src/App.tsx'
+        importerPath
       )
 
-      expect(mockResolve).toHaveBeenCalledWith(
-        './styles.inline.css',
-        '/project/src/App.tsx',
-        { skipSelf: true }
-      )
+      expect(mockResolve).toHaveBeenCalledWith('./styles.inline.css', importerPath, {
+        skipSelf: true,
+      })
 
-      expect(result).toEqual({ id: '/project/src/styles.inline.css' })
+      expect(result).toEqual({ id: resolvedCssPath })
     })
 
     it('should track inline CSS source paths', async () => {
@@ -68,34 +71,37 @@ describe('criticalCSSPlugin', () => {
         await import('./criticalCSSPlugin')
       const plugin = criticalCSSPlugin()
 
-      ;(plugin.configResolved as any)({ root: '/project' })
+      ;(plugin.configResolved as any)({ root: PROJECT_ROOT })
 
       const mockResolve = vi.fn().mockResolvedValue({
-        id: '/project/src/layout.inline.css',
+        id: resolve('/project/src/layout.inline.css'),
       })
 
       await (plugin.resolveId as any).call(
         { resolve: mockResolve },
         './layout.inline.css',
-        '/project/src/App.tsx'
+        resolve('/project/src/App.tsx')
       )
 
       const sources = getCriticalCSSSources()
-      expect(sources.has('src/layout.inline.css')).toBe(true)
+      // relative() produces forward slashes on POSIX, backslashes on Windows
+      expect(
+        sources.has('src/layout.inline.css') || sources.has('src\\layout.inline.css')
+      ).toBe(true)
     })
 
     it('should return null when resolve fails', async () => {
       const { criticalCSSPlugin } = await import('./criticalCSSPlugin')
       const plugin = criticalCSSPlugin()
 
-      ;(plugin.configResolved as any)({ root: '/project' })
+      ;(plugin.configResolved as any)({ root: PROJECT_ROOT })
 
       const mockResolve = vi.fn().mockResolvedValue(null)
 
       const result = await (plugin.resolveId as any).call(
         { resolve: mockResolve },
         './nonexistent.inline.css',
-        '/project/src/App.tsx'
+        resolve('/project/src/App.tsx')
       )
 
       expect(result).toBeNull()
@@ -108,21 +114,25 @@ describe('criticalCSSPlugin', () => {
         await import('./criticalCSSPlugin')
       const plugin = criticalCSSPlugin()
 
-      ;(plugin.configResolved as any)({ root: '/project' })
+      ;(plugin.configResolved as any)({ root: PROJECT_ROOT })
 
       const mockResolve = vi.fn().mockResolvedValue({
-        id: '/project/app/layout.inline.css',
+        id: resolve('/project/app/layout.inline.css'),
       })
       await (plugin.resolveId as any).call(
         { resolve: mockResolve },
         './layout.inline.css',
-        '/project/app/_layout.tsx'
+        resolve('/project/app/_layout.tsx')
       )
 
+      // Build a manifest keyed by the relative path that criticalCSSSources actually stores
+      const sources = getCriticalCSSSources()
+      const sourceKey = [...sources].find((s) => s.includes('layout.inline.css'))!
+
       const manifest = {
-        'app/layout.inline.css': {
+        [sourceKey]: {
           file: 'assets/layout-abc123.css',
-          src: 'app/layout.inline.css',
+          src: sourceKey,
         },
         'app/_layout.tsx': {
           file: 'assets/layout-def456.js',

package/src/vite/plugins/criticalCSSPlugin.ts

@@ -1,4 +1,5 @@
 import { relative } from 'node:path'
+import { normalizePath } from 'vite'
 import type { Plugin } from 'vite'
 
 /**
@@ -62,8 +63,8 @@ export function criticalCSSPlugin(): Plugin {
       const resolved = await this.resolve(id, importer, { skipSelf: true })
 
       if (resolved) {
-        // store as relative path to match manifest keys
-        const relativePath = relative(root, resolved.id)
+        // store as relative path to match manifest keys (forward slashes to match Vite)
+        const relativePath = normalizePath(relative(root, resolved.id))
         criticalCSSSources.add(relativePath)
         return resolved
       }

package/src/vite/plugins/imageDataPlugin.test.ts

@@ -1,5 +1,12 @@
+import { resolve } from 'node:path'
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 
+// Platform-correct test paths — resolve() normalizes to native separators
+const PROJECT_ROOT = resolve('/project')
+const PUBLIC_DIR = resolve('/project/public')
+const COMPONENTS_DIR = resolve('/project/src/components')
+const HERO_FILE = resolve('/project/src/components/Hero.tsx')
+
 // Mock fs before importing the plugin
 vi.mock('node:fs', async () => {
   const actual = await vi.importActual('node:fs')
@@ -11,6 +18,13 @@ vi.mock('node:fs', async () => {
   }
 })
 
+function mockConfig() {
+  return {
+    publicDir: PUBLIC_DIR,
+    root: PROJECT_ROOT,
+  }
+}
+
 describe('imageDataPlugin', () => {
   beforeEach(() => {
     vi.resetModules()
@@ -25,13 +39,8 @@ describe('imageDataPlugin', () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       const result = await (plugin.resolveId as any)('./image.jpg', undefined)
@@ -42,13 +51,8 @@ describe('imageDataPlugin', () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       // ?imagedata in the middle should not match
@@ -60,53 +64,38 @@ describe('imageDataPlugin', () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       const result = await (plugin.resolveId as any)(
         '/test-image.jpg?imagedata',
         undefined
       )
-      expect(result).toBe('\0imagedata:/project/public/test-image.jpg')
+      expect(result).toBe('\0imagedata:' + resolve(PUBLIC_DIR, 'test-image.jpg'))
     })
 
     it('should resolve relative imports', async () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       const result = await (plugin.resolveId as any)(
         './test-image.jpg?imagedata',
-        '/project/src/components/Hero.tsx'
+        HERO_FILE
       )
-      expect(result).toBe('\0imagedata:/project/src/components/test-image.jpg')
+      expect(result).toBe('\0imagedata:' + resolve(COMPONENTS_DIR, 'test-image.jpg'))
     })
 
     it('should return null for non-existent files', async () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       const result = await (plugin.resolveId as any)(
@@ -122,13 +111,8 @@ describe('imageDataPlugin', () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       const result = await (plugin.resolveId as any)(
@@ -142,18 +126,13 @@ describe('imageDataPlugin', () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       const result = await (plugin.resolveId as any)(
         '../../../../etc/passwd?imagedata',
-        '/project/src/components/Hero.tsx'
+        HERO_FILE
       )
       expect(result).toBeNull()
     })
@@ -162,13 +141,8 @@ describe('imageDataPlugin', () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       const result = await (plugin.resolveId as any)(
@@ -182,22 +156,17 @@ describe('imageDataPlugin', () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       // Going up and back down should still work if within bounds
       // From /project/src/components, ../.. goes to /project, then src/test-image.jpg
       const result = await (plugin.resolveId as any)(
         '../../src/test-image.jpg?imagedata',
-        '/project/src/components/Hero.tsx'
+        HERO_FILE
       )
-      expect(result).toBe('\0imagedata:/project/src/test-image.jpg')
+      expect(result).toBe('\0imagedata:' + resolve(PROJECT_ROOT, 'src/test-image.jpg'))
     })
   })
 
@@ -206,13 +175,8 @@ describe('imageDataPlugin', () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       const mockContext = {
@@ -227,33 +191,28 @@ describe('imageDataPlugin', () => {
       const { imageDataPlugin } = await import('./imageDataPlugin')
       const plugin = imageDataPlugin()
 
-      const mockConfig = {
-        publicDir: '/project/public',
-        root: '/project',
-      }
-
       if (plugin.configResolved) {
-        ;(plugin.configResolved as any)(mockConfig)
+        ;(plugin.configResolved as any)(mockConfig())
       }
 
       const mockContext = {
         addWatchFile: vi.fn(),
       }
 
+      const testFilePath = resolve(PUBLIC_DIR, 'test-image.jpg')
+
       // This will fail because the file doesn't actually exist
       // But it should gracefully fallback
       const result = await (plugin.load as any).call(
         mockContext,
-        '\0imagedata:/project/public/test-image.jpg'
+        '\0imagedata:' + testFilePath
       )
 
       expect(result).toContain('export default')
       expect(result).toContain('"src":"/test-image.jpg"')
       expect(result).toContain('"width":')
       expect(result).toContain('"height":')
-      expect(mockContext.addWatchFile).toHaveBeenCalledWith(
-        '/project/public/test-image.jpg'
-      )
+      expect(mockContext.addWatchFile).toHaveBeenCalledWith(testFilePath)
     })
   })
 
@@ -279,22 +238,19 @@ describe('imageDataPlugin output format', () => {
     const { imageDataPlugin } = await import('./imageDataPlugin')
     const plugin = imageDataPlugin()
 
-    const mockConfig = {
-      publicDir: '/project/public',
-      root: '/project',
-    }
-
     if (plugin.configResolved) {
-      ;(plugin.configResolved as any)(mockConfig)
+      ;(plugin.configResolved as any)(mockConfig())
     }
 
     const mockContext = {
       addWatchFile: vi.fn(),
     }
 
+    const testFilePath = resolve(PUBLIC_DIR, 'test-image.jpg')
+
     const result = await (plugin.load as any).call(
       mockContext,
-      '\0imagedata:/project/public/test-image.jpg'
+      '\0imagedata:' + testFilePath
     )
 
     // Extract JSON from the export

package/src/vite/plugins/imageDataPlugin.ts

@@ -1,6 +1,7 @@
 import { existsSync } from 'node:fs'
-import { dirname, relative, resolve } from 'node:path'
+import { dirname, relative, resolve, sep } from 'node:path'
 import type { Plugin, ResolvedConfig } from 'vite'
+import { normalizePath } from 'vite'
 import { processImageMeta } from '../../image/getImageData'
 
 const IMAGEDATA_SUFFIX = '?imagedata'
@@ -12,14 +13,14 @@ export function imageDataPlugin(): Plugin {
 
   function getSrcPath(filePath: string): string {
     return filePath.startsWith(publicDir)
-      ? '/' + relative(publicDir, filePath)
-      : '/' + relative(root, filePath)
+      ? '/' + normalizePath(relative(publicDir, filePath))
+      : '/' + normalizePath(relative(root, filePath))
   }
 
   function isPathWithinBounds(filePath: string, allowedDir: string): boolean {
     const resolved = resolve(filePath)
     const allowed = resolve(allowedDir)
-    return resolved.startsWith(allowed + '/') || resolved === allowed
+    return resolved.startsWith(allowed + sep) || resolved === allowed
   }
 
   function createImageDataExport(src: string, width = 0, height = 0, blurDataURL = '') {

package/src/vite/plugins/sourceInspectorPlugin.test.ts

@@ -0,0 +1,40 @@
+import { describe, expect, it } from 'vitest'
+
+import { getSourceInspectorPath, resolveEditorFilePath } from './sourceInspectorPlugin'
+
+describe('sourceInspectorPlugin helpers', () => {
+  describe('getSourceInspectorPath', () => {
+    it('keeps project files relative to the current cwd', () => {
+      expect(getSourceInspectorPath('/repo/packages/one/src/App.tsx', '/repo')).toBe(
+        '/packages/one/src/App.tsx'
+      )
+    })
+
+    it('does not strip matching path prefixes from files outside cwd', () => {
+      expect(
+        getSourceInspectorPath('/repo-other/packages/one/src/App.tsx', '/repo')
+      ).toBe('/repo-other/packages/one/src/App.tsx')
+    })
+  })
+
+  describe('resolveEditorFilePath', () => {
+    it('resolves project-relative source paths against cwd', () => {
+      const fileExists = (filePath: string) =>
+        filePath === '/repo/packages/one/src/App.tsx'
+
+      expect(
+        resolveEditorFilePath('/packages/one/src/App.tsx', '/repo', fileExists)
+      ).toBe('/repo/packages/one/src/App.tsx')
+    })
+
+    it('preserves absolute source paths for files outside cwd', () => {
+      expect(
+        resolveEditorFilePath(
+          '/Users/n8/shared/ui/Button.tsx',
+          '/repo/apps/site',
+          () => false
+        )
+      ).toBe('/Users/n8/shared/ui/Button.tsx')
+    })
+  })
+})

package/src/vite/plugins/sourceInspectorPlugin.ts

@@ -1,4 +1,5 @@
 import { spawn } from 'node:child_process'
+import { existsSync } from 'node:fs'
 import path from 'node:path'
 import { parse } from 'oxc-parser'
 import type { Plugin, ViteDevServer } from 'vite'
@@ -91,6 +92,33 @@ async function findJsxElements(code: string, filename: string): Promise<JsxLocat
 
 type TransformOut = { code: string; map?: null } | undefined
 
+export function getSourceInspectorPath(filePath: string, cwd = process.cwd()): string {
+  const normalizedFilePath = normalizePath(filePath)
+  const normalizedCwd = normalizePath(cwd)
+
+  if (normalizedFilePath === normalizedCwd) {
+    return '/'
+  }
+
+  if (normalizedFilePath.startsWith(`${normalizedCwd}/`)) {
+    return normalizedFilePath.slice(normalizedCwd.length)
+  }
+
+  return normalizedFilePath
+}
+
+export function resolveEditorFilePath(
+  filePath: string,
+  cwd = process.cwd(),
+  fileExists: (path: string) => boolean = existsSync
+): string {
+  const projectPath = path.join(cwd, filePath)
+
+  // data-one-source uses "/foo.tsx" for project-relative paths, but files outside
+  // cwd are stored as absolute paths and must not be re-joined onto cwd.
+  return fileExists(projectPath) ? projectPath : filePath
+}
+
 /**
  * Transforms JSX to inject data-one-source attributes using oxc-parser.
  */
@@ -98,7 +126,7 @@ async function injectSourceToJsx(code: string, id: string): Promise<TransformOut
   const [filePath] = id.split('?')
   if (!filePath) return
 
-  const location = filePath.replace(normalizePath(process.cwd()), '')
+  const location = getSourceInspectorPath(filePath)
 
   // Quick check - skip if no JSX-like content
   if (!code.includes('<') || !code.includes('>')) {
@@ -159,7 +187,7 @@ function openInEditor(
     return
   }
 
-  const fullPath = path.join(process.cwd(), filePath)
+  const fullPath = resolveEditorFilePath(filePath)
   const l = line || '1'
   const c = column || '1'
   const buildArgs = editorArgs[resolved]

package/src/vite/resolveResponse.ts

@@ -65,7 +65,9 @@ export function resolveAPIEndpoint(
   // this is the result of importing the file:
   runEndpoint: () => Promise<any>,
   request: Request,
-  params: Record<string, string>
+  params: Record<string, string>,
+  env?: unknown,
+  executionCtx?: unknown
 ) {
   return resolveResponse(async () => {
     const imported = await runEndpoint()
@@ -75,7 +77,9 @@ export function resolveAPIEndpoint(
       console.warn(`No handler found for request ${requestType}`)
       return
     }
-    return await handler(request, { params })
+    const worker =
+      env !== undefined || executionCtx !== undefined ? { env, executionCtx } : undefined
+    return await handler(request, { params, worker })
   })
 }
 

package/types/cli/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAqSA,wBAAsB,KAAK,CAAC,IAAI,EAAE;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAA;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,iBA2qCA"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AA2SA,wBAAsB,KAAK,CAAC,IAAI,EAAE;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAA;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,iBA8tCA"}

package/types/constants.d.ts

@@ -2,6 +2,15 @@ import type { One } from './vite/types';
 export declare const isWebClient: boolean;
 export declare const isWebServer: boolean;
 export declare const isNative: boolean;
+/**
+ * True only in a browser main-thread context with a navigable history —
+ * i.e. `window` AND `window.history` are available. Excludes native,
+ * SSR, web workers / service workers (no `window`), and exotic sandboxed
+ * environments where `window` exists but history is stripped. Use this
+ * for guarding any `window.history` / `window.location` access so
+ * intercept routes, URL masking, etc. don't assume a full browser.
+ */
+export declare const hasWebHistory: boolean;
 export declare const CACHE_KEY: string;
 export declare const LOADER_JS_POSTFIX_UNCACHED = "_vxrn_loader.js";
 export declare const LOADER_JS_POSTFIX_REGEX_STRING = "_\\d+_vxrn_loader.js$";

package/types/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEvC,eAAO,MAAM,WAAW,SACkD,CAAA;AAC1E,eAAO,MAAM,WAAW,SACkD,CAAA;AAC1E,eAAO,MAAM,QAAQ,SAA0C,CAAA;AAE/D,eAAO,MAAM,SAAS,QAA4E,CAAA;AAElG,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAC3D,eAAO,MAAM,8BAA8B,0BAAwC,CAAA;AACnF,eAAO,MAAM,uBAAuB,QAA6C,CAAA;AACjF,eAAO,MAAM,iBAAiB,QAA+C,CAAA;AAE7E,eAAO,MAAM,kBAAkB,QAA6B,CAAA;AAC5D,eAAO,MAAM,sBAAsB,QAAiC,CAAA;AAGpE,eAAO,MAAM,qBAAqB,wBAAwB,CAAA;AAC1D,eAAO,MAAM,oBAAoB,oCAAyC,CAAA;AAE1E,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAE1D,eAAO,MAAM,oBAAoB,GAAI,qBAElC;IACD,aAAa,CAAC,EAAE,GAAG,CAAC,aAAa,CAAA;CAC7B,WAKL,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEvC,eAAO,MAAM,WAAW,SACkD,CAAA;AAE1E,eAAO,MAAM,WAAW,SACkD,CAAA;AAE1E,eAAO,MAAM,QAAQ,SAA0C,CAAA;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,SAGc,CAAA;AAExC,eAAO,MAAM,SAAS,QAA4E,CAAA;AAElG,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAC3D,eAAO,MAAM,8BAA8B,0BAAwC,CAAA;AACnF,eAAO,MAAM,uBAAuB,QAA6C,CAAA;AACjF,eAAO,MAAM,iBAAiB,QAA+C,CAAA;AAE7E,eAAO,MAAM,kBAAkB,QAA6B,CAAA;AAC5D,eAAO,MAAM,sBAAsB,QAAiC,CAAA;AAGpE,eAAO,MAAM,qBAAqB,wBAAwB,CAAA;AAC1D,eAAO,MAAM,oBAAoB,oCAAyC,CAAA;AAE1E,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAE1D,eAAO,MAAM,oBAAoB,GAAI,qBAElC;IACD,aAAa,CAAC,EAAE,GAAG,CAAC,aAAa,CAAA;CAC7B,WAKL,CAAA"}

package/types/createAPIRoute.d.ts

@@ -1,8 +1,31 @@
 import type { OneRouter } from './interfaces/router';
 type MaybePromise<T> = T | Promise<T>;
-type APIRouteHandler<Params extends Record<string, string> = Record<string, string>> = (request: Request, context: {
+/**
+ * Minimal shape of the Cloudflare Workers `ExecutionContext`.
+ * Use `context.worker?.executionCtx?.waitUntil(promise)` from an API handler
+ * to keep the worker alive for fire-and-forget background work after the
+ * response has been sent.
+ */
+export type WorkerExecutionContext = {
+    waitUntil: (promise: Promise<unknown>) => void;
+    passThroughOnException: () => void;
+};
+/** Cloudflare Workers `env` bindings. Shape is app-specific; `unknown` by default. */
+export type WorkerEnv = Record<string, unknown>;
+/**
+ * Worker-runtime context surfaced on API handlers when running under an edge
+ * runtime (Cloudflare Workers). Undefined in dev/Node.
+ */
+export type WorkerContext = {
+    env?: WorkerEnv;
+    executionCtx?: WorkerExecutionContext;
+};
+export type APIRouteContext<Params extends Record<string, string> = Record<string, string>> = {
     params: Params;
-}) => MaybePromise<Response>;
+    /** Present on worker runtimes (Cloudflare Workers). Undefined in dev/Node. */
+    worker?: WorkerContext;
+};
+type APIRouteHandler<Params extends Record<string, string> = Record<string, string>> = (request: Request, context: APIRouteContext<Params>) => MaybePromise<Response>;
 /**
  * Type helper for API route handlers with typed params.
  *
@@ -11,8 +34,10 @@ type APIRouteHandler<Params extends Record<string, string> = Record<string, stri
  * // app/api/users/[id]+api.ts
  * import { createAPIRoute } from 'one'
  *
- * export const GET = createAPIRoute<'/api/users/[id]'>((request, { params }) => {
+ * export const GET = createAPIRoute<'/api/users/[id]'>((request, { params, worker }) => {
  *   // params.id is typed as string
+ *   // on cloudflare workers, worker.executionCtx.waitUntil() keeps background work alive
+ *   worker?.executionCtx?.waitUntil(trackEvent(params.id))
  *   return Response.json({ id: params.id })
  * })
  * ```

package/types/createAPIRoute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createAPIRoute.d.ts","sourceRoot":"","sources":["../src/createAPIRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAErC,KAAK,eAAe,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CACrF,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,KACxB,YAAY,CAAC,QAAQ,CAAC,CAAA;AAE3B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EACzD,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,wDAG9D;AAED,YAAY,EAAE,eAAe,EAAE,CAAA"}
+{"version":3,"file":"createAPIRoute.d.ts","sourceRoot":"","sources":["../src/createAPIRoute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAErC;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;IAC9C,sBAAsB,EAAE,MAAM,IAAI,CAAA;CACnC,CAAA;AAED,sFAAsF;AACtF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE/C;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,SAAS,CAAA;IACf,YAAY,CAAC,EAAE,sBAAsB,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,eAAe,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAC5D;IACF,MAAM,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB,CAAA;AAED,KAAK,eAAe,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CACrF,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,KAC7B,YAAY,CAAC,QAAQ,CAAC,CAAA;AAE3B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EACzD,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,wDAG9D;AAED,YAAY,EAAE,eAAe,EAAE,CAAA"}