@posthog/ai 8.12.1 → 8.13.1

package/dist/index.d.ts

@@ -154,6 +154,9 @@ type PromptsOptions = PromptsWithPostHogOptions | PromptsDirectOptions;
  * // Or fetch all prompts at a label in one request and warm the cache
  * const prodPrompts = await prompts.getAll({ label: 'production' })
  *
+ * // Or fetch the latest version of every prompt in one request
+ * const allPrompts = await prompts.getAll()
+ *
  * // Compile with variables
  * const systemPrompt = prompts.compile(result.prompt, {
  *   company: 'Acme Corp',
@@ -181,26 +184,28 @@ declare class Prompts {
    */
   get(name: string, options?: GetPromptOptions): Promise<PromptResult>;
   /**
-   * Fetch every prompt that carries a label, in one batch.
+   * Fetch every prompt in one batch.
    *
-   * Returns an object mapping prompt name to `PromptRemoteResult`, with each
-   * prompt at the version the label points to. Prompts without the label are
-   * not included.
+   * Returns an object mapping prompt name to `PromptRemoteResult`. With a
+   * label, each prompt is at the version the label points to, and prompts
+   * without the label are not included. Without a label, every prompt is
+   * included at its latest version, matching what `get(name)` returns.
    *
    * Each fetched prompt is stored in the cache, so later
-   * `get(name, { label })` calls are served from cache within the TTL. An app
-   * with many prompts can call this once per cache cycle instead of making one
-   * `get()` request per prompt.
+   * `get(name, { label })` (or plain `get(name)`) calls are served from cache
+   * within the TTL. An app with many prompts can call this once per cache
+   * cycle instead of making one `get()` request per prompt.
    *
    * Unlike `get()`, there is no `fallback` option, so callers should handle
    * the error themselves.
    *
    * @throws {Error} When the request fails, when the response is malformed,
-   * or when the server does not support fetching prompts by label on the list
-   * endpoint (PostHog releases from before September 2026).
+   * or when a label was passed and the server does not support fetching
+   * prompts by label on the list endpoint (PostHog releases from before
+   * September 2026).
    */
-  getAll(options: {
-    label: string;
+  getAll(options?: {
+    label?: string;
   }): Promise<Record<string, PromptRemoteResult>>;
   /**
    * Internal method that handles cache + fetch logic, returning full metadata.
@@ -228,7 +233,12 @@ declare class Prompts {
   clearCache(name?: string, version?: number): void;
   private requireCredentials;
   /**
-   * Fetch all prompts at a label from the paginated list endpoint.
+   * Fetch all prompts from the paginated list endpoint.
+   *
+   * Without a label the endpoint serves the latest version of every prompt;
+   * the param is then omitted entirely, since the server treats any value as
+   * a label name to filter by.
+   *
    * Follows pagination links until the last page and returns the raw rows.
    */
   private fetchPromptListFromApi;

package/dist/index.mjs

@@ -395,7 +395,7 @@ function sanitizeValues(obj) {
 }
 //#endregion
 //#region package.json
-var version = "8.12.1";
+var version = "8.13.1";
 //#endregion
 //#region src/serializeError.ts
 const DEFAULT_MAX_DEPTH = 3;
@@ -1132,6 +1132,10 @@ function isSameOrigin(url, host) {
 		return false;
 	}
 }
+/** Formats a batch-fetch reference for logs and errors. */
+function promptListReference(label) {
+	return label === void 0 ? "all prompts" : `prompts with label "${label}"`;
+}
 /**
 * Classify how a list row relates to the requested label, via its all_labels
 * field.
@@ -1187,6 +1191,9 @@ function isPromptsWithPostHog(options) {
 * // Or fetch all prompts at a label in one request and warm the cache
 * const prodPrompts = await prompts.getAll({ label: 'production' })
 *
+* // Or fetch the latest version of every prompt in one request
+* const allPrompts = await prompts.getAll()
+*
 * // Compile with variables
 * const systemPrompt = prompts.compile(result.prompt, {
 *   company: 'Acme Corp',
@@ -1253,31 +1260,38 @@ var Prompts = class {
 		}
 	}
 	/**
-	* Fetch every prompt that carries a label, in one batch.
+	* Fetch every prompt in one batch.
 	*
-	* Returns an object mapping prompt name to `PromptRemoteResult`, with each
-	* prompt at the version the label points to. Prompts without the label are
-	* not included.
+	* Returns an object mapping prompt name to `PromptRemoteResult`. With a
+	* label, each prompt is at the version the label points to, and prompts
+	* without the label are not included. Without a label, every prompt is
+	* included at its latest version, matching what `get(name)` returns.
 	*
 	* Each fetched prompt is stored in the cache, so later
-	* `get(name, { label })` calls are served from cache within the TTL. An app
-	* with many prompts can call this once per cache cycle instead of making one
-	* `get()` request per prompt.
+	* `get(name, { label })` (or plain `get(name)`) calls are served from cache
+	* within the TTL. An app with many prompts can call this once per cache
+	* cycle instead of making one `get()` request per prompt.
 	*
 	* Unlike `get()`, there is no `fallback` option, so callers should handle
 	* the error themselves.
 	*
 	* @throws {Error} When the request fails, when the response is malformed,
-	* or when the server does not support fetching prompts by label on the list
-	* endpoint (PostHog releases from before September 2026).
+	* or when a label was passed and the server does not support fetching
+	* prompts by label on the list endpoint (PostHog releases from before
+	* September 2026).
 	*/
 	async getAll(options) {
-		const label = options.label;
+		const label = options?.label;
 		const rows = await this.fetchPromptListFromApi(label);
+		const reference = promptListReference(label);
 		const resolvedRows = [];
 		const skipped = [];
 		for (const row of rows) {
-			if (!isPromptApiResponse(row)) throw new Error(`[PostHog Prompts] Invalid response format for prompts with label "${label}"`);
+			if (!isPromptApiResponse(row)) throw new Error(`[PostHog Prompts] Invalid response format for ${reference}`);
+			if (label === void 0) {
+				resolvedRows.push(row);
+				continue;
+			}
 			const labelState = rowLabelState(row, label);
 			if (labelState === "absent") throw new Error(`[PostHog Prompts] The server returned a prompt that does not carry label "${label}". It may not support fetching prompts by label on the list endpoint yet. Upgrade PostHog, or fetch prompts one by one with get().`);
 			if (labelState === "moved") {
@@ -1286,7 +1300,7 @@ var Prompts = class {
 			}
 			resolvedRows.push(row);
 		}
-		if (rows.length > 0 && resolvedRows.length === 0) throw new Error(`[PostHog Prompts] The server returned prompts, but none resolve label "${label}". It may not support fetching prompts by label on the list endpoint yet. Upgrade PostHog, or fetch prompts one by one with get().`);
+		if (label !== void 0 && rows.length > 0 && resolvedRows.length === 0) throw new Error(`[PostHog Prompts] The server returned prompts, but none resolve label "${label}". It may not support fetching prompts by label on the list endpoint yet. Upgrade PostHog, or fetch prompts one by one with get().`);
 		const now = Date.now();
 		const results = /* @__PURE__ */ new Map();
 		for (const row of resolvedRows) {
@@ -1406,14 +1420,20 @@ var Prompts = class {
 		if (!this.projectApiKey) throw new Error("[PostHog Prompts] projectApiKey is required to fetch prompts. Please provide it when initializing the Prompts instance.");
 	}
 	/**
-	* Fetch all prompts at a label from the paginated list endpoint.
+	* Fetch all prompts from the paginated list endpoint.
+	*
+	* Without a label the endpoint serves the latest version of every prompt;
+	* the param is then omitted entirely, since the server treats any value as
+	* a label name to filter by.
+	*
 	* Follows pagination links until the last page and returns the raw rows.
 	*/
 	async fetchPromptListFromApi(label) {
 		this.requireCredentials();
-		const query = `token=${encodeURIComponent(this.projectApiKey)}&label=${encodeURIComponent(label)}&content=full`;
+		const labelQuery = label === void 0 ? "" : `&label=${encodeURIComponent(label)}`;
+		const query = `token=${encodeURIComponent(this.projectApiKey)}${labelQuery}&content=full`;
 		let url = `${this.host}/api/environments/@current/llm_prompts/?${query}`;
-		const reference = `prompts with label "${label}"`;
+		const reference = promptListReference(label);
 		const rows = [];
 		let pages = 0;
 		while (url !== void 0) {