feat(export): excludeCategories filtering in GraphQL export mode

Adds category to the migrate-client schema/ORM (SqlAction field, filter,
orderBy) and filters sql_actions server-side in exportGraphQL via
or: [category isNull, category notIn excludeCategories], keeping
null-category rows. CLI now passes --exclude-categories in both modes.

Author: pyramation

pgpm/cli/src/commands/export.ts

@@ -24,7 +24,7 @@ Options:
   --extensionName <name>  Extension name
   --metaExtensionName <name>  Meta extension name (default: svc)
   --exclude-categories <list>  Comma-separated sql_actions categories to omit
-                          (e.g. security,permissions,auth,memberships). SQL mode only.
+                          (e.g. security,permissions,auth,memberships). Works in SQL and GraphQL modes.
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
@@ -179,7 +179,8 @@ export default async (
       metaExtensionName,
       prompter,
       argv,
-      username
+      username,
+      excludeCategories
     });
   } else {
     // =========================================================================

pgpm/export/src/export-graphql.ts

@@ -70,6 +70,12 @@ export interface ExportGraphQLOptions {
   username?: string;
   serviceOutdir?: string;
   skipSchemaRenaming?: boolean;
+  /**
+   * sql_actions categories to exclude from the export (e.g. ['security',
+   * 'permissions']). Rows whose category matches are omitted; rows with a
+   * null category are always kept.
+   */
+  excludeCategories?: string[];
 }
 
 export const exportGraphQL = async ({
@@ -94,7 +100,8 @@ export const exportGraphQL = async ({
   repoName,
   username,
   serviceOutdir,
-  skipSchemaRenaming = false
+  skipSchemaRenaming = false,
+  excludeCategories
 }: ExportGraphQLOptions): Promise<void> => {
   const normalizedOutdir = normalizeOutdir(outdir);
   const svcOutdir = normalizeOutdir(serviceOutdir || outdir);
@@ -147,10 +154,19 @@ export const exportGraphQL = async ({
             actionName: true,
             actionId: true,
             actorId: true,
-            payload: true
+            payload: true,
+            category: true
           },
           where: {
-            databaseId: { equalTo: databaseId }
+            databaseId: { equalTo: databaseId },
+            ...(excludeCategories && excludeCategories.length > 0
+              ? {
+                  or: [
+                    { category: { isNull: true } },
+                    { category: { notIn: excludeCategories } }
+                  ]
+                }
+              : {})
           },
           orderBy: ['ID_ASC'],
           first: PAGE_SIZE,

sdk/migrate-client/schemas/migrate.graphql

@@ -662,6 +662,7 @@ type SqlAction {
   actionId: UUID
   actionName: String
   actorId: UUID
+  category: String
   content: String
   createdAt: Datetime
   databaseId: UUID
@@ -716,6 +717,9 @@ input SqlActionFilter {
   """Checks for all expressions in this list."""
   and: [SqlActionFilter!]
 
+  """Filter by the object’s `category` field."""
+  category: StringFilter
+
   """Filter by the object’s `content` field."""
   content: StringFilter
 
@@ -758,6 +762,8 @@ enum SqlActionOrderBy {
   ACTION_NAME_DESC
   ACTOR_ID_ASC
   ACTOR_ID_DESC
+  CATEGORY_ASC
+  CATEGORY_DESC
   CONTENT_ASC
   CONTENT_DESC
   CREATED_AT_ASC

sdk/migrate-client/src/migrate/orm/README.md

@@ -78,6 +78,7 @@ CRUD operations for SqlAction records.
 | `actionId` | UUID | Yes |
 | `actionName` | String | Yes |
 | `actorId` | UUID | Yes |
+| `category` | String | Yes |
 | `content` | String | Yes |
 | `createdAt` | Datetime | No |
 | `databaseId` | UUID | Yes |
@@ -93,13 +94,13 @@ CRUD operations for SqlAction records.
 
 ```typescript
 // List all sqlAction records
-const items = await db.sqlAction.findMany({ select: { actionId: true, actionName: true, actorId: true, content: true, createdAt: true, databaseId: true, deploy: true, deps: true, id: true, name: true, payload: true, revert: true, verify: true } }).execute();
+const items = await db.sqlAction.findMany({ select: { actionId: true, actionName: true, actorId: true, category: true, content: true, createdAt: true, databaseId: true, deploy: true, deps: true, id: true, name: true, payload: true, revert: true, verify: true } }).execute();
 
 // Get one by id
-const item = await db.sqlAction.findOne({ id: '<Int>', select: { actionId: true, actionName: true, actorId: true, content: true, createdAt: true, databaseId: true, deploy: true, deps: true, id: true, name: true, payload: true, revert: true, verify: true } }).execute();
+const item = await db.sqlAction.findOne({ id: '<Int>', select: { actionId: true, actionName: true, actorId: true, category: true, content: true, createdAt: true, databaseId: true, deploy: true, deps: true, id: true, name: true, payload: true, revert: true, verify: true } }).execute();
 
 // Create
-const created = await db.sqlAction.create({ data: { actionId: '<UUID>', actionName: '<String>', actorId: '<UUID>', content: '<String>', databaseId: '<UUID>', deploy: '<String>', deps: '<String>', name: '<String>', payload: '<JSON>', revert: '<String>', verify: '<String>' }, select: { id: true } }).execute();
+const created = await db.sqlAction.create({ data: { actionId: '<UUID>', actionName: '<String>', actorId: '<UUID>', category: '<String>', content: '<String>', databaseId: '<UUID>', deploy: '<String>', deps: '<String>', name: '<String>', payload: '<JSON>', revert: '<String>', verify: '<String>' }, select: { id: true } }).execute();
 
 // Update
 const updated = await db.sqlAction.update({ where: { id: '<Int>' }, data: { actionId: '<UUID>' }, select: { id: true } }).execute();

sdk/migrate-client/src/migrate/orm/input-types.ts

@@ -250,6 +250,7 @@ export interface SqlAction {
   actionId?: string | null;
   actionName?: string | null;
   actorId?: string | null;
+  category?: string | null;
   content?: string | null;
   createdAt?: string | null;
   databaseId?: string | null;
@@ -299,6 +300,7 @@ export type SqlActionSelect = {
   actionId?: boolean;
   actionName?: boolean;
   actorId?: boolean;
+  category?: boolean;
   content?: boolean;
   createdAt?: boolean;
   databaseId?: boolean;
@@ -354,6 +356,8 @@ export interface SqlActionFilter {
   actorId?: UUIDFilter;
   /** Checks for all expressions in this list. */
   and?: SqlActionFilter[];
+  /** Filter by the object’s `category` field. */
+  category?: StringFilter;
   /** Filter by the object’s `content` field. */
   content?: StringFilter;
   /** Filter by the object’s `createdAt` field. */
@@ -413,6 +417,8 @@ export type SqlActionOrderBy =
   | 'ACTION_NAME_DESC'
   | 'ACTOR_ID_ASC'
   | 'ACTOR_ID_DESC'
+  | 'CATEGORY_ASC'
+  | 'CATEGORY_DESC'
   | 'CONTENT_ASC'
   | 'CONTENT_DESC'
   | 'CREATED_AT_ASC'
@@ -479,6 +485,7 @@ export interface CreateSqlActionInput {
     actionId: string;
     actionName?: string;
     actorId: string;
+    category?: string;
     content?: string;
     databaseId: string;
     deploy?: string;
@@ -493,6 +500,7 @@ export interface SqlActionPatch {
   actionId?: string | null;
   actionName?: string | null;
   actorId?: string | null;
+  category?: string | null;
   content?: string | null;
   databaseId?: string | null;
   deploy?: string | null;