@tinyfiles/cli 0.1.2

package/README.md

@@ -0,0 +1,32 @@
+# @tinyfiles/cli
+
+The **AT-1 / TinyFiles** command-line tool as a native binary — no Python required.
+
+```bash
+npm install -g @tinyfiles/cli      # or:  pnpm add -g @tinyfiles/cli   /   yarn global add @tinyfiles/cli
+at1 compress qcolumnar data.csv data.at1    # verified-lossless, queryable
+at1 sql data.at1 "SELECT id WHERE ts BETWEEN 100 AND 200"   # query without decompressing
+at1 decompress data.at1 data.out            # byte-for-byte identical
+```
+
+AT-1 is structure-aware **lossless** compression you can **query in place**, with a SHA-256
+integrity trailer on every archive. See **https://tinyfiles.io/docs** for the full guide,
+and **https://tinyfiles.io/docs/start-here** if you're new.
+
+## How it installs
+
+This package contains only a tiny launcher. The actual engine ships as a **prebuilt,
+compiled binary** in a per-platform package (`@tinyfiles/cli-win32-x64`, `@tinyfiles/cli-darwin-arm64`,
+…) listed under `optionalDependencies`. Your package manager fetches **only** the one
+matching your OS/arch (via the packages' `os`/`cpu` fields) — there is **no install
+script**, so it works cleanly under npm, pnpm, yarn, and bun.
+
+Supported: `win32-x64`, `darwin-x64`, `darwin-arm64`, `linux-x64`. On other platforms,
+install via pip instead: `pip install at1-compression`.
+
+## Notes
+
+- **Decoding** an `.at1` is always free and needs no account. Heavy **encoding** is metered
+  against your AT-1 account (set `AT1_LICENSE_KEY`, or `at1 login`) — same as the pip/desktop
+  clients. See https://tinyfiles.io/pricing.
+- Decode-only in the browser/Node? Use [`@tinyfiles/decoder`](https://www.npmjs.com/package/@tinyfiles/decoder).

package/bin/at1.cjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * @tinyfiles/cli launcher. Execs the prebuilt, COMPILED AT-1 binary for this platform.
+ *
+ * No IP leak: the engine ships only as a compiled binary (PyInstaller; engine modules are
+ * Cython-compiled — no readable .py/.pyc) inside a per-platform optionalDependency
+ * (@tinyfiles/cli-<platform>-<arch>). This launcher contains zero engine logic. The per-platform
+ * packages carry `os`/`cpu` fields, so the package manager installs only the matching one —
+ * and because the binary travels inside that dependency, there is NO postinstall script,
+ * which is what makes this work cleanly under pnpm's default script-blocking.
+ */
+const { spawnSync } = require("node:child_process");
+
+function resolveBinary() {
+  const platform = process.platform; // 'win32' | 'darwin' | 'linux'
+  const arch = process.arch;         // 'x64' | 'arm64'
+  const binName = platform === "win32" ? "at1.exe" : "at1";
+  try {
+    return require.resolve(`@tinyfiles/cli-${platform}-${arch}/bin/${binName}`);
+  } catch {
+    return null;
+  }
+}
+
+const bin = resolveBinary();
+if (!bin) {
+  process.stderr.write(
+    `AT-1: no prebuilt binary for ${process.platform}-${process.arch}.\n` +
+    `Supported: win32-x64, darwin-x64, darwin-arm64, linux-x64.\n` +
+    `If you're on one of those, reinstall so the platform package is fetched ` +
+    `(e.g. npm i -g @tinyfiles/cli). Otherwise use pip: pip install at1-compression.\n`
+  );
+  process.exit(1);
+}
+
+const res = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+if (res.error) {
+  process.stderr.write(`AT-1: failed to launch binary: ${res.error.message}\n`);
+  process.exit(1);
+}
+process.exit(res.status === null ? 1 : res.status);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@tinyfiles/cli",
+  "version": "0.1.2",
+  "description": "AT-1 / TinyFiles CLI — verified-lossless, queryable compression. Native prebuilt binary, no Python required.",
+  "bin": {
+    "at1": "bin/at1.cjs"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "optionalDependencies": {
+    "@tinyfiles/cli-win32-x64": "0.1.2",
+    "@tinyfiles/cli-linux-x64": "0.1.2"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "keywords": [
+    "compression",
+    "lossless",
+    "queryable",
+    "at1",
+    "tinyfiles",
+    "archive",
+    "cli"
+  ],
+  "license": "UNLICENSED",
+  "homepage": "https://tinyfiles.io",
+  "bugs": {
+    "url": "https://github.com/AT1-Tinyfiles/AT-1-Public/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AT1-Tinyfiles/AT-1-Public.git"
+  }
+}