@pgpmjs/export 0.27.0 → 0.28.0

package/esm/export-utils.js

@@ -4,6 +4,7 @@ import { toSnakeCase } from 'inflekt';
 import path from 'path';
 import { PgpmPackage, getMissingInstallableModules, parseAuthor } from '@pgpmjs/core';
 import { lookupByPgUdt } from './type-map';
+import metaExportTables from './meta-export-tables.json';
 // =============================================================================
 // Shared constants
 // =============================================================================
@@ -81,207 +82,17 @@ $LQLMIGRATION$;`;
 export const META_COMMON_FOOTER = `
 SET session_replication_role TO DEFAULT;`;
 /**
- * Ordered list of meta tables for export.
- * Tables are processed in this order to satisfy foreign key dependencies.
+ * Hand-authored per-table overrides layered on top of the generated
+ * table manifest. Only exceptional exporter behavior lives here:
+ * conflict handling, special field types (image, upload, url) that
+ * cannot be inferred, GraphQL type name overrides, and columns whose
+ * values must come from DDL defaults at deploy time.
  */
-export const META_TABLE_ORDER = [
-    'database',
-    'schema',
-    'function',
-    'table',
-    'field',
-    'spatial_relation',
-    'policy',
-    'index',
-    'trigger',
-    'trigger_function',
-    'rls_function',
-    'foreign_key_constraint',
-    'primary_key_constraint',
-    'unique_constraint',
-    'check_constraint',
-    'full_text_search',
-    'schema_grant',
-    'table_grant',
-    'default_privilege',
-    'domains',
-    'sites',
-    'apis',
-    'apps',
-    'site_modules',
-    'site_themes',
-    'site_metadata',
-    'api_modules',
-    'api_extensions',
-    'api_schemas',
-    'database_settings',
-    'api_settings',
-    'rls_settings',
-    'cors_settings',
-    'pubkey_settings',
-    'webauthn_settings',
-    'rls_module',
-    'user_auth_module',
-    'memberships_module',
-    'permissions_module',
-    'limits_module',
-    'levels_module',
-    'events_module',
-    'users_module',
-    'hierarchy_module',
-    'membership_types_module',
-    'invites_module',
-    'emails_module',
-    'sessions_module',
-    'user_state_module',
-    'profiles_module',
-    'config_secrets_user_module',
-    'user_credentials_module',
-    'user_settings_module',
-    'connected_accounts_module',
-    'phone_numbers_module',
-    'crypto_addresses_module',
-    'crypto_auth_module',
-    'field_module',
-    'table_module',
-    'secure_table_provision',
-    'uuid_module',
-    'default_ids_module',
-    'denormalized_table_field',
-    // NOTE: blueprint_template, blueprint, and blueprint_construction are intentionally
-    // excluded from the export flow — they are runtime-only tables not exported as metadata.
-    'relation_provision',
-    'entity_type_provision',
-    'rate_limits_module',
-    'storage_module',
-    'billing_module',
-    'billing_provider_module',
-    'devices_module',
-    'identity_providers_module',
-    'integration_providers_module',
-    'notifications_module',
-    'plans_module',
-    'realtime_module',
-    'session_secrets_module',
-    'infra_secrets_module',
-    'infra_config_module',
-    'internal_secrets_module',
-    'i18n_module',
-    'agent_module',
-    'function_module',
-    'namespace_module',
-    'merkle_store_module',
-    'graph_module',
-    'graph_execution_module',
-    'function_deployment_module',
-    'function_invocation_module',
-    'compute_log_module',
-    'db_usage_module',
-    'storage_log_module',
-    'transfer_log_module',
-    'webauthn_auth_module',
-    'webauthn_credentials_module',
-    'inference_log_module',
-    'rate_limit_meters_module'
-];
-/**
- * Shared metadata table configuration.
- *
- * Fields are discovered dynamically at runtime via introspection:
- * - SQL flow: uses information_schema.columns + mapPgTypeToFieldType()
- * - GraphQL flow: uses __type introspection + mapGraphQLTypeToFieldType()
- *
- * Only `typeOverrides` are hardcoded for special types (image, upload, url)
- * that cannot be inferred from database/GraphQL types alone.
- *
- */
-export const META_TABLE_CONFIG = {
-    // =============================================================================
-    // metaschema_public tables
-    // =============================================================================
-    database: {
-        schema: 'metaschema_public',
-        table: 'database'
-    },
-    schema: {
-        schema: 'metaschema_public',
-        table: 'schema'
-    },
-    function: {
-        schema: 'metaschema_public',
-        table: 'function'
-    },
-    table: {
-        schema: 'metaschema_public',
-        table: 'table'
-    },
+export const META_TABLE_OVERRIDES = {
     field: {
-        schema: 'metaschema_public',
-        table: 'field',
         conflictDoNothing: true
     },
-    policy: {
-        schema: 'metaschema_public',
-        table: 'policy'
-    },
-    index: {
-        schema: 'metaschema_public',
-        table: 'index'
-    },
-    trigger: {
-        schema: 'metaschema_public',
-        table: 'trigger'
-    },
-    trigger_function: {
-        schema: 'metaschema_public',
-        table: 'trigger_function'
-    },
-    rls_function: {
-        schema: 'metaschema_public',
-        table: 'rls_function'
-    },
-    foreign_key_constraint: {
-        schema: 'metaschema_public',
-        table: 'foreign_key_constraint'
-    },
-    primary_key_constraint: {
-        schema: 'metaschema_public',
-        table: 'primary_key_constraint'
-    },
-    unique_constraint: {
-        schema: 'metaschema_public',
-        table: 'unique_constraint'
-    },
-    check_constraint: {
-        schema: 'metaschema_public',
-        table: 'check_constraint'
-    },
-    full_text_search: {
-        schema: 'metaschema_public',
-        table: 'full_text_search'
-    },
-    schema_grant: {
-        schema: 'metaschema_public',
-        table: 'schema_grant'
-    },
-    table_grant: {
-        schema: 'metaschema_public',
-        table: 'table_grant'
-    },
-    default_privilege: {
-        schema: 'metaschema_public',
-        table: 'default_privilege'
-    },
-    // =============================================================================
-    // services_public tables
-    // =============================================================================
-    domains: {
-        schema: 'services_public',
-        table: 'domains'
-    },
     sites: {
-        schema: 'services_public',
-        table: 'sites',
         typeOverrides: {
             og_image: 'image',
             favicon: 'upload',
@@ -293,326 +104,47 @@ export const META_TABLE_CONFIG = {
         }
     },
     apis: {
-        schema: 'services_public',
-        table: 'apis',
         columnDefaults: {
             dbname: 'current_database()'
         }
     },
     apps: {
-        schema: 'services_public',
-        table: 'apps',
         typeOverrides: {
             app_image: 'image',
             app_store_link: 'url',
             play_store_link: 'url'
         }
     },
-    site_modules: {
-        schema: 'services_public',
-        table: 'site_modules'
-    },
-    site_themes: {
-        schema: 'services_public',
-        table: 'site_themes'
-    },
     site_metadata: {
-        schema: 'services_public',
-        table: 'site_metadata',
         typeOverrides: {
             og_image: 'image'
         }
     },
-    api_modules: {
-        schema: 'services_public',
-        table: 'api_modules'
-    },
-    api_extensions: {
-        schema: 'services_public',
-        table: 'api_extensions'
-    },
-    api_schemas: {
-        schema: 'services_public',
-        table: 'api_schemas'
-    },
-    database_settings: {
-        schema: 'services_public',
-        table: 'database_settings'
-    },
-    api_settings: {
-        schema: 'services_public',
-        table: 'api_settings'
-    },
-    rls_settings: {
-        schema: 'services_public',
-        table: 'rls_settings'
-    },
-    cors_settings: {
-        schema: 'services_public',
-        table: 'cors_settings'
-    },
-    pubkey_settings: {
-        schema: 'services_public',
-        table: 'pubkey_settings'
-    },
-    webauthn_settings: {
-        schema: 'services_public',
-        table: 'webauthn_settings'
-    },
-    // =============================================================================
-    // metaschema_modules_public tables
-    // =============================================================================
-    rls_module: {
-        schema: 'metaschema_modules_public',
-        table: 'rls_module'
-    },
-    user_auth_module: {
-        schema: 'metaschema_modules_public',
-        table: 'user_auth_module'
-    },
-    memberships_module: {
-        schema: 'metaschema_modules_public',
-        table: 'memberships_module'
-    },
-    permissions_module: {
-        schema: 'metaschema_modules_public',
-        table: 'permissions_module'
-    },
-    limits_module: {
-        schema: 'metaschema_modules_public',
-        table: 'limits_module'
-    },
-    levels_module: {
-        schema: 'metaschema_modules_public',
-        table: 'levels_module'
-    },
-    events_module: {
-        schema: 'metaschema_modules_public',
-        table: 'events_module'
-    },
-    users_module: {
-        schema: 'metaschema_modules_public',
-        table: 'users_module'
-    },
-    hierarchy_module: {
-        schema: 'metaschema_modules_public',
-        table: 'hierarchy_module'
-    },
-    membership_types_module: {
-        schema: 'metaschema_modules_public',
-        table: 'membership_types_module'
-    },
-    invites_module: {
-        schema: 'metaschema_modules_public',
-        table: 'invites_module'
-    },
-    emails_module: {
-        schema: 'metaschema_modules_public',
-        table: 'emails_module'
-    },
-    sessions_module: {
-        schema: 'metaschema_modules_public',
-        table: 'sessions_module'
-    },
-    user_state_module: {
-        schema: 'metaschema_modules_public',
-        table: 'user_state_module'
-    },
-    profiles_module: {
-        schema: 'metaschema_modules_public',
-        table: 'profiles_module'
-    },
-    config_secrets_user_module: {
-        schema: 'metaschema_modules_public',
-        table: 'config_secrets_user_module'
-    },
-    user_credentials_module: {
-        schema: 'metaschema_modules_public',
-        table: 'user_credentials_module'
-    },
-    user_settings_module: {
-        schema: 'metaschema_modules_public',
-        table: 'user_settings_module'
-    },
-    connected_accounts_module: {
-        schema: 'metaschema_modules_public',
-        table: 'connected_accounts_module'
-    },
-    phone_numbers_module: {
-        schema: 'metaschema_modules_public',
-        table: 'phone_numbers_module'
-    },
-    crypto_addresses_module: {
-        schema: 'metaschema_modules_public',
-        table: 'crypto_addresses_module'
-    },
-    crypto_auth_module: {
-        schema: 'metaschema_modules_public',
-        table: 'crypto_auth_module'
-    },
-    field_module: {
-        schema: 'metaschema_modules_public',
-        table: 'field_module'
-    },
-    table_module: {
-        schema: 'metaschema_modules_public',
-        table: 'table_module'
-    },
-    // NOTE: table_template_module has been removed from pgpm-modules (superseded by blueprints)
-    secure_table_provision: {
-        schema: 'metaschema_modules_public',
-        table: 'secure_table_provision'
-    },
-    uuid_module: {
-        schema: 'metaschema_modules_public',
-        table: 'uuid_module'
-    },
-    default_ids_module: {
-        schema: 'metaschema_modules_public',
-        table: 'default_ids_module'
-    },
-    denormalized_table_field: {
-        schema: 'metaschema_modules_public',
-        table: 'denormalized_table_field'
-    },
-    relation_provision: {
-        schema: 'metaschema_modules_public',
-        table: 'relation_provision'
-    },
-    entity_type_provision: {
-        schema: 'metaschema_modules_public',
-        table: 'entity_type_provision'
-    },
-    rate_limits_module: {
-        schema: 'metaschema_modules_public',
-        table: 'rate_limits_module'
-    },
-    storage_module: {
-        schema: 'metaschema_modules_public',
-        table: 'storage_module'
-    },
-    billing_module: {
-        schema: 'metaschema_modules_public',
-        table: 'billing_module'
-    },
-    billing_provider_module: {
-        schema: 'metaschema_modules_public',
-        table: 'billing_provider_module'
-    },
-    devices_module: {
-        schema: 'metaschema_modules_public',
-        table: 'devices_module'
-    },
-    identity_providers_module: {
-        schema: 'metaschema_modules_public',
-        table: 'identity_providers_module'
-    },
-    integration_providers_module: {
-        schema: 'metaschema_modules_public',
-        table: 'integration_providers_module'
-    },
-    notifications_module: {
-        schema: 'metaschema_modules_public',
-        table: 'notifications_module'
-    },
-    plans_module: {
-        schema: 'metaschema_modules_public',
-        table: 'plans_module'
-    },
-    realtime_module: {
-        schema: 'metaschema_modules_public',
-        table: 'realtime_module'
-    },
-    session_secrets_module: {
-        schema: 'metaschema_modules_public',
-        table: 'session_secrets_module'
-    },
-    infra_secrets_module: {
-        schema: 'metaschema_modules_public',
-        table: 'infra_secrets_module'
-    },
-    infra_config_module: {
-        schema: 'metaschema_modules_public',
-        table: 'infra_config_module'
-    },
-    internal_secrets_module: {
-        schema: 'metaschema_modules_public',
-        table: 'internal_secrets_module'
-    },
     i18n_module: {
-        schema: 'metaschema_modules_public',
-        table: 'i18n_module',
         gqlTypeName: 'I18NModule' // i18n is a well-known abbreviation; PostGraphile inflector capitalizes the N
-    },
-    agent_module: {
-        schema: 'metaschema_modules_public',
-        table: 'agent_module'
-    },
-    function_module: {
-        schema: 'metaschema_modules_public',
-        table: 'function_module'
-    },
-    namespace_module: {
-        schema: 'metaschema_modules_public',
-        table: 'namespace_module'
-    },
-    merkle_store_module: {
-        schema: 'metaschema_modules_public',
-        table: 'merkle_store_module'
-    },
-    graph_module: {
-        schema: 'metaschema_modules_public',
-        table: 'graph_module'
-    },
-    graph_execution_module: {
-        schema: 'metaschema_modules_public',
-        table: 'graph_execution_module'
-    },
-    function_deployment_module: {
-        schema: 'metaschema_modules_public',
-        table: 'function_deployment_module'
-    },
-    function_invocation_module: {
-        schema: 'metaschema_modules_public',
-        table: 'function_invocation_module'
-    },
-    compute_log_module: {
-        schema: 'metaschema_modules_public',
-        table: 'compute_log_module'
-    },
-    db_usage_module: {
-        schema: 'metaschema_modules_public',
-        table: 'db_usage_module'
-    },
-    storage_log_module: {
-        schema: 'metaschema_modules_public',
-        table: 'storage_log_module'
-    },
-    transfer_log_module: {
-        schema: 'metaschema_modules_public',
-        table: 'transfer_log_module'
-    },
-    webauthn_auth_module: {
-        schema: 'metaschema_modules_public',
-        table: 'webauthn_auth_module'
-    },
-    webauthn_credentials_module: {
-        schema: 'metaschema_modules_public',
-        table: 'webauthn_credentials_module'
-    },
-    inference_log_module: {
-        schema: 'metaschema_modules_public',
-        table: 'inference_log_module',
-    },
-    rate_limit_meters_module: {
-        schema: 'metaschema_modules_public',
-        table: 'rate_limit_meters_module',
-    },
-    spatial_relation: {
-        schema: 'metaschema_public',
-        table: 'spatial_relation'
     }
 };
+/**
+ * Ordered list of meta tables for export, derived from the generated
+ * manifest. Tables are already topologically sorted by foreign key
+ * dependencies at generation time.
+ */
+export const META_TABLE_ORDER = metaExportTables.tables.map(t => t.key);
+/**
+ * Shared metadata table configuration, built from the generated manifest
+ * plus META_TABLE_OVERRIDES.
+ *
+ * Fields are discovered dynamically at runtime via introspection:
+ * - SQL flow: uses information_schema.columns + mapPgTypeToFieldType()
+ * - GraphQL flow: uses __type introspection + mapGraphQLTypeToFieldType()
+ *
+ * Only `typeOverrides` are hardcoded for special types (image, upload, url)
+ * that cannot be inferred from database/GraphQL types alone.
+ */
+export const META_TABLE_CONFIG = Object.fromEntries(metaExportTables.tables.map(t => [
+    t.key,
+    { schema: t.schema, table: t.table, ...META_TABLE_OVERRIDES[t.key] }
+]));
 // =============================================================================
 // Shared functions
 // =============================================================================

package/esm/index.js

@@ -4,6 +4,6 @@ export * from './export-graphql';
 export * from './export-graphql-meta';
 export { GraphQLClient } from './graphql-client';
 export { getGraphQLQueryName, getGraphQLTypeName, graphqlRowToPostgresRow, buildFieldsFragment, mapGraphQLTypeToFieldType, unwrapGraphQLType } from './graphql-naming';
-export { DB_REQUIRED_EXTENSIONS, SERVICE_REQUIRED_EXTENSIONS, META_COMMON_HEADER, META_COMMON_FOOTER, META_TABLE_ORDER, META_TABLE_CONFIG, mapPgTypeToFieldType, makeReplacer, preparePackage, normalizeOutdir, detectMissingModules, installMissingModules } from './export-utils';
+export { DB_REQUIRED_EXTENSIONS, SERVICE_REQUIRED_EXTENSIONS, META_COMMON_HEADER, META_COMMON_FOOTER, META_TABLE_ORDER, META_TABLE_CONFIG, META_TABLE_OVERRIDES, mapPgTypeToFieldType, makeReplacer, preparePackage, normalizeOutdir, detectMissingModules, installMissingModules } from './export-utils';
 export { PG_TYPE_MAP, lookupByPgUdt, lookupByGqlType } from './type-map';
 export { intervalToPostgres, parsePgInterval } from './interval-utils';