1.0.0alpha release

Author: JerrySievert

Makefile

@@ -1,6 +1,6 @@
 .PHONY: lintcheck format cleansql docs clean test all
 
-PLJS_VERSION = 0.8.1
+PLJS_VERSION = 1.0.0alpha
 
 PG_CONFIG = pg_config
 PGXS := $(shell $(PG_CONFIG) --pgxs)

README.md

@@ -12,9 +12,7 @@ PostgreSQL: 14+
 
 ### Current Status
 
-Close to initial release.
-
-It compiles, and is on track to match functionality of [PLV8](https://github.com/plv8/plv8).
+Currently 1.0.0 alpha release.
 
 Missing:
 
@@ -38,15 +36,3 @@ Building is meant to be easy, but not all platforms have been worked out as far
 ```
 $ make install
 ```
-
-## FAQ
-
-Q. Is this a replacement for [PLV8](https://github.com/plv8/plv8)?
-
-A. For general cases, no. PLJS is built to be compact and lightweight, as well as easy to build
-and maintain. It uses [QuickJS](https://github.com/bellard/quickjs) as the Javascript engine
-instead of using V8. This makes for a very lightweight build with a tradeoff for speed.
-
-Q. How fast is it compared to [PLV8](https://github.com/plv8/plv8)?
-
-A. We shall see, there will be tradeoffs, and before 1.0 release, any tradeoffs will be well documented. Help is always welcome when there is a specific use-case that can be distilled into a simple benchmark.

ROADMAP.md

@@ -32,7 +32,6 @@ Current Release Version: `0.8`
 - [x] procedures/transactions
 - [x] find function
 - [x] `BigInt`
-- [ ] full PLV8 parity
 
 # 1.1
 

pljs.control

@@ -1,6 +1,6 @@
 comment = 'PL/JS trusted procedural language'
 
-default_version = '0.8.1'
+default_version = '1.0.0alpha'
 module_pathname = '$libdir/pljs'
 relocatable = false
 schema = pg_catalog

pljs.sql

@@ -11,3 +11,8 @@ CREATE OR REPLACE TRUSTED LANGUAGE pljs
  HANDLER pljs_call_handler
  INLINE pljs_inline_handler
  VALIDATOR pljs_call_validator;
+
+CREATE OR REPLACE FUNCTION pljs_version()
+ RETURNS TEXT
+ AS 'MODULE_PATHNAME', 'pljs_version'
+ LANGUAGE C STRICT IMMUTABLE;

src/functions.c

@@ -65,16 +65,19 @@ static JSValue pljs_window_get_func_arg_current(JSContext *, JSValueConst, int,
 static JSValue pljs_window_object_to_string(JSContext *, JSValueConst, int,
                                             JSValueConst *);
 
+#ifdef EXPOSE_GC
+static JSValue pljs_gc(JSContext *, JSValueConst, int, JSValueConst *);
+#endif
+
+// Set up any stored procedures we export to Postgres.
+Datum pljs_version(PG_FUNCTION_ARGS);
+PG_FUNCTION_INFO_V1(pljs_version);
+
 /**
  * @brief toString Javascript method for the pljs object.
  *
  * @returns #JSValue containing the string "[object pljs]"
  */
-#ifdef EXPOSE_GC
-static JSValue pljs_gc(JSContext *, JSValueConst, int, JSValueConst *);
-#endif
-
-// The toString for the pljs object.
 static JSValue pljs_object_to_string(JSContext *ctx, JSValueConst this_obj,
                                      int argc, JSValueConst *argv) {
   return JS_NewString(ctx, "[object pljs]");
@@ -1492,3 +1495,19 @@ static JSValue pljs_gc(JSContext *ctx, JSValueConst this_val, int argc,
   return JS_UNDEFINED;
 }
 #endif
+
+/**
+ * @brief Returns the `PLJS_VERSION` to Postgres.
+ *
+ * Callable function from Postgres `SELECT pljs_version();` which returns
+ * a `TEXT` copy of the current compiled version.
+ */
+Datum pljs_version(PG_FUNCTION_ARGS) {
+  int32 length = strlen(PLJS_VERSION);
+  text *version = (text *)palloc0(sizeof(text) + length);
+
+  memcpy(VARDATA(version), PLJS_VERSION, length);
+  SET_VARSIZE(version, VARHDRSZ + length);
+
+  PG_RETURN_TEXT_P(version);
+}