@pgpm/stamps 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/Makefile CHANGED
@@ -1,5 +1,5 @@
1
1
  EXTENSION = launchql-stamps
2
- DATA = sql/launchql-stamps--0.4.0.sql
2
+ DATA = sql/launchql-stamps--0.6.0.sql
3
3
 
4
4
  PG_CONFIG = pg_config
5
5
  PGXS := $(shell $(PG_CONFIG) --pgxs)
package/README.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # @pgpm/stamps
2
2
 
3
+ <p align="center" width="100%">
4
+ <img height="250" src="https://raw.githubusercontent.com/launchql/launchql/refs/heads/main/assets/outline-logo.svg" />
5
+ </p>
6
+
7
+ <p align="center" width="100%">
8
+ <a href="https://github.com/launchql/pgpm-modules/actions/workflows/ci.yml">
9
+ <img height="20" src="https://github.com/launchql/pgpm-modules/actions/workflows/ci.yml/badge.svg" />
10
+ </a>
11
+ <a href="https://github.com/launchql/pgpm-modules/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
12
+ <a href="https://www.npmjs.com/package/@pgpm/stamps"><img height="20" src="https://img.shields.io/github/package-json/v/launchql/pgpm-modules?filename=packages%2Fdata-types%2Fstamps%2Fpackage.json"/></a>
13
+ </p>
14
+
3
15
  Timestamp utilities and audit trail functions for PostgreSQL.
4
16
 
5
17
  ## Overview
@@ -27,40 +39,42 @@ This is a quick way to get started. The sections below provide more detailed ins
27
39
  ### Prerequisites
28
40
 
29
41
  ```bash
30
- # Install pgpm globally
42
+ # Install pgpm CLI
31
43
  npm install -g pgpm
32
44
 
33
- # Start PostgreSQL
45
+ # Start local Postgres (via Docker) and export env vars
34
46
  pgpm docker start
35
-
36
- # Set environment variables
37
47
  eval "$(pgpm env)"
38
48
  ```
39
49
 
40
- ### Deploy
50
+ > **Tip:** Already running Postgres? Skip the Docker step and just export your `PG*` environment variables.
41
51
 
42
- #### Option 1: Deploy by installing with pgpm
52
+ ### **Add to an Existing Package**
43
53
 
44
54
  ```bash
55
+ # 1. Install the package
45
56
  pgpm install @pgpm/stamps
46
- pgpm deploy
57
+
58
+ # 2. Deploy locally
59
+ pgpm deploy
47
60
  ```
48
61
 
49
- #### Option 2: Deploy from Package Directory
62
+ ### **Add to a New Project**
50
63
 
51
64
  ```bash
52
- cd packages/data-types/stamps
53
- pgpm deploy --createdb
54
- ```
65
+ # 1. Create a workspace
66
+ pgpm init --workspace
67
+ cd my-app
55
68
 
56
- #### Option 3: Deploy from Workspace Root
69
+ # 2. Create your first module
70
+ pgpm init
71
+ cd packages/your-module
57
72
 
58
- ```bash
59
- # Install workspace dependencies
60
- pgpm install
73
+ # 3. Install a package
74
+ pgpm install @pgpm/stamps
61
75
 
62
- # Deploy with dependencies
63
- pgpm deploy mydb1 --yes --createdb
76
+ # 4. Deploy everything
77
+ pgpm deploy --createdb --database mydb1
64
78
  ```
65
79
 
66
80
  ## Usage
@@ -187,76 +201,6 @@ The test suite validates:
187
201
  - Preservation of creation timestamps and users on updates
188
202
  - Integration with JWT claims for user context
189
203
 
190
- ## Development
191
-
192
- See the [Development](#development) section below for information on working with this package.
193
-
194
- ---
195
-
196
- ## Development
197
-
198
- ### **Before You Begin**
199
-
200
- ```bash
201
- # 1. Install pgpm
202
- npm install -g pgpm
203
-
204
- # 2. Start Postgres (Docker or local)
205
- pgpm docker start
206
-
207
- # 3. Load PG* environment variables (PGHOST, PGUSER, ...)
208
- eval "$(pgpm env)"
209
- ```
210
-
211
- ---
212
-
213
- ### **Starting a New Project**
214
-
215
- ```bash
216
- # 1. Create a workspace
217
- pgpm init --workspace
218
- cd my-app
219
-
220
- # 2. Create your first module
221
- pgpm init
222
-
223
- # 3. Add a migration
224
- pgpm add some_change
225
-
226
- # 4. Deploy (auto-creates database)
227
- pgpm deploy --createdb
228
- ```
229
-
230
- ---
231
-
232
- ### **Working With an Existing Project**
233
-
234
- ```bash
235
- # 1. Clone and enter the project
236
- git clone <repo> && cd <project>
237
-
238
- # 2. Install dependencies
239
- pnpm install
240
-
241
- # 3. Deploy locally
242
- pgpm deploy --createdb
243
- ```
244
-
245
- ---
246
-
247
- ### **Testing a Module Inside a Workspace**
248
-
249
- ```bash
250
- # 1. Install workspace deps
251
- pnpm install
252
-
253
- # 2. Enter the module directory
254
- cd packages/<some-module>
255
-
256
- # 3. Run tests in watch mode
257
- pnpm test:watch
258
- ```
259
-
260
204
  ## Related Tooling
261
205
 
262
206
  * [pgpm](https://github.com/launchql/launchql/tree/main/packages/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
@@ -1,6 +1,6 @@
1
1
  # launchql-stamps extension
2
2
  comment = 'launchql-stamps extension'
3
- default_version = '0.4.0'
3
+ default_version = '0.6.0'
4
4
  module_pathname = '$libdir/launchql-stamps'
5
5
  requires = 'plpgsql,launchql-jwt-claims,launchql-verify'
6
6
  relocatable = false
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pgpm/stamps",
3
- "version": "0.5.0",
3
+ "version": "0.7.0",
4
4
  "description": "Timestamp utilities and audit trail functions for PostgreSQL",
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -11,19 +11,19 @@
11
11
  "test:watch": "jest --watch"
12
12
  },
13
13
  "dependencies": {
14
- "@pgpm/jwt-claims": "0.5.0",
15
- "@pgpm/verify": "0.5.0"
14
+ "@pgpm/jwt-claims": "0.7.0",
15
+ "@pgpm/verify": "0.7.0"
16
16
  },
17
17
  "devDependencies": {
18
18
  "pgpm": "^0.2.0"
19
19
  },
20
20
  "repository": {
21
21
  "type": "git",
22
- "url": "https://github.com/launchql/extensions"
22
+ "url": "https://github.com/launchql/pgpm-modules"
23
23
  },
24
- "homepage": "https://github.com/launchql/extensions",
24
+ "homepage": "https://github.com/launchql/pgpm-modules",
25
25
  "bugs": {
26
- "url": "https://github.com/launchql/extensions/issues"
26
+ "url": "https://github.com/launchql/pgpm-modules/issues"
27
27
  },
28
- "gitHead": "d8eedbb24ad22a106634bc3b919bfb8d41976c16"
28
+ "gitHead": "1f24d8fa95fb141f16e5b8345458c3b687d80908"
29
29
  }