@pgpm/stamps 0.4.0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Dan Lynch <pyramation@gmail.com>
+Copyright (c) 2025 Interweb, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Makefile

@@ -0,0 +1,6 @@
+EXTENSION = launchql-stamps
+DATA = sql/launchql-stamps--0.4.6.sql
+
+PG_CONFIG = pg_config
+PGXS := $(shell $(PG_CONFIG) --pgxs)
+include $(PGXS)

package/README.md

@@ -0,0 +1,5 @@
+# @pgpm/stamps
+
+Timestamp utilities and audit trail functions for PostgreSQL.
+
+Provides created_at, updated_at, and other timestamp management functions for tracking data changes and audit trails.

package/__tests__/stamps.test.ts

@@ -0,0 +1,54 @@
+import { getConnections, PgTestClient } from 'pgsql-test';
+
+let pg: PgTestClient;
+let teardown:  () => Promise<void>;
+
+beforeAll(async () => {
+  ({ pg, teardown } = await getConnections());
+
+  await pg.any(`
+    CREATE TABLE public.test_stamps (
+      id serial PRIMARY KEY,
+      name text,
+      created_at timestamptz,
+      updated_at timestamptz,
+      created_by uuid,
+      updated_by uuid
+    );
+
+    CREATE TRIGGER set_stamps
+    BEFORE INSERT OR UPDATE ON public.test_stamps
+    FOR EACH ROW
+    EXECUTE FUNCTION stamps.timestamps();
+
+    CREATE TRIGGER set_peoplestamps
+    BEFORE INSERT OR UPDATE ON public.test_stamps
+    FOR EACH ROW
+    EXECUTE FUNCTION stamps.peoplestamps();
+  `);
+});
+
+afterAll(async () => {
+  try {
+    await teardown();
+  } catch (e) {
+    console.error('Teardown failed:', e);
+  }
+});
+
+beforeEach(() => pg.beforeEach());
+afterEach(() => pg.afterEach());
+
+it('applies timestamps and peoplestamps', async () => {
+  await pg.setContext({ 'jwt.claims.user_id': '00000000-0000-0000-0000-000000000001' });
+
+  const insertRes = await pg.one(
+    `INSERT INTO public.test_stamps (name) VALUES ($1) RETURNING *`,
+    ['Alice']
+  );
+
+  expect(insertRes.created_at).toBeTruthy();
+  expect(insertRes.updated_at).toBeTruthy();
+  expect(insertRes.created_by).toBe('00000000-0000-0000-0000-000000000001');
+  expect(insertRes.updated_by).toBe('00000000-0000-0000-0000-000000000001');
+});

package/deploy/schemas/stamps/procedures/utils.sql

@@ -0,0 +1,35 @@
+-- Deploy schemas/stamps/procedures/utils to pg
+
+-- requires: schemas/stamps/schema
+
+BEGIN;
+
+CREATE FUNCTION stamps.peoplestamps()
+RETURNS TRIGGER AS $$
+BEGIN
+    IF TG_OP = 'INSERT' THEN
+      NEW.created_by = jwt_public.current_user_id();
+      NEW.updated_by = jwt_public.current_user_id();
+    ELSIF TG_OP = 'UPDATE' THEN
+      NEW.created_by = OLD.created_by;
+      NEW.updated_by = jwt_public.current_user_id();
+    END IF;
+    RETURN NEW;
+END;
+$$ LANGUAGE 'plpgsql';
+
+CREATE FUNCTION stamps.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 = NOW();
+    END IF;
+    RETURN NEW;
+END;
+$$ LANGUAGE 'plpgsql';
+
+COMMIT;

package/deploy/schemas/stamps/schema.sql

@@ -0,0 +1,15 @@
+-- Deploy schemas/stamps/schema to pg
+
+
+BEGIN;
+
+CREATE SCHEMA stamps;
+
+GRANT USAGE ON SCHEMA stamps
+TO authenticated, anonymous;
+
+ALTER DEFAULT PRIVILEGES IN SCHEMA stamps
+GRANT EXECUTE ON FUNCTIONS
+TO authenticated;
+
+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-stamps.control

@@ -0,0 +1,8 @@
+# launchql-stamps extension
+comment = 'launchql-stamps extension'
+default_version = '0.4.6'
+module_pathname = '$libdir/launchql-stamps'
+requires = 'plpgsql,launchql-jwt-claims,launchql-verify'
+relocatable = false
+superuser = false
+  

package/launchql.plan

@@ -0,0 +1,6 @@
+%syntax-version=1.0.0
+%project=launchql-stamps
+%uri=launchql-stamps
+  
+schemas/stamps/schema 2020-12-18T04:55:26Z Dan Lynch <dlynch@Dans-MBP-3> # add schemas/stamps/schema
+schemas/stamps/procedures/utils [schemas/stamps/schema] 2020-12-18T04:57:09Z Dan Lynch <dlynch@Dans-MBP-3> # add schemas/stamps/procedures/utils

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@pgpm/stamps",
+  "version": "0.4.0",
+  "description": "Timestamp utilities and audit trail functions for PostgreSQL",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "bundle": "lql package",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "dependencies": {
+    "@pgpm/jwt-claims": "0.4.0",
+    "@pgpm/verify": "0.4.0"
+  },
+  "devDependencies": {
+    "@launchql/cli": "^4.9.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/launchql/extensions"
+  },
+  "homepage": "https://github.com/launchql/extensions",
+  "bugs": {
+    "url": "https://github.com/launchql/extensions/issues"
+  },
+  "gitHead": "cc9f52a335caa6e21ee7751b04b77c84ce6cb809"
+}

package/revert/schemas/stamps/procedures/utils.sql

@@ -0,0 +1,8 @@
+-- Revert schemas/stamps/procedures/utils from pg
+
+BEGIN;
+
+DROP FUNCTION stamps.peoplestamps();
+DROP FUNCTION stamps.timestamps();
+
+COMMIT;

package/revert/schemas/stamps/schema.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/stamps/schema from pg
+
+BEGIN;
+
+DROP SCHEMA stamps;
+
+COMMIT;

package/sql/launchql-stamps--0.4.6.sql

@@ -0,0 +1,33 @@
+\echo Use "CREATE EXTENSION launchql-stamps" to load this file. \quit
+CREATE SCHEMA stamps;
+
+GRANT USAGE ON SCHEMA stamps TO authenticated, anonymous;
+
+ALTER DEFAULT PRIVILEGES IN SCHEMA stamps
+  GRANT EXECUTE ON FUNCTIONS TO authenticated;
+
+CREATE FUNCTION stamps.peoplestamps() RETURNS trigger AS $EOFCODE$
+BEGIN
+    IF TG_OP = 'INSERT' THEN
+      NEW.created_by = jwt_public.current_user_id();
+      NEW.updated_by = jwt_public.current_user_id();
+    ELSIF TG_OP = 'UPDATE' THEN
+      NEW.created_by = OLD.created_by;
+      NEW.updated_by = jwt_public.current_user_id();
+    END IF;
+    RETURN NEW;
+END;
+$EOFCODE$ LANGUAGE plpgsql;
+
+CREATE FUNCTION stamps.timestamps() RETURNS trigger AS $EOFCODE$
+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 = NOW();
+    END IF;
+    RETURN NEW;
+END;
+$EOFCODE$ LANGUAGE plpgsql;

package/verify/schemas/stamps/procedures/utils.sql

@@ -0,0 +1,8 @@
+-- Verify schemas/stamps/procedures/utils  on pg
+
+BEGIN;
+
+SELECT verify_function ('stamps.peoplestamps');
+SELECT verify_function ('stamps.timestamps');
+
+ROLLBACK;

package/verify/schemas/stamps/schema.sql

@@ -0,0 +1,7 @@
+-- Verify schemas/stamps/schema  on pg
+
+BEGIN;
+
+SELECT verify_schema ('stamps');
+
+ROLLBACK;