@pgpm/metaschema-modules 0.18.0 → 0.19.1

package/deploy/schemas/metaschema_modules_public/tables/memberships_module/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.memberships_module (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
     database_id uuid NOT NULL,
     --
     schema_id uuid NOT NULL DEFAULT uuid_nil(),
@@ -76,45 +76,6 @@ CREATE TABLE metaschema_modules_public.memberships_module (
     CONSTRAINT default_permissions_table_fkey FOREIGN KEY (default_permissions_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE
 );
 
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT private_schema_fkey ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
 CREATE INDEX memberships_module_database_id_idx ON metaschema_modules_public.memberships_module ( database_id );
 
-COMMENT ON CONSTRAINT entity_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT entity_table_owner_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT memberships_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT members_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT membership_defaults_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT grants_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT sprt_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT actor_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT limits_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT default_limits_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT permissions_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT default_permissions_table_fkey
-     ON metaschema_modules_public.memberships_module IS E'@omit manyToMany';
-
 COMMIT;

package/deploy/schemas/metaschema_modules_public/tables/permissions_module/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.permissions_module (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
     database_id uuid NOT NULL,
     --
     schema_id uuid NOT NULL DEFAULT uuid_nil(),
@@ -48,18 +48,6 @@ CREATE TABLE metaschema_modules_public.permissions_module (
     CONSTRAINT actor_table_fkey FOREIGN KEY (actor_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE
 );
 
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.permissions_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT private_schema_fkey ON metaschema_modules_public.permissions_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.permissions_module IS E'@omit manyToMany';
 CREATE INDEX permissions_module_database_id_idx ON metaschema_modules_public.permissions_module ( database_id );
 
-COMMENT ON CONSTRAINT table_fkey
-     ON metaschema_modules_public.permissions_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT default_table_fkey
-     ON metaschema_modules_public.permissions_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT actor_table_fkey
-     ON metaschema_modules_public.permissions_module IS E'@omit manyToMany';
-
 COMMIT;

package/deploy/schemas/metaschema_modules_public/tables/phone_numbers_module/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.phone_numbers_module (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
     database_id uuid NOT NULL,
     
     schema_id uuid NOT NULL DEFAULT uuid_nil(),
@@ -24,11 +24,6 @@ CREATE TABLE metaschema_modules_public.phone_numbers_module (
     CONSTRAINT private_schema_fkey FOREIGN KEY (private_schema_id) REFERENCES metaschema_public.schema (id) ON DELETE CASCADE
 );
 
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.phone_numbers_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT private_schema_fkey ON metaschema_modules_public.phone_numbers_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT table_fkey ON metaschema_modules_public.phone_numbers_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT owner_table_fkey ON metaschema_modules_public.phone_numbers_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.phone_numbers_module IS E'@omit manyToMany';
 CREATE INDEX phone_numbers_module_database_id_idx ON metaschema_modules_public.phone_numbers_module ( database_id );
 
 COMMIT;

package/deploy/schemas/metaschema_modules_public/tables/profiles_module/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.profiles_module (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
     database_id uuid NOT NULL,
     --
     schema_id uuid NOT NULL DEFAULT uuid_nil(),
@@ -55,33 +55,6 @@ CREATE TABLE metaschema_modules_public.profiles_module (
     CONSTRAINT profiles_module_unique UNIQUE (database_id, membership_type)
 );
 
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT private_schema_fkey ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
 CREATE INDEX profiles_module_database_id_idx ON metaschema_modules_public.profiles_module ( database_id );
 
-COMMENT ON CONSTRAINT table_fkey
-     ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT profile_permissions_table_fkey
-     ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT profile_grants_table_fkey
-     ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT profile_definition_grants_table_fkey
-     ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT entity_table_fkey
-     ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT actor_table_fkey
-     ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT permissions_table_fkey
-     ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT memberships_table_fkey
-     ON metaschema_modules_public.profiles_module IS E'@omit manyToMany';
-
 COMMIT;

package/deploy/schemas/metaschema_modules_public/tables/relation_provision/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.relation_provision (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
 
     database_id uuid NOT NULL,
 
@@ -31,6 +31,8 @@ CREATE TABLE metaschema_modules_public.relation_provision (
 
     is_required boolean NOT NULL DEFAULT true,
 
+    api_required boolean NOT NULL DEFAULT false,
+
     -- =========================================================================
     -- ManyToMany: junction table identity
     -- =========================================================================
@@ -51,6 +53,18 @@ CREATE TABLE metaschema_modules_public.relation_provision (
 
     use_composite_key boolean NOT NULL DEFAULT false,
 
+    -- =========================================================================
+    -- Index creation on FK fields
+    -- =========================================================================
+
+    create_index boolean NOT NULL DEFAULT true,
+
+    -- =========================================================================
+    -- ManyToMany: API visibility (PostGraphile v5 @behavior +manyToMany)
+    -- =========================================================================
+
+    expose_in_api boolean NOT NULL DEFAULT true,
+
     -- =========================================================================
     -- ManyToMany: field creation (forwarded to secure_table_provision)
     -- =========================================================================
@@ -65,7 +79,7 @@ CREATE TABLE metaschema_modules_public.relation_provision (
 
     grant_roles text[] NOT NULL DEFAULT ARRAY['authenticated'],
 
-    grant_privileges jsonb NOT NULL DEFAULT '[["select","*"],["insert","*"],["delete","*"]]',
+    grant_privileges jsonb[] NOT NULL DEFAULT ARRAY['["select","*"]'::jsonb, '["insert","*"]'::jsonb, '["delete","*"]'::jsonb],
 
     -- =========================================================================
     -- ManyToMany: RLS policies (forwarded to secure_table_provision)
@@ -167,6 +181,12 @@ COMMENT ON COLUMN metaschema_modules_public.relation_provision.is_required IS
      - RelationHasOne: typically true.
      Ignored for RelationManyToMany (junction FK fields are always required).';
 
+COMMENT ON COLUMN metaschema_modules_public.relation_provision.api_required IS
+    'Whether the FK field should be required at the API level even though it is nullable at the database level. Defaults to false.
+     When true and is_required is false, the field is created as nullable (allowing SET NULL cascade) but a @requiredInput smart tag is added so PostGraphile treats it as non-null in create/update input types.
+     When is_required is true, api_required is ignored (the field is already required at both levels).
+     Ignored for RelationManyToMany (junction FK fields are always required).';
+
 -- =============================================================================
 -- ManyToMany: junction table identity
 -- =============================================================================
@@ -200,6 +220,28 @@ COMMENT ON COLUMN metaschema_modules_public.relation_provision.use_composite_key
      use_composite_key and node_type=''DataId'' are mutually exclusive — using both would create two conflicting PKs.
      Ignored for RelationBelongsTo/RelationHasOne.';
 
+COMMENT ON COLUMN metaschema_modules_public.relation_provision.create_index IS
+    'Whether to create a btree index on FK fields created by this relation. Defaults to true.
+     PostgreSQL does not automatically index foreign key columns (only the referenced PK side is indexed).
+     Without indexes on FK columns, JOINs, CASCADE deletes, and RLS policy lookups perform sequential scans.
+     - RelationBelongsTo: creates an index on the FK field on the source table.
+     - RelationHasMany: creates an index on the FK field on the target table.
+     - RelationHasOne: skipped — the unique constraint already creates an implicit index.
+     - RelationManyToMany: creates indexes on both FK fields on the junction table.
+     Set to false only for very small tables or write-heavy tables where index maintenance cost outweighs read performance.';
+
+-- =============================================================================
+-- ManyToMany: API visibility
+-- =============================================================================
+
+COMMENT ON COLUMN metaschema_modules_public.relation_provision.expose_in_api IS
+    'For RelationManyToMany: whether to expose the M:N shortcut fields in the GraphQL API. Defaults to true.
+     When true, sets @behavior +manyToMany on the junction table smart_tags so PostGraphile generates
+     clean M:N connection fields (e.g., event.contacts instead of event.contactEventsByEventId).
+     When false (or toggled off via UPDATE), the behavior tag is removed and the M:N fields disappear from GraphQL.
+     Toggling is supported: UPDATE expose_in_api to true/false and the smart tag is added/removed automatically.
+     Ignored for RelationBelongsTo/RelationHasOne/RelationHasMany.';
+
 -- =============================================================================
 -- ManyToMany: field creation (forwarded to secure_table_provision)
 -- =============================================================================
@@ -227,7 +269,7 @@ COMMENT ON COLUMN metaschema_modules_public.relation_provision.grant_roles IS
     'For RelationManyToMany: database roles to grant privileges to on the junction table. Forwarded to secure_table_provision as-is. Supports multiple roles, e.g. ARRAY[''authenticated'', ''admin'']. Each role receives all privileges defined in grant_privileges. Defaults to ARRAY[''authenticated'']. Ignored for RelationBelongsTo/RelationHasOne.';
 
 COMMENT ON COLUMN metaschema_modules_public.relation_provision.grant_privileges IS
-    'For RelationManyToMany: privilege grants for the junction table. Forwarded to secure_table_provision as-is. Format: array of [privilege, columns] tuples. Examples: [["select","*"],["insert","*"]] for full access, or [["update",["name","bio"]]] for column-level grants. "*" means all columns. Defaults to select/insert/delete for all columns. Ignored for RelationBelongsTo/RelationHasOne.';
+    'For RelationManyToMany: privilege grants for the junction table. Forwarded to secure_table_provision as-is. Format: PostgreSQL array of jsonb [privilege, columns] tuples. Examples: ARRAY[''["select","*"]''::jsonb, ''["insert","*"]''::jsonb] for full access, or ARRAY[''["update",["name","bio"]]''::jsonb] for column-level grants. "*" means all columns. Defaults to select/insert/delete for all columns. Ignored for RelationBelongsTo/RelationHasOne.';
 
 -- =============================================================================
 -- ManyToMany: RLS policies (forwarded to secure_table_provision)
@@ -275,10 +317,6 @@ COMMENT ON COLUMN metaschema_modules_public.relation_provision.out_source_field_
 COMMENT ON COLUMN metaschema_modules_public.relation_provision.out_target_field_id IS
     'Output column for RelationManyToMany: the UUID of the FK field on the junction table referencing the target table. Populated by the trigger. NULL for RelationBelongsTo/RelationHasOne. Callers should not set this directly.';
 
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.relation_provision IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT source_table_fkey ON metaschema_modules_public.relation_provision IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT target_table_fkey ON metaschema_modules_public.relation_provision IS E'@omit manyToMany';
-
 CREATE INDEX relation_provision_database_id_idx ON metaschema_modules_public.relation_provision ( database_id );
 CREATE INDEX relation_provision_relation_type_idx ON metaschema_modules_public.relation_provision ( relation_type );
 CREATE INDEX relation_provision_source_table_id_idx ON metaschema_modules_public.relation_provision ( source_table_id );

package/deploy/schemas/metaschema_modules_public/tables/rls_module/table.sql

@@ -6,10 +6,9 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.rls_module (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
     database_id uuid NOT NULL,
 
-    api_id uuid NOT NULL DEFAULT uuid_nil(),
     schema_id uuid NOT NULL DEFAULT uuid_nil(),
     private_schema_id uuid NOT NULL DEFAULT uuid_nil(),
     session_credentials_table_id uuid NOT NULL DEFAULT uuid_nil(),
@@ -25,7 +24,6 @@ CREATE TABLE metaschema_modules_public.rls_module (
 
     --
     CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,
-    CONSTRAINT api_fkey FOREIGN KEY (api_id) REFERENCES services_public.apis (id) ON DELETE CASCADE,
     CONSTRAINT session_credentials_table_fkey FOREIGN KEY (session_credentials_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE,
     CONSTRAINT sessions_table_fkey FOREIGN KEY (sessions_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE,
     CONSTRAINT users_table_fkey FOREIGN KEY (users_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE,
@@ -33,12 +31,9 @@ CREATE TABLE metaschema_modules_public.rls_module (
     CONSTRAINT pschema_fkey FOREIGN KEY (private_schema_id) REFERENCES metaschema_public.schema (id) ON DELETE CASCADE,
 
     --
-    CONSTRAINT api_id_uniq UNIQUE(api_id)
+    CONSTRAINT database_id_uniq UNIQUE(database_id)
 );
 
-COMMENT ON CONSTRAINT api_fkey ON metaschema_modules_public.rls_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.rls_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT pschema_fkey ON metaschema_modules_public.rls_module IS E'@omit manyToMany';
 
 COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.rls_module IS E'@omit';
 COMMENT ON CONSTRAINT session_credentials_table_fkey ON metaschema_modules_public.rls_module IS E'@omit';

package/deploy/schemas/metaschema_modules_public/tables/secrets_module/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.secrets_module (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
     database_id uuid NOT NULL,
     --
     schema_id uuid NOT NULL DEFAULT uuid_nil(),
@@ -18,11 +18,6 @@ CREATE TABLE metaschema_modules_public.secrets_module (
 
 );
 
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.secrets_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.secrets_module IS E'@omit manyToMany';
 CREATE INDEX secrets_module_database_id_idx ON metaschema_modules_public.secrets_module ( database_id );
 
-COMMENT ON CONSTRAINT table_fkey
-     ON metaschema_modules_public.secrets_module IS E'@omit manyToMany';
-
 COMMIT;

package/deploy/schemas/metaschema_modules_public/tables/secure_table_provision/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.secure_table_provision (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
 
     database_id uuid NOT NULL,
 
@@ -21,9 +21,11 @@ CREATE TABLE metaschema_modules_public.secure_table_provision (
 
     node_data jsonb NOT NULL DEFAULT '{}',
 
+    fields jsonb[] NOT NULL DEFAULT '{}',
+
     grant_roles text[] NOT NULL DEFAULT ARRAY['authenticated'],
 
-    grant_privileges jsonb NOT NULL DEFAULT '[]',
+    grant_privileges jsonb[] NOT NULL DEFAULT '{}',
 
     policy_type text DEFAULT NULL,
 
@@ -69,13 +71,16 @@ COMMENT ON COLUMN metaschema_modules_public.secure_table_provision.use_rls IS
     'If true and Row Level Security is not yet enabled on the target table, enable it. Automatically set to true by the trigger when policy_type is provided. Defaults to true.';
 
 COMMENT ON COLUMN metaschema_modules_public.secure_table_provision.node_data IS
-    'Configuration passed to the generator function for field creation (only used when node_type is set). Known keys include: field_name (text, default ''id'') for DataId, owner_field_name (text, default ''owner_id'') for DataDirectOwner/DataOwnershipInEntity, entity_field_name (text, default ''entity_id'') for DataEntityMembership/DataOwnershipInEntity, include_id (boolean, default true) for most node_types, include_user_fk (boolean, default true) to add FK to users table. Defaults to ''{}''.';
+    'Configuration passed to the generator function for field creation (only used when node_type is set). Known keys include: field_name (text, default ''id'') for DataId, owner_field_name (text, default ''owner_id'') for DataDirectOwner/DataOwnershipInEntity, entity_field_name (text, default ''entity_id'') for DataEntityMembership/DataOwnershipInEntity, include_id (boolean, default true) for most node_types, include_user_fk (boolean, default true) to add FK to users table, create_index (boolean, default true) to create btree indexes on FK fields for join and cascade performance. Defaults to ''{}''.';
+
+COMMENT ON COLUMN metaschema_modules_public.secure_table_provision.fields IS
+    'PostgreSQL array of jsonb field definition objects to create on the target table. Each object has keys: "name" (text, required), "type" (text, required), "default" (text, optional), "is_required" (boolean, optional, defaults to false), "min" (float, optional), "max" (float, optional), "regexp" (text, optional), "index" (boolean, optional, defaults to false — creates a btree index on the field). min/max generate CHECK constraints: for text/citext they constrain character_length, for integer/float types they constrain the value. regexp generates a CHECK (col ~ pattern) constraint for text/citext. Fields are created via metaschema.create_field() after any node_type generator runs, and their IDs are appended to out_fields. Example: ARRAY[''{"name":"username","type":"citext","max":256,"regexp":"^[a-z0-9_]+$"}''::jsonb, ''{"name":"score","type":"integer","min":0,"max":100}''::jsonb]. Defaults to ''{}'' (no additional fields).';
 
 COMMENT ON COLUMN metaschema_modules_public.secure_table_provision.grant_roles IS
     'Database roles to grant privileges to. Supports multiple roles, e.g. ARRAY[''authenticated'', ''admin'']. Each role receives all privileges defined in grant_privileges. Defaults to ARRAY[''authenticated''].';
 
 COMMENT ON COLUMN metaschema_modules_public.secure_table_provision.grant_privileges IS
-    'Array of [privilege, columns] tuples defining table grants. Examples: [["select","*"],["insert","*"]] for full access, or [["update",["name","bio"]]] for column-level grants. "*" means all columns; an array means column-level grant. Defaults to ''[]'' (no grants). The trigger validates this is a proper jsonb array.';
+    'PostgreSQL array of jsonb [privilege, columns] tuples defining table grants. Examples: ARRAY[''["select","*"]''::jsonb, ''["insert","*"]''::jsonb] for full access, or ARRAY[''["update",["name","bio"]]''::jsonb] for column-level grants. "*" means all columns; an array means column-level grant. Defaults to ''{}'' (no grants). Type safety is enforced by PostgreSQL at INSERT time.';
 
 COMMENT ON COLUMN metaschema_modules_public.secure_table_provision.policy_type IS
     'Policy generator type, e.g. ''AuthzEntityMembership'', ''AuthzMembership'', ''AuthzAllowAll''. NULL means no policy is created. When set, the trigger automatically enables RLS on the target table.';
@@ -98,9 +103,6 @@ COMMENT ON COLUMN metaschema_modules_public.secure_table_provision.policy_data I
 COMMENT ON COLUMN metaschema_modules_public.secure_table_provision.out_fields IS
     'Output column populated by the trigger after field creation. Contains the UUIDs of the metaschema fields created on the target table by this provision row''s generator. NULL when node_type is NULL or before the trigger runs. Callers should not set this directly.';
 
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.secure_table_provision IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT table_fkey ON metaschema_modules_public.secure_table_provision IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.secure_table_provision IS E'@omit manyToMany';
 
 CREATE INDEX secure_table_provision_database_id_idx ON metaschema_modules_public.secure_table_provision ( database_id );
 CREATE INDEX secure_table_provision_table_id_idx ON metaschema_modules_public.secure_table_provision ( table_id );

package/deploy/schemas/metaschema_modules_public/tables/sessions_module/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.sessions_module (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
     database_id uuid NOT NULL,
 
     --
@@ -29,17 +29,13 @@ CREATE TABLE metaschema_modules_public.sessions_module (
     CONSTRAINT users_table_fkey FOREIGN KEY (users_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE
 );
 
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.sessions_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.sessions_module IS E'@omit manyToMany';
 CREATE INDEX sessions_module_database_id_idx ON metaschema_modules_public.sessions_module ( database_id );
 
 COMMENT ON CONSTRAINT sessions_table_fkey
-     ON metaschema_modules_public.sessions_module IS E'@fieldName sessionsTableBySessionsTableId\n@omit manyToMany';
+     ON metaschema_modules_public.sessions_module IS E'@fieldName sessionsTableBySessionsTableId';
 COMMENT ON CONSTRAINT session_credentials_table_fkey
-     ON metaschema_modules_public.sessions_module IS E'@fieldName sessionCredentialsTableBySessionCredentialsTableId\n@omit manyToMany';
+     ON metaschema_modules_public.sessions_module IS E'@fieldName sessionCredentialsTableBySessionCredentialsTableId';
 COMMENT ON CONSTRAINT auth_settings_table_fkey
-     ON metaschema_modules_public.sessions_module IS E'@fieldName authSettingsTableByAuthSettingsTableId\n@omit manyToMany';
-COMMENT ON CONSTRAINT users_table_fkey
-     ON metaschema_modules_public.sessions_module IS E'@omit manyToMany';
+     ON metaschema_modules_public.sessions_module IS E'@fieldName authSettingsTableByAuthSettingsTableId';
 
 COMMIT;

package/deploy/schemas/metaschema_modules_public/tables/table_template_module/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.table_template_module (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
     database_id uuid NOT NULL,
     
     schema_id uuid NOT NULL DEFAULT uuid_nil(),
@@ -33,11 +33,6 @@ CREATE TABLE metaschema_modules_public.table_template_module (
     CONSTRAINT private_schema_fkey FOREIGN KEY (private_schema_id) REFERENCES metaschema_public.schema (id) ON DELETE CASCADE
 );
 
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.table_template_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT private_schema_fkey ON metaschema_modules_public.table_template_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT table_fkey ON metaschema_modules_public.table_template_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT owner_table_fkey ON metaschema_modules_public.table_template_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.table_template_module IS E'@omit manyToMany';
 CREATE INDEX table_template_module_database_id_idx ON metaschema_modules_public.table_template_module ( database_id );
 CREATE INDEX table_template_module_schema_id_idx ON metaschema_modules_public.table_template_module ( schema_id );
 CREATE INDEX table_template_module_private_schema_id_idx ON metaschema_modules_public.table_template_module ( private_schema_id );

package/deploy/schemas/metaschema_modules_public/tables/user_auth_module/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.user_auth_module (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
     database_id uuid NOT NULL,
 
     schema_id uuid NOT NULL DEFAULT uuid_nil(),
@@ -56,8 +56,6 @@ CREATE TABLE metaschema_modules_public.user_auth_module (
     CONSTRAINT session_credentials_table_fkey FOREIGN KEY (session_credentials_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE
 );
 
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.user_auth_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.user_auth_module IS E'@omit manyToMany';
 CREATE INDEX user_auth_module_database_id_idx ON metaschema_modules_public.user_auth_module ( database_id );
 
 COMMENT ON CONSTRAINT email_table_fkey

package/deploy/schemas/metaschema_modules_public/tables/users_module/table.sql

@@ -5,7 +5,7 @@
 BEGIN;
 
 CREATE TABLE metaschema_modules_public.users_module (
-    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
     database_id uuid NOT NULL,
     --
     schema_id uuid NOT NULL DEFAULT uuid_nil(),
@@ -24,15 +24,6 @@ CREATE TABLE metaschema_modules_public.users_module (
     CONSTRAINT type_table_fkey FOREIGN KEY (type_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE
 );
 
-COMMENT ON CONSTRAINT schema_fkey ON metaschema_modules_public.users_module IS E'@omit manyToMany';
-COMMENT ON CONSTRAINT db_fkey ON metaschema_modules_public.users_module IS E'@omit manyToMany';
 CREATE INDEX users_module_database_id_idx ON metaschema_modules_public.users_module ( database_id );
 
-COMMENT ON CONSTRAINT table_fkey
-     ON metaschema_modules_public.users_module IS E'@omit manyToMany';
-
-COMMENT ON CONSTRAINT type_table_fkey
-     ON metaschema_modules_public.users_module IS E'@omit manyToMany';
-
-
 COMMIT;

package/metaschema-modules.control

@@ -2,6 +2,6 @@
 comment = 'metaschema-modules extension'
 default_version = '0.15.5'
 module_pathname = '$libdir/metaschema-modules'
-requires = 'plpgsql,metaschema-schema,services,pgpm-verify'
+requires = 'plpgsql,uuid-ossp,metaschema-schema,services,pgpm-verify'
 relocatable = false
 superuser = false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgpm/metaschema-modules",
-  "version": "0.18.0",
+  "version": "0.19.1",
   "description": "Module metadata handling and dependency tracking",
   "author": "Dan Lynch <pyramation@gmail.com>",
   "contributors": [
@@ -21,8 +21,8 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "@pgpm/metaschema-schema": "0.18.0",
-    "@pgpm/verify": "0.18.0"
+    "@pgpm/metaschema-schema": "0.19.1",
+    "@pgpm/verify": "0.19.1"
   },
   "devDependencies": {
     "pgpm": "^4.2.3"
@@ -35,5 +35,5 @@
   "bugs": {
     "url": "https://github.com/constructive-io/pgpm-modules/issues"
   },
-  "gitHead": "8144027c7fab4956bcdebd736d04c0d4f57344bc"
+  "gitHead": "874490c55094ce0232bf230c613ee58685f369dc"
 }

package/pgpm.plan

@@ -14,7 +14,6 @@ schemas/metaschema_modules_public/tables/denormalized_table_field/table [schemas
 schemas/metaschema_modules_public/tables/emails_module/table [schemas/metaschema_modules_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/metaschema_modules_public/tables/emails_module/table
 schemas/metaschema_modules_public/tables/encrypted_secrets_module/table [schemas/metaschema_modules_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/metaschema_modules_public/tables/encrypted_secrets_module/table
 schemas/metaschema_modules_public/tables/field_module/table [schemas/metaschema_modules_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/metaschema_modules_public/tables/field_module/table
-schemas/metaschema_modules_public/tables/table_module/table [schemas/metaschema_modules_public/schema] 2026-01-12T00:00:00Z devin <devin@cognition.ai> # add schemas/metaschema_modules_public/tables/table_module/table
 schemas/metaschema_modules_public/tables/invites_module/table [schemas/metaschema_modules_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/metaschema_modules_public/tables/invites_module/table
 schemas/metaschema_modules_public/tables/levels_module/table [schemas/metaschema_modules_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/metaschema_modules_public/tables/levels_module/table
 schemas/metaschema_modules_public/tables/limits_module/table [schemas/metaschema_modules_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/metaschema_modules_public/tables/limits_module/table
@@ -29,8 +28,10 @@ schemas/services_public/tables/sites/table [schemas/services_public/schema] 2017
 schemas/metaschema_modules_public/tables/sessions_module/table [schemas/metaschema_modules_public/schema] 2026-01-24T00:00:00Z devin <devin@cognition.ai> # add schemas/metaschema_modules_public/tables/sessions_module/table
 schemas/metaschema_modules_public/tables/user_auth_module/table [schemas/metaschema_modules_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/metaschema_modules_public/tables/user_auth_module/table
 schemas/metaschema_modules_public/tables/users_module/table [schemas/metaschema_modules_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/metaschema_modules_public/tables/users_module/table
-schemas/metaschema_modules_public/tables/uuid_module/table [schemas/metaschema_modules_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/metaschema_modules_public/tables/uuid_module/table
+
 schemas/metaschema_modules_public/tables/hierarchy_module/table [schemas/metaschema_modules_public/schema] 2024-12-28T00:00:00Z skitch <skitch@5b0c196eeb62> # add schemas/metaschema_modules_public/tables/hierarchy_module/table
 schemas/metaschema_modules_public/tables/table_template_module/table [schemas/metaschema_modules_public/schema] 2026-01-14T00:00:00Z devin <devin@cognition.ai> # add schemas/metaschema_modules_public/tables/table_template_module/table
 schemas/metaschema_modules_public/tables/secure_table_provision/table [schemas/metaschema_modules_public/schema] 2026-02-25T00:00:00Z Constructive <developers@constructive.io> # add schemas/metaschema_modules_public/tables/secure_table_provision/table
 schemas/metaschema_modules_public/tables/relation_provision/table [schemas/metaschema_modules_public/schema] 2026-02-26T00:00:00Z Constructive <developers@constructive.io> # add schemas/metaschema_modules_public/tables/relation_provision/table
+schemas/metaschema_modules_public/tables/blueprint_template/table [schemas/metaschema_modules_public/schema] 2026-03-20T00:00:00Z Constructive <developers@constructive.io> # add blueprint_template table for shareable schema recipes
+schemas/metaschema_modules_public/tables/blueprint/table [schemas/metaschema_modules_public/schema schemas/metaschema_modules_public/tables/blueprint_template/table] 2026-03-20T00:00:01Z Constructive <developers@constructive.io> # add blueprint table for owned executable blueprints

package/revert/schemas/metaschema_modules_public/tables/blueprint/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/metaschema_modules_public/tables/blueprint/table from pg
+
+BEGIN;
+
+DROP TABLE IF EXISTS metaschema_modules_public.blueprint;
+
+COMMIT;

package/revert/schemas/metaschema_modules_public/tables/blueprint_template/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/metaschema_modules_public/tables/blueprint_template/table from pg
+
+BEGIN;
+
+DROP TABLE IF EXISTS metaschema_modules_public.blueprint_template;
+
+COMMIT;

package/verify/schemas/metaschema_modules_public/tables/blueprint/table.sql

@@ -0,0 +1,26 @@
+-- Verify schemas/metaschema_modules_public/tables/blueprint/table on pg
+
+BEGIN;
+
+SELECT
+    id,
+    owner_id,
+    database_id,
+    name,
+    display_name,
+    description,
+    definition,
+    template_id,
+    status,
+    constructed_at,
+    error_details,
+    ref_map,
+    constructed_definition,
+    definition_hash,
+    table_hashes,
+    created_at,
+    updated_at
+FROM metaschema_modules_public.blueprint
+WHERE FALSE;
+
+ROLLBACK;

package/verify/schemas/metaschema_modules_public/tables/blueprint_template/table.sql

@@ -0,0 +1,29 @@
+-- Verify schemas/metaschema_modules_public/tables/blueprint_template/table on pg
+
+BEGIN;
+
+SELECT
+    id,
+    name,
+    version,
+    display_name,
+    description,
+    owner_id,
+    visibility,
+    categories,
+    tags,
+    definition,
+    definition_schema_version,
+    source,
+    complexity,
+    copy_count,
+    fork_count,
+    forked_from_id,
+    definition_hash,
+    table_hashes,
+    created_at,
+    updated_at
+FROM metaschema_modules_public.blueprint_template
+WHERE FALSE;
+
+ROLLBACK;

package/verify/schemas/metaschema_modules_public/tables/relation_provision/table.sql

@@ -11,6 +11,7 @@ SELECT
     field_name,
     delete_action,
     is_required,
+    api_required,
     junction_table_id,
     junction_table_name,
     junction_schema_id,

package/verify/schemas/metaschema_modules_public/tables/secure_table_provision/table.sql

@@ -11,6 +11,7 @@ SELECT
     node_type,
     use_rls,
     node_data,
+    fields,
     grant_roles,
     grant_privileges,
     policy_type,