@quereus/quereus 4.4.1 → 4.6.0

package/dist/src/func/builtins/return-types.d.ts

@@ -0,0 +1,327 @@
+import type { ScalarType } from '../../common/datatype.js';
+import type { LogicalType } from '../../types/logical-type.js';
+/**
+ * Shared `returnType` declarations for the built-in scalar, aggregate and window
+ * functions.
+ *
+ * A function that declares nothing reports ANY (unknown) — safe, but it forfeits
+ * comparison specialization, cross-type coercion and write-path convert-once
+ * detection (see the note on `createScalarFunction`). Declaring the truth is
+ * always better, so these constants exist to make declaring it a one-token edit
+ * instead of a repeated four-field object literal.
+ *
+ * Most built-ins return SQL NULL for input they cannot use, so the plain
+ * constants are nullable; the `_NOT_NULL` variants are for the handful whose
+ * implementation provably cannot return null on any path.
+ *
+ * NOTE: one constant object is shared by every function that names it, so a
+ * `returnType` is only ever read, never mutated. Nothing mutates one today; if a
+ * caller ever needs a per-function variation, build a fresh object with
+ * `scalarReturn` rather than editing a shared constant in place.
+ */
+/** Build a scalar return-type declaration. */
+export declare function scalarReturn(logicalType: LogicalType, nullable?: boolean): ScalarType;
+export declare const TEXT_RETURN: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+export declare const TEXT_RETURN_NOT_NULL: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+export declare const INTEGER_RETURN: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+export declare const INTEGER_RETURN_NOT_NULL: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+export declare const REAL_RETURN: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+export declare const REAL_RETURN_NOT_NULL: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+export declare const BOOLEAN_RETURN: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+export declare const BOOLEAN_RETURN_NOT_NULL: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+export declare const BLOB_RETURN: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+export declare const JSON_RETURN: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+/**
+ * For a genuinely polymorphic function whose result shape depends on the data,
+ * not on the argument types — declaring this explicitly says "unknown on
+ * purpose" so a reader does not have to wonder whether the declaration was
+ * forgotten. Equivalent to omitting `returnType`.
+ */
+export declare const ANY_RETURN: {
+    readonly typeClass: "scalar";
+    readonly logicalType: {
+        readonly name: string;
+        readonly physicalType: import("../../types/logical-type.js").PhysicalType;
+        readonly validate?: ((value: import("../../index.js").SqlValue) => boolean) | undefined;
+        readonly parse?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly compare?: ((a: import("../../index.js").SqlValue, b: import("../../index.js").SqlValue, collation?: import("../../types/logical-type.js").CollationFunction) => number) | undefined;
+        readonly collationAware?: boolean | undefined;
+        readonly semanticOrdering?: boolean | undefined;
+        readonly groupKey?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly supportedCollations?: readonly string[] | undefined;
+        readonly serialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly deserialize?: ((value: import("../../index.js").SqlValue) => import("../../index.js").SqlValue) | undefined;
+        readonly isNumeric?: boolean | undefined;
+        readonly isTextual?: boolean | undefined;
+        readonly isTemporal?: boolean | undefined;
+        readonly bucketBounds?: ((kind: string, value: import("../../index.js").SqlValue) => {
+            lowerInclusive: import("../../index.js").SqlValue;
+            upperExclusive: import("../../index.js").SqlValue;
+        } | undefined) | undefined;
+    };
+    readonly collationName?: string | undefined;
+    readonly collationSource?: import("../../common/datatype.js").CollationSource | undefined;
+    readonly nullable: boolean;
+    readonly isReadOnly?: boolean | undefined;
+};
+//# sourceMappingURL=return-types.d.ts.map

package/dist/src/func/builtins/return-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-types.d.ts","sourceRoot":"","sources":["../../../../src/func/builtins/return-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D;;;;;;;;;;;;;;;;;;GAkBG;AAEH,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,UAAO,GAAG,UAAU,CAElF;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;CAA0B,CAAC;AACnD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;CAAiC,CAAC;AACnE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;CAA6B,CAAC;AACzD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;CAAoC,CAAC;AACzE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;CAA0B,CAAC;AACnD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;CAAiC,CAAC;AACnE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;CAA6B,CAAC;AACzD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;CAAoC,CAAC;AACzE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;CAA0B,CAAC;AACnD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;CAA0B,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;CAAyB,CAAC"}

package/dist/src/func/builtins/return-types.js

@@ -0,0 +1,43 @@
+import { ANY_TYPE, BLOB_TYPE, BOOLEAN_TYPE, INTEGER_TYPE, REAL_TYPE, TEXT_TYPE } from '../../types/builtin-types.js';
+import { JSON_TYPE } from '../../types/json-type.js';
+/**
+ * Shared `returnType` declarations for the built-in scalar, aggregate and window
+ * functions.
+ *
+ * A function that declares nothing reports ANY (unknown) — safe, but it forfeits
+ * comparison specialization, cross-type coercion and write-path convert-once
+ * detection (see the note on `createScalarFunction`). Declaring the truth is
+ * always better, so these constants exist to make declaring it a one-token edit
+ * instead of a repeated four-field object literal.
+ *
+ * Most built-ins return SQL NULL for input they cannot use, so the plain
+ * constants are nullable; the `_NOT_NULL` variants are for the handful whose
+ * implementation provably cannot return null on any path.
+ *
+ * NOTE: one constant object is shared by every function that names it, so a
+ * `returnType` is only ever read, never mutated. Nothing mutates one today; if a
+ * caller ever needs a per-function variation, build a fresh object with
+ * `scalarReturn` rather than editing a shared constant in place.
+ */
+/** Build a scalar return-type declaration. */
+export function scalarReturn(logicalType, nullable = true) {
+    return { typeClass: 'scalar', logicalType, nullable, isReadOnly: true };
+}
+export const TEXT_RETURN = scalarReturn(TEXT_TYPE);
+export const TEXT_RETURN_NOT_NULL = scalarReturn(TEXT_TYPE, false);
+export const INTEGER_RETURN = scalarReturn(INTEGER_TYPE);
+export const INTEGER_RETURN_NOT_NULL = scalarReturn(INTEGER_TYPE, false);
+export const REAL_RETURN = scalarReturn(REAL_TYPE);
+export const REAL_RETURN_NOT_NULL = scalarReturn(REAL_TYPE, false);
+export const BOOLEAN_RETURN = scalarReturn(BOOLEAN_TYPE);
+export const BOOLEAN_RETURN_NOT_NULL = scalarReturn(BOOLEAN_TYPE, false);
+export const BLOB_RETURN = scalarReturn(BLOB_TYPE);
+export const JSON_RETURN = scalarReturn(JSON_TYPE);
+/**
+ * For a genuinely polymorphic function whose result shape depends on the data,
+ * not on the argument types — declaring this explicitly says "unknown on
+ * purpose" so a reader does not have to wonder whether the declaration was
+ * forgotten. Equivalent to omitting `returnType`.
+ */
+export const ANY_RETURN = scalarReturn(ANY_TYPE);
+//# sourceMappingURL=return-types.js.map

package/dist/src/func/builtins/return-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-types.js","sourceRoot":"","sources":["../../../../src/func/builtins/return-types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACrH,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,WAAwB,EAAE,QAAQ,GAAG,IAAI;IACrE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC"}

package/dist/src/func/builtins/scalar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scalar.d.ts","sourceRoot":"","sources":["../../../../src/func/builtins/scalar.ts"],"names":[],"mappings":"AA8CA,eAAO,MAAM,OAAO,yDAsBnB,CAAC;AAoCF,eAAO,MAAM,UAAU,yDAGtB,CAAC;AAEF,eAAO,MAAM,UAAU,yDAGtB,CAAC;AAGF,eAAO,MAAM,YAAY,yDAqBxB,CAAC;AAGF,eAAO,MAAM,UAAU,yDAiBtB,CAAC;AAQF,eAAO,MAAM,UAAU,yDAetB,CAAC;AAGF,eAAO,MAAM,UAAU,yDAMtB,CAAC;AAGF,eAAO,MAAM,cAAc,yDAc1B,CAAC;AAGF,eAAO,MAAM,OAAO,yDA8BnB,CAAC;AAGF,eAAO,MAAM,QAAQ,yDAoBpB,CAAC;AAYF,eAAO,MAAM,OAAO,yDAGnB,CAAC;AAEF,eAAO,MAAM,SAAS,yDAGrB,CAAC;AAGF,eAAO,MAAM,SAAS,yDAoBrB,CAAC;AAqBF,eAAO,MAAM,QAAQ,yDAGpB,CAAC;AAEF,eAAO,MAAM,WAAW,yDAGvB,CAAC;AAGF,eAAO,MAAM,SAAS,yDAsBrB,CAAC;AAGF,eAAO,MAAM,YAAY,yDAsBxB,CAAC;AAGF,eAAO,MAAM,SAAS,yDAsBrB,CAAC;AAGF,eAAO,MAAM,UAAU,yDAgCtB,CAAC"}
+{"version":3,"file":"scalar.d.ts","sourceRoot":"","sources":["../../../../src/func/builtins/scalar.ts"],"names":[],"mappings":"AA+DA,eAAO,MAAM,OAAO,yDAsBnB,CAAC;AAoCF,eAAO,MAAM,UAAU,yDAGtB,CAAC;AAEF,eAAO,MAAM,UAAU,yDAGtB,CAAC;AAGF,eAAO,MAAM,YAAY,yDAqBxB,CAAC;AAiEF,eAAO,MAAM,UAAU,yDA+BtB,CAAC;AAUF,eAAO,MAAM,UAAU,yDAUtB,CAAC;AAGF,eAAO,MAAM,UAAU,yDAMtB,CAAC;AAGF,eAAO,MAAM,cAAc,yDAc1B,CAAC;AAGF,eAAO,MAAM,OAAO,yDA8BnB,CAAC;AAGF,eAAO,MAAM,QAAQ,yDAmBpB,CAAC;AAcF,eAAO,MAAM,OAAO,yDAGnB,CAAC;AAEF,eAAO,MAAM,SAAS,yDAGrB,CAAC;AAGF,eAAO,MAAM,SAAS,yDAoBrB,CAAC;AAqBF,eAAO,MAAM,QAAQ,yDAGpB,CAAC;AAEF,eAAO,MAAM,WAAW,yDAGvB,CAAC;AAGF,eAAO,MAAM,SAAS,yDA0BrB,CAAC;AA+EF,eAAO,MAAM,YAAY,yDAyBxB,CAAC;AAKF,eAAO,MAAM,SAAS,yDAyBrB,CAAC;AAKF,eAAO,MAAM,UAAU,yDAgCtB,CAAC"}