build: add Makefile for PGXS

Signed-off-by: Snehil Shah <snehilshah.989@gmail.com>

Author: Snehil-Shah

.gitignore

@@ -0,0 +1 @@
+dist/

Makefile

@@ -0,0 +1,12 @@
+EXTENSION = pg_dispatch
+EXTVERSION = 0.1.2
+DATA = pg_dispatch--0.1.2.sql
+
+PG_CONFIG ?= pg_config
+PGXS := $(shell $(PG_CONFIG) --pgxs)
+include $(PGXS)
+
+.PHONY: dist
+dist:
+	mkdir -p dist
+	git archive --format zip --prefix=$(EXTENSION)-$(EXTVERSION)/ -o dist/$(EXTENSION)-$(EXTVERSION).zip HEAD

README.md

@@ -2,13 +2,13 @@
 
 > A [TLE](https://github.com/aws/pg_tle) compliant alternative to [pg_later](https://github.com/ChuckHend/pg_later).
 
-An asynchronous task dispatcher for PostgreSQL that helps unblock your main transaction by offloading heavy SQL as deferrable jobs.
+An asynchronous task dispatcher for PostgreSQL that helps unblock your main transaction by offloading heavy SQL as deferrable jobs, allowing you to run SQL queries asynchronously.
 
-This is meant to be a [TLE](https://github.com/aws/pg_tle) compliant alternative to [pg_later](https://github.com/ChuckHend/pg_later) built on top of [`pg_cron`](https://github.com/citusdata/pg_cron), which means you can easily use it in sandboxed environments like Supabase and AWS RDS.
+This is meant to be a [TLE](https://github.com/aws/pg_tle) compliant alternative to [pg_later](https://github.com/ChuckHend/pg_later) built on top of [pg_cron](https://github.com/citusdata/pg_cron), which means you can easily use it in sandboxed environments like Supabase and AWS RDS.
 
 ## Use cases
 
-This extension is particularly useful when writing database-native server-side logic (in something like PL/pgSQL) and wanting to dispatch **_side-effects_** asynchronously.
+This extension is particularly useful when writing database-native server-side logic (in something like PL/pgSQL) and wanting to dispatch **_side-effects_** asynchronously in a separate transaction.
 
 Say you have an `AFTER INSERT` trigger on a user profiles table that is called every time a new user hops in by calling an [RPC (remote procedure call)](https://docs.postgrest.org/en/v12/references/api/functions.html).
 You can offload the bulky and asynchronous **_side-effects_** (written as PostgreSQL functions), such as sending notifications to other users or updating large tables storing analytics, thereby unblocking your main RPC, for which btw, the client is still waiting for a response from.
@@ -21,19 +21,21 @@ You can offload the bulky and asynchronous **_side-effects_** (written as Postgr
 
 ## Installation
 
-Install via [database.dev](https://database.dev/Snehil-Shah/pg_dispatch):
+Install via [database.dev](https://database.dev/Snehil_Shah/pg_dispatch):
 
 ```sql
-SELECT dbdev.install(Snehil-Shah@pg_dispatch);
+SELECT dbdev.install(Snehil_Shah@pg_dispatch);
 ```
 
+To learn how to install `dbdev` and published TLE extensions, read [here](https://supabase.github.io/dbdev/install-in-db-client/).
+
 > [!WARNING]
 > This extension is installed in the `pgdispatch` schema and can potentially cause namespace collisions if you already had one before.
 
 ## Usage
 
 ```sql
-CREATE EXTENSION "Snehil-Shah@pg_dispatch";
+CREATE EXTENSION "Snehil_Shah@pg_dispatch";
 ```
 
 <!-- <docs> -->

pg_dispatch--0.1.2.sql

@@ -21,9 +21,9 @@ COMMENT ON SCHEMA pgdispatch IS
 'Reserved for the pg_dispatch extension';
 
 /**
- * (internal) ### pgdispatch._schedule_job
+ * (internal) ### pgdispatch._schedule_job( command TEXT, delay INTERVAL )
  *
- * Internal function for scheduling temporary cron jobs
+ * Internal function for scheduling temporary cron jobs.
  *
  * #### Parameters:
  *   - **command** (`TEXT`) - The SQL statement to execute
@@ -89,7 +89,7 @@ COMMENT ON FUNCTION pgdispatch._schedule_job(TEXT, INTERVAL) IS
 /**
  * ### pgdispatch.fire( command TEXT )
  *
- * Dispatches an SQL command for asynchronous execution
+ * Dispatches an SQL command for asynchronous execution.
  *
  * ```sql
  * SELECT pgdispatch.fire('SELECT pg_sleep(40);');
@@ -114,7 +114,7 @@ COMMENT ON FUNCTION pgdispatch.fire(TEXT) IS
 /**
  * ### pgdispatch.snooze( command TEXT, delay INTERVAL )
  *
- * Dispatches a delayed SQL command for asynchronous execution
+ * Dispatches a delayed SQL command for asynchronous execution.
  *
  * ```sql
  * SELECT pgdispatch.snooze('SELECT pg_sleep(20);', '20 seconds');