{"record":{"id":"0fa950a659e36af1","repo":"paperclipai/paperclip","slug":"ctx-db-query-cannot-contain-mutation-or-ddl-keywor","errorCode":null,"errorMessage":"ctx.db.query cannot contain mutation or DDL keywords","messagePattern":"ctx\\.db\\.query cannot contain mutation or DDL keywords","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"server/src/services/plugin-database.ts","lineNumber":262,"sourceCode":"}\n\nexport function validatePluginRuntimeQuery(\n  query: string,\n  namespace: string,\n  coreReadTables: readonly PluginDatabaseCoreReadTable[] = [],\n): void {\n  const statements = splitSqlStatements(query);\n  if (statements.length !== 1) {\n    throw new Error(\"Plugin runtime SQL must contain exactly one statement\");\n  }\n  const statement = statements[0]!;\n  assertNoBannedSql(statement);\n  const normalized = normaliseSql(statement);\n  if (!normalized.startsWith(\"select \") && !normalized.startsWith(\"with \")) {\n    throw new Error(\"ctx.db.query only allows SELECT statements\");\n  }\n  if (/\\b(insert|update|delete|alter|create|drop|truncate)\\b/.test(normalized)) {\n    throw new Error(\"ctx.db.query cannot contain mutation or DDL keywords\");\n  }\n\n  const allowedCoreReadTables = new Set(coreReadTables);\n  for (const ref of extractQualifiedRefs(statement)) {\n    if (ref.schema === namespace) continue;\n    if (ref.schema === \"public\") {\n      assertAllowedPublicRead(ref, allowedCoreReadTables);\n      continue;\n    }\n    throw new Error(`ctx.db.query cannot read schema \"${ref.schema}\"`);\n  }\n}\n\nexport function validatePluginRuntimeExecute(query: string, namespace: string): void {\n  const statements = splitSqlStatements(query);\n  if (statements.length !== 1) {\n    throw new Error(\"Plugin runtime SQL must contain exactly one statement\");\n  }","sourceCodeStart":244,"sourceCodeEnd":280,"githubUrl":"https://github.com/paperclipai/paperclip/blob/120ae5428fa29bee300bcf806491cd4d965fbb7c/server/src/services/plugin-database.ts#L244-L280","documentation":"Keyword ban inside runtime SELECT: even statements that start with select/with are rejected if they contain insert/update/delete/alter/create/drop/truncate anywhere (e.g. inside CTEs). Defense in depth ensuring ctx.db.query can never mutate; the smuggled keyword query is at fault.","triggerScenarios":"Thrown at server/src/services/plugin-database.ts:262 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Remove mutation or DDL keywords from the ctx.db.query SQL; use SELECT only."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"120ae5428fa29bee300bcf806491cd4d965fbb7c","analyzedAt":"2026-08-18T22:49:45.177Z","contentChangedAt":"2026-08-18T22:49:45.177Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}