refactor(devframe): rename node/internal subpath to node/hub-internals

This subpath is the bridge `@devframes/hub` (and any future first-party
hub adapter) uses to reach into devframe's remote-dock token machinery
and basePath resolver. Calling it "internal" while a published package
depends on it understates the contract: rename to `hub-internals` and
document it as the stable surface for first-party hub adapters.

Author: antfu

alias.ts

@@ -14,7 +14,7 @@ export const alias = {
   'devframe/rpc': r('devframe/src/rpc'),
   'devframe/types': r('devframe/src/types/index.ts'),
   'devframe/node/auth': r('devframe/src/node/auth/index.ts'),
-  'devframe/node/internal': r('devframe/src/node/internal/index.ts'),
+  'devframe/node/hub-internals': r('devframe/src/node/hub-internals/index.ts'),
   'devframe/node': r('devframe/src/node/index.ts'),
   'devframe/constants': r('devframe/src/constants.ts'),
   'devframe/utils/colors': r('devframe/src/utils/colors.ts'),

packages/devframe/package.json

@@ -30,7 +30,7 @@
     "./helpers/vite": "./dist/helpers/vite.mjs",
     "./node": "./dist/node/index.mjs",
     "./node/auth": "./dist/node/auth.mjs",
-    "./node/internal": "./dist/node/internal.mjs",
+    "./node/hub-internals": "./dist/node/hub-internals.mjs",
     "./recipes/open-helpers": "./dist/recipes/open-helpers.mjs",
     "./rpc": "./dist/rpc/index.mjs",
     "./rpc/client": "./dist/rpc/client.mjs",

packages/devframe/src/node/auth/revoke.ts

@@ -1,7 +1,7 @@
 import type { DevframeNodeContext } from 'devframe/types'
 import type { SharedState } from 'devframe/utils/shared-state'
 import type { RpcFunctionsHost } from '../host-functions'
-import type { InternalAnonymousAuthStorage } from '../internal/context'
+import type { InternalAnonymousAuthStorage } from '../hub-internals/context'
 
 /**
  * Flip `isTrusted` to false on any live WS clients connected with `token`

packages/devframe/src/node/auth/state.ts

@@ -1,6 +1,6 @@
 import type { DevframeNodeRpcSession } from 'devframe/types'
 import type { SharedState } from 'devframe/utils/shared-state'
-import type { InternalAnonymousAuthStorage } from '../internal/context'
+import type { InternalAnonymousAuthStorage } from '../hub-internals/context'
 import { humanId } from 'devframe/utils/human-id'
 
 export interface PendingAuthRequest {

…es/devframe/src/node/internal/context.ts …vframe/src/node/hub-internals/context.tspackages/devframe/src/node/internal/context.ts renamed to packages/devframe/src/node/hub-internals/context.ts packages/devframe/src/node/internal/context.ts renamed to packages/devframe/src/node/hub-internals/context.ts

@@ -0,0 +1,25 @@
+/**
+ * Public surface for first-party hub adapters (`@devframes/hub` and
+ * similar). Carries the primitives a hub-kit author needs to bridge a
+ * framework dev server into a hub context — base-path resolution and
+ * the remote-dock token bridge used by the hub's docks host.
+ *
+ * Stable across minor versions; treat additions or removals as breaking
+ * only across major versions.
+ */
+
+export {
+  normalizeBasePath,
+  resolveBasePath,
+} from '../../adapters/_shared'
+
+export {
+  getInternalContext,
+  internalContextMap,
+} from './context'
+
+export type {
+  DevframeInternalContext,
+  InternalAnonymousAuthStorage,
+  RemoteTokenRecord,
+} from './context'

packages/devframe/src/node/hub-internals/index.ts

@@ -8,7 +8,7 @@ import { createRpcServer } from 'devframe/rpc/server'
 import { attachWsRpcTransport } from 'devframe/rpc/transports/ws-server'
 import { H3, toNodeHandler } from 'h3'
 import { WebSocketServer as WSServer } from 'ws'
-import { getInternalContext } from './internal/context'
+import { getInternalContext } from './hub-internals/context'
 
 export interface StartHttpAndWsOptions {
   context: DevframeNodeContext

packages/devframe/src/node/internal/index.ts

@@ -83,7 +83,7 @@ const serverEntries = {
   'rpc/transports/ws-server': 'src/rpc/transports/ws-server.ts',
   'node/index': 'src/node/index.ts',
   'node/auth': 'src/node/auth/index.ts',
-  'node/internal': 'src/node/internal/index.ts',
+  'node/hub-internals': 'src/node/hub-internals/index.ts',
   'utils/launch-editor': 'src/utils/launch-editor.ts',
   'utils/open': 'src/utils/open.ts',
   'utils/serve-static': 'src/utils/serve-static.ts',

packages/devframe/src/node/server.ts

@@ -2,7 +2,7 @@ import { mkdtempSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 import { createHostContext, startHttpAndWs } from 'devframe/node'
-import { getInternalContext } from 'devframe/node/internal'
+import { getInternalContext } from 'devframe/node/hub-internals'
 import { describe, expect, it } from 'vitest'
 import { createHubContext } from '../context'