@mastra/pg 1.9.3 → 1.9.4-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @mastra/pg
 
+## 1.9.4-alpha.1
+
+### Patch Changes
+
+- Added platform channels framework with ChannelProvider interface, ChannelsStorage domain, and ChannelConnectResult discriminated union supporting OAuth, deep link, and immediate connection flows. Channels can be registered on the Mastra instance and expose connect/disconnect/list APIs for platform integrations. ([#15876](https://github.com/mastra-ai/mastra/pull/15876))
+
+- Updated dependencies [[`b2deb29`](https://github.com/mastra-ai/mastra/commit/b2deb29412b300c868655b5840463614fbb7962d), [`66644be`](https://github.com/mastra-ai/mastra/commit/66644beac1aa560f0e417956ff007c89341dc382), [`310b953`](https://github.com/mastra-ai/mastra/commit/310b95345f302dcd5ba3ed862bdc96f059d44122), [`43f0e1d`](https://github.com/mastra-ai/mastra/commit/43f0e1d5d5a74ba6fc746f2ad89ebe0c64777a7d), [`da0b9e2`](https://github.com/mastra-ai/mastra/commit/da0b9e2ba7ecc560213b426d6c097fe63946086e)]:
+  - @mastra/core@1.31.0-alpha.3
+
+## 1.9.4-alpha.0
+
+### Patch Changes
+
+- Fixed workflow snapshot sanitization in `@mastra/pg` for strings containing escaped surrogate patterns like `[^\ud800-\udfff]`. This prevents invalid JSON escape sequences that caused PostgreSQL `jsonb` writes to fail with error `22P02`. ([#15923](https://github.com/mastra-ai/mastra/pull/15923))
+
+  Fixes #15920
+
+- Updated dependencies [[`e109607`](https://github.com/mastra-ai/mastra/commit/e10960749251e34d46b480a20648c490fd30381b)]:
+  - @mastra/core@1.31.0-alpha.1
+
 ## 1.9.3
 
 ### Patch Changes

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.9.3"
+  version: "1.9.4-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

package/dist/index.cjs

@@ -4658,6 +4658,202 @@ var BlobsPG = class extends storage.BlobStore {
     };
   }
 };
+var ChannelsPG = class _ChannelsPG extends storage.ChannelsStorage {
+  #db;
+  #schema;
+  #skipDefaultIndexes;
+  #indexes;
+  static MANAGED_TABLES = [storage.TABLE_CHANNEL_INSTALLATIONS, storage.TABLE_CHANNEL_CONFIG];
+  constructor(config) {
+    super();
+    const { client, schemaName, skipDefaultIndexes, indexes } = resolvePgConfig(config);
+    this.#db = new PgDB({ client, schemaName, skipDefaultIndexes });
+    this.#schema = schemaName || "public";
+    this.#skipDefaultIndexes = skipDefaultIndexes;
+    this.#indexes = indexes?.filter((idx) => _ChannelsPG.MANAGED_TABLES.includes(idx.table));
+  }
+  async init() {
+    await this.#db.createTable({
+      tableName: storage.TABLE_CHANNEL_INSTALLATIONS,
+      schema: storage.TABLE_SCHEMAS[storage.TABLE_CHANNEL_INSTALLATIONS]
+    });
+    await this.#db.createTable({
+      tableName: storage.TABLE_CHANNEL_CONFIG,
+      schema: storage.TABLE_SCHEMAS[storage.TABLE_CHANNEL_CONFIG]
+    });
+    await this.createDefaultIndexes();
+    await this.createCustomIndexes();
+  }
+  static getDefaultIndexDefs(schemaPrefix) {
+    return [
+      {
+        name: `${schemaPrefix}idx_channel_installations_webhook`,
+        table: storage.TABLE_CHANNEL_INSTALLATIONS,
+        columns: ["webhookId"],
+        unique: true
+      },
+      {
+        name: `${schemaPrefix}idx_channel_installations_platform_agent`,
+        table: storage.TABLE_CHANNEL_INSTALLATIONS,
+        columns: ["platform", "agentId"]
+      }
+    ];
+  }
+  static getExportDDL(schemaName) {
+    const statements = [];
+    const parsedSchema = schemaName ? utils.parseSqlIdentifier(schemaName, "schema name") : "";
+    const schemaPrefix = parsedSchema && parsedSchema !== "public" ? `${parsedSchema}_` : "";
+    for (const tableName of _ChannelsPG.MANAGED_TABLES) {
+      statements.push(
+        generateTableSQL({
+          tableName,
+          schema: storage.TABLE_SCHEMAS[tableName],
+          schemaName,
+          includeAllConstraints: true
+        })
+      );
+    }
+    for (const idx of _ChannelsPG.getDefaultIndexDefs(schemaPrefix)) {
+      statements.push(generateIndexSQL(idx, schemaName));
+    }
+    return statements;
+  }
+  getDefaultIndexDefinitions() {
+    const schemaPrefix = this.#schema !== "public" ? `${this.#schema}_` : "";
+    return _ChannelsPG.getDefaultIndexDefs(schemaPrefix);
+  }
+  async createDefaultIndexes() {
+    if (this.#skipDefaultIndexes) return;
+    for (const indexDef of this.getDefaultIndexDefinitions()) {
+      try {
+        await this.#db.createIndex(indexDef);
+      } catch (error) {
+        this.logger?.warn?.(`Failed to create index ${indexDef.name}:`, error);
+      }
+    }
+  }
+  async createCustomIndexes() {
+    if (!this.#indexes || this.#indexes.length === 0) return;
+    for (const indexDef of this.#indexes) {
+      try {
+        await this.#db.createIndex(indexDef);
+      } catch (error) {
+        this.logger?.warn?.(`Failed to create custom index ${indexDef.name}:`, error);
+      }
+    }
+  }
+  async dangerouslyClearAll() {
+    await this.#db.clearTable({ tableName: storage.TABLE_CHANNEL_INSTALLATIONS });
+    await this.#db.clearTable({ tableName: storage.TABLE_CHANNEL_CONFIG });
+  }
+  async saveInstallation(installation) {
+    const schemaName = getSchemaName2(this.#schema);
+    const tableName = getTableName2({ indexName: storage.TABLE_CHANNEL_INSTALLATIONS, schemaName });
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    await this.#db.client.none(
+      `INSERT INTO ${tableName} ("id", "platform", "agentId", "status", "webhookId", "data", "configHash", "error", "createdAt", "updatedAt")
+       VALUES ($1, $2, $3, $4, $5, $6::jsonb, $7, $8, $9, $10)
+       ON CONFLICT ("id") DO UPDATE SET
+         "platform" = EXCLUDED."platform",
+         "agentId" = EXCLUDED."agentId",
+         "status" = EXCLUDED."status",
+         "webhookId" = EXCLUDED."webhookId",
+         "data" = EXCLUDED."data",
+         "configHash" = EXCLUDED."configHash",
+         "error" = EXCLUDED."error",
+         "updatedAt" = EXCLUDED."updatedAt"`,
+      [
+        installation.id,
+        installation.platform,
+        installation.agentId,
+        installation.status,
+        installation.webhookId ?? null,
+        JSON.stringify(installation.data),
+        installation.configHash ?? null,
+        installation.error ?? null,
+        installation.createdAt?.toISOString() ?? now,
+        now
+      ]
+    );
+  }
+  async getInstallation(id) {
+    const schemaName = getSchemaName2(this.#schema);
+    const tableName = getTableName2({ indexName: storage.TABLE_CHANNEL_INSTALLATIONS, schemaName });
+    const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "id" = $1`, [id]);
+    return row ? this.#parseInstallationRow(row) : null;
+  }
+  async getInstallationByAgent(platform, agentId) {
+    const schemaName = getSchemaName2(this.#schema);
+    const tableName = getTableName2({ indexName: storage.TABLE_CHANNEL_INSTALLATIONS, schemaName });
+    const row = await this.#db.client.oneOrNone(
+      `SELECT * FROM ${tableName} WHERE "platform" = $1 AND "agentId" = $2 ORDER BY CASE "status" WHEN 'active' THEN 0 WHEN 'pending' THEN 1 ELSE 2 END, "updatedAt" DESC LIMIT 1`,
+      [platform, agentId]
+    );
+    return row ? this.#parseInstallationRow(row) : null;
+  }
+  async getInstallationByWebhookId(webhookId) {
+    const schemaName = getSchemaName2(this.#schema);
+    const tableName = getTableName2({ indexName: storage.TABLE_CHANNEL_INSTALLATIONS, schemaName });
+    const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "webhookId" = $1`, [webhookId]);
+    return row ? this.#parseInstallationRow(row) : null;
+  }
+  async listInstallations(platform) {
+    const schemaName = getSchemaName2(this.#schema);
+    const tableName = getTableName2({ indexName: storage.TABLE_CHANNEL_INSTALLATIONS, schemaName });
+    const rows = await this.#db.client.manyOrNone(
+      `SELECT * FROM ${tableName} WHERE "platform" = $1 ORDER BY "createdAt" DESC`,
+      [platform]
+    );
+    return rows.map((row) => this.#parseInstallationRow(row));
+  }
+  async deleteInstallation(id) {
+    const schemaName = getSchemaName2(this.#schema);
+    const tableName = getTableName2({ indexName: storage.TABLE_CHANNEL_INSTALLATIONS, schemaName });
+    await this.#db.client.none(`DELETE FROM ${tableName} WHERE "id" = $1`, [id]);
+  }
+  async saveConfig(config) {
+    const schemaName = getSchemaName2(this.#schema);
+    const tableName = getTableName2({ indexName: storage.TABLE_CHANNEL_CONFIG, schemaName });
+    await this.#db.client.none(
+      `INSERT INTO ${tableName} ("platform", "data", "updatedAt")
+       VALUES ($1, $2::jsonb, $3)
+       ON CONFLICT ("platform") DO UPDATE SET
+         "data" = EXCLUDED."data",
+         "updatedAt" = EXCLUDED."updatedAt"`,
+      [config.platform, JSON.stringify(config.data), config.updatedAt.toISOString()]
+    );
+  }
+  async getConfig(platform) {
+    const schemaName = getSchemaName2(this.#schema);
+    const tableName = getTableName2({ indexName: storage.TABLE_CHANNEL_CONFIG, schemaName });
+    const row = await this.#db.client.oneOrNone(`SELECT * FROM ${tableName} WHERE "platform" = $1`, [platform]);
+    if (!row) return null;
+    return {
+      platform: row.platform,
+      data: typeof row.data === "string" ? JSON.parse(row.data) : row.data,
+      updatedAt: new Date(row.updatedAt)
+    };
+  }
+  async deleteConfig(platform) {
+    const schemaName = getSchemaName2(this.#schema);
+    const tableName = getTableName2({ indexName: storage.TABLE_CHANNEL_CONFIG, schemaName });
+    await this.#db.client.none(`DELETE FROM ${tableName} WHERE "platform" = $1`, [platform]);
+  }
+  #parseInstallationRow(row) {
+    return {
+      id: row.id,
+      platform: row.platform,
+      agentId: row.agentId,
+      status: row.status,
+      webhookId: row.webhookId || void 0,
+      data: typeof row.data === "string" ? JSON.parse(row.data) : row.data,
+      configHash: row.configHash || void 0,
+      error: row.error || void 0,
+      createdAt: row.createdAt instanceof Date ? row.createdAt : new Date(row.createdAt),
+      updatedAt: row.updatedAt instanceof Date ? row.updatedAt : new Date(row.updatedAt)
+    };
+  }
+};
 function jsonbArg(value) {
   return value === void 0 || value === null ? null : JSON.stringify(value);
 }
@@ -12930,7 +13126,7 @@ function getTableName6({ indexName, schemaName }) {
   return schemaName ? `${schemaName}.${quotedIndexName}` : quotedIndexName;
 }
 function sanitizeJsonForPg(jsonString) {
-  return jsonString.replace(/(^|[^\\])(\\(?!["\\/bfnrtu]))/g, "$1\\\\").replace(/\\u(0000|[Dd][89A-Fa-f][0-9A-Fa-f]{2})/g, "");
+  return jsonString.replace(/\\\\?u(0000|[Dd][89A-Fa-f][0-9A-Fa-f]{2})/g, "").replace(/(^|[^\\])(\\(?!["\\/bfnrtu]))/g, "$1\\\\");
 }
 var WorkflowsPG = class _WorkflowsPG extends storage.WorkflowsStorage {
   #db;
@@ -14034,7 +14230,8 @@ var ALL_DOMAINS = [
   WorkflowsPG,
   DatasetsPG,
   ExperimentsPG,
-  BackgroundTasksPG
+  BackgroundTasksPG,
+  ChannelsPG
 ];
 function exportSchemas(schemaName) {
   const statements = [];
@@ -14089,7 +14286,8 @@ var PostgresStore = class extends storage.MastraCompositeStore {
         blobs: new BlobsPG(domainConfig),
         datasets: new DatasetsPG(domainConfig),
         experiments: new ExperimentsPG(domainConfig),
-        backgroundTasks: new BackgroundTasksPG(domainConfig)
+        backgroundTasks: new BackgroundTasksPG(domainConfig),
+        channels: new ChannelsPG(domainConfig)
       };
     } catch (e) {
       throw new error.MastraError(
@@ -14281,6 +14479,7 @@ Example Complex Query:
 exports.AgentsPG = AgentsPG;
 exports.BackgroundTasksPG = BackgroundTasksPG;
 exports.BlobsPG = BlobsPG;
+exports.ChannelsPG = ChannelsPG;
 exports.DatasetsPG = DatasetsPG;
 exports.ExperimentsPG = ExperimentsPG;
 exports.MCPClientsPG = MCPClientsPG;