@neon/tools 2.14.4 → 2.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/README.md +195 -5
  2. package/dist/descriptions.gen.js +2 -2
  3. package/dist/effect.d.ts +22 -0
  4. package/dist/effect.d.ts.map +1 -0
  5. package/dist/effect.js +3 -0
  6. package/dist/generated/output.gen.d.ts +3418 -0
  7. package/dist/generated/output.gen.d.ts.map +1 -0
  8. package/dist/generated/output.gen.js +1498 -0
  9. package/dist/generated/zod.gen.d.ts +3 -3
  10. package/dist/index.d.ts +17 -5
  11. package/dist/index.d.ts.map +1 -1
  12. package/dist/index.js +30 -9
  13. package/dist/lib/custom/auth-config.d.ts +63 -2
  14. package/dist/lib/custom/auth-config.d.ts.map +1 -1
  15. package/dist/lib/custom/auth-config.js +34 -7
  16. package/dist/lib/custom/docs.d.ts +32 -2
  17. package/dist/lib/custom/docs.d.ts.map +1 -1
  18. package/dist/lib/custom/docs.js +18 -1
  19. package/dist/lib/custom/feedback.d.ts +7 -2
  20. package/dist/lib/custom/feedback.d.ts.map +1 -1
  21. package/dist/lib/custom/feedback.js +3 -0
  22. package/dist/lib/custom/fetch.d.ts +15 -1
  23. package/dist/lib/custom/fetch.d.ts.map +1 -1
  24. package/dist/lib/custom/fetch.js +10 -1
  25. package/dist/lib/custom/organizations.d.ts +23 -1
  26. package/dist/lib/custom/organizations.d.ts.map +1 -1
  27. package/dist/lib/custom/organizations.js +3 -0
  28. package/dist/lib/custom/resources.d.ts +15 -1
  29. package/dist/lib/custom/resources.d.ts.map +1 -1
  30. package/dist/lib/custom/resources.js +8 -1
  31. package/dist/lib/custom/sql/connection.d.ts +6 -7
  32. package/dist/lib/custom/sql/connection.d.ts.map +1 -1
  33. package/dist/lib/custom/sql/connection.js +10 -12
  34. package/dist/lib/custom/sql/describe-branch.d.ts +99 -1
  35. package/dist/lib/custom/sql/describe-branch.d.ts.map +1 -1
  36. package/dist/lib/custom/sql/describe-branch.js +11 -2
  37. package/dist/lib/custom/sql/inspect/inspect.d.ts +27 -1
  38. package/dist/lib/custom/sql/inspect/inspect.d.ts.map +1 -1
  39. package/dist/lib/custom/sql/inspect/inspect.js +17 -3
  40. package/dist/lib/custom/sql/migrations.d.ts +46 -2
  41. package/dist/lib/custom/sql/migrations.d.ts.map +1 -1
  42. package/dist/lib/custom/sql/migrations.js +29 -7
  43. package/dist/lib/custom/sql/query-tuning.d.ts +90 -2
  44. package/dist/lib/custom/sql/query-tuning.d.ts.map +1 -1
  45. package/dist/lib/custom/sql/query-tuning.js +31 -8
  46. package/dist/lib/custom/sql/run.d.ts +30 -3
  47. package/dist/lib/custom/sql/run.d.ts.map +1 -1
  48. package/dist/lib/custom/sql/run.js +15 -6
  49. package/dist/lib/custom/sql/schema.d.ts +76 -2
  50. package/dist/lib/custom/sql/schema.d.ts.map +1 -1
  51. package/dist/lib/custom/sql/schema.js +34 -5
  52. package/dist/lib/custom/sql/slow-queries.d.ts +15 -1
  53. package/dist/lib/custom/sql/slow-queries.d.ts.map +1 -1
  54. package/dist/lib/custom/sql/slow-queries.js +11 -3
  55. package/dist/lib/customize.d.ts +1 -1
  56. package/dist/lib/customize.d.ts.map +1 -1
  57. package/dist/lib/customize.js +8 -4
  58. package/dist/lib/effect/errors.d.ts +51 -0
  59. package/dist/lib/effect/errors.d.ts.map +1 -0
  60. package/dist/lib/effect/errors.js +37 -0
  61. package/dist/lib/effect/tools.d.ts +56 -0
  62. package/dist/lib/effect/tools.d.ts.map +1 -0
  63. package/dist/lib/effect/tools.js +67 -0
  64. package/dist/lib/ergonomic/bind.d.ts +25 -7
  65. package/dist/lib/ergonomic/bind.d.ts.map +1 -1
  66. package/dist/lib/ergonomic/bind.js +13 -3
  67. package/dist/lib/ergonomic/catalog.d.ts +5335 -180
  68. package/dist/lib/ergonomic/catalog.d.ts.map +1 -1
  69. package/dist/lib/ergonomic/catalog.js +286 -23
  70. package/dist/lib/ergonomic/composed.d.ts +866 -12
  71. package/dist/lib/ergonomic/composed.d.ts.map +1 -1
  72. package/dist/lib/ergonomic/composed.js +63 -0
  73. package/dist/lib/mcp-json-schema.d.ts +20 -0
  74. package/dist/lib/mcp-json-schema.d.ts.map +1 -1
  75. package/dist/lib/mcp-json-schema.js +89 -1
  76. package/dist/lib/mcp-register.d.ts +1 -1
  77. package/dist/lib/mcp-register.d.ts.map +1 -1
  78. package/dist/lib/mcp-register.js +2 -1
  79. package/dist/lib/operation.d.ts +56 -5
  80. package/dist/lib/operation.d.ts.map +1 -1
  81. package/dist/lib/operation.js +6 -1
  82. package/dist/lib/policy.d.ts +24 -0
  83. package/dist/lib/policy.d.ts.map +1 -0
  84. package/dist/lib/policy.js +49 -0
  85. package/dist/lib/redact.d.ts +8 -0
  86. package/dist/lib/redact.d.ts.map +1 -0
  87. package/dist/lib/redact.js +40 -0
  88. package/dist/mastra.d.ts +2 -1
  89. package/dist/mastra.d.ts.map +1 -1
  90. package/dist/mcp-v1.d.ts.map +1 -1
  91. package/dist/mcp-v1.js +3 -1
  92. package/dist/mcp.d.ts +3 -3
  93. package/dist/mcp.d.ts.map +1 -1
  94. package/dist/mcp.js +3 -3
  95. package/dist/operations.gen.d.ts +194 -194
  96. package/package.json +21 -2
@@ -0,0 +1,40 @@
1
+ // src/lib/redact.ts
2
+ const REDACTED_SECRET = "***redacted***";
3
+ const parsePath = (path) => {
4
+ if (!path.startsWith("$")) throw new TypeError(`Secret path must start with $: ${path}`);
5
+ const segments = [];
6
+ const pattern = /\.([a-zA-Z_][a-zA-Z0-9_]*)|\[\*\]/gy;
7
+ pattern.lastIndex = 1;
8
+ while (pattern.lastIndex < path.length) {
9
+ const match = pattern.exec(path);
10
+ if (match === null) throw new TypeError(`Unsupported secret path: ${path}`);
11
+ segments.push(match[1] === void 0 ? { each: true } : { key: match[1] });
12
+ }
13
+ return segments;
14
+ };
15
+ const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
16
+ const redactAt = (value, segments, path) => {
17
+ if (value === void 0 || value === null) return value;
18
+ const [head, ...rest] = segments;
19
+ if (head === void 0) {
20
+ if (typeof value !== "string") throw new TypeError(`Secret at ${path} is not a string`);
21
+ return value === "" ? value : REDACTED_SECRET;
22
+ }
23
+ if ("each" in head) {
24
+ if (!Array.isArray(value)) throw new TypeError(`Secret path ${path} expects an array`);
25
+ return value.map((item) => redactAt(item, rest, path));
26
+ }
27
+ if (!isRecord(value)) throw new TypeError(`Secret path ${path} expects an object`);
28
+ if (!(head.key in value)) return value;
29
+ return {
30
+ ...value,
31
+ [head.key]: redactAt(value[head.key], rest, path)
32
+ };
33
+ };
34
+ /**
35
+ * Replaces every non-empty string at `paths` with `REDACTED_SECRET`. An absent,
36
+ * null, or empty value is left as is, so "no secret" stays distinguishable
37
+ * from "redacted". A path that meets a different shape throws.
38
+ */
39
+ const redactSecretFields = (data, paths) => paths.reduce((current, path) => redactAt(current, parsePath(path), path), data);
40
+ export { REDACTED_SECRET, redactSecretFields };
package/dist/mastra.d.ts CHANGED
@@ -10,8 +10,9 @@ export type MastraToolConfig<Tool extends NeonTool> = {
10
10
  requireApproval: boolean;
11
11
  execute(input: Parameters<Tool["execute"]>[0], context: MastraToolContext): ReturnType<Tool["execute"]>;
12
12
  };
13
+ /** Keyed by published id; a tool optional in `Tools`, as after a `tools` predicate, stays optional. */
13
14
  export type MastraTools<Tools extends Readonly<Record<string, NeonTool>>> = {
14
- [Tool in Tools[keyof Tools] as Tool["id"]]: MastraToolConfig<Tool>;
15
+ [Key in keyof Tools as NonNullable<Tools[Key]>["id"]]: MastraToolConfig<NonNullable<Tools[Key]>>;
15
16
  };
16
17
  type MastraToolSource = {
17
18
  id: string;
@@ -1 +1 @@
1
- {"version":3,"file":"mastra.d.ts","sourceRoot":"","sources":["../src/mastra.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,KAAK,CAAC;AAC9B,OAAO,KAAK,EACX,QAAQ,EACR,wBAAwB,EACxB,cAAc,EACd,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,iBAAiB;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,MAAM,gBAAgB,CAAC,IAAI,SAAS,QAAQ,IAAI;IACrD,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,CACN,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EACrC,OAAO,EAAE,iBAAiB,GACxB,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,KAAK,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,IAAI;KAC1E,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC;CAClE,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,CACR,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,wBAAwB,KAC9B,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,KAAK,CAAC,IAAI,SAAS,gBAAgB,EAC/D,MAAM,IAAI;;;;;qBAOF,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,WAC5B,iBAAiB,KACxB,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;CAI7B,CAAC;AAgBH,eAAO,MAAM,aAAa,GACzB,KAAK,CAAC,KAAK,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EAEtD,OAAO,KAAK,KACV,WAAW,CAAC,KAAK,CAMnB,CAAC"}
1
+ {"version":3,"file":"mastra.d.ts","sourceRoot":"","sources":["../src/mastra.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,KAAK,CAAC;AAC9B,OAAO,KAAK,EACX,QAAQ,EACR,wBAAwB,EACxB,cAAc,EACd,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,iBAAiB;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,MAAM,gBAAgB,CAAC,IAAI,SAAS,QAAQ,IAAI;IACrD,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,CACN,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EACrC,OAAO,EAAE,iBAAiB,GACxB,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF,uGAAuG;AACvG,MAAM,MAAM,WAAW,CAAC,KAAK,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,IAAI;KAC1E,GAAG,IAAI,MAAM,KAAK,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,gBAAgB,CACtE,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CACvB;CACD,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,CACR,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,wBAAwB,KAC9B,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,KAAK,CAAC,IAAI,SAAS,gBAAgB,EAC/D,MAAM,IAAI;;;;;qBAOF,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,WAC5B,iBAAiB,KACxB,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;CAI7B,CAAC;AAgBH,eAAO,MAAM,aAAa,GACzB,KAAK,CAAC,KAAK,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EAEtD,OAAO,KAAK,KACV,WAAW,CAAC,KAAK,CAMnB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"mcp-v1.d.ts","sourceRoot":"","sources":["../src/mcp-v1.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAE7C,eAAO,MAAM,iBAAiB,GAC7B,QAAQ,aAAa,EACrB,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,KACvC,IAEF,CAAC"}
1
+ {"version":3,"file":"mcp-v1.d.ts","sourceRoot":"","sources":["../src/mcp-v1.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAE7C,eAAO,MAAM,iBAAiB,GAC7B,QAAQ,aAAa,EACrB,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,KACvC,IAOF,CAAC"}
package/dist/mcp-v1.js CHANGED
@@ -1,6 +1,8 @@
1
+ import { toMcpOutputJsonSchema } from "./lib/mcp-json-schema.js";
1
2
  import { registerNeonToolsWithSchema } from "./lib/mcp-register.js";
3
+ import * as z from "zod";
2
4
  // src/mcp-v1.ts
3
5
  const registerNeonTools = (server, tools) => {
4
- registerNeonToolsWithSchema(server, tools, (tool) => tool.inputSchema);
6
+ registerNeonToolsWithSchema(server, tools, (tool) => tool.inputSchema, (schema) => z.fromJSONSchema(toMcpOutputJsonSchema(schema)));
5
7
  };
6
8
  export { registerNeonTools };
package/dist/mcp.d.ts CHANGED
@@ -1,8 +1,8 @@
1
- import { compactJsonSchema, toMcpInputSchema } from "./lib/mcp-json-schema.js";
1
+ import { compactJsonSchema, toMcpInputSchema, toMcpOutputJsonSchema, toMcpOutputSchema } from "./lib/mcp-json-schema.js";
2
2
  import { type McpToolResult, type McpToolServer } from "./lib/mcp-register.js";
3
3
  import type { NeonTool } from "./lib/operation.js";
4
- export type { McpStandardSchema } from "./lib/mcp-json-schema.js";
4
+ export type { McpOutputSchemaOptions, McpStandardSchema, } from "./lib/mcp-json-schema.js";
5
5
  export type { McpToolResult, McpToolServer };
6
- export { compactJsonSchema, toMcpInputSchema };
6
+ export { compactJsonSchema, toMcpInputSchema, toMcpOutputJsonSchema, toMcpOutputSchema, };
7
7
  export declare const registerNeonTools: (server: McpToolServer, tools: Readonly<Record<string, NeonTool>>) => void;
8
8
  //# sourceMappingURL=mcp.d.ts.map
package/dist/mcp.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;AAE/C,eAAO,MAAM,iBAAiB,GAC7B,QAAQ,aAAa,EACrB,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,KACvC,IAIF,CAAC"}
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,YAAY,EACX,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAC7C,OAAO,EACN,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,GACjB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC7B,QAAQ,aAAa,EACrB,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,KACvC,IAOF,CAAC"}
package/dist/mcp.js CHANGED
@@ -1,7 +1,7 @@
1
+ import { compactJsonSchema, toMcpInputSchema, toMcpOutputJsonSchema, toMcpOutputSchema } from "./lib/mcp-json-schema.js";
1
2
  import { registerNeonToolsWithSchema } from "./lib/mcp-register.js";
2
- import { compactJsonSchema, toMcpInputSchema } from "./lib/mcp-json-schema.js";
3
3
  // src/mcp.ts
4
4
  const registerNeonTools = (server, tools) => {
5
- registerNeonToolsWithSchema(server, tools, (tool) => toMcpInputSchema(tool.inputSchema));
5
+ registerNeonToolsWithSchema(server, tools, (tool) => toMcpInputSchema(tool.inputSchema), toMcpOutputSchema);
6
6
  };
7
- export { compactJsonSchema, registerNeonTools, toMcpInputSchema };
7
+ export { compactJsonSchema, registerNeonTools, toMcpInputSchema, toMcpOutputJsonSchema, toMcpOutputSchema };