@tnldotdev/tnl 0.0.0 → 0.1.0-rc.13

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chase Adams
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,4 +1,34 @@
 # `@tnldotdev/tnl`
 
-This is an inert placeholder used to configure trusted publishing for the tnl client.
-It does not contain an executable or library entry point.
+This package installs the `tnl` client for macOS or Linux on arm64 or x64. It
+does not include the `tnld` server daemon.
+
+## Install
+
+Install the client:
+
+```console
+pnpm add --save-dev @tnldotdev/tnl@next
+```
+
+Add `@tnldotdev/next` or `@tnldotdev/vite` for framework integration.
+
+Then invoke `tnl` from a package script:
+
+```json
+{
+  "scripts": {
+    "dev:public": "tnl dev -- pnpm dev"
+  }
+}
+```
+
+Use `tnl publish 3000 --open` or `tnl dev --open -- pnpm dev` to launch the
+public URL once it is ready.
+
+The package selects an exact-version native optional dependency for the current
+platform. It does not run an install script or download executable code from a
+third-party host. Node.js 22.15 or newer is required by the launcher.
+
+Deploy `tnld` with the release container or install it from Homebrew or a
+release archive.

package/bin/tnl.mjs

@@ -0,0 +1,13 @@
+#!/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/launcher.mjs

@@ -0,0 +1,64 @@
+import { constants, accessSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import process from "node:process";
+
+const require = createRequire(import.meta.url);
+const launcherManifest = new URL("../package.json", import.meta.url);
+
+const nativePackages = new Map([
+  ["darwin-arm64", "@tnldotdev/tnl-darwin-arm64"],
+  ["darwin-x64", "@tnldotdev/tnl-darwin-x64"],
+  ["linux-arm64", "@tnldotdev/tnl-linux-arm64"],
+  ["linux-x64", "@tnldotdev/tnl-linux-x64"],
+]);
+
+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"));
+}

package/package.json

@@ -1,17 +1,34 @@
 {
   "name": "@tnldotdev/tnl",
-  "version": "0.0.0",
-  "description": "Bootstrap placeholder for the tnl client.",
+  "version": "0.1.0-rc.13",
+  "description": "The tnl client for project-local development workflows.",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/tnldotdev/tnl.git",
     "directory": "packages/tnl"
   },
+  "bin": {
+    "tnl": "bin/tnl.mjs"
+  },
   "files": [
-    "README.md"
+    "bin",
+    "lib"
   ],
+  "type": "module",
   "publishConfig": {
     "access": "public"
+  },
+  "engines": {
+    "node": ">=22.15"
+  },
+  "optionalDependencies": {
+    "@tnldotdev/tnl-darwin-arm64": "0.1.0-rc.13",
+    "@tnldotdev/tnl-darwin-x64": "0.1.0-rc.13",
+    "@tnldotdev/tnl-linux-arm64": "0.1.0-rc.13",
+    "@tnldotdev/tnl-linux-x64": "0.1.0-rc.13"
+  },
+  "tnl": {
+    "commit": "5ea468a77835db128d4ff826c126dc234595704a"
   }
 }