@mastra/pg 1.22.3-alpha.3 → 1.22.3

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-pg
 description: Documentation for @mastra/pg. Use when working with @mastra/pg APIs, configuration, or implementation.
 metadata:
   package: "@mastra/pg"
-  version: "1.22.3-alpha.3"
+  version: "1.22.3"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.22.3-alpha.3",
+  "version": "1.22.3",
   "package": "@mastra/pg",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-deployment-workers.md

@@ -39,6 +39,12 @@ Polls storage for due cron schedules and publishes `workflow.start` events. It's
 
 The scheduler reads declarative `schedule` fields from your workflow definitions automatically. See [Scheduled workflows](https://mastra.ai/docs/workflows/scheduled-workflows) for how to declare schedules.
 
+The scheduler only polls storage once a schedule exists. At boot, a process with no declared schedules runs a single `listSchedules()` check. If that check finds no rows, the poll loop never starts, so idle deployments issue no recurring scheduler queries and can scale to zero.
+
+When a schedule is created at runtime, Mastra publishes a wake event on the PubSub backend. Any process running the default worker set starts its scheduler in response, which is how a standalone worker discovers schedules created by the API process. This requires both processes to share the same PubSub backend.
+
+To poll from startup regardless of whether schedules exist (for example, when your processes don't share a PubSub backend), set `scheduler: { enabled: true }` on the worker or run it with `MASTRA_WORKERS=scheduler`.
+
 **Don't run more than one scheduler instance.** Multiple schedulers polling the same storage would fire duplicate events for the same schedule.
 
 ### Background task worker

package/dist/index.cjs

@@ -14073,6 +14073,11 @@ const FEEDBACK_EVENT_COLUMNS = [
 		type: "text",
 		nullable: true
 	},
+	{
+		name: "reviewStatus",
+		type: "text",
+		defaultSql: "'needs-review'"
+	},
 	...COMMON_CONTEXT_COLUMNS,
 	{
 		name: "tags",
@@ -14513,6 +14518,10 @@ function additiveColumns(schema) {
 		table: TABLE_SPAN_EVENTS,
 		column: "isPending",
 		ddl: `ALTER TABLE ${qualifiedTable(schema, TABLE_SPAN_EVENTS)} ADD COLUMN IF NOT EXISTS "isPending" boolean NOT NULL DEFAULT false`
+	}, {
+		table: TABLE_FEEDBACK_EVENTS,
+		column: "reviewStatus",
+		ddl: `ALTER TABLE ${qualifiedTable(schema, TABLE_FEEDBACK_EVENTS)} ADD COLUMN IF NOT EXISTS "reviewStatus" text NOT NULL DEFAULT 'needs-review'`
 	}];
 }
 /** Existence probe for an additive column. Params: schema, table, column. */
@@ -14835,6 +14844,31 @@ function whereOrEmpty(acc) {
 	return acc.conditions.length ? `WHERE ${acc.conditions.join(" AND ")}` : "";
 }
 //#endregion
+//#region src/storage/domains/observability/v-next/review-status.ts
+const FEEDBACK_REVIEW_STATUSES = ["needs-review", "reviewed"];
+function isFeedbackReviewStatus(value) {
+	return FEEDBACK_REVIEW_STATUSES.some((status) => status === value);
+}
+/** Normalize a stored value to a review status, defaulting legacy/unknown values to `needs-review`. */
+function coerceFeedbackReviewStatus(value) {
+	return isFeedbackReviewStatus(value) ? value : "needs-review";
+}
+function parseUpdateFeedbackReviewStatusArgs(args) {
+	const invalid = (text) => new _mastra_core_error.MastraError({
+		id: "OBSERVABILITY_UPDATE_FEEDBACK_REVIEW_STATUS_INVALID_ARGS",
+		domain: _mastra_core_error.ErrorDomain.STORAGE,
+		category: _mastra_core_error.ErrorCategory.USER,
+		text
+	});
+	if (typeof args !== "object" || args === null) throw invalid("args must be an object");
+	if (typeof args.feedbackId !== "string" || args.feedbackId.length === 0) throw invalid("feedbackId is required");
+	if (!isFeedbackReviewStatus(args.reviewStatus)) throw invalid(`reviewStatus must be one of: ${FEEDBACK_REVIEW_STATUSES.join(", ")}`);
+	return {
+		feedbackId: args.feedbackId,
+		reviewStatus: args.reviewStatus
+	};
+}
+//#endregion
 //#region src/storage/domains/observability/v-next/helpers.ts
 const PROMOTED_KEYS = /* @__PURE__ */ new Set([
 	"experimentId",
@@ -15199,6 +15233,7 @@ function feedbackRecordToRow(feedback) {
 		spanId: feedback.spanId ?? null,
 		feedbackUserId: feedback.feedbackUserId ?? null,
 		sourceId: feedback.sourceId ?? null,
+		reviewStatus: feedback.reviewStatus ?? "needs-review",
 		feedbackSource,
 		feedbackType: feedback.feedbackType,
 		valueString: typeof feedback.value === "string" ? feedback.value : null,
@@ -15220,6 +15255,7 @@ function rowToFeedbackRecord(row) {
 		spanId: nullableString(row.spanId),
 		feedbackUserId: nullableString(row.feedbackUserId),
 		sourceId: nullableString(row.sourceId),
+		reviewStatus: coerceFeedbackReviewStatus(row.reviewStatus),
 		feedbackSource,
 		feedbackType: row.feedbackType,
 		value: hasNumber ? Number(row.valueNumber) : nullableString(row.valueString) ?? "",
@@ -15739,6 +15775,10 @@ function applyFeedbackFilters(acc, filters) {
 		acc.conditions.push(`"feedbackUserId" = $${acc.next++}`);
 		acc.params.push(filters.feedbackUserId);
 	}
+	if (filters?.reviewStatus) {
+		acc.conditions.push(`"reviewStatus" = $${acc.next++}`);
+		acc.params.push(filters.reviewStatus);
+	}
 }
 /**
 * OLAP queries take an explicit feedbackType / feedbackSource pair as
@@ -15762,6 +15802,21 @@ async function batchCreateFeedback(client, schema, args) {
 	const insert = buildInsert(schema, TABLE_FEEDBACK_EVENTS, args.feedbacks.map(feedbackRecordToRow));
 	if (insert) await client.query(insert.text, insert.values);
 }
+async function updateFeedbackReviewStatus(client, schema, args) {
+	const { feedbackId, reviewStatus } = parseUpdateFeedbackReviewStatusArgs(args);
+	const row = await client.oneOrNone(`UPDATE ${qualifiedTable(schema, TABLE_FEEDBACK_EVENTS)}
+     SET "reviewStatus" = $2
+     WHERE "feedbackId" = $1
+     RETURNING ${FEEDBACK_SELECT_COLUMNS}`, [feedbackId, reviewStatus]);
+	if (!row) throw new _mastra_core_error.MastraError({
+		id: "OBSERVABILITY_UPDATE_FEEDBACK_REVIEW_STATUS_NOT_FOUND",
+		domain: _mastra_core_error.ErrorDomain.MASTRA_OBSERVABILITY,
+		category: _mastra_core_error.ErrorCategory.USER,
+		text: "Feedback record not found",
+		details: { feedbackId }
+	});
+	return rowToFeedbackRecord(row);
+}
 async function listFeedback(client, schema, args) {
 	const { mode, filters, pagination, orderBy, after, limit } = _mastra_core_storage.listFeedbackArgsSchema.parse(args);
 	const table = qualifiedTable(schema, TABLE_FEEDBACK_EVENTS);
@@ -17625,6 +17680,9 @@ var ObservabilityStoragePostgresVNext = class ObservabilityStoragePostgresVNext
 	async listFeedback(args) {
 		return this.#run("LIST_FEEDBACK", () => listFeedback(this.#client, this.#schema, args));
 	}
+	async updateFeedbackReviewStatus(args) {
+		return this.#run("UPDATE_FEEDBACK_REVIEW_STATUS", () => updateFeedbackReviewStatus(this.#client, this.#schema, args), { feedbackId: args.feedbackId });
+	}
 	async getMetricAggregate(args) {
 		return this.#run("GET_METRIC_AGGREGATE", () => getMetricAggregate(this.#client, this.#schema, args));
 	}