diff --git a/functions/send-email-link/README.md b/functions/send-email-link/README.md index 33705df50..636096353 100644 --- a/functions/send-email-link/README.md +++ b/functions/send-email-link/README.md @@ -1,5 +1,17 @@ # @constructive-io/send-email-link-fn +

+ +

+ +

+ + + + + +

+ Knative-compatible email link function used with the Constructive jobs system. It is designed to be invoked by `@constructive-io/knative-job-worker` as an HTTP function named `send-email-link`. The function: diff --git a/functions/simple-email/README.md b/functions/simple-email/README.md index 9402a38bf..ab3e82d36 100644 --- a/functions/simple-email/README.md +++ b/functions/simple-email/README.md @@ -1,5 +1,17 @@ # @constructive-io/simple-email-fn +

+ +

+ +

+ + + + + +

+ Simple Knative-compatible email function used with the Constructive jobs system. This function is intentionally minimal: it reads an email payload from the job diff --git a/graphile/graphile-cache/README.md b/graphile/graphile-cache/README.md index bc1f66899..5eb5c674b 100644 --- a/graphile/graphile-cache/README.md +++ b/graphile/graphile-cache/README.md @@ -1,15 +1,15 @@ # graphile-cache

- +

- - + + - - + +

diff --git a/graphile/graphile-connection-filter/README.md b/graphile/graphile-connection-filter/README.md index 48a961006..7f1ae3962 100644 --- a/graphile/graphile-connection-filter/README.md +++ b/graphile/graphile-connection-filter/README.md @@ -1,5 +1,17 @@ # graphile-connection-filter +

+ +

+ +

+ + + + + +

+ A PostGraphile v5 native connection filter plugin for the Constructive monorepo. Adds advanced filtering capabilities to connection and list fields, including: diff --git a/graphile/graphile-misc-plugins/README.md b/graphile/graphile-misc-plugins/README.md index 8996f7fdc..4dbc508d5 100644 --- a/graphile/graphile-misc-plugins/README.md +++ b/graphile/graphile-misc-plugins/README.md @@ -1,3 +1,15 @@ # graphile-misc-plugins +

+ +

+ +

+ + + + + +

+ Miscellaneous PostGraphile v5 plugins for Constructive: inflection, conflict detection, meta-schema, type mappings, public-key signature, and more. diff --git a/graphile/graphile-postgis/README.md b/graphile/graphile-postgis/README.md index a5c9ec457..759099c25 100644 --- a/graphile/graphile-postgis/README.md +++ b/graphile/graphile-postgis/README.md @@ -1,5 +1,17 @@ # graphile-postgis +

+ +

+ +

+ + + + + +

+ PostGIS support for PostGraphile v5. Automatically generates GraphQL types for PostGIS geometry and geography columns, including GeoJSON scalar types, dimension-aware interfaces, and subtype-specific fields (coordinates, points, rings, etc.). diff --git a/graphile/graphile-search/README.md b/graphile/graphile-search/README.md index 6453d7f6a..ff75b3816 100644 --- a/graphile/graphile-search/README.md +++ b/graphile/graphile-search/README.md @@ -1,5 +1,17 @@ # graphile-search +

+ +

+ +

+ + + + + +

+ Unified PostGraphile v5 search plugin — abstracts tsvector, BM25, pg_trgm, and pgvector behind a single adapter-based architecture with composite `searchScore`. ## Overview diff --git a/graphile/graphile-sql-expression-validator/README.md b/graphile/graphile-sql-expression-validator/README.md index 64048449b..ecf97c737 100644 --- a/graphile/graphile-sql-expression-validator/README.md +++ b/graphile/graphile-sql-expression-validator/README.md @@ -1,5 +1,17 @@ # graphile-sql-expression-validator +

+ +

+ +

+ + + + + +

+ SQL expression validation and normalization for PostGraphile v5. Validates SQL expressions against a configurable allowlist of functions and schemas, preventing injection of dangerous SQL constructs while allowing safe default expressions. diff --git a/graphile/graphile-upload-plugin/README.md b/graphile/graphile-upload-plugin/README.md index a91809d57..91775f61b 100644 --- a/graphile/graphile-upload-plugin/README.md +++ b/graphile/graphile-upload-plugin/README.md @@ -1,3 +1,15 @@ # graphile-upload-plugin +

+ +

+ +

+ + + + + +

+ File upload support for PostGraphile v5. diff --git a/graphql/env/README.md b/graphql/env/README.md index 8add4f897..e3e1f85dd 100644 --- a/graphql/env/README.md +++ b/graphql/env/README.md @@ -1,5 +1,17 @@ # @constructive-io/graphql-env +

+ +

+ +

+ + + + + +

+ Constructive environment configuration with GraphQL/Graphile support. This package extends `@pgpmjs/env` with GraphQL-specific environment variable parsing and defaults for Constructive applications. diff --git a/graphql/playwright-test/README.md b/graphql/playwright-test/README.md index 16ecbb0c3..f726f982c 100644 --- a/graphql/playwright-test/README.md +++ b/graphql/playwright-test/README.md @@ -1,5 +1,17 @@ # @constructive-io/playwright-test +

+ +

+ +

+ + + + + +

+ Constructive Playwright Testing with HTTP server support for end-to-end testing. This package extends `@constructive-io/graphql-test` to provide an actual HTTP server for Playwright and other E2E testing frameworks. It creates isolated test databases and starts a GraphQL server that bypasses domain routing, making it perfect for integration testing. diff --git a/graphql/test-app/README.md b/graphql/test-app/README.md index fbb152e9d..488b23975 100644 --- a/graphql/test-app/README.md +++ b/graphql/test-app/README.md @@ -1,5 +1,17 @@ # test-codegen-app +

+ +

+ +

+ + + + + +

+ Local integration app for validating `@constructive-io/graphql-codegen` output against a real GraphQL endpoint. This package is intended for: diff --git a/graphql/types/README.md b/graphql/types/README.md index 569eba89e..64a07165b 100644 --- a/graphql/types/README.md +++ b/graphql/types/README.md @@ -1,5 +1,17 @@ # @constructive-io/graphql-types +

+ +

+ +

+ + + + + +

+ GraphQL/Graphile types for the Constructive framework. This package contains TypeScript type definitions for PostGraphile/Graphile configuration used by Constructive server, explorer, and related packages. diff --git a/jobs/job-pg/README.md b/jobs/job-pg/README.md index e27b10a64..8bc958db9 100644 --- a/jobs/job-pg/README.md +++ b/jobs/job-pg/README.md @@ -1 +1,14 @@ -# job-pg \ No newline at end of file +# job-pg + +

+ +

+ +

+ + + + + +

+ diff --git a/jobs/job-scheduler/README.md b/jobs/job-scheduler/README.md index f04c5d95b..db1b308c0 100644 --- a/jobs/job-scheduler/README.md +++ b/jobs/job-scheduler/README.md @@ -1 +1,14 @@ -# job-scheduler \ No newline at end of file +# job-scheduler + +

+ +

+ +

+ + + + + +

+ diff --git a/jobs/job-utils/README.md b/jobs/job-utils/README.md index d65462cb2..6395823da 100644 --- a/jobs/job-utils/README.md +++ b/jobs/job-utils/README.md @@ -1 +1,14 @@ -# job-utils \ No newline at end of file +# job-utils + +

+ +

+ +

+ + + + + +

+ diff --git a/jobs/job-worker/README.md b/jobs/job-worker/README.md index 23c5620c7..ec9c50296 100644 --- a/jobs/job-worker/README.md +++ b/jobs/job-worker/README.md @@ -1 +1,14 @@ -# job-worker \ No newline at end of file +# job-worker + +

+ +

+ +

+ + + + + +

+ diff --git a/jobs/knative-job-example/README.md b/jobs/knative-job-example/README.md index 0be676fd0..cd1af4426 100644 --- a/jobs/knative-job-example/README.md +++ b/jobs/knative-job-example/README.md @@ -1 +1,14 @@ # knative-job-example + +

+ +

+ +

+ + + + + +

+ diff --git a/jobs/knative-job-fn/README.md b/jobs/knative-job-fn/README.md index 996008bbb..b30f34c72 100644 --- a/jobs/knative-job-fn/README.md +++ b/jobs/knative-job-fn/README.md @@ -1 +1,14 @@ # knative-job-fn + +

+ +

+ +

+ + + + + +

+ diff --git a/jobs/knative-job-server/README.md b/jobs/knative-job-server/README.md index f23ae1b42..1b9077aac 100644 --- a/jobs/knative-job-server/README.md +++ b/jobs/knative-job-server/README.md @@ -1 +1,14 @@ # knative-job-server + +

+ +

+ +

+ + + + + +

+ diff --git a/jobs/knative-job-service/README.md b/jobs/knative-job-service/README.md index 17003b53b..edd9804e6 100644 --- a/jobs/knative-job-service/README.md +++ b/jobs/knative-job-service/README.md @@ -1 +1,14 @@ # knative-job-service + +

+ +

+ +

+ + + + + +

+ diff --git a/jobs/knative-job-worker/README.md b/jobs/knative-job-worker/README.md index be44f870d..51c6f506e 100644 --- a/jobs/knative-job-worker/README.md +++ b/jobs/knative-job-worker/README.md @@ -1,3 +1,15 @@ # knative-job-worker +

+ +

+ +

+ + + + + +

+ Knative-compatible job worker that uses the existing Constructive PostgreSQL job queue and job utilities, invoking HTTP functions via `KNATIVE_SERVICE_URL` (or `INTERNAL_GATEWAY_URL` as a fallback) while preserving the same headers and payload shape as the OpenFaaS worker. diff --git a/packages/cli/README.md b/packages/cli/README.md index fb33e1ee0..f6533e489 100644 --- a/packages/cli/README.md +++ b/packages/cli/README.md @@ -1,5 +1,17 @@ # Constructive CLI +

+ +

+ +

+ + + + + +

+ > API Server and Development Tools for PostgreSQL Constructive CLI provides GraphQL server capabilities and code generation tools for PostgreSQL databases. For database migrations, packages, and deployment operations, use [pgpm](https://pgpm.io). diff --git a/packages/csv-to-pg/README.md b/packages/csv-to-pg/README.md index aecc680ac..20989f0e0 100644 --- a/packages/csv-to-pg/README.md +++ b/packages/csv-to-pg/README.md @@ -1,15 +1,15 @@ # csv-to-pg

- +

- - + + - - + +

Create PostgreSQL statements from CSV files @@ -64,9 +64,9 @@ csv2pg ./config.yaml ### 🧪 Testing -* [launchql/pgsql-test](https://github.com/launchql/launchql/tree/main/packages/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation. -* [launchql/graphile-test](https://github.com/launchql/launchql/tree/main/packages/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts. -* [launchql/pg-query-context](https://github.com/launchql/launchql/tree/main/packages/pg-query-context): **🔒 Session context injection** to add session-local context (e.g., `SET LOCAL`) into queries—ideal for setting `role`, `jwt.claims`, and other session settings. +* [launchql/pgsql-test](https://github.com/constructive-io/constructive/tree/main/packages/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation. +* [launchql/graphile-test](https://github.com/constructive-io/constructive/tree/main/packages/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts. +* [launchql/pg-query-context](https://github.com/constructive-io/constructive/tree/main/packages/pg-query-context): **🔒 Session context injection** to add session-local context (e.g., `SET LOCAL`) into queries—ideal for setting `role`, `jwt.claims`, and other session settings. ### 🧠 Parsing & AST @@ -79,24 +79,24 @@ csv2pg ./config.yaml ### 🚀 API & Dev Tools -* [launchql/server](https://github.com/launchql/launchql/tree/main/packages/server): **⚡ Express-based API server** powered by PostGraphile to expose a secure, scalable GraphQL API over your Postgres database. -* [launchql/explorer](https://github.com/launchql/launchql/tree/main/packages/explorer): **🔎 Visual API explorer** with GraphiQL for browsing across all databases and schemas—useful for debugging, documentation, and API prototyping. +* [launchql/server](https://github.com/constructive-io/constructive/tree/main/packages/server): **⚡ Express-based API server** powered by PostGraphile to expose a secure, scalable GraphQL API over your Postgres database. +* [launchql/explorer](https://github.com/constructive-io/constructive/tree/main/packages/explorer): **🔎 Visual API explorer** with GraphiQL for browsing across all databases and schemas—useful for debugging, documentation, and API prototyping. ### 🔁 Streaming & Uploads -* [launchql/s3-streamer](https://github.com/launchql/launchql/tree/main/packages/s3-streamer): **📤 Direct S3 streaming** for large files with support for metadata injection and content validation. -* [launchql/etag-hash](https://github.com/launchql/launchql/tree/main/packages/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks. -* [launchql/etag-stream](https://github.com/launchql/launchql/tree/main/packages/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer. -* [launchql/uuid-hash](https://github.com/launchql/launchql/tree/main/packages/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing. -* [launchql/uuid-stream](https://github.com/launchql/launchql/tree/main/packages/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines. -* [launchql/upload-names](https://github.com/launchql/launchql/tree/main/packages/upload-names): **📂 Collision-resistant filenames** utility for structured and unique file names for uploads. +* [launchql/s3-streamer](https://github.com/constructive-io/constructive/tree/main/packages/s3-streamer): **📤 Direct S3 streaming** for large files with support for metadata injection and content validation. +* [launchql/etag-hash](https://github.com/constructive-io/constructive/tree/main/packages/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks. +* [launchql/etag-stream](https://github.com/constructive-io/constructive/tree/main/packages/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer. +* [launchql/uuid-hash](https://github.com/constructive-io/constructive/tree/main/packages/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing. +* [launchql/uuid-stream](https://github.com/constructive-io/constructive/tree/main/packages/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines. +* [launchql/upload-names](https://github.com/constructive-io/constructive/tree/main/packages/upload-names): **📂 Collision-resistant filenames** utility for structured and unique file names for uploads. ### 🧰 CLI & Codegen -* [@launchql/cli](https://github.com/launchql/launchql/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing LaunchQL projects—supports database scaffolding, migrations, seeding, code generation, and automation. -* [launchql/launchql-gen](https://github.com/launchql/launchql/tree/main/packages/launchql-gen): **✨ Auto-generated GraphQL** mutations and queries dynamically built from introspected schema data. -* [@launchql/query-builder](https://github.com/launchql/launchql/tree/main/packages/query-builder): **🏗️ SQL constructor** providing a robust TypeScript-based query builder for dynamic generation of `SELECT`, `INSERT`, `UPDATE`, `DELETE`, and stored procedure calls—supports advanced SQL features like `JOIN`, `GROUP BY`, and schema-qualified queries. -* [@launchql/query](https://github.com/launchql/launchql/tree/main/packages/query): **🧩 Fluent GraphQL builder** for PostGraphile schemas. ⚡ Schema-aware via introspection, 🧩 composable and ergonomic for building deeply nested queries. +* [@launchql/cli](https://github.com/constructive-io/constructive/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing LaunchQL projects—supports database scaffolding, migrations, seeding, code generation, and automation. +* [constructive-io/constructive-gen](https://github.com/constructive-io/constructive/tree/main/packages/launchql-gen): **✨ Auto-generated GraphQL** mutations and queries dynamically built from introspected schema data. +* [@launchql/query-builder](https://github.com/constructive-io/constructive/tree/main/packages/query-builder): **🏗️ SQL constructor** providing a robust TypeScript-based query builder for dynamic generation of `SELECT`, `INSERT`, `UPDATE`, `DELETE`, and stored procedure calls—supports advanced SQL features like `JOIN`, `GROUP BY`, and schema-qualified queries. +* [@launchql/query](https://github.com/constructive-io/constructive/tree/main/packages/query): **🧩 Fluent GraphQL builder** for PostGraphile schemas. ⚡ Schema-aware via introspection, 🧩 composable and ergonomic for building deeply nested queries. ## Disclaimer diff --git a/packages/smtppostmaster/README.md b/packages/smtppostmaster/README.md index ca217380c..7e301a95f 100644 --- a/packages/smtppostmaster/README.md +++ b/packages/smtppostmaster/README.md @@ -1,5 +1,17 @@ # simple-smtp-server +

+ +

+ +

+ + + + + +

+ SMTP-based email sender for Constructive services. This package exposes a `send` helper with the same call shape used by `@launchql/postmaster` (e.g. `{ to, subject, html, text }`). Configuration is managed through the centralized `@pgpmjs/env` system, which merges defaults, config files, environment variables, and runtime overrides. diff --git a/pgpm/env/README.md b/pgpm/env/README.md index 69eecf901..bc41f0aa9 100644 --- a/pgpm/env/README.md +++ b/pgpm/env/README.md @@ -1,5 +1,17 @@ # @pgpmjs/env +

+ +

+ +

+ + + + + +

+ Environment management for PGPM (and Constructive) projects. Provides unified configuration resolution from defaults, config files, environment variables, and overrides. ## Features diff --git a/pgpm/logger/README.md b/pgpm/logger/README.md index 2e5c38ddb..ef61f6dbf 100644 --- a/pgpm/logger/README.md +++ b/pgpm/logger/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ Simple logger utility with yanse colors for consistent logging across packages. ## Installation diff --git a/postgres/pg-env/README.md b/postgres/pg-env/README.md index aa5298106..dcf748b4c 100644 --- a/postgres/pg-env/README.md +++ b/postgres/pg-env/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ PostgreSQL environment configuration utilities for managing database connection settings. ## Installation diff --git a/postgres/supabase-test/README.md b/postgres/supabase-test/README.md index a2e86964d..5912eac35 100644 --- a/postgres/supabase-test/README.md +++ b/postgres/supabase-test/README.md @@ -1,7 +1,7 @@ # supabase-test

- +

diff --git a/sdk/constructive-cli/README.md b/sdk/constructive-cli/README.md index 122660ef5..016f5d828 100644 --- a/sdk/constructive-cli/README.md +++ b/sdk/constructive-cli/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ ## APIs diff --git a/sdk/constructive-node/README.md b/sdk/constructive-node/README.md index feb0bc5d9..016677a43 100644 --- a/sdk/constructive-node/README.md +++ b/sdk/constructive-node/README.md @@ -1,5 +1,17 @@ # @constructive-io/node +

+ +

+ +

+ + + + + +

+ Drop-in replacement for `@constructive-io/sdk` for Node.js applications. ## Why? diff --git a/sdk/constructive-react/README.md b/sdk/constructive-react/README.md index 9ec0d4202..ec0434d6e 100644 --- a/sdk/constructive-react/README.md +++ b/sdk/constructive-react/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ ## APIs diff --git a/sdk/constructive-sdk/README.md b/sdk/constructive-sdk/README.md index ec3441f5c..26735893d 100644 --- a/sdk/constructive-sdk/README.md +++ b/sdk/constructive-sdk/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ ## APIs