@p11-core/cli 0.0.7 → 0.0.9

package/dist/index.js

@@ -3469,7 +3469,7 @@ var require_commander = __commonJS({
 import { realpathSync } from "fs";
 import { chmod, mkdir, mkdtemp, readFile, readdir, rename, rm, stat, writeFile } from "fs/promises";
 import { createRequire } from "module";
-import { homedir } from "os";
+import { homedir, tmpdir } from "os";
 import path from "path";
 import { fileURLToPath } from "url";
 import process from "process";
@@ -3625,6 +3625,11 @@ async function main() {
     return;
   }
   const command = process.argv[2];
+  if (isVersionFlag(command)) {
+    await warnIfUpdateAvailable({ force: true });
+    console.log(packageJson.version);
+    return;
+  }
   if (!isKnownTopLevelCommand(program2, command)) throw new Error(`Unknown command: ${command}`);
   await program2.parseAsync(process.argv);
 }
@@ -3632,7 +3637,9 @@ function createCliProgram(options = {}) {
   const program2 = new Command();
   const warnBeforeAction = options.warnIfUpdateAvailable ?? warnIfUpdateAvailable;
   program2.name("p11").description("Share and inspect p11 document pages.");
-  program2.hook("preAction", async () => {
+  program2.version(packageJson.version);
+  program2.hook("preAction", async (_thisCommand, actionCommand) => {
+    if (actionCommand.name() === "version") return;
     await warnBeforeAction();
   });
   program2.addHelpText(
@@ -3640,9 +3647,10 @@ function createCliProgram(options = {}) {
     `
 
 Environment:
-  P11_API_URL  Defaults to ${builtDefaultApiUrl}`
+  P11_API_URL    Defaults to ${builtDefaultApiUrl}
+  P11_BUILD_DIR  Directory for temporary share build files. Defaults to the OS temp directory.`
   );
-  const shareCommand = program2.command("share").description("Share a review link for a page.").argument("[page.tsx]").option("--json", "Print the API response as JSON.").option("--edit-url [url]", "Share a new version using an edit URL or edit id.").option("--api-url [url]", "Override the p11 API URL.").action(async (input, options2) => {
+  const shareCommand = program2.command("share").description("Share a review link for a page.").argument("[page.tsx]").option("--json", "Print the API response as JSON.").option("--edit-url [url]", "Share a new version using an edit URL or edit id.").option("--api-url [url]", "Override the p11 API URL.").option("--build-dir [dir]", "Directory for temporary build files.").action(async (input, options2) => {
     await publish(input, normalizePublishOptions(options2));
   });
   allowLegacyParserBehavior(shareCommand);
@@ -3654,6 +3662,10 @@ Environment:
     await deleteDocument(target, normalizeDeleteOptions(options2));
   });
   allowLegacyParserBehavior(deleteCommand);
+  program2.command("version").description("Print the p11 CLI version.").action(async () => {
+    await warnBeforeAction({ force: true });
+    console.log(packageJson.version);
+  });
   program2.command("history").description("List saved read/edit links.").option("--json", "Print saved history as JSON.").action(async (options2) => {
     await history(normalizeHistoryOptions(options2));
   });
@@ -3668,7 +3680,10 @@ Environment:
   return program2;
 }
 function isKnownTopLevelCommand(program2, command) {
-  return command === "--help" || command === "-h" || command === "help" || program2.commands.some((subcommand) => subcommand.name() === command);
+  return command === "--help" || command === "-h" || isVersionFlag(command) || command === "help" || program2.commands.some((subcommand) => subcommand.name() === command);
+}
+function isVersionFlag(command) {
+  return command === "--version" || command === "-V";
 }
 function allowLegacyParserBehavior(command) {
   return command.allowUnknownOption().allowExcessArguments();
@@ -3677,7 +3692,8 @@ function normalizePublishOptions(options) {
   return {
     json: options.json,
     editUrl: optionString(options.editUrl, "--edit-url requires a URL or edit id."),
-    apiUrl: optionString(options.apiUrl, "--api-url requires a URL.")
+    apiUrl: optionString(options.apiUrl, "--api-url requires a URL."),
+    buildDir: optionString(options.buildDir, "--build-dir requires a directory path.")
   };
 }
 function normalizeCommentsOptions(options) {
@@ -3719,10 +3735,12 @@ async function publish(input, options) {
   if (!/\.[cm]?[tj]sx?$/.test(resolvedInput)) {
     throw new Error("File input must be a .tsx, .jsx, .ts, or .js page file.");
   }
-  const cleanupDir = await mkdtemp(path.join(process.cwd(), ".p11-build-"));
+  const buildParentDir = resolveBuildParentDir(options.buildDir);
+  await mkdir(buildParentDir, { recursive: true });
+  const cleanupDir = await mkdtemp(path.join(buildParentDir, "p11-build-"));
   const distDir = path.join(cleanupDir, "dist");
-  await buildPageModule(resolvedInput, distDir);
   try {
+    await buildPageModule(resolvedInput, distDir);
     await ensureIndexHtml(distDir);
     const zipBytes = await zipDirectory(distDir);
     const editUrl = options.editUrl ?? "";
@@ -4107,34 +4125,48 @@ async function buildPageModule(inputFile, outDir) {
       "</html>"
     ].join("\n")
   );
-  await build({
-    root: tempDir,
-    base: "./",
-    configFile: false,
-    logLevel: "warn",
-    plugins: [react(), tailwindcss()],
-    resolve: {
-      alias: {
-        "@p11-core/components/styles.css": componentStyles,
-        "@p11-core/components": componentEntry,
-        "@recogito/text-annotator/text-annotator.css": textAnnotatorStyles,
-        "@recogito/text-annotator": textAnnotatorEntry,
-        "react/jsx-runtime": nodeRequire.resolve("react/jsx-runtime"),
-        "react/jsx-dev-runtime": nodeRequire.resolve("react/jsx-dev-runtime"),
-        "react-dom/client": nodeRequire.resolve("react-dom/client"),
-        "react-dom": nodeRequire.resolve("react-dom"),
-        react: nodeRequire.resolve("react")
+  const previousCwd = process.cwd();
+  try {
+    process.chdir(tempDir);
+    await build({
+      root: ".",
+      base: "./",
+      configFile: false,
+      logLevel: "warn",
+      plugins: [react(), tailwindcss()],
+      resolve: {
+        alias: {
+          "@p11-core/components/styles.css": componentStyles,
+          "@p11-core/components": componentEntry,
+          "@recogito/text-annotator/text-annotator.css": textAnnotatorStyles,
+          "@recogito/text-annotator": textAnnotatorEntry,
+          "react/jsx-runtime": nodeRequire.resolve("react/jsx-runtime"),
+          "react/jsx-dev-runtime": nodeRequire.resolve("react/jsx-dev-runtime"),
+          "react-dom/client": nodeRequire.resolve("react-dom/client"),
+          "react-dom": nodeRequire.resolve("react-dom"),
+          react: nodeRequire.resolve("react")
+        },
+        dedupe: ["react", "react-dom"]
       },
-      dedupe: ["react", "react-dom"]
-    },
-    build: {
-      outDir: path.relative(tempDir, outDir),
-      emptyOutDir: true,
-      assetsDir: "assets"
-    }
-  });
+      build: {
+        outDir: path.relative(tempDir, outDir),
+        emptyOutDir: true,
+        assetsDir: "assets",
+        rollupOptions: {
+          input: {
+            index: "index.html"
+          }
+        }
+      }
+    });
+  } finally {
+    process.chdir(previousCwd);
+  }
   await writeFile(path.join(outDir, P11_MANIFEST_FILE), JSON.stringify({ runtimeVersion: P11_RUNTIME_VERSION }, null, 2));
 }
+function resolveBuildParentDir(buildDir) {
+  return path.resolve(buildDir || process.env.P11_BUILD_DIR || tmpdir());
+}
 function validatePageSource(code, inputFile = "page.tsx") {
   validatePageAst(parsePageSource(code), inputFile);
 }
@@ -4399,12 +4431,12 @@ function validateAccessTarget(target, expected) {
 function normalizeApiUrl(value) {
   return value.endsWith("/") ? value.slice(0, -1) : value;
 }
-async function warnIfUpdateAvailable() {
+async function warnIfUpdateAvailable(options = {}) {
   if (process.env.P11_DISABLE_UPDATE_CHECK) return;
   try {
     const cachePath = updateCheckCachePath();
     const checkedAt = await readUpdateCheckTime(cachePath);
-    if (checkedAt && Date.now() - checkedAt.getTime() < updateCheckIntervalMs) return;
+    if (!options.force && checkedAt && Date.now() - checkedAt.getTime() < updateCheckIntervalMs) return;
     await writeUpdateCheckTime(cachePath);
     const latestVersion = await fetchLatestVersion();
     if (!latestVersion || !isNewerVersion(latestVersion, packageJson.version)) return;
@@ -4480,5 +4512,6 @@ export {
   parseEditId,
   parseReadId,
   readHistoryEntries,
+  resolveBuildParentDir,
   validatePageSource
 };

package/docs/sharing.md

@@ -35,5 +35,6 @@ p11 delete <editUrl|editId>
 Add `--json` when scripting or when exact structured fields are needed.
 
 `P11_API_URL` overrides the default API URL. `--api-url <url>` can override it per command.
+Temporary share builds are created under the OS temp directory by default. Use `P11_BUILD_DIR` or `--build-dir <dir>` only when you need to inspect or redirect the transient build workspace.
 
 Edit URLs are bearer credentials for updating or deleting a document. Keep them private.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p11-core/cli",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "license": "UNLICENSED",
   "type": "module",
   "bin": {