@pgpm/database-jobs 0.4.0

package/deploy/schemas/app_jobs/procedures/permanently_fail_jobs.sql

@@ -0,0 +1,24 @@
+-- Deploy schemas/app_jobs/procedures/permanently_fail_jobs to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/job_queues/table
+-- requires: schemas/app_jobs/tables/jobs/table
+
+BEGIN;
+CREATE FUNCTION app_jobs.permanently_fail_jobs (job_ids bigint[], error_message text DEFAULT NULL)
+  RETURNS SETOF app_jobs.jobs
+  LANGUAGE sql
+  AS $$
+  UPDATE
+    app_jobs.jobs
+  SET
+    last_error = coalesce(error_message, 'Manually marked as failed'),
+    attempts = max_attempts
+  WHERE
+    id = ANY (job_ids)
+    AND (locked_by IS NULL
+      OR locked_at < NOW() - interval '4 hours')
+  RETURNING
+    *;
+$$;
+COMMIT;
+

package/deploy/schemas/app_jobs/procedures/release_jobs.sql

@@ -0,0 +1,34 @@
+-- Deploy schemas/app_jobs/procedures/release_jobs to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/jobs/table
+-- requires: schemas/app_jobs/tables/job_queues/table
+
+BEGIN;
+CREATE FUNCTION app_jobs.release_jobs (worker_id text)
+  RETURNS void
+  AS $$
+DECLARE
+BEGIN
+  -- clear the job
+  UPDATE
+    app_jobs.jobs
+  SET
+    locked_at = NULL,
+    locked_by = NULL,
+    attempts = GREATEST (attempts - 1, 0)
+  WHERE
+    locked_by = worker_id;
+  -- clear the queue
+  UPDATE
+    app_jobs.job_queues
+  SET
+    locked_at = NULL,
+    locked_by = NULL
+  WHERE
+    locked_by = worker_id;
+END;
+$$
+LANGUAGE 'plpgsql'
+VOLATILE;
+COMMIT;
+

package/deploy/schemas/app_jobs/procedures/release_scheduled_jobs.sql

@@ -0,0 +1,26 @@
+-- Deploy schemas/app_jobs/procedures/release_scheduled_jobs to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/scheduled_jobs/table
+
+BEGIN;
+CREATE FUNCTION app_jobs.release_scheduled_jobs (worker_id text, ids bigint[] DEFAULT NULL)
+  RETURNS void
+  AS $$
+DECLARE
+BEGIN
+  -- clear the scheduled job
+  UPDATE
+    app_jobs.scheduled_jobs s
+  SET
+    locked_at = NULL,
+    locked_by = NULL
+  WHERE
+    locked_by = worker_id
+    AND (ids IS NULL
+      OR s.id = ANY (ids));
+END;
+$$
+LANGUAGE 'plpgsql'
+VOLATILE;
+COMMIT;
+

package/deploy/schemas/app_jobs/procedures/reschedule_jobs.sql

@@ -0,0 +1,26 @@
+-- Deploy schemas/app_jobs/procedures/reschedule_jobs to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/jobs/table
+
+BEGIN;
+-- NOTE this should be renamed to reset_jobs to avoid confusion of scheduled jobs
+CREATE FUNCTION app_jobs.reschedule_jobs (job_ids bigint[], run_at timestamptz DEFAULT NULL, priority integer DEFAULT NULL, attempts integer DEFAULT NULL, max_attempts integer DEFAULT NULL)
+  RETURNS SETOF app_jobs.jobs
+  LANGUAGE sql
+  AS $$
+  UPDATE
+    app_jobs.jobs
+  SET
+    run_at = coalesce(reschedule_jobs.run_at, jobs.run_at),
+    priority = coalesce(reschedule_jobs.priority, jobs.priority),
+    attempts = coalesce(reschedule_jobs.attempts, jobs.attempts),
+    max_attempts = coalesce(reschedule_jobs.max_attempts, jobs.max_attempts)
+  WHERE
+    id = ANY (job_ids)
+    AND (locked_by IS NULL
+      OR locked_at < NOW() - interval '4 hours')
+  RETURNING
+    *;
+$$;
+COMMIT;
+

package/deploy/schemas/app_jobs/procedures/run_scheduled_job.sql

@@ -0,0 +1,78 @@
+-- Deploy schemas/app_jobs/procedures/run_scheduled_job to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/jobs/table
+-- requires: schemas/app_jobs/tables/scheduled_jobs/table
+
+BEGIN;
+CREATE FUNCTION app_jobs.run_scheduled_job (id bigint, job_expiry interval DEFAULT '1 hours')
+  RETURNS app_jobs.jobs
+  AS $$
+DECLARE
+  j app_jobs.jobs;
+  last_id bigint;
+  lkd_by text;
+BEGIN
+  -- check last scheduled
+  SELECT
+    last_scheduled_id
+  FROM
+    app_jobs.scheduled_jobs s
+  WHERE
+    s.id = run_scheduled_job.id INTO last_id;
+
+  -- if it's been scheduled check if it's been run
+  
+  IF (last_id IS NOT NULL) THEN
+    SELECT
+      locked_by
+    FROM
+      app_jobs.jobs js
+    WHERE
+      js.id = last_id
+      AND (js.locked_at IS NULL -- never been run
+        OR js.locked_at >= (NOW() - job_expiry)
+        -- still running within a safe interval
+) INTO lkd_by;
+    IF (FOUND) THEN
+      RAISE EXCEPTION 'ALREADY_SCHEDULED';
+    END IF;
+  END IF;
+
+  -- insert new job
+  INSERT INTO app_jobs.jobs (
+    database_id,
+    queue_name,
+    task_identifier,
+    payload,
+    priority,
+    max_attempts,
+    key
+  ) SELECT
+    database_id,
+    queue_name,
+    task_identifier,
+    payload,
+    priority,
+    max_attempts,
+    key
+  FROM
+    app_jobs.scheduled_jobs s
+  WHERE
+    s.id = run_scheduled_job.id
+  RETURNING
+    * INTO j;
+  -- update the scheduled job
+  UPDATE
+    app_jobs.scheduled_jobs s
+  SET
+    last_scheduled = NOW(),
+    last_scheduled_id = j.id
+  WHERE
+    s.id = run_scheduled_job.id;
+  RETURN j;
+END;
+$$
+LANGUAGE 'plpgsql'
+VOLATILE;
+COMMIT;
+

package/deploy/schemas/app_jobs/schema.sql

@@ -0,0 +1,7 @@
+-- Deploy schemas/app_jobs/schema to pg
+BEGIN;
+CREATE SCHEMA IF NOT EXISTS app_jobs;
+GRANT USAGE ON SCHEMA app_jobs TO administrator;
+ALTER DEFAULT PRIVILEGES IN SCHEMA app_jobs GRANT EXECUTE ON FUNCTIONS TO administrator;
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/job_queues/grants/grant_select_insert_update_delete_to_administrator.sql

@@ -0,0 +1,12 @@
+-- Deploy schemas/app_jobs/tables/job_queues/grants/grant_select_insert_update_delete_to_administrator to pg
+
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/job_queues/table
+
+BEGIN;
+
+-- TODO make sure to require any policies on this table!
+
+GRANT SELECT, INSERT, UPDATE, DELETE ON TABLE app_jobs.job_queues TO administrator;
+
+COMMIT;

package/deploy/schemas/app_jobs/tables/job_queues/indexes/job_queues_locked_by_idx.sql

@@ -0,0 +1,8 @@
+-- Deploy schemas/app_jobs/tables/job_queues/indexes/job_queues_locked_by_idx to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/job_queues/table
+
+BEGIN;
+CREATE INDEX job_queues_locked_by_idx ON app_jobs.job_queues (locked_by);
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/job_queues/table.sql

@@ -0,0 +1,12 @@
+-- Deploy schemas/app_jobs/tables/job_queues/table to pg
+-- requires: schemas/app_jobs/schema
+
+BEGIN;
+CREATE TABLE app_jobs.job_queues (
+  queue_name text NOT NULL PRIMARY KEY,
+  job_count int DEFAULT 0 NOT NULL,
+  locked_at timestamptz,
+  locked_by text
+);
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/jobs/grants/grant_select_insert_update_delete_to_administrator.sql

@@ -0,0 +1,12 @@
+-- Deploy schemas/app_jobs/tables/jobs/grants/grant_select_insert_update_delete_to_administrator to pg
+
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/jobs/table
+
+BEGIN;
+
+-- TODO make sure to require any policies on this table!
+
+GRANT SELECT, INSERT, UPDATE, DELETE ON TABLE app_jobs.jobs TO administrator;
+
+COMMIT;

package/deploy/schemas/app_jobs/tables/jobs/indexes/jobs_locked_by_idx.sql

@@ -0,0 +1,8 @@
+-- Deploy schemas/app_jobs/tables/jobs/indexes/jobs_locked_by_idx to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/jobs/table
+
+BEGIN;
+CREATE INDEX jobs_locked_by_idx ON app_jobs.jobs (locked_by);
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/jobs/indexes/priority_run_at_id_idx.sql

@@ -0,0 +1,8 @@
+-- Deploy schemas/app_jobs/tables/jobs/indexes/priority_run_at_id_idx to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/jobs/table
+
+BEGIN;
+CREATE INDEX priority_run_at_id_idx ON app_jobs.jobs (priority, run_at, id);
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/jobs/table.sql

@@ -0,0 +1,27 @@
+-- Deploy schemas/app_jobs/tables/jobs/table to pg
+-- requires: schemas/app_jobs/schema
+
+BEGIN;
+CREATE TABLE app_jobs.jobs (
+  id bigserial PRIMARY KEY,
+  database_id uuid NOT NULL,
+  queue_name text DEFAULT (public.gen_random_uuid ()) ::text,
+  task_identifier text NOT NULL,
+  payload json DEFAULT '{}' ::json NOT NULL,
+  priority integer DEFAULT 0 NOT NULL,
+  run_at timestamptz DEFAULT now() NOT NULL,
+  attempts integer DEFAULT 0 NOT NULL,
+  max_attempts integer DEFAULT 25 NOT NULL,
+  key text,
+  last_error text,
+  locked_at timestamptz,
+  locked_by text,
+  CHECK (length(key) < 513),
+  CHECK (length(task_identifier) < 127),
+  CHECK (max_attempts > 0),
+  CHECK (length(queue_name) < 127),
+  CHECK (length(locked_by) > 3),
+  UNIQUE (key)
+);
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/jobs/triggers/decrease_job_queue_count.sql

@@ -0,0 +1,45 @@
+-- Deploy schemas/app_jobs/tables/jobs/triggers/decrease_job_queue_count to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/jobs/table
+
+BEGIN;
+CREATE FUNCTION app_jobs.tg_decrease_job_queue_count ()
+  RETURNS TRIGGER
+  AS $$
+DECLARE
+  v_new_job_count int;
+BEGIN
+  UPDATE
+    app_jobs.job_queues
+  SET
+    job_count = job_queues.job_count - 1
+  WHERE
+    queue_name = OLD.queue_name
+  RETURNING
+    job_count INTO v_new_job_count;
+  IF v_new_job_count <= 0 THEN
+    DELETE FROM app_jobs.job_queues
+    WHERE queue_name = OLD.queue_name
+      AND job_count <= 0;
+  END IF;
+  RETURN OLD;
+END;
+$$
+LANGUAGE 'plpgsql'
+VOLATILE;
+
+CREATE TRIGGER decrease_job_queue_count_on_delete
+  AFTER DELETE ON app_jobs.jobs
+  FOR EACH ROW
+  WHEN ((OLD.queue_name IS NOT NULL))
+  EXECUTE PROCEDURE app_jobs.tg_decrease_job_queue_count ();
+
+-- only a person would do this...
+CREATE TRIGGER decrease_job_queue_count_on_update
+  AFTER UPDATE OF queue_name ON app_jobs.jobs
+  FOR EACH ROW
+  WHEN (((NEW.queue_name IS DISTINCT FROM OLD.queue_name) AND (OLD.queue_name IS NOT NULL)))
+  EXECUTE PROCEDURE app_jobs.tg_decrease_job_queue_count ();
+  
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/jobs/triggers/increase_job_queue_count.sql

@@ -0,0 +1,32 @@
+-- Deploy schemas/app_jobs/tables/jobs/triggers/increase_job_queue_count to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/jobs/table
+
+BEGIN;
+CREATE FUNCTION app_jobs.tg_increase_job_queue_count ()
+  RETURNS TRIGGER
+  AS $$
+BEGIN
+  INSERT INTO app_jobs.job_queues (queue_name, job_count)
+    VALUES (NEW.queue_name, 1)
+  ON CONFLICT (queue_name)
+    DO UPDATE SET
+      job_count = job_queues.job_count + 1;
+  RETURN NEW;
+END;
+$$
+LANGUAGE 'plpgsql'
+VOLATILE;
+CREATE TRIGGER _500_increase_job_queue_count_on_insert
+  AFTER INSERT ON app_jobs.jobs
+  FOR EACH ROW
+  WHEN ((NEW.queue_name IS NOT NULL))
+  EXECUTE PROCEDURE app_jobs.tg_increase_job_queue_count ();
+-- only a person would do this
+CREATE TRIGGER _500_increase_job_queue_count_on_update
+  AFTER UPDATE OF queue_name ON app_jobs.jobs
+  FOR EACH ROW
+  WHEN (((NEW.queue_name IS DISTINCT FROM OLD.queue_name) AND (NEW.queue_name IS NOT NULL)))
+  EXECUTE PROCEDURE app_jobs.tg_increase_job_queue_count ();
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/jobs/triggers/notify_worker.sql

@@ -0,0 +1,13 @@
+-- Deploy schemas/app_jobs/tables/jobs/triggers/notify_worker to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/jobs/table
+-- requires: schemas/app_jobs/procedures/do_notify
+-- requires: schemas/app_jobs/tables/jobs/triggers/increase_job_queue_count
+
+BEGIN;
+CREATE TRIGGER _900_notify_worker
+    AFTER INSERT ON app_jobs.jobs
+    FOR EACH ROW
+    EXECUTE PROCEDURE app_jobs.do_notify ('jobs:insert');
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/jobs/triggers/timestamps.sql

@@ -0,0 +1,20 @@
+-- Deploy schemas/app_jobs/tables/jobs/triggers/timestamps to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/jobs/table
+-- requires: schemas/app_jobs/triggers/tg_update_timestamps
+
+BEGIN;
+ALTER TABLE app_jobs.jobs
+    ADD COLUMN created_at timestamptz;
+ALTER TABLE app_jobs.jobs
+    ALTER COLUMN created_at SET DEFAULT NOW();
+ALTER TABLE app_jobs.jobs
+    ADD COLUMN updated_at timestamptz;
+ALTER TABLE app_jobs.jobs
+    ALTER COLUMN updated_at SET DEFAULT NOW();
+CREATE TRIGGER _100_update_jobs_modtime_tg
+    BEFORE UPDATE OR INSERT ON app_jobs.jobs
+    FOR EACH ROW
+    EXECUTE PROCEDURE app_jobs.tg_update_timestamps ();
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/scheduled_jobs/grants/grant_select_insert_update_delete_to_administrator.sql

@@ -0,0 +1,12 @@
+-- Deploy schemas/app_jobs/tables/scheduled_jobs/grants/grant_select_insert_update_delete_to_administrator to pg
+
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/scheduled_jobs/table
+
+BEGIN;
+
+-- TODO make sure to require any policies on this table!
+
+GRANT SELECT, INSERT, UPDATE, DELETE ON TABLE app_jobs.scheduled_jobs TO administrator;
+
+COMMIT;

package/deploy/schemas/app_jobs/tables/scheduled_jobs/indexes/scheduled_jobs_locked_by_idx.sql

@@ -0,0 +1,8 @@
+-- Deploy schemas/app_jobs/tables/scheduled_jobs/indexes/scheduled_jobs_locked_by_idx to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/scheduled_jobs/table
+
+BEGIN;
+CREATE INDEX scheduled_jobs_locked_by_idx ON app_jobs.scheduled_jobs (locked_by);
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/scheduled_jobs/indexes/scheduled_jobs_priority_id_idx.sql

@@ -0,0 +1,8 @@
+-- Deploy schemas/app_jobs/tables/scheduled_jobs/indexes/scheduled_jobs_priority_id_idx to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/scheduled_jobs/table
+
+BEGIN;
+CREATE INDEX scheduled_jobs_priority_id_idx ON app_jobs.scheduled_jobs (priority, id);
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/scheduled_jobs/table.sql

@@ -0,0 +1,27 @@
+-- Deploy schemas/app_jobs/tables/scheduled_jobs/table to pg
+-- requires: schemas/app_jobs/schema
+
+BEGIN;
+CREATE TABLE app_jobs.scheduled_jobs (
+  id bigserial PRIMARY KEY,
+  database_id uuid NOT NULL,
+  queue_name text DEFAULT (public.gen_random_uuid ()) ::text,
+  task_identifier text NOT NULL,
+  payload json DEFAULT '{}' ::json NOT NULL,
+  priority integer DEFAULT 0 NOT NULL,
+  max_attempts integer DEFAULT 25 NOT NULL,
+  key text,
+  locked_at timestamptz,
+  locked_by text,
+  schedule_info json NOT NULL,
+  last_scheduled timestamptz,
+  last_scheduled_id bigint,
+  CHECK (length(key) < 513),
+  CHECK (length(task_identifier) < 127),
+  CHECK (max_attempts > 0),
+  CHECK (length(queue_name) < 127),
+  CHECK (length(locked_by) > 3),
+  UNIQUE (key)
+);
+COMMIT;
+

package/deploy/schemas/app_jobs/tables/scheduled_jobs/triggers/notify_scheduled_job.sql

@@ -0,0 +1,12 @@
+-- Deploy schemas/app_jobs/tables/scheduled_jobs/triggers/notify_scheduled_job to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/tables/scheduled_jobs/table
+-- requires: schemas/app_jobs/procedures/do_notify 
+
+BEGIN;
+CREATE TRIGGER _900_notify_scheduled_job
+    AFTER INSERT ON app_jobs.scheduled_jobs
+    FOR EACH ROW
+    EXECUTE PROCEDURE app_jobs.do_notify ('scheduled_jobs:insert');
+COMMIT;
+

package/deploy/schemas/app_jobs/triggers/tg_add_job_with_fields.sql

@@ -0,0 +1,50 @@
+-- Deploy schemas/app_jobs/triggers/tg_add_job_with_fields to pg
+-- requires: schemas/app_jobs/schema
+-- requires: schemas/app_jobs/helpers/json_build_object_apply
+
+BEGIN;
+CREATE FUNCTION app_jobs.trigger_job_with_fields ()
+  RETURNS TRIGGER
+  AS $$
+DECLARE
+  arg text;
+  fn text;
+  i int;
+  args text[];
+BEGIN
+  FOR i IN
+  SELECT
+    *
+  FROM
+    generate_series(1, TG_NARGS) g (i)
+    LOOP
+      IF (i = 1) THEN
+        fn = TG_ARGV[i - 1];
+      ELSE
+        args = array_append(args, TG_ARGV[i - 1]);
+        IF (TG_OP = 'INSERT' OR TG_OP = 'UPDATE') THEN
+          EXECUTE format('SELECT ($1).%s::text', TG_ARGV[i - 1])
+          USING NEW INTO arg;
+        END IF;
+        IF (TG_OP = 'DELETE') THEN
+          EXECUTE format('SELECT ($1).%s::text', TG_ARGV[i - 1])
+          USING OLD INTO arg;
+        END IF;
+        args = array_append(args, arg);
+      END IF;
+    END LOOP;
+  PERFORM
+    app_jobs.add_job (jwt_private.current_database_id(), fn, app_jobs.json_build_object_apply (args));
+  IF (TG_OP = 'INSERT' OR TG_OP = 'UPDATE') THEN
+    RETURN NEW;
+  END IF;
+  IF (TG_OP = 'DELETE') THEN
+    RETURN OLD;
+  END IF;
+END;
+$$
+LANGUAGE plpgsql
+VOLATILE
+SECURITY DEFINER;
+COMMIT;
+

package/deploy/schemas/app_jobs/triggers/tg_add_job_with_row.sql

@@ -0,0 +1,26 @@
+-- Deploy schemas/app_jobs/triggers/tg_add_job_with_row to pg
+-- requires: schemas/app_jobs/schema
+
+BEGIN;
+CREATE FUNCTION app_jobs.tg_add_job_with_row ()
+  RETURNS TRIGGER
+  AS $$
+BEGIN
+  IF (TG_OP = 'INSERT' OR TG_OP = 'UPDATE') THEN
+    PERFORM
+      app_jobs.add_job (jwt_private.current_database_id(), TG_ARGV[0], to_json(NEW));
+    RETURN NEW;
+  END IF;
+  IF (TG_OP = 'DELETE') THEN
+    PERFORM
+      app_jobs.add_job (jwt_private.current_database_id(), TG_ARGV[0], to_json(OLD));
+    RETURN OLD;
+  END IF;
+END;
+$$
+LANGUAGE plpgsql
+VOLATILE
+SECURITY DEFINER;
+COMMENT ON FUNCTION app_jobs.tg_add_job_with_row IS E'Useful shortcut to create a job on insert or update. Pass the task name as the trigger argument, and the record data will automatically be available on the JSON payload.';
+COMMIT;
+

package/deploy/schemas/app_jobs/triggers/tg_add_job_with_row_id.sql

@@ -0,0 +1,27 @@
+-- Deploy schemas/app_jobs/triggers/tg_add_job_with_row_id to pg
+
+-- requires: schemas/app_jobs/schema
+
+BEGIN;
+CREATE FUNCTION app_jobs.tg_add_job_with_row_id ()
+  RETURNS TRIGGER
+  AS $$
+BEGIN
+  IF (TG_OP = 'INSERT' OR TG_OP = 'UPDATE') THEN
+    PERFORM
+      app_jobs.add_job (jwt_private.current_database_id(), tg_argv[0], json_build_object('id', NEW.id));
+    RETURN NEW;
+  END IF;
+  IF (TG_OP = 'DELETE') THEN
+    PERFORM
+      app_jobs.add_job (jwt_private.current_database_id(), tg_argv[0], json_build_object('id', OLD.id));
+    RETURN OLD;
+  END IF;
+END;
+$$
+LANGUAGE plpgsql
+VOLATILE
+SECURITY DEFINER;
+COMMENT ON FUNCTION app_jobs.tg_add_job_with_row_id IS E'Useful shortcut to create a job on insert or update. Pass the task name as the trigger argument, and the record id will automatically be available on the JSON payload.';
+COMMIT;
+

package/deploy/schemas/app_jobs/triggers/tg_update_timestamps.sql

@@ -0,0 +1,21 @@
+-- Deploy schemas/app_jobs/triggers/tg_update_timestamps to pg
+-- requires: schemas/app_jobs/schema
+
+BEGIN;
+CREATE FUNCTION app_jobs.tg_update_timestamps ()
+  RETURNS TRIGGER
+  AS $$
+BEGIN
+  IF TG_OP = 'INSERT' THEN
+    NEW.created_at = NOW();
+    NEW.updated_at = NOW();
+  ELSIF TG_OP = 'UPDATE' THEN
+    NEW.created_at = OLD.created_at;
+    NEW.updated_at = greatest (now(), OLD.updated_at + interval '1 millisecond');
+  END IF;
+  RETURN NEW;
+END;
+$$
+LANGUAGE 'plpgsql';
+COMMIT;
+

package/jest.config.js

@@ -0,0 +1,15 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+
+  // Match both __tests__ and colocated test files
+  testMatch: ['**/?(*.)+(test|spec).{ts,tsx,js,jsx}'],
+
+  // Ignore build artifacts and type declarations
+  testPathIgnorePatterns: ['/dist/', '\\.d\\.ts$'],
+  modulePathIgnorePatterns: ['<rootDir>/dist/'],
+  watchPathIgnorePatterns: ['/dist/'],
+
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+};

package/launchql-database-jobs.control

@@ -0,0 +1,8 @@
+# launchql-database-jobs extension
+comment = 'launchql-database-jobs extension'
+default_version = '0.4.6'
+module_pathname = '$libdir/launchql-database-jobs'
+requires = 'plpgsql,uuid-ossp,pgcrypto,launchql-default-roles,launchql-verify'
+relocatable = false
+superuser = false
+