@justram/pie 0.2.5 → 0.2.6

package/CHANGELOG.md

@@ -12,6 +12,21 @@
 
 ### Removed
 
+## 0.2.6
+
+### Breaking Changes
+
+### Added
+
+- Added SDK helper utilities for checking updates and formatting update notifications.
+- Added CLI update notification that checks npm registry for newer versions.
+
+### Changed
+
+### Fixed
+
+### Removed
+
 ## 0.2.5
 
 ### Breaking Changes

package/dist/index.d.ts

@@ -12,3 +12,4 @@ export { loadRecipeSetup, loadRecipes, resolveRecipe, } from "./recipes/index.js
 export type { ExtractionSetup, LoadExtractionSetupOptions } from "./setup.js";
 export { loadExtractionSetup } from "./setup.js";
 export type { ExtractOptions, ExtractResult, ExtractStream, ThinkingBudgets, ThinkingLevel, Usage } from "./types.js";
+export { checkForUpdates, formatUpdateNotification, type UpdateInfo } from "./update.js";

package/dist/index.js

@@ -7,3 +7,4 @@ export { extract, extractSync } from "./extract.js";
 export { getModel, getModels, getProviders } from "./models.js";
 export { loadRecipeSetup, loadRecipes, resolveRecipe, } from "./recipes/index.js";
 export { loadExtractionSetup } from "./setup.js";
+export { checkForUpdates, formatUpdateNotification } from "./update.js";

package/dist/main.js

@@ -11,6 +11,7 @@ import { loadExtractionSetupFromContent } from "./core/setup.js";
 import { extract } from "./extract.js";
 import { getModels, getProviders } from "./models.js";
 import { loadRecipeSetup, loadRecipes } from "./recipes/index.js";
+import { checkForUpdates, formatUpdateNotification, getVersion } from "./update.js";
 const MODEL_PROVIDER_PREFERENCE = ["anthropic", "openai", "google"];
 class CliExitError extends Error {
     exitCode;
@@ -121,6 +122,7 @@ async function runCliInternal(argv, deps, stdout, stderr) {
         }
         return 0;
     }
+    startVersionCheck(stderr);
     const promptInput = args.promptFile ? readTextFile(args.promptFile, "prompt") : args.prompt;
     const promptPath = args.promptFile ? resolve(args.promptFile) : undefined;
     const promptIsSetup = !args.config && !useRecipe && typeof promptInput === "string" && promptInput.startsWith("---");
@@ -591,11 +593,14 @@ function mapExtractionExitCode(error) {
 function writeLine(stream, message) {
     stream.write(`${message}\n`);
 }
-function getVersion() {
-    const pkgPath = new URL("../package.json", import.meta.url);
-    const raw = readFileSync(pkgPath, "utf8");
-    const pkg = JSON.parse(raw);
-    return pkg.version ?? "0.0.0";
+function startVersionCheck(stderr) {
+    void checkForUpdates().then((info) => {
+        if (!info)
+            return;
+        for (const line of formatUpdateNotification(info)) {
+            writeLine(stderr, line);
+        }
+    });
 }
 async function readStream(stream) {
     return await new Promise((resolveStream, reject) => {

package/dist/update.d.ts

@@ -0,0 +1,10 @@
+export interface UpdateInfo {
+    packageName: string;
+    currentVersion: string;
+    latestVersion: string;
+}
+export declare function getVersion(): string;
+export declare function checkForUpdates(options?: {
+    skipEnv?: boolean;
+}): Promise<UpdateInfo | undefined>;
+export declare function formatUpdateNotification(info: UpdateInfo): string[];

package/dist/update.js

@@ -0,0 +1,42 @@
+import { readFileSync } from "node:fs";
+function getPackageInfo() {
+    const pkgPath = new URL("../package.json", import.meta.url);
+    const raw = readFileSync(pkgPath, "utf8");
+    const pkg = JSON.parse(raw);
+    return {
+        name: pkg.name ?? "pie",
+        version: pkg.version ?? "0.0.0",
+    };
+}
+export function getVersion() {
+    return getPackageInfo().version;
+}
+export async function checkForUpdates(options = {}) {
+    if (!options.skipEnv && process.env.PI_SKIP_VERSION_CHECK)
+        return undefined;
+    const { name, version } = getPackageInfo();
+    try {
+        const response = await fetch(`https://registry.npmjs.org/${name}/latest`);
+        if (!response.ok)
+            return undefined;
+        const data = (await response.json());
+        const latestVersion = data.version;
+        if (latestVersion && latestVersion !== version) {
+            return {
+                packageName: name,
+                currentVersion: version,
+                latestVersion,
+            };
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function formatUpdateNotification(info) {
+    return [
+        `Update available for ${info.packageName}: v${info.latestVersion} (current v${info.currentVersion}). Run: npm install -g ${info.packageName}`,
+        "Changelog: https://github.com/justram/pie/blob/main/CHANGELOG.md",
+    ];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@justram/pie",
-	"version": "0.2.5",
+	"version": "0.2.6",
 	"description": "Structured extraction library and CLI built on @mariozechner/pi-ai.",
 	"homepage": "https://github.com/justram/pie#readme",
 	"repository": {