@tnldotdev/tnl 0.1.0-rc.26 → 0.1.0-rc.28

package/dist/bin/tnl.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/tnl.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { resolveNativeBinary } from "../internal/launcher.js";
+try {
+    const binary = resolveNativeBinary();
+    if (process.execve === undefined) {
+        throw new Error("Node.js does not support replacing the launcher process");
+    }
+    process.execve(binary, [binary, ...process.argv.slice(2)], process.env);
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`tnl: ${message}\n`);
+    process.exitCode = 1;
+}

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { TnlConfigInput } from "./config.gen.js";
+export type * from "./config.gen.js";
+/** Adds type checking to a version-1 tnl.config.ts configuration. */
+export declare function defineConfig<const Config extends TnlConfigInput>(config: Config): Config;

package/dist/config.gen.d.ts

@@ -0,0 +1,133 @@
+export interface TnlConfig {
+    /**
+     * Control URL used by this project.
+     */
+    server?: string;
+    /**
+     * Team ID or unambiguous display name used by this project.
+     */
+    team?: string;
+    /**
+     * Default route and tunnel settings.
+     */
+    tunnel?: {
+        /**
+         * Complete route hostname to publish.
+         */
+        host?: string;
+        /**
+         * One DNS label beneath the current member namespace.
+         */
+        subdomain?: string;
+        /**
+         * Remove the route when this tunnel stops.
+         */
+        ephemeral?: boolean;
+        /**
+         * Allow visitors from every IP address.
+         */
+        allowAllIPs?: boolean;
+        /**
+         * Visitor IP addresses or prefixes allowed to use the route; the current client IP is added automatically.
+         *
+         * @maxItems 63
+         */
+        allowIP?: string[];
+        /**
+         * Maximum concurrent requests forwarded by the publisher for this route, including streams and upgrades.
+         */
+        requestLimit?: number;
+    };
+    publish?: Publish;
+    dev?: Dev;
+    /**
+     * Named local services with optional project-setting overrides.
+     */
+    services?: {
+        [k: string]: {
+            /**
+             * Service directory relative to the project configuration.
+             */
+            directory?: string;
+            /**
+             * Control URL override for this service.
+             */
+            server?: string;
+            /**
+             * Team override for this service.
+             */
+            team?: string;
+            /**
+             * Route and tunnel overrides for this service.
+             */
+            tunnel?: {
+                /**
+                 * Complete route hostname to publish.
+                 */
+                host?: string;
+                /**
+                 * One DNS label beneath the current member namespace.
+                 */
+                subdomain?: string;
+                /**
+                 * Remove the route when this tunnel stops.
+                 */
+                ephemeral?: boolean;
+                /**
+                 * Allow visitors from every IP address.
+                 */
+                allowAllIPs?: boolean;
+                /**
+                 * Visitor IP addresses or prefixes allowed to use the route; the current client IP is added automatically.
+                 *
+                 * @maxItems 63
+                 */
+                allowIP?: string[];
+                /**
+                 * Maximum concurrent requests forwarded by the publisher for this route, including streams and upgrades.
+                 */
+                requestLimit?: number;
+            };
+            publish?: Publish;
+            dev?: Dev;
+        } | undefined;
+    };
+}
+export interface Publish {
+    /**
+     * Local HTTP URL or port reached by the publisher.
+     */
+    target?: string | number;
+}
+export interface Dev {
+    /**
+     * Child command and arguments run by tnl dev.
+     *
+     * @minItems 1
+     */
+    command?: [string, ...string[]];
+    /**
+     * Required local service port for tnl dev.
+     */
+    port?: number;
+    /**
+     * Maximum time to wait for the local service to start.
+     */
+    startupTimeout?: string;
+}
+/** The Git worktree or project directory that contains tnl.config.ts. */
+export interface TnlWorktree {
+    readonly isGit: boolean;
+    /** DNS-safe worktree label derived from this worktree and client state. */
+    readonly label: string;
+    readonly name: string;
+    readonly root: string;
+}
+/** Values passed to a tnl.config.ts configuration factory. */
+export interface TnlConfigContext {
+    readonly cwd: string;
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly worktree: TnlWorktree;
+}
+export type TnlConfigFactory = (context: TnlConfigContext) => TnlConfig | Promise<TnlConfig>;
+export type TnlConfigInput = TnlConfig | TnlConfigFactory;

package/dist/config.gen.js

@@ -0,0 +1,2 @@
+// Code generated by scripts/generate-config-types.ts. DO NOT EDIT.
+export {};

package/dist/config.js

@@ -0,0 +1,4 @@
+/** Adds type checking to a version-1 tnl.config.ts configuration. */
+export function defineConfig(config) {
+    return config;
+}

package/dist/index.js

@@ -1,4 +1,6 @@
 import { parseRuntimePayload } from "./internal/runtime.js";
 const serializedRuntime = typeof process === "undefined" ? undefined : process.env?.TNL_PROJECT_RUNTIME;
 /** Project metadata added by a tnl framework integration during development. */
+// The parser validates the runtime shape; generated project declarations supply
+// project-specific service names and literals unavailable to this shared module.
 export const tnl = parseRuntimePayload(serializedRuntime);

package/dist/internal/dev.js

@@ -59,7 +59,7 @@ export function canonicalLoopbackTarget(host, port) {
     if (hostname === "::1") {
         return `http://[::1]:${port}`;
     }
-    throw new Error("tnl development target must use a loopback listener");
+    throw new Error("tnl development target must listen on localhost or all interfaces");
 }
 export async function registerLocalTarget(assignment, target) {
     const body = JSON.stringify({ protocol: 1, framework: assignment.framework, target });
@@ -110,8 +110,10 @@ function parseBootstrapEnvironment(environment) {
         throw new Error(`TNL_DEV_SOCKET is required by tnl dev protocol ${protocolVersion}`);
     }
     const rawPort = environment.TNL_DEV_PORT;
-    const port = rawPort === undefined ? undefined : parseListenerPort(rawPort, "TNL_DEV_PORT");
-    return Object.freeze({ port, socket });
+    if (rawPort === undefined) {
+        return Object.freeze({ socket });
+    }
+    return Object.freeze({ port: parseListenerPort(rawPort, "TNL_DEV_PORT"), socket });
 }
 function discoverDevSocket(discovery, environment) {
     const getuid = process.getuid;
@@ -157,7 +159,8 @@ function parseAssignment(value, bootstrap, framework) {
     }
     const memberNamespace = requiredHostname(object.memberNamespace, "tnl dev returned member namespace");
     const hostname = requiredHostname(object.hostname, "tnl dev returned public hostname");
-    if (object.publicURL !== `https://${hostname}`) {
+    const publicURL = `https://${hostname}`;
+    if (object.publicURL !== publicURL) {
         throw new Error("tnl dev returned an invalid public URL");
     }
     const project = parseProjectRuntime(object.project, "tnl dev project metadata");
@@ -182,7 +185,7 @@ function parseAssignment(value, bootstrap, framework) {
         hostname,
         memberNamespace,
         project,
-        publicURL: object.publicURL,
+        publicURL,
         service: object.service,
         tunnelID: object.tunnelID,
     });
@@ -383,5 +386,5 @@ function canonicalPath(value) {
     }
 }
 function isMissing(error) {
-    return error.code === "ENOENT";
+    return error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT";
 }

package/dist/internal/launcher.d.ts

@@ -0,0 +1,8 @@
+interface NativeBinaryOptions {
+    readonly architecture?: NodeJS.Architecture;
+    readonly platform?: NodeJS.Platform;
+    readonly resolve?: (specifier: string) => string;
+}
+export declare function nativePackageName(platform: NodeJS.Platform, architecture: NodeJS.Architecture): string;
+export declare function resolveNativeBinary(options?: NativeBinaryOptions): string;
+export {};

package/dist/internal/launcher.js

@@ -0,0 +1,55 @@
+import { constants, accessSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import process from "node:process";
+import { nativeTargets } from "./native-targets.js";
+const require = createRequire(import.meta.url);
+const launcherManifest = new URL("../../package.json", import.meta.url);
+const nativePackages = new Map(nativeTargets.map(({ platform, architecture, packageName }) => [
+    `${platform}-${architecture}`,
+    packageName,
+]));
+export function nativePackageName(platform, architecture) {
+    const packageName = nativePackages.get(`${platform}-${architecture}`);
+    if (packageName === undefined) {
+        throw new Error(`unsupported platform ${platform}-${architecture}; tnl supports macOS and Linux on arm64 and x64`);
+    }
+    return packageName;
+}
+export function resolveNativeBinary(options = {}) {
+    const { architecture = process.arch, platform = process.platform, resolve = require.resolve, } = options;
+    const packageName = nativePackageName(platform, architecture);
+    let nativeManifestPath;
+    try {
+        nativeManifestPath = resolve(`${packageName}/package.json`);
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "MODULE_NOT_FOUND") {
+            throw new Error(`${packageName} is missing; reinstall @tnldotdev/tnl without disabling optional dependencies`, { cause: error });
+        }
+        throw error;
+    }
+    const mainManifest = readManifest(launcherManifest);
+    const nativeManifest = readManifest(nativeManifestPath);
+    if (nativeManifest.version !== mainManifest.version) {
+        throw new Error(`${packageName}@${String(nativeManifest.version)} does not match @tnldotdev/tnl@${String(mainManifest.version)}`);
+    }
+    const binary = path.join(path.dirname(nativeManifestPath), "bin", "tnl");
+    try {
+        accessSync(binary, constants.X_OK);
+    }
+    catch (error) {
+        throw new Error(`${packageName} does not contain an executable tnl binary`, { cause: error });
+    }
+    return binary;
+}
+function readManifest(file) {
+    const value = JSON.parse(readFileSync(file, "utf8"));
+    if (value === null ||
+        typeof value !== "object" ||
+        !("version" in value) ||
+        typeof value.version !== "string") {
+        throw new Error("package manifest has an invalid shape");
+    }
+    return { version: value.version };
+}

package/dist/internal/native-targets.d.ts

@@ -0,0 +1,9 @@
+export type NativeArchitecture = "arm64" | "x64";
+export type NativePlatform = "darwin" | "linux";
+export interface NativeTarget {
+    readonly architecture: NativeArchitecture;
+    readonly packageName: `@tnldotdev/tnl-${NativePlatform}-${NativeArchitecture}`;
+    readonly platform: NativePlatform;
+}
+/** Internal distribution catalog shared by the launcher and release scripts. */
+export declare const nativeTargets: readonly Readonly<NativeTarget>[];

package/{lib/native-targets.mjs → dist/internal/native-targets.js}

@@ -1,12 +1,8 @@
-/** Internal distribution catalog shared by the launcher and release scripts.
- * Node architecture names belong here; Go artifact paths and versions do not.
- * Entries retain native publish order. This module is not a public package export.
- */
-export const nativeTargets = Object.freeze(
-  [
+const targets = [
     { platform: "darwin", architecture: "arm64", packageName: "@tnldotdev/tnl-darwin-arm64" },
     { platform: "darwin", architecture: "x64", packageName: "@tnldotdev/tnl-darwin-x64" },
     { platform: "linux", architecture: "arm64", packageName: "@tnldotdev/tnl-linux-arm64" },
     { platform: "linux", architecture: "x64", packageName: "@tnldotdev/tnl-linux-x64" },
-  ].map((target) => Object.freeze(target)),
-);
+];
+/** Internal distribution catalog shared by the launcher and release scripts. */
+export const nativeTargets = Object.freeze(targets.map((target) => Object.freeze(target)));

package/dist/internal/runtime.d.ts

@@ -5,7 +5,7 @@ export interface ProjectServiceMetadata {
 }
 export interface ProjectMetadata {
     readonly memberNamespace: string;
-    readonly services: Readonly<Record<string, ProjectServiceMetadata>>;
+    readonly services: Readonly<Record<string, ProjectServiceMetadata | undefined>>;
 }
 export interface ProjectRuntime extends ProjectMetadata {
     readonly runningUnderTnlDev: boolean;

package/dist/internal/runtime.js

@@ -21,7 +21,8 @@ export function parseProjectMetadata(value, description) {
         exactKeys(service, ["hostname", "memberNamespace", "url"], `${description} service ${JSON.stringify(name)}`);
         const serviceMemberNamespace = requiredHostname(service.memberNamespace, `${description} service ${JSON.stringify(name)} member namespace`);
         const hostname = requiredHostname(service.hostname, `${description} service ${JSON.stringify(name)} hostname`);
-        if (service.url !== `https://${hostname}`) {
+        const url = `https://${hostname}`;
+        if (service.url !== url) {
             throw new Error(`${description} service ${JSON.stringify(name)} has an invalid URL`);
         }
         if (hostnames.has(hostname)) {
@@ -31,7 +32,7 @@ export function parseProjectMetadata(value, description) {
         services[name] = Object.freeze({
             memberNamespace: serviceMemberNamespace,
             hostname,
-            url: service.url,
+            url,
         });
     }
     return Object.freeze({

package/package.json

@@ -1,25 +1,9 @@
 {
   "name": "@tnldotdev/tnl",
-  "version": "0.1.0-rc.26",
-  "description": "The tnl client and framework integrations for project-local development.",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tnldotdev/tnl.git",
-    "directory": "packages/tnl"
-  },
+  "version": "0.1.0-rc.28",
   "bin": {
-    "tnl": "bin/tnl.mjs"
+    "tnl": "dist/bin/tnl.js"
   },
-  "files": [
-    "bin",
-    "dist",
-    "lib",
-    "NOTICE",
-    "THIRD_PARTY_LICENSES.txt"
-  ],
-  "type": "module",
-  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -27,8 +11,9 @@
       "default": "./dist/index.js"
     },
     "./config": {
-      "types": "./lib/config.d.ts",
-      "import": "./lib/config.mjs"
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "default": "./dist/config.js"
     },
     "./next": {
       "types": "./dist/next.d.ts",
@@ -41,19 +26,33 @@
       "default": "./dist/vite.js"
     }
   },
-  "publishConfig": {
-    "access": "public"
-  },
   "scripts": {
     "build": "pnpm run clean && tsc --project tsconfig.json",
-    "clean": "node ../../scripts/clean-package.mjs",
+    "clean": "node ../../scripts/clean-package.ts",
     "prepack": "pnpm run build"
   },
+  "description": "The tnl client and framework integrations for project-local development.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tnldotdev/tnl.git",
+    "directory": "packages/tnl"
+  },
+  "files": [
+    "dist",
+    "NOTICE",
+    "THIRD_PARTY_LICENSES.txt"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
   "devDependencies": {
-    "next": "16.3.4",
-    "react": "19.2.8",
-    "react-dom": "19.2.8",
-    "vite": "8.2.2"
+    "next": "16.3.5",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "vite": "8.3.0"
   },
   "peerDependencies": {
     "next": ">=16.3.4",
@@ -71,12 +70,12 @@
     "node": ">=22.18"
   },
   "optionalDependencies": {
-    "@tnldotdev/tnl-darwin-arm64": "0.1.0-rc.26",
-    "@tnldotdev/tnl-darwin-x64": "0.1.0-rc.26",
-    "@tnldotdev/tnl-linux-arm64": "0.1.0-rc.26",
-    "@tnldotdev/tnl-linux-x64": "0.1.0-rc.26"
+    "@tnldotdev/tnl-darwin-arm64": "0.1.0-rc.28",
+    "@tnldotdev/tnl-darwin-x64": "0.1.0-rc.28",
+    "@tnldotdev/tnl-linux-arm64": "0.1.0-rc.28",
+    "@tnldotdev/tnl-linux-x64": "0.1.0-rc.28"
   },
   "tnl": {
-    "commit": "d6e8318fb2738a4377e67856e9eb6fe017e6097a"
+    "commit": "48180dc541348df42a0730cdaf749a2d507b05f6"
   }
 }

package/readme.md

@@ -0,0 +1,25 @@
+# `@tnldotdev/tnl`
+
+The tnl client, plus official Next.js and Vite integrations for project-local
+development. Available for macOS and Linux on arm64 and x64 with Node.js 22.18
+or newer. The package selects a native binary through optional dependencies;
+it does not install the `tnld` server.
+
+```console
+pnpm add -D @tnldotdev/tnl@next
+pnpm exec tnl init
+pnpm exec tnl dev
+```
+
+`tnl init` sets up missing project and framework configuration and lists any
+actions required for existing files. Sign in when prompted; hosted tnl.dev is
+the default server. Each Git worktree gets its own HTTPS URL.
+
+Read the [quickstart](https://tnl.dev/docs),
+[Next.js and Vite setup](https://tnl.dev/docs/frameworks),
+[project configuration](https://tnl.dev/docs/configuration), and
+[CLI commands](https://tnl.dev/docs/cli) on tnl.dev.
+
+The client enables pseudonymous telemetry by default. Disable it with
+`TNL_NO_TELEMETRY=true` or `--no-telemetry`; see the
+[telemetry disclosure](https://tnl.dev/docs/cli#telemetry).

package/README.md

@@ -1,212 +0,0 @@
-# `@tnldotdev/tnl`
-
-This package installs the `tnl` client for macOS or Linux on arm64 or x64 and
-provides its browser-safe project runtime plus official Next.js and Vite
-integrations. It does not include the `tnld` server process.
-
-## Install
-
-```console
-pnpm add --save-dev @tnldotdev/tnl@next
-```
-
-The package selects an exact-version native optional dependency for the current
-platform. It has no install script and does not download executable code from a
-third-party host. Node.js 22.18 or newer is required by the launcher,
-integrations, and TypeScript configuration loader.
-
-The native CLI enables pseudonymous telemetry by default. Use
-`TNL_NO_TELEMETRY=true` or `--no-telemetry` to disable it; see the
-[telemetry disclosure](../../README.md#telemetry).
-
-## Configuration
-
-Run `tnl init` to add the package and missing project/framework configuration.
-It preserves existing Next.js, Vite, and TypeScript configuration and reports
-remaining integration actions. Configure an integration below before starting
-a framework-discovered tunnel.
-
-For a project with existing `apps/api` and `apps/web` directories:
-
-```ts
-// tnl.config.ts
-import { defineConfig } from "@tnldotdev/tnl/config";
-
-export default defineConfig({
-  dev: { command: ["pnpm", "dev"] },
-  services: {
-    api: { directory: "apps/api", publish: { target: 3001 } },
-    web: { directory: "apps/web" },
-  },
-});
-```
-
-Each project service inherits the root settings and can override them. Commands
-run in the service directory, which must be inside the project root. If the
-project has several services, choose one with a command such as `tnl dev web` or
-`tnl publish api`. A project with one service selects it automatically.
-
-Service names must start with a lowercase ASCII letter. They may contain
-lowercase letters, digits, and hyphens, cannot end with a hyphen, and may be up
-to 32 characters long. A project may define up to 32 services.
-
-`defineConfig` also accepts a synchronous or asynchronous factory:
-
-```ts
-export default defineConfig(({ worktree }) => ({
-  tunnel: { subdomain: worktree.label },
-  dev: { command: ["pnpm", "dev"], startupTimeout: "90s" },
-}));
-```
-
-`worktree.label` combines a readable name with an eight-character hash. It stays
-the same for a worktree and client state directory, but differs across worktrees
-and installations. The private value used to create the hash is not exposed.
-
-Factories receive read-only `cwd`, `env`, and `worktree` values. `cwd` is the
-directory where the command started. Node runs the configuration file from its
-own directory. The loader and `context.env` omit `TNL_*` and `TNLD_*` variables,
-but they do not remove other application secrets.
-
-TypeScript configuration runs as trusted project code. It is not sandboxed.
-`defineConfig` provides type checking; the native client still validates the
-result at runtime. TypeScript uses camel-case fields and is always version 1.
-Static YAML and JSON require `version: 1` and snake-case fields; see
-[discovery and precedence](../../README.md#project-configuration) and the
-[JSON Schema](https://tnl.dev/schema/v1.json).
-
-Choose either `tunnel.host` or `tunnel.subdomain`. Choose either `public: true`
-or `allowIP`. A project-service override replaces the other inherited choice.
-`dev.port` requires the local service to use that port. `dev.startupTimeout`
-defaults to two minutes and must be greater than zero and no more than ten
-minutes. `dev.command` is an argument array, not a shell command string.
-
-## Project Runtime
-
-Authenticate to the configured server, then generate metadata from the project
-root:
-
-```console
-tnl login https://control.tnl.example.com --token
-tnl config generate
-```
-
-Generation selects the current membership and a ready domain for the project and
-each service. It also respects service-specific server and team settings. The
-command writes `.tnl/project.json` and `.tnl/project.d.ts`.
-
-Regenerate after changing project services, servers, teams, or domains. The
-`tnl dev` command also generates metadata when the project has a configuration
-file. Keep `.tnl` ignored by Git.
-
-Add the declaration to the application's existing TypeScript `include` list.
-For an app at the project root, include `.tnl/project.d.ts`; for the example's
-`apps/web/tsconfig.json`, include `../../.tnl/project.d.ts`:
-
-```json
-{
-  "include": ["**/*.ts", "**/*.tsx", "../../.tnl/project.d.ts"]
-}
-```
-
-Keep any other entries required by the framework. The generated declaration
-adds the configured service names and their exact hostname and URL types. Without
-it, service names use a general string type, so check that a service exists
-before reading it.
-
-The integrations expose this browser-safe runtime during development:
-
-```ts
-import { tnl } from "@tnldotdev/tnl";
-
-if (tnl) {
-  tnl.memberNamespace;
-  tnl.services.api.hostname;
-  tnl.services.api.url;
-  tnl.runningUnderTnlDev;
-}
-```
-
-The `tnl` value is undefined during builds, previews, and production. During
-development, behavior depends on discovery:
-
-| Development context                                 | Runtime and network behavior                                                              |
-| --------------------------------------------------- | ----------------------------------------------------------------------------------------- |
-| No generated metadata or `tnl dev` environment      | `tnl` is undefined; no tunnel configuration                                               |
-| Metadata without a matching development socket      | Frozen metadata, `runningUnderTnlDev: false`; no tunnel configuration                     |
-| `tnl dev` environment or discovered matching socket | Assigned metadata, `runningUnderTnlDev: true`; configure and register the actual listener |
-
-You can start `tnl dev web` in one terminal and start the framework from the
-service directory in another. The integration looks for the development socket
-when the framework configuration loads; it does not keep searching afterward.
-
-Project metadata is a snapshot. It does not show whether the route or local
-service is healthy. The values are read-only, and malformed metadata causes an
-error. `tnl publish` cannot add metadata to an application that is already
-running.
-
-## Next.js
-
-```ts
-// next.config.ts
-import { withTnl } from "@tnldotdev/tnl/next";
-
-export default withTnl({
-  reactStrictMode: true,
-});
-```
-
-`withTnl` accepts every Next.js configuration form: an object, a promise, or a
-synchronous or asynchronous function. During `tnl dev`, it:
-
-- Adds the assigned hostname to `allowedDevOrigins`.
-- Injects the project runtime.
-- Registers the listener after Next.js reports the port it actually used.
-
-The integration preserves existing host and port settings. If no port was
-forced, Next.js can retry when its preferred port is occupied. `tnl` waits for
-the port Next.js chooses instead of forwarding to another process. A port set by
-`tnl dev --port` must match exactly. Host settings remain independent, so the
-development server can still be exposed on the LAN.
-
-Next.js 16.3.4 or newer is supported.
-
-## Vite
-
-```ts
-// vite.config.ts
-import { defineConfig } from "vite";
-import tnl from "@tnldotdev/tnl/vite";
-
-export default defineConfig({
-  plugins: [tnl()],
-});
-```
-
-During `tnl dev`, the plugin allows the assigned hostname, injects the project
-runtime, and registers the listener after Vite chooses its port. Vite keeps its
-normal host and port behavior, including retries when a port is occupied. A port
-set by `tnl dev --port` must match exactly. Host settings can still expose Vite
-on the LAN.
-
-Without a development socket, the plugin only injects generated project
-metadata. It does nothing during builds and previews. Vite 6.0.9 or newer is
-supported.
-
-Next.js and Vite are optional peers, so only the framework already used by the
-project is required. Keep hostname, policy, server, service, and command
-settings in project configuration rather than passing integration options.
-
-### Listener Requirements
-
-The target must use HTTP over loopback. A wildcard binding (`0.0.0.0` or `::`)
-is allowed because tnl can still connect through loopback. Binding only to a
-specific LAN address is not supported. Vite middleware mode does not provide a
-supported listener. Next.js must report an HTTP listener URL.
-
-When a port is forced, the integration checks the actual listener instead of
-trusting configuration alone. The integration preserves Vite's
-`allowedHosts: true` and will not re-enable host filtering.
-
-Deploy `tnld` with the release container or install it from Homebrew or a
-release archive.

package/bin/tnl.mjs

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-
-import process from "node:process";
-import { resolveNativeBinary } from "../lib/launcher.mjs";
-
-try {
-  const binary = resolveNativeBinary();
-  process.execve(binary, [binary, ...process.argv.slice(2)], process.env);
-} catch (error) {
-  const message = error instanceof Error ? error.message : String(error);
-  process.stderr.write(`tnl: ${message}\n`);
-  process.exitCode = 1;
-}

package/lib/config.d.ts

@@ -1,69 +0,0 @@
-export interface TNL {
-  server?: string;
-  team?: string;
-  tunnel?: {
-    host?: string;
-    subdomain?: string;
-    public?: boolean;
-    ephemeral?: boolean;
-    /**
-     * @maxItems 63
-     */
-    allowIP?: string[];
-  };
-  publish?: Publish;
-  dev?: Dev;
-  services?: {
-    [k: string]: {
-      directory?: string;
-      server?: string;
-      team?: string;
-      tunnel?: {
-        host?: string;
-        subdomain?: string;
-        public?: boolean;
-        ephemeral?: boolean;
-        /**
-         * @maxItems 63
-         */
-        allowIP?: string[];
-      };
-      publish?: Publish;
-      dev?: Dev;
-    };
-  };
-}
-export interface Publish {
-  target?: string | number;
-}
-export interface Dev {
-  /**
-   * @minItems 1
-   */
-  command?: [string, ...string[]];
-  port?: number;
-  startupTimeout?: string;
-}
-
-/** The Git worktree or project directory that contains tnl.config.ts. */
-export interface TnlWorktree {
-  readonly isGit: boolean;
-  /** DNS-safe worktree label derived from this worktree and client state. */
-  readonly label: string;
-  readonly name: string;
-  readonly root: string;
-}
-
-/** Values passed to a tnl.config.ts configuration factory. */
-export interface TnlConfigContext {
-  readonly cwd: string;
-  readonly env: Readonly<Record<string, string>>;
-  readonly worktree: TnlWorktree;
-}
-
-export type TnlConfigFactory = (context: TnlConfigContext) => TNL | Promise<TNL>;
-
-export type TnlConfigInput = TNL | TnlConfigFactory;
-
-/** Adds type checking to a version-1 tnl.config.ts configuration. */
-export declare function defineConfig<const Config extends TnlConfigInput>(config: Config): Config;

package/lib/config.mjs

@@ -1,3 +0,0 @@
-export function defineConfig(config) {
-  return config;
-}

package/lib/launcher.mjs

@@ -1,65 +0,0 @@
-import { constants, accessSync, readFileSync } from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import process from "node:process";
-import { nativeTargets } from "./native-targets.mjs";
-
-const require = createRequire(import.meta.url);
-const launcherManifest = new URL("../package.json", import.meta.url);
-
-const nativePackages = new Map(
-  nativeTargets.map(({ platform, architecture, packageName }) => [
-    `${platform}-${architecture}`,
-    packageName,
-  ]),
-);
-
-export function nativePackageName(platform, architecture) {
-  const packageName = nativePackages.get(`${platform}-${architecture}`);
-  if (packageName === undefined) {
-    throw new Error(
-      `unsupported platform ${platform}-${architecture}; tnl supports macOS and Linux on arm64 and x64`,
-    );
-  }
-  return packageName;
-}
-
-export function resolveNativeBinary({
-  architecture = process.arch,
-  platform = process.platform,
-  resolve = require.resolve,
-} = {}) {
-  const packageName = nativePackageName(platform, architecture);
-  let nativeManifestPath;
-  try {
-    nativeManifestPath = resolve(`${packageName}/package.json`);
-  } catch (error) {
-    if (error instanceof Error && "code" in error && error.code === "MODULE_NOT_FOUND") {
-      throw new Error(
-        `${packageName} is missing; reinstall @tnldotdev/tnl without disabling optional dependencies`,
-        { cause: error },
-      );
-    }
-    throw error;
-  }
-
-  const mainManifest = readManifest(launcherManifest);
-  const nativeManifest = readManifest(nativeManifestPath);
-  if (nativeManifest.version !== mainManifest.version) {
-    throw new Error(
-      `${packageName}@${String(nativeManifest.version)} does not match @tnldotdev/tnl@${String(mainManifest.version)}`,
-    );
-  }
-
-  const binary = path.join(path.dirname(nativeManifestPath), "bin", "tnl");
-  try {
-    accessSync(binary, constants.X_OK);
-  } catch (error) {
-    throw new Error(`${packageName} does not contain an executable tnl binary`, { cause: error });
-  }
-  return binary;
-}
-
-function readManifest(file) {
-  return JSON.parse(readFileSync(file, "utf8"));
-}