@pgpm/metaschema-modules 0.28.3 → 0.28.5

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

@@ -0,0 +1,70 @@
+-- Deploy schemas/metaschema_modules_public/tables/server_definition_module/table to pg
+
+-- requires: schemas/metaschema_modules_public/schema
+
+BEGIN;
+
+CREATE TABLE metaschema_modules_public.server_definition_module (
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
+    database_id uuid NOT NULL,
+
+    -- Schema references (if uuid_nil, resolved from schema name or default)
+    schema_id uuid NOT NULL DEFAULT uuid_nil(),
+    private_schema_id uuid NOT NULL DEFAULT uuid_nil(),
+
+    -- Optional schema name overrides (used when schema IDs are not provided)
+    public_schema_name text,
+    private_schema_name text,
+
+    -- Generated table IDs (populated by the generator)
+    definitions_table_id uuid NOT NULL DEFAULT uuid_nil(),
+
+    -- Table names (input to the generator — bare names without scope prefix).
+    -- The trigger prepends the scope prefix automatically.
+    definitions_table_name text NOT NULL DEFAULT 'server_definitions',
+
+    -- API routing (get-or-create: if set, schema is added to this API; if NULL, no API is added)
+    api_name text,
+    private_api_name text,
+
+    -- Scope: determines the security level for this module instance.
+    -- Resolved to a membership_type integer at trigger time via membership_types table.
+    scope text NOT NULL DEFAULT 'platform',
+
+    -- Table name prefix. Auto-derived from scope by the trigger when empty.
+    -- Override to create multiple module instances at the same scope.
+    prefix text NOT NULL DEFAULT '',
+
+    -- Entity table for RLS (NULL for platform-level definitions, entity table for entity-scoped)
+    entity_table_id uuid NULL,
+
+    -- Configurable security policies (NULL = use defaults based on scope).
+    -- When provided, replaces the default policy set in apply_server_definition_security.
+    -- Accepts a JSON array of policy objects:
+    --   {"$type": "AuthzEntityMembership", "privileges": ["select", "update"], "data": {...}}
+    policies jsonb NULL,
+
+    -- Per-table provisions overrides from blueprint config.
+    -- Keys are table keys (definitions).
+    -- When a key is present, the module trigger skips default security for that table;
+    -- secure_table_provision applies the custom grants/policies instead.
+    provisions jsonb NULL,
+
+    -- Default permissions: permission names auto-granted to new members.
+    -- NULL uses the module's built-in defaults; explicit array overrides them.
+    default_permissions text[] DEFAULT NULL,
+
+    -- Constraints
+    CONSTRAINT server_definition_module_db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,
+    CONSTRAINT server_definition_module_schema_fkey FOREIGN KEY (schema_id) REFERENCES metaschema_public.schema (id) ON DELETE CASCADE,
+    CONSTRAINT server_definition_module_private_schema_fkey FOREIGN KEY (private_schema_id) REFERENCES metaschema_public.schema (id) ON DELETE CASCADE,
+    CONSTRAINT server_definition_module_definitions_table_fkey FOREIGN KEY (definitions_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE,
+    CONSTRAINT server_definition_module_entity_table_fkey FOREIGN KEY (entity_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE
+);
+
+CREATE INDEX server_definition_module_database_id_idx ON metaschema_modules_public.server_definition_module ( database_id );
+
+-- Unique constraint: one server definition module per database per scope per prefix.
+CREATE UNIQUE INDEX server_definition_module_unique_scope ON metaschema_modules_public.server_definition_module ( database_id, scope, prefix );
+
+COMMIT;

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

@@ -0,0 +1,83 @@
+-- Deploy schemas/metaschema_modules_public/tables/server_deployment_module/table to pg
+
+-- requires: schemas/metaschema_modules_public/schema
+-- requires: schemas/metaschema_modules_public/tables/server_definition_module/table
+-- requires: schemas/metaschema_modules_public/tables/namespace_module/table
+
+BEGIN;
+
+CREATE TABLE metaschema_modules_public.server_deployment_module (
+    id uuid PRIMARY KEY DEFAULT uuidv7(),
+    database_id uuid NOT NULL,
+
+    -- Schema references (if uuid_nil, resolved from schema name or default)
+    schema_id uuid NOT NULL DEFAULT uuid_nil(),
+    private_schema_id uuid NOT NULL DEFAULT uuid_nil(),
+
+    -- Optional schema name overrides (used when schema IDs are not provided)
+    public_schema_name text,
+    private_schema_name text,
+
+    -- Generated table IDs (populated by the generator)
+    deployments_table_id uuid NOT NULL DEFAULT uuid_nil(),
+    deployment_events_table_id uuid NOT NULL DEFAULT uuid_nil(),
+
+    -- Table names (input to the generator — bare names without scope prefix).
+    -- The trigger prepends the scope prefix automatically.
+    deployments_table_name text NOT NULL DEFAULT 'server_deployments',
+    deployment_events_table_name text NOT NULL DEFAULT 'server_deployment_events',
+
+    -- API routing (get-or-create: if set, schema is added to this API; if NULL, no API is added)
+    api_name text,
+    private_api_name text,
+
+    -- Scope: determines the security level for this module instance.
+    -- Resolved to a membership_type integer at trigger time via membership_types table.
+    scope text NOT NULL DEFAULT 'app',
+
+    -- Table name prefix. Auto-derived from scope by the trigger when empty.
+    -- Override to create multiple module instances at the same scope.
+    prefix text NOT NULL DEFAULT '',
+
+    -- Entity table for RLS (NULL for app-level deployments, entity table for entity-scoped)
+    entity_table_id uuid NULL,
+
+    -- FK to server_definition_module: which server definitions table deployments reference
+    server_definition_module_id uuid NULL,
+
+    -- FK to namespace_module: which namespaces table deployments reference
+    namespace_module_id uuid NULL,
+
+    -- Configurable security policies (NULL = use defaults based on scope).
+    -- When provided, replaces the default policy set in apply_server_deployment_security.
+    -- Accepts a JSON array of policy objects:
+    --   {"$type": "AuthzEntityMembership", "privileges": ["select", "update"], "data": {...}}
+    policies jsonb NULL,
+
+    -- Per-table provisions overrides from blueprint config.
+    -- Keys are table keys (deployments, deployment_events).
+    -- When a key is present, the module trigger skips default security for that table;
+    -- secure_table_provision applies the custom grants/policies instead.
+    provisions jsonb NULL,
+
+    -- Default permissions: permission names auto-granted to new members.
+    -- NULL uses the module's built-in defaults; explicit array overrides them.
+    default_permissions text[] DEFAULT NULL,
+
+    -- Constraints
+    CONSTRAINT server_deployment_module_db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,
+    CONSTRAINT server_deployment_module_schema_fkey FOREIGN KEY (schema_id) REFERENCES metaschema_public.schema (id) ON DELETE CASCADE,
+    CONSTRAINT server_deployment_module_private_schema_fkey FOREIGN KEY (private_schema_id) REFERENCES metaschema_public.schema (id) ON DELETE CASCADE,
+    CONSTRAINT server_deployment_module_deployments_table_fkey FOREIGN KEY (deployments_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE,
+    CONSTRAINT server_deployment_module_events_table_fkey FOREIGN KEY (deployment_events_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE,
+    CONSTRAINT server_deployment_module_entity_table_fkey FOREIGN KEY (entity_table_id) REFERENCES metaschema_public.table (id) ON DELETE CASCADE,
+    CONSTRAINT server_deployment_module_server_def_module_fkey FOREIGN KEY (server_definition_module_id) REFERENCES metaschema_modules_public.server_definition_module (id) ON DELETE SET NULL,
+    CONSTRAINT server_deployment_module_namespace_module_fkey FOREIGN KEY (namespace_module_id) REFERENCES metaschema_modules_public.namespace_module (id) ON DELETE SET NULL
+);
+
+CREATE INDEX server_deployment_module_database_id_idx ON metaschema_modules_public.server_deployment_module ( database_id );
+
+-- Unique constraint: one server deployment module per database per scope per prefix.
+CREATE UNIQUE INDEX server_deployment_module_unique_scope ON metaschema_modules_public.server_deployment_module ( database_id, scope, prefix );
+
+COMMIT;

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

@@ -11,6 +11,10 @@ CREATE TABLE metaschema_modules_public.storage_log_module (
   schema_id uuid NOT NULL DEFAULT uuid_nil(),
   private_schema_id uuid NOT NULL DEFAULT uuid_nil(),
 
+  -- Schema name overrides: when set, the trigger uses these instead of hardcoded defaults.
+  public_schema_name text,
+  private_schema_name text,
+
   -- Storage log table (partitioned by snapshot_at)
   storage_log_table_id uuid NOT NULL DEFAULT uuid_nil(),
   storage_log_table_name text NOT NULL DEFAULT '',

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

@@ -12,6 +12,11 @@ CREATE TABLE metaschema_modules_public.storage_module (
     schema_id uuid NOT NULL DEFAULT uuid_nil(),
     private_schema_id uuid NOT NULL DEFAULT uuid_nil(),
 
+    -- Schema name overrides: when set, the trigger uses these instead of hardcoded defaults.
+    -- Enables putting storage tables into a dedicated schema (e.g. per-entity isolation).
+    public_schema_name text,
+    private_schema_name text,
+
     -- Generated table IDs (populated by the generator)
     buckets_table_id uuid NOT NULL DEFAULT uuid_nil(),
     files_table_id uuid NOT NULL DEFAULT uuid_nil(),
@@ -92,7 +97,8 @@ CREATE TABLE metaschema_modules_public.storage_module (
 
     -- Constraints
     -- API routing (configurable per-module)
-    api_name text DEFAULT 'admin',
+    -- NULL = no automatic API routing (caller must route explicitly or use entity_type_provision).
+    api_name text DEFAULT NULL,
     private_api_name text DEFAULT NULL,
 
     CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,

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

@@ -11,6 +11,10 @@ CREATE TABLE metaschema_modules_public.transfer_log_module (
   schema_id uuid NOT NULL DEFAULT uuid_nil(),
   private_schema_id uuid NOT NULL DEFAULT uuid_nil(),
 
+  -- Schema name overrides: when set, the trigger uses these instead of hardcoded defaults.
+  public_schema_name text,
+  private_schema_name text,
+
   -- Transfer log table (partitioned by created_at)
   transfer_log_table_id uuid NOT NULL DEFAULT uuid_nil(),
   transfer_log_table_name text NOT NULL DEFAULT '',

package/metaschema-modules.control

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgpm/metaschema-modules",
-  "version": "0.28.3",
+  "version": "0.28.5",
   "description": "Module metadata handling and dependency tracking",
   "author": "Dan Lynch <pyramation@gmail.com>",
   "contributors": [
@@ -21,11 +21,12 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "@pgpm/metaschema-schema": "0.28.3",
-    "@pgpm/verify": "0.28.3"
+    "@pgpm/metaschema-schema": "0.28.4",
+    "@pgpm/verify": "0.28.4"
   },
   "devDependencies": {
-    "pgpm": "^4.23.2"
+    "constructive-test": "^0.4.1",
+    "pgpm": "^4.28.7"
   },
   "repository": {
     "type": "git",
@@ -35,5 +36,5 @@
   "bugs": {
     "url": "https://github.com/constructive-io/pgpm-modules/issues"
   },
-  "gitHead": "ebab5300b911578a615bf8d267fe7c5c244caea3"
+  "gitHead": "1ea2567e22a81f4d0b2bea83c3e1289406015e58"
 }

package/pgpm.plan

@@ -58,6 +58,7 @@ schemas/metaschema_modules_public/tables/db_usage_module/table [schemas/metasche
 schemas/metaschema_modules_public/tables/agent_module/table [schemas/metaschema_modules_public/schema] 2026-05-12T23:01:00Z devin <devin@cognition.ai> # add agent_module config table for AI agent conversation threads, messages, and tasks
 schemas/metaschema_modules_public/tables/merkle_store_module/table [schemas/metaschema_modules_public/schema] 2026-05-21T00:00:00Z devin <devin@cognition.ai> # add merkle_store_module config table for content-addressed Merkle object stores
 schemas/metaschema_modules_public/tables/graph_module/table [schemas/metaschema_modules_public/schema schemas/metaschema_modules_public/tables/merkle_store_module/table] 2026-05-21T01:00:00Z devin <devin@cognition.ai> # add graph_module config table for FBP graph utilities on top of merkle store
+schemas/metaschema_modules_public/tables/graph_execution_module/table [schemas/metaschema_modules_public/schema schemas/metaschema_modules_public/tables/graph_module/table] 2026-06-12T00:00:00Z devin <devin@cognition.ai> # add graph_execution_module config table for partitioned execution state + merkle tree time-travel debugging
 schemas/metaschema_modules_public/tables/namespace_module/table [schemas/metaschema_modules_public/schema] 2026-05-21T02:00:00Z devin <devin@cognition.ai> # add namespace_module config table for entity-aware namespace provisioning
 schemas/metaschema_modules_public/tables/function_module/table [schemas/metaschema_modules_public/schema] 2026-05-21T03:00:00Z devin <devin@cognition.ai> # add function_module config table for entity-aware function definitions
 schemas/metaschema_modules_public/tables/function_invocation_module/table [schemas/metaschema_modules_public/schema] 2026-06-08T00:00:00Z devin <devin@cognition.ai> # add function_invocation_module config table for entity-scoped invocations and execution logs
@@ -66,4 +67,10 @@ schemas/metaschema_modules_public/tables/user_credentials_module/table [schemas/
 schemas/metaschema_modules_public/tables/user_settings_module/table [schemas/metaschema_modules_public/schema] 2026-05-28T00:00:00Z devin <devin@cognition.ai> # add user_settings_module for extensible per-user preferences (1:1 with users)
 
 schemas/metaschema_modules_public/tables/i18n_module/table [schemas/metaschema_modules_public/schema] 2026-05-28T00:00:00Z devin <devin@cognition.ai> # add i18n_module config table for internationalization settings
-schemas/metaschema_modules_public/tables/graph_execution_module/table [schemas/metaschema_modules_public/schema schemas/metaschema_modules_public/tables/graph_module/table] 2026-06-12T00:00:00Z devin <devin@cognition.ai> # add graph_execution_module config table for partitioned execution state + merkle tree time-travel debugging
+schemas/metaschema_modules_public/tables/function_deployment_module/table [schemas/metaschema_modules_public/schema schemas/metaschema_modules_public/tables/function_module/table schemas/metaschema_modules_public/tables/namespace_module/table] 2026-06-11T06:00:00Z devin <devin@cognition.ai> # add function_deployment_module config table for function-to-namespace deployment binding
+schemas/metaschema_modules_public/tables/function_module/constraints/one_platform_database [schemas/metaschema_modules_public/tables/function_module/table] 2026-06-11T08:00:00Z devin <devin@cognition.ai> # enforce at most one platform-scope function_module (unambiguous resolveDatabaseId)
+schemas/metaschema_modules_public/tables/principal_auth_module/table [schemas/metaschema_modules_public/schema] 2026-06-24T11:15:00Z devin <devin@cognition.ai> # add principal_auth_module config table for scoped API keys and agent principals
+schemas/metaschema_modules_public/tables/server_definition_module/table [schemas/metaschema_modules_public/schema] 2026-06-30T00:00:00Z devin <devin@cognition.ai> # add server_definition_module config table for persistent server definitions (GraphQL, agentic, WebSocket, etc.)
+schemas/metaschema_modules_public/tables/server_deployment_module/table [schemas/metaschema_modules_public/schema schemas/metaschema_modules_public/tables/server_definition_module/table schemas/metaschema_modules_public/tables/namespace_module/table] 2026-06-30T00:00:01Z devin <devin@cognition.ai> # add server_deployment_module config table for server-to-namespace deployment binding
+schemas/metaschema_modules_public/tables/route_module/table [schemas/metaschema_modules_public/schema] 2026-06-30T00:00:02Z devin <devin@cognition.ai> # add route_module config table for gateway route rules (domain+path to backend target)
+schemas/metaschema_modules_public/tables/certificate_module/table [schemas/metaschema_modules_public/schema] 2026-06-30T00:00:03Z devin <devin@cognition.ai> # add certificate_module config table for TLS certificate lifecycle management

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

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

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

@@ -2,6 +2,6 @@
 
 BEGIN;
 
-DROP TABLE IF EXISTS metaschema_modules_public.config_secrets_module;
+DROP TABLE metaschema_modules_public.config_secrets_module;
 
 COMMIT;

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

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

package/revert/schemas/metaschema_modules_public/tables/function_module/constraints/one_platform_database.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/metaschema_modules_public/tables/function_module/constraints/one_platform_database from pg
+
+BEGIN;
+
+-- No-op: nothing to revert (deploy was a no-op documentation migration)
+
+COMMIT;

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

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

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

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

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

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

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

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

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

@@ -2,6 +2,6 @@
 
 BEGIN;
 
-DROP TABLE IF EXISTS metaschema_modules_public.user_credentials_module;
+DROP TABLE metaschema_modules_public.user_credentials_module;
 
 COMMIT;

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

@@ -2,6 +2,6 @@
 
 BEGIN;
 
-DROP TABLE IF EXISTS metaschema_modules_public.user_settings_module;
+DROP TABLE metaschema_modules_public.user_settings_module;
 
 COMMIT;