xq-lsp 1.8.0 → 1.8.2

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.8.2](https://github.com/DrRataplan/xq-lsp/compare/lsp-v1.8.1...lsp-v1.8.2) (2026-09-01)
+
+
+### Bug Fixes
+
+* recover eXist-db functions the generator silently dropped ([6e76557](https://github.com/DrRataplan/xq-lsp/commit/6e765574bb484fa650ab83cf33ee301686b92604))
+* use an explicit textEdit for auto-declare-namespace completions ([b319917](https://github.com/DrRataplan/xq-lsp/commit/b3199170a138bc2281cff86bbd4368b0d1c5b9f7))
+
+## [1.8.1](https://github.com/DrRataplan/xq-lsp/compare/lsp-v1.8.0...lsp-v1.8.1) (2026-07-29)
+
+
+### Bug Fixes
+
+* stop retaining full ASTs for every glob-matched file to prevent OOM ([b44460f](https://github.com/DrRataplan/xq-lsp/commit/b44460f1de449b48903ebddff4f56b7524b99234))
+
 ## [1.8.0](https://github.com/DrRataplan/xq-lsp/compare/lsp-v1.7.0...lsp-v1.8.0) (2026-07-28)
 
 

package/dist/call-hierarchy.d.ts

@@ -1,6 +1,6 @@
 import type { CallHierarchyItem, CallHierarchyIncomingCall, CallHierarchyOutgoingCall } from "vscode-languageserver/node.js";
 import type { FileAnalysis } from "./types.ts";
-import type { FileRecord } from "./references.ts";
+import type { FileRecord, LoadAst } from "./references.ts";
 /**
  * Resolve the function under the cursor (declaration name or call-site name) to a
  * `CallHierarchyItem[]`, the same way `getDefinition` resolves go-to-definition targets.
@@ -17,4 +17,4 @@ export declare function getOutgoingCalls(item: CallHierarchyItem, text: string,
  * namespace + local name + arity), grouped by each call site's enclosing
  * `declare function` — found by walking up the AST from the call-site offset.
  */
-export declare function getIncomingCalls(item: CallHierarchyItem, itemText: string, itemAnalysis: FileAnalysis, getOtherFiles: () => FileRecord[]): CallHierarchyIncomingCall[];
+export declare function getIncomingCalls(item: CallHierarchyItem, itemText: string, itemAnalysis: FileAnalysis, getOtherFiles: () => FileRecord[], loadAst: LoadAst): CallHierarchyIncomingCall[];

package/dist/call-hierarchy.js

@@ -143,34 +143,49 @@ export function getOutgoingCalls(item, text, analysis, imported) {
  * namespace + local name + arity), grouped by each call site's enclosing
  * `declare function` — found by walking up the AST from the call-site offset.
  */
-export function getIncomingCalls(item, itemText, itemAnalysis, getOtherFiles) {
+export function getIncomingCalls(item, itemText, itemAnalysis, getOtherFiles, loadAst) {
     const offset = toOffset(itemText, item.selectionRange.start);
     // includeDeclaration:false — we only want actual call sites, not the declaration itself.
-    const callSites = getReferences(item.uri, itemText, offset, itemAnalysis, false, getOtherFiles);
+    const callSites = getReferences(item.uri, itemText, offset, itemAnalysis, false, getOtherFiles, loadAst);
     if (callSites.length === 0)
         return [];
-    const fileByUri = new Map(getOtherFiles().map((f) => [f.uri, f]));
-    if (!fileByUri.has(item.uri))
-        fileByUri.set(item.uri, { uri: item.uri, text: itemText, analysis: itemAnalysis });
+    // getOtherFiles() returns cached, ast-free records — cheap to re-iterate for a uri->text
+    // lookup. The full (ast-bearing) analysis for each call site's file is fetched below, once
+    // per distinct uri, via loadAst.
+    const textByUri = new Map([[item.uri, itemText]]);
+    for (const file of getOtherFiles())
+        if (!textByUri.has(file.uri))
+            textByUri.set(file.uri, file.text);
+    const analysisByUri = new Map([[item.uri, itemAnalysis]]);
     const groups = new Map();
     for (const loc of callSites) {
-        const record = fileByUri.get(loc.uri);
-        if (!record?.analysis.ast)
+        const text = textByUri.get(loc.uri);
+        if (text === undefined)
             continue;
-        const callOffset = toOffset(record.text, loc.range.start);
-        const stack = nodeStackAtOffset(record.analysis.ast, callOffset);
+        let fileAnalysis = analysisByUri.get(loc.uri);
+        if (!fileAnalysis) {
+            const loaded = loadAst(loc.uri, text);
+            if (!loaded)
+                continue;
+            fileAnalysis = loaded;
+            analysisByUri.set(loc.uri, fileAnalysis);
+        }
+        if (!fileAnalysis.ast)
+            continue;
+        const callOffset = toOffset(text, loc.range.start);
+        const stack = nodeStackAtOffset(fileAnalysis.ast, callOffset);
         // Function declarations can't nest in XQuery, so at most one AnnotatedDecl/FunctionDecl
         // pair appears in the stack; a call at module level (no enclosing function) has none.
         const enclosingDecl = stack.find((n) => n.type === "AnnotatedDecl" && directChildOf(n, "FunctionDecl"));
         if (!enclosingDecl)
             continue;
-        const enclosingFn = record.analysis.functions.find((f) => f.sourceOffset === enclosingDecl.start);
+        const enclosingFn = fileAnalysis.functions.find((f) => f.sourceOffset === enclosingDecl.start);
         if (!enclosingFn)
             continue;
         const key = `${qnameKey(enclosingFn.qname)}#${enclosingFn.arity}@${loc.uri}`;
         let group = groups.get(key);
         if (!group) {
-            const from = buildItemForFunction(enclosingFn, record.analysis, loc.uri, record.text);
+            const from = buildItemForFunction(enclosingFn, fileAnalysis, loc.uri, text);
             if (!from)
                 continue;
             group = { from, ranges: [] };

package/dist/code-lens.d.ts

@@ -1,7 +1,7 @@
 import { CodeLens } from "vscode-languageserver/node.js";
 import type { TextDocument } from "vscode-languageserver-textdocument";
 import type { FileAnalysis } from "./types.ts";
-import type { FileRecord } from "./references.ts";
+import type { FileRecord, LoadAst } from "./references.ts";
 /** Carried on each unresolved lens so `resolveCodeLens` can find the declaration again later. */
 export interface CodeLensData {
     uri: string;
@@ -20,4 +20,4 @@ export declare function buildCodeLenses(doc: TextDocument, analysis: FileAnalysi
  * reference search `textDocument/references` uses. Declarations aren't counted as
  * references. 0 references is reported as-is — it's a useful signal, not hidden.
  */
-export declare function resolveCodeLens(lens: CodeLens, text: string, analysis: FileAnalysis, getOtherFiles: () => FileRecord[]): CodeLens;
+export declare function resolveCodeLens(lens: CodeLens, text: string, analysis: FileAnalysis, getOtherFiles: () => FileRecord[], loadAst: LoadAst): CodeLens;

package/dist/code-lens.js

@@ -60,10 +60,10 @@ function findNameOffset(ast, analysis, data) {
  * reference search `textDocument/references` uses. Declarations aren't counted as
  * references. 0 references is reported as-is — it's a useful signal, not hidden.
  */
-export function resolveCodeLens(lens, text, analysis, getOtherFiles) {
+export function resolveCodeLens(lens, text, analysis, getOtherFiles, loadAst) {
     const data = lens.data;
     const ast = analysis.ast;
     const offset = data && ast ? findNameOffset(ast, analysis, data) : null;
-    const count = data && offset !== null ? getReferences(data.uri, text, offset, analysis, false, getOtherFiles).length : 0;
+    const count = data && offset !== null ? getReferences(data.uri, text, offset, analysis, false, getOtherFiles, loadAst).length : 0;
     return { ...lens, command: { title: `${count} references`, command: "" } };
 }

package/dist/completion.js

@@ -1,6 +1,7 @@
 import { CompletionItem, CompletionItemKind, InsertTextFormat, MarkupKind } from "vscode-languageserver/node.js";
 import { getCompletions as getCoreCompletions } from "./completion-core.js";
 import { findImportInsertPosition, findDeclareNsInsertPosition, computeRelativePath } from "./namespace-diagnostics.js";
+import { offsetToPosition } from "./references.js";
 export function getCompletions(ctx, currentAnalysis, importedAnalyses, snippets, lastValidAnalysis, availableAnalyses, knownNamespaces, editContext) {
     return getCoreCompletions(ctx, currentAnalysis, importedAnalyses, snippets, lastValidAnalysis, availableAnalyses, knownNamespaces).map((e) => {
         const item = {
@@ -33,6 +34,19 @@ export function getCompletions(ctx, currentAnalysis, importedAnalyses, snippets,
                 newText = `declare namespace ${e.additionalEdit.prefix} = "${e.additionalEdit.namespaceUri}";\n`;
             }
             item.additionalTextEdits = [{ range: { start: insertPos, end: insertPos }, newText }];
+            // The "declare namespace" entry's own insertText is just an echo of what's already
+            // typed after the prefix (often ""). Some clients (e.g. eglot) fall back to inserting
+            // the item's label verbatim at the cursor when insertText is empty, which would dump
+            // the whole `declare namespace tei = "...";` statement inline. An explicit textEdit
+            // with a concrete range forces every spec-compliant client onto the deterministic
+            // replace path instead of guessing, so only the additionalTextEdit above lands the text.
+            if (e.additionalEdit.kind === "declare-namespace") {
+                const start = ctx.cursorOffset - e.insertText.length;
+                item.textEdit = {
+                    range: { start: offsetToPosition(docText, start), end: offsetToPosition(docText, ctx.cursorOffset) },
+                    newText: e.insertText,
+                };
+            }
         }
         return item;
     });

package/dist/references.d.ts

@@ -10,6 +10,14 @@ export declare function offsetToPosition(text: string, offset: number): {
     line: number;
     character: number;
 };
+/**
+ * Parses one glob-matched file's full AST on demand for a cross-file occurrence walk.
+ * Reuses `analysisCache` (open documents, explicit imports) when the file is already
+ * resident; otherwise parses fresh and returns without caching the result, so a
+ * cross-file search never retains more than the file currently being walked. See
+ * `getGlobFileAccess` in server.ts.
+ */
+export type LoadAst = (uri: string, text: string) => FileAnalysis | null;
 /**
  * Find all references to the symbol at `offset` in the current file.
  *
@@ -26,9 +34,11 @@ export declare function offsetToPosition(text: string, offset: number): {
  * Requires a valid AST (returns `[]` on the regex-fallback path, since parse
  * failures don't produce reliable node positions).
  * `getOtherFiles` is only invoked for symbol kinds that need a cross-file
- * search, so callers can make it lazy.
+ * search, so callers can make it lazy. `getOtherFiles` returns lightweight,
+ * ast-free records for cheap candidate filtering; `loadAst` parses a specific
+ * candidate's full AST on demand once it survives that filter (see `LoadAst`).
  */
-export declare function getReferences(currentUri: string, currentText: string, offset: number, analysis: FileAnalysis, includeDeclaration: boolean, getOtherFiles: () => FileRecord[]): Location[];
+export declare function getReferences(currentUri: string, currentText: string, offset: number, analysis: FileAnalysis, includeDeclaration: boolean, getOtherFiles: () => FileRecord[], loadAst: LoadAst): Location[];
 /**
  * Range of the renameable identifier at `offset`, trimmed to the local-name part
  * (namespace-prefix qualifiers are left untouched) or the bare prefix NCName for
@@ -48,7 +58,7 @@ export declare function getRenameRangeAtOffset(currentText: string, offset: numb
  * recognizable at `offset`, or no resolvable local declaration (e.g. a builtin
  * function or a predeclared runtime namespace prefix).
  */
-export declare function getRenameLocations(currentUri: string, currentText: string, offset: number, analysis: FileAnalysis, getOtherFiles: () => FileRecord[]): Location[] | null;
+export declare function getRenameLocations(currentUri: string, currentText: string, offset: number, analysis: FileAnalysis, getOtherFiles: () => FileRecord[], loadAst: LoadAst): Location[] | null;
 /**
  * Highlight every occurrence of the symbol at `offset` within the current
  * document only (`textDocument/documentHighlight` is file-scoped by spec, even

package/dist/references.js

@@ -277,8 +277,7 @@ function getPrefixReferences(currentUri, currentText, ast, analysis, prefix, inc
     }
     return locs;
 }
-// ── Cross-file orchestration ──────────────────────────────────────────────────
-function getVariableReferences(currentUri, currentText, ast, analysis, offset, includeDeclaration, getOtherFiles, trimToLocalName = false) {
+function getVariableReferences(currentUri, currentText, ast, analysis, offset, includeDeclaration, getOtherFiles, loadAst, trimToLocalName = false) {
     const occurrences = [];
     walkVariables(ast, analysis, new ScopeStack(), occurrences);
     const target = occurrences.find((o) => offset >= o.start && offset <= o.end);
@@ -301,10 +300,16 @@ function getVariableReferences(currentUri, currentText, ast, analysis, offset, i
         o,
     }));
     for (const file of getOtherFiles()) {
-        if (file.uri === currentUri || !file.analysis.ast)
+        // Cheap pre-filter: localName always appears verbatim in source regardless of EQName
+        // syntax (prefixed, URIQualified, or unprefixed), so its absence rules out a match
+        // without needing to parse the file at all.
+        if (file.uri === currentUri || !file.text.includes(localName))
+            continue;
+        const fileAnalysis = loadAst(file.uri, file.text);
+        if (!fileAnalysis?.ast)
             continue;
         const fileOccs = [];
-        walkVariables(file.analysis.ast, file.analysis, new ScopeStack(), fileOccs);
+        walkVariables(fileAnalysis.ast, fileAnalysis, new ScopeStack(), fileOccs);
         for (const o of matches(fileOccs))
             all.push({ uri: file.uri, text: file.text, o });
     }
@@ -313,7 +318,7 @@ function getVariableReferences(currentUri, currentText, ast, analysis, offset, i
         return [];
     return all.filter((m) => includeDeclaration || !m.o.isDeclaration).map((m) => toLoc(m.uri, m.text, m.o));
 }
-function getFunctionReferences(currentUri, currentText, ast, analysis, offset, includeDeclaration, getOtherFiles, trimToLocalName = false) {
+function getFunctionReferences(currentUri, currentText, ast, analysis, offset, includeDeclaration, getOtherFiles, loadAst, trimToLocalName = false) {
     const occurrences = [];
     walkFunctions(ast, analysis, occurrences);
     const target = occurrences.find((o) => offset >= o.start && offset <= o.end);
@@ -328,10 +333,13 @@ function getFunctionReferences(currentUri, currentText, ast, analysis, offset, i
         o,
     }));
     for (const file of getOtherFiles()) {
-        if (file.uri === currentUri || !file.analysis.ast)
+        if (file.uri === currentUri || !file.text.includes(localName))
+            continue;
+        const fileAnalysis = loadAst(file.uri, file.text);
+        if (!fileAnalysis?.ast)
             continue;
         const fileOccs = [];
-        walkFunctions(file.analysis.ast, file.analysis, fileOccs);
+        walkFunctions(fileAnalysis.ast, fileAnalysis, fileOccs);
         for (const o of matches(fileOccs))
             all.push({ uri: file.uri, text: file.text, o });
     }
@@ -385,9 +393,11 @@ function prefixHasDeclaration(analysis, prefix) {
  * Requires a valid AST (returns `[]` on the regex-fallback path, since parse
  * failures don't produce reliable node positions).
  * `getOtherFiles` is only invoked for symbol kinds that need a cross-file
- * search, so callers can make it lazy.
+ * search, so callers can make it lazy. `getOtherFiles` returns lightweight,
+ * ast-free records for cheap candidate filtering; `loadAst` parses a specific
+ * candidate's full AST on demand once it survives that filter (see `LoadAst`).
  */
-export function getReferences(currentUri, currentText, offset, analysis, includeDeclaration, getOtherFiles) {
+export function getReferences(currentUri, currentText, offset, analysis, includeDeclaration, getOtherFiles, loadAst) {
     const ast = analysis.ast;
     if (!ast)
         return [];
@@ -397,8 +407,8 @@ export function getReferences(currentUri, currentText, offset, analysis, include
     if (target.kind === "prefix")
         return getPrefixReferences(currentUri, currentText, ast, analysis, target.prefix, includeDeclaration);
     if (target.kind === "variable")
-        return getVariableReferences(currentUri, currentText, ast, analysis, offset, includeDeclaration, getOtherFiles);
-    return getFunctionReferences(currentUri, currentText, ast, analysis, offset, includeDeclaration, getOtherFiles);
+        return getVariableReferences(currentUri, currentText, ast, analysis, offset, includeDeclaration, getOtherFiles, loadAst);
+    return getFunctionReferences(currentUri, currentText, ast, analysis, offset, includeDeclaration, getOtherFiles, loadAst);
 }
 /**
  * Range of the renameable identifier at `offset`, trimmed to the local-name part
@@ -430,7 +440,7 @@ export function getRenameRangeAtOffset(currentText, offset, analysis) {
  * recognizable at `offset`, or no resolvable local declaration (e.g. a builtin
  * function or a predeclared runtime namespace prefix).
  */
-export function getRenameLocations(currentUri, currentText, offset, analysis, getOtherFiles) {
+export function getRenameLocations(currentUri, currentText, offset, analysis, getOtherFiles, loadAst) {
     const ast = analysis.ast;
     if (!ast)
         return null;
@@ -443,8 +453,8 @@ export function getRenameLocations(currentUri, currentText, offset, analysis, ge
         return getPrefixReferences(currentUri, currentText, ast, analysis, target.prefix, true);
     }
     const locs = target.kind === "variable"
-        ? getVariableReferences(currentUri, currentText, ast, analysis, offset, true, getOtherFiles, true)
-        : getFunctionReferences(currentUri, currentText, ast, analysis, offset, true, getOtherFiles, true);
+        ? getVariableReferences(currentUri, currentText, ast, analysis, offset, true, getOtherFiles, loadAst, true)
+        : getFunctionReferences(currentUri, currentText, ast, analysis, offset, true, getOtherFiles, loadAst, true);
     return locs.length > 0 ? locs : null;
 }
 /**

package/dist/runtimes/existdb/file.xq

@@ -116,6 +116,59 @@ declare function file:read-unicode($path as item()) as xs:string? external;
  :)
 declare function file:read-unicode($path as item(), $encoding as xs:string) as xs:string? external;
 
+(:~
+ : Writes the node set into a file on the file system. $parameters contains a
+ : sequence of zero or more serialization parameters specified as key=value
+ : pairs. The serialization options are the same as those recognized by
+ : "declare option exist:serialize". The function does NOT automatically
+ : inherit the serialization options of the XQuery it is called from. This
+ : method is only available to the DBA role.
+ : @param $node-set The contents to write to the file system.
+ : @param $path The full path or URI to the file
+ : @param $parameters The serialization parameters: either a sequence of key=value pairs or an output:serialization-parameters element as defined by the standard fn:serialize function.
+ : @return true on success - false if the specified file can not be created or is not writable. The empty sequence is returned if the argument sequence is empty.
+ :)
+declare function file:serialize($node-set as node()*, $path as item(), $parameters as item()*) as xs:boolean? external;
+
+(:~
+ : Writes the node set into a file on the file system, optionally appending to
+ : it. $parameters contains a sequence of zero or more serialization parameters
+ : specified as key=value pairs. The serialization options are the same as
+ : those recognized by "declare option exist:serialize". The function does NOT
+ : automatically inherit the serialization options of the XQuery it is called
+ : from. This method is only available to the DBA role.
+ : @param $node-set The contents to write to the file system.
+ : @param $path The full path or URI to the file
+ : @param $parameters The serialization parameters: either a sequence of key=value pairs or an output:serialization-parameters element as defined by the standard fn:serialize function.
+ : @param $append Should content be appended?
+ : @return true on success - false if the specified file can not be created or is not writable. The empty sequence is returned if the argument sequence is empty.
+ :)
+declare function file:serialize(
+	$node-set as node()*,
+	$path as item(),
+	$parameters as item()*,
+	$append as xs:boolean
+) as xs:boolean? external;
+
+(:~
+ : Writes binary data into a file on the file system. This method is only
+ : available to the DBA role.
+ : @param $binarydata The contents to write to the file system.
+ : @param $path The full path or URI to the file
+ : @return true on success - false if the specified file can not be created or is not writable
+ :)
+declare function file:serialize-binary($binarydata as xs:base64Binary, $path as item()) as xs:boolean external;
+
+(:~
+ : Writes binary data into a file on the file system, optionally appending the
+ : content. This method is only available to the DBA role.
+ : @param $binarydata The contents to write to the file system.
+ : @param $path The full path or URI to the file
+ : @param $append Should content be appended?
+ : @return true on success - false if the specified file can not be created or is not writable
+ :)
+declare function file:serialize-binary($binarydata as xs:base64Binary, $path as item(), $append as xs:boolean) as xs:boolean external;
+
 (:~
  : Synchronize a collection with a directory hierarchy. This method is only
  : available to the DBA role.

package/dist/runtimes/existdb/request.xq

@@ -240,3 +240,19 @@ declare function request:is-multipart-content() as xs:boolean external;
  : @param $value The attribute value
  :)
 declare function request:set-attribute($name as xs:string, $value as item()*) as empty-sequence() external;
+ : Returns the empty sequence if no item of $available is acceptable; the
+ : caller should then respond with 406 Not Acceptable.
+ : @param $available The media types the server can produce, in order of preference.
+ : @return the best matching media type, or the empty sequence if none is acceptable
+ :)
+declare function request:negotiate-content-type($available as xs:string*) as xs:string? external;
+
+(:~
+ : Returns $default if no item of $available is acceptable.
+ : @param $available The media types the server can produce, in order of preference.
+ : @param $default The media type to fall back to when no item of $available is acceptable.
+ : @return the best matching media type, or $default if none is acceptable
+ :)
+declare function request:negotiate-content-type($available as xs:string*, $default as xs:string?) as xs:string? external;
+
+(:~

package/dist/runtimes/existdb/response.xq

@@ -13,18 +13,54 @@ declare function response:redirect-to($uri as xs:anyURI) as empty-sequence() ext
 
 (:~
  : Sets a HTTP Cookie on the HTTP Response.
+ : @param $name The cookie name
+ : @param $value The cookie value
  :)
-declare function response:set-cookie() as empty-sequence() external;
+declare function response:set-cookie($name as xs:string, $value as xs:string) as empty-sequence() external;
+
+(:~
+ : Sets a HTTP Cookie on the HTTP Response.
+ : @param $name The cookie name
+ : @param $value The cookie value
+ : @param $max-age The xs:duration of the cookie
+ :)
+declare function response:set-cookie(
+	$name as xs:string,
+	$value as xs:string,
+	$max-age as xs:duration?,
+	$secure-flag as xs:boolean?
+) as empty-sequence() external;
+
+(:~
+ : Sets a HTTP Cookie on the HTTP Response.
+ : @param $name The cookie name
+ : @param $value The cookie value
+ : @param $max-age The xs:duration of the cookie
+ : @param $domain The cookie domain
+ : @param $path The cookie path
+ :)
+declare function response:set-cookie(
+	$name as xs:string,
+	$value as xs:string,
+	$max-age as xs:duration?,
+	$secure-flag as xs:boolean?,
+	$domain as xs:string?,
+	$path as xs:string?
+) as empty-sequence() external;
 
 (:~
  : Sets a HTTP Header on the HTTP Response.
+ : @param $name The header name
+ : @param $value The header value
  :)
-declare function response:set-date-header() as empty-sequence() external;
+declare function response:set-date-header($name as xs:string, $value as xs:string) as empty-sequence() external;
 
 (:~
  : Sets a HTTP Header on the HTTP Response.
+ : @param $name The header name
+ : @param $value The header value
  :)
-declare function response:set-header() as empty-sequence() external;
+declare function response:set-header($name as xs:string, $value as xs:string) as empty-sequence() external;
 
 (:~
  : Sets a HTTP server status code on the HTTP Response.
@@ -46,5 +82,22 @@ declare function response:stream($content as item()*, $serialization-options as
  : ContentType HTTP header is set to the value given in $content-type. Note:
  : the servlet output stream will be closed afterwards and mime-type settings
  : in the prolog will not be passed.
+ : @param $binary-data The binary data to stream
+ : @param $content-type The ContentType HTTP header value
+ : @param $filename The filename. If provided, a Content-Disposition header is set for the filename in the HTTP Response
+ :)
+declare function response:stream-binary($binary-data as xs:base64Binary, $content-type as xs:string, $filename as xs:string?) as empty-sequence() external;
+
+(:~
+ : @param $binary-resource-path The path to the stored binary resource, e.g. /db/path/to/image.png
+ : @param $content-type The ContentType HTTP header value
+ :)
+declare function response:stream-binary-resource($binary-resource-path as xs:string, $content-type as xs:string) as empty-sequence() external;
+
+(:~
+ : A Content-Disposition header is set from $filename.
+ : @param $binary-resource-path The path to the stored binary resource, e.g. /db/path/to/image.png
+ : @param $content-type The ContentType HTTP header value
+ : @param $filename The filename. If provided, a Content-Disposition header is set for the filename in the HTTP Response
  :)
-declare function response:stream-binary() as empty-sequence() external;
+declare function response:stream-binary-resource($binary-resource-path as xs:string, $content-type as xs:string, $filename as xs:string?) as empty-sequence() external;

package/dist/runtimes/existdb/scheduler.xq

@@ -33,3 +33,176 @@ declare function scheduler:pause-scheduled-job($job-name as xs:string) as xs:boo
  : @return the indicator of successful resumption
  :)
 declare function scheduler:resume-scheduled-job($job-name as xs:string) as xs:boolean external;
+
+(:~
+ : Schedules the Java Class named (the class must extend
+ : org.exist.scheduler.UserJavaJob) according to the Cron expression. The job
+ : will be registered using the job name.
+ : @param $java-classname The full name of the class to be executed. It must extend the org.exist.scheduler.UserJavaJob class.
+ : @param $cron-expression The cron expression. Please see the scheduler documentation.
+ : @param $job-name The name of the job.
+ :)
+declare function scheduler:schedule-java-cron-job($java-classname as xs:string, $cron-expression as xs:string, $job-name as xs:string) as item()* external;
+
+(:~
+ : Schedules the Java Class named (the class must extend
+ : org.exist.scheduler.UserJavaJob) according to the Cron expression. The job
+ : will be registered using the name passed in $job-name. The final argument
+ : can be used to specify parameters for the job, which will be passed to the
+ : query as external variables. Parameters are specified in an XML fragment
+ : with the following structure: <parameters><param name="param-name1"
+ : value="param-value1"/></parameters>.
+ : @param $java-classname The full name of the class to be executed. It must extend the org.exist.scheduler.UserJavaJob class.
+ : @param $cron-expression The cron expression. Please see the scheduler documentation.
+ : @param $job-name The name of the job.
+ : @param $job-parameters The XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ :)
+declare function scheduler:schedule-java-cron-job(
+	$java-classname as xs:string,
+	$cron-expression as xs:string,
+	$job-name as xs:string,
+	$job-parameters as element()?
+) as item()* external;
+
+(:~
+ : Schedules the Java Class named (the class must extend
+ : org.exist.scheduler.UserJavaJob) according to the periodic value. The job
+ : will be registered using the job name. The $job-parameters argument can be
+ : used to specify parameters for the job, which will be passed to the query as
+ : external variables. Parameters are specified in an XML fragment with the
+ : following structure: <parameters><param name="param-name1"
+ : value="param-value1"/></parameters>, Given the delay and the repeat.
+ : @param $java-classname The full name of the class to be executed. It must extend the org.exist.scheduler.UserJavaJob class.
+ : @param $period Time in milliseconds between execution of the job
+ : @param $job-name The name of the job.
+ : @param $job-parameters The XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ : @param $delay The period in milliseconds to delay the start of a job.
+ : @param $repeat The number of times to repeat the job after the initial execution. A value of -1 means repeat forever.
+ :)
+declare function scheduler:schedule-java-periodic-job(
+	$java-classname as xs:string,
+	$period as xs:integer,
+	$job-name as xs:string,
+	$job-parameters as element()?,
+	$delay as xs:integer,
+	$repeat as xs:integer
+) as item()* external;
+
+(:~
+ : Schedules the named XQuery resource (e.g. /db/foo.xql) according to the Cron
+ : expression. XQuery job's will be launched under the guest account initially,
+ : although the running XQuery may switch permissions through calls to
+ : xmldb:login(). The job will be registered using the job name. Jobs submitted
+ : via this function are transitory and will be lost on a server restart. To
+ : ensure the persistence of scheduled tasks add them to the conf.xml file.
+ : @param $xquery-resource The path to the XQuery resource
+ : @param $cron-expression The cron expression. Please see the scheduler documentation.
+ : @param $job-name The name of the job.
+ :)
+declare function scheduler:schedule-xquery-cron-job($xquery-resource as xs:string, $cron-expression as xs:string, $job-name as xs:string) as item()* external;
+
+(:~
+ : Schedules the named XQuery resource (e.g. /db/foo.xql) according to the Cron
+ : expression. XQuery job's will be launched under the guest account initially,
+ : although the running XQuery may switch permissions through calls to
+ : xmldb:login(). The job will be registered using the job name. The final
+ : argument can be used to specify parameters for the job, which will be passed
+ : to the query as external variables. Parameters are specified in an XML
+ : fragment with the following structure: <parameters><param name="param-name1"
+ : value="param-value1"/></parameters> Jobs submitted via this function are
+ : transitory and will be lost on a server restart. To ensure the persistence
+ : of scheduled tasks add them to the conf.xml file.
+ : @param $xquery-resource The path to the XQuery resource
+ : @param $cron-expression A cron expression. Please see the scheduler documentation.
+ : @param $job-name The name of the job.
+ : @param $job-parameters XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ :)
+declare function scheduler:schedule-xquery-cron-job(
+	$xquery-resource as xs:string,
+	$cron-expression as xs:string,
+	$job-name as xs:string,
+	$job-parameters as element()?
+) as item()* external;
+
+(:~
+ : Schedules the named XQuery resource (e.g. /db/foo.xql) according to the Cron
+ : expression. XQuery job's will be launched under the guest account initially,
+ : although the running XQuery may switch permissions through calls to
+ : xmldb:login(). The job will be registered using the job name. The job
+ : parameters argument can be used to specify parameters for the job, which
+ : will be passed to the query as external variables. Parameters are specified
+ : in an XML fragment with the following structure: <parameters><param
+ : name="param-name1" value="param-value1"/></parameters> Jobs submitted via
+ : this function are transitory and will be lost on a server restart. To ensure
+ : the persistence of scheduled tasks add them to the conf.xml file.
+ : @param $xquery-resource The path to the XQuery resource
+ : @param $cron-expression A cron expression. Please see the scheduler documentation.
+ : @param $job-name The name of the job.
+ : @param $job-parameters XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ : @param $unschedule Specifies whether to unschedule this job if an XPathException is raised, default is true.
+ :)
+declare function scheduler:schedule-xquery-cron-job(
+	$xquery-resource as xs:string,
+	$cron-expression as xs:string,
+	$job-name as xs:string,
+	$job-parameters as element()?,
+	$unschedule as xs:boolean
+) as item()* external;
+
+(:~
+ : Schedules the named XQuery resource (e.g. /db/foo.xql) according to the
+ : period. XQuery job's will be launched under the guest account initially,
+ : although the running XQuery may switch permissions through calls to
+ : xmldb:login(). The job will be registered using the job name. The job
+ : parameters argument can be used to specify parameters for the job, which
+ : will be passed to the query as external variables. Parameters are specified
+ : in an XML fragment with the following structure: <parameters><param
+ : name="param-name1" value="param-value1"/></parameters> , Given the delay
+ : passed and the repeat value. Jobs submitted via this function are transitory
+ : and will be lost on a server restart. To ensure the persistence of scheduled
+ : tasks add them to the conf.xml file.
+ : @param $xquery-resource The path to the XQuery resource
+ : @param $period Time in milliseconds between execution of the job
+ : @param $job-name The name of the job.
+ : @param $job-parameters XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ : @param $delay Can be used with a period in milliseconds to delay the start of a job.
+ : @param $repeat Number of times to repeat the job after the initial execution. A value of -1 means repeat forever.
+ :)
+declare function scheduler:schedule-xquery-periodic-job(
+	$xquery-resource as xs:string,
+	$period as xs:integer,
+	$job-name as xs:string,
+	$job-parameters as element()?,
+	$delay as xs:integer,
+	$repeat as xs:integer
+) as item()* external;
+
+(:~
+ : Schedules the named XQuery resource (e.g. /db/foo.xql) according to the
+ : period. XQuery job's will be launched under the guest account initially,
+ : although the running XQuery may switch permissions through calls to
+ : xmldb:login(). The job will be registered using the job name. The job
+ : parameters argument can be used to specify parameters for the job, which
+ : will be passed to the query as external variables. Parameters are specified
+ : in an XML fragment with the following structure: <parameters><param
+ : name="param-name1" value="param-value1"/></parameters> , Given the delay
+ : passed and the repeat value. Jobs submitted via this function are transitory
+ : and will be lost on a server restart. To ensure the persistence of scheduled
+ : tasks add them to the conf.xml file.
+ : @param $xquery-resource The path to the XQuery resource
+ : @param $period Time in milliseconds between execution of the job
+ : @param $job-name The name of the job.
+ : @param $job-parameters XML fragment with the following structure: <parameters><param name="param-name1" value="param-value1"/></parameters>
+ : @param $delay Can be used with a period in milliseconds to delay the start of a job.
+ : @param $repeat Number of times to repeat the job after the initial execution. A value of -1 means repeat forever.
+ : @param $unschedule Specifies whether to unschedule this job if an XPathException is raised, default is true.
+ :)
+declare function scheduler:schedule-xquery-periodic-job(
+	$xquery-resource as xs:string,
+	$period as xs:integer,
+	$job-name as xs:string,
+	$job-parameters as element()?,
+	$delay as xs:integer,
+	$repeat as xs:integer,
+	$unschedule as xs:boolean
+) as item()* external;