@tailor-platform/erp-kit 0.6.0 → 0.7.0

package/src/modules/finance-ledger/docs/queries/ListAccountingPeriods.md

@@ -0,0 +1,46 @@
+# ListAccountingPeriods
+
+## Overview
+
+ListAccountingPeriods retrieves a list of accounting periods for a given company or fiscal year, with optional filters for status and period type. Results are sorted by startDate ascending. This query supports period navigation, close workflow coordination, and upstream module posting validation.
+
+## Business Rules
+
+- At least one scoping parameter is required: `companyId` or `fiscalYearId`
+- Optional filters:
+  - `status` — filter by period status (NEVER_OPENED, FUTURE_ENTERABLE, OPEN, CLOSED, PERMANENTLY_CLOSED)
+  - `periodType` — filter by period type (OPERATING, ADJUSTMENT)
+- All filters can be combined; when multiple filters are provided, results must match all criteria (AND logic)
+- Returns full accounting period records (same shape as GetAccountingPeriod output)
+- Results are sorted by startDate ascending
+- Returns an empty list if no periods match the filters
+
+## Process Flow
+
+```mermaid
+flowchart TD
+    A[Receive input with companyId or fiscalYearId] --> B[Build query with scope]
+    B --> C{Filters provided?}
+    C -->|Yes| D[Apply status and/or periodType filters]
+    C -->|No| E[Return all periods in scope]
+    D --> E
+    E --> F[Sort by startDate ascending]
+    F --> G[Return period list]
+```
+
+## External Dependencies
+
+- None
+
+## Error Scenarios
+
+- **EMPTY_RESULT**: No accounting periods match the given criteria — returns empty list
+
+## Test Cases
+
+- returns error when neither companyId nor fiscalYearId is provided
+- returns all accounting periods for a company
+- returns accounting periods filtered by fiscal year
+- returns accounting periods filtered by status
+- returns accounting periods filtered by period type
+- returns empty list when no accounting periods match

package/src/modules/finance-ledger/docs/queries/ListFinancialStatements.md

@@ -0,0 +1,46 @@
+# ListFinancialStatements
+
+## Overview
+
+ListFinancialStatements retrieves a list of financial statements for a given company, with optional filters for statement type, status, and date range. Results are sorted by creation date descending. This query supports statement management, audit review, and reporting history navigation.
+
+## Business Rules
+
+- companyId is required — financial statements are always scoped to a company
+- Optional filters:
+  - `statementType` — filter by statement type (BALANCE_SHEET, PROFIT_AND_LOSS, CASH_FLOW)
+  - `status` — filter by status (DRAFT, FINALIZED)
+  - `dateRange` — filter by reporting date or date range overlap
+- All filters can be combined; when multiple filters are provided, results must match all criteria (AND logic)
+- Returns financial statement records including header fields (line items are not included in list results for performance)
+- Results are sorted by creation date descending
+- Returns an empty list if no financial statements match the filters
+
+## Process Flow
+
+```mermaid
+flowchart TD
+    A[Receive input with companyId] --> B[Build query scoped to companyId]
+    B --> C{Filters provided?}
+    C -->|Yes| D[Apply statementType, status, and/or dateRange filters]
+    C -->|No| E[Return all financial statements for company]
+    D --> E
+    E --> F[Sort by creation date descending]
+    F --> G[Return financial statement list]
+```
+
+## External Dependencies
+
+- None
+
+## Error Scenarios
+
+- **EMPTY_RESULT**: No financial statements match the given criteria — returns empty list
+
+## Test Cases
+
+- returns all financial statements for a company
+- returns financial statements filtered by statement type
+- returns financial statements filtered by status
+- returns financial statements filtered by dateRange
+- returns empty list when no financial statements match

package/src/modules/finance-ledger/docs/queries/ListFiscalYears.md

@@ -0,0 +1,42 @@
+# ListFiscalYears
+
+## Overview
+
+ListFiscalYears retrieves a list of fiscal years for a given company, with optional date range filtering. Results are sorted by startDate ascending. This query supports fiscal calendar navigation, period setup workflows, and year-end close coordination.
+
+## Business Rules
+
+- companyId is required — fiscal years are always scoped to a company
+- Optional filters:
+  - `startDate` / `endDate` — filter fiscal years overlapping the specified date range
+- Returns full fiscal year records (same shape as GetFiscalYear output)
+- Results are sorted by startDate ascending
+- Returns an empty list if no fiscal years match the filters
+
+## Process Flow
+
+```mermaid
+flowchart TD
+    A[Receive input with companyId] --> B[Build query scoped to companyId]
+    B --> C{Date range filter provided?}
+    C -->|Yes| D[Apply date range filter to query]
+    C -->|No| E[Return all fiscal years for company]
+    D --> E
+    E --> F[Sort by startDate ascending]
+    F --> G[Return fiscal year list]
+```
+
+## External Dependencies
+
+- None
+
+## Error Scenarios
+
+- **EMPTY_RESULT**: No fiscal years match the given criteria — returns empty list
+
+## Test Cases
+
+- returns all fiscal years for a company
+- returns fiscal years filtered by startDate
+- returns fiscal years filtered by endDate
+- returns empty list when no fiscal years match

package/src/modules/finance-ledger/docs/queries/ListJournalEntries.md

@@ -0,0 +1,48 @@
+# ListJournalEntries
+
+## Overview
+
+ListJournalEntries retrieves a list of journal entries with various filters. This query supports journal review workflows, period-end reconciliation, audit inquiries, and subledger-to-GL reconciliation by allowing filtering on company, period, journal type, status, and date range. Results are sorted by entryDate descending.
+
+## Business Rules
+
+- companyId is required — journal entries are always scoped to a company
+- Optional filters:
+  - `accountingPeriodId` — filter by accounting period
+  - `journalType` — filter by journal type (Sales, Purchase, Cash, Bank, Miscellaneous, Opening, Closing)
+  - `status` — filter by status (DRAFT, POSTED, REVERSED)
+  - `dateRange` — filter by entry date range (startDate and endDate)
+- All filters can be combined; when multiple filters are provided, results must match all criteria (AND logic)
+- Returns full journal entry records including header fields (journal lines are not included in list results for performance)
+- Results are sorted by entryDate descending
+- Returns an empty list if no journal entries match the filters
+
+## Process Flow
+
+```mermaid
+flowchart TD
+    A[Receive input with companyId] --> B[Build query scoped to companyId]
+    B --> C{Filters provided?}
+    C -->|Yes| D[Apply accountingPeriodId, journalType, status, and/or dateRange filters]
+    C -->|No| E[Return all journal entries for company]
+    D --> E
+    E --> F[Sort by entryDate descending]
+    F --> G[Return journal entry list]
+```
+
+## External Dependencies
+
+- None
+
+## Error Scenarios
+
+- **EMPTY_RESULT**: No journal entries match the given criteria — returns empty list
+
+## Test Cases
+
+- returns all journal entries for a company
+- returns journal entries filtered by accounting period
+- returns journal entries filtered by journal type
+- returns journal entries filtered by status
+- returns journal entries filtered by date range
+- returns empty list when no journal entries match

package/src/modules/finance-ledger/docs/queries/ListPeriodCloses.md

@@ -0,0 +1,46 @@
+# ListPeriodCloses
+
+## Overview
+
+ListPeriodCloses retrieves a list of period close records for a given company, with optional filters by fiscal year and status. Results are sorted by the associated accounting period's start date ascending. This query supports close coordination dashboards, audit trail review, and multi-entity close progress tracking.
+
+## Business Rules
+
+- companyId is required — period close records are always scoped to a company via their associated accounting period
+- Optional filters:
+  - `fiscalYearId` — filter to period closes within a specific fiscal year
+  - `status` — filter by close status (NOT_STARTED, IN_PROGRESS, SUBLEDGERS_VERIFIED, ADJUSTMENTS_POSTED, TRIAL_BALANCE_VERIFIED, UNDER_REVIEW, SOFT_LOCKED, PERMANENTLY_CLOSED)
+- All filters can be combined; when multiple filters are provided, results must match all criteria (AND logic)
+- Returns full period close records (same shape as GetPeriodClose output)
+- Results are sorted by the associated accounting period's start date ascending
+- Returns an empty list if no period close records match the filters
+
+## Process Flow
+
+```mermaid
+flowchart TD
+    A[Receive input with companyId] --> B[Build query scoped to companyId via accounting period join]
+    B --> C{Fiscal year filter provided?}
+    C -->|Yes| D[Apply fiscal year filter]
+    C -->|No| E{Status filter provided?}
+    D --> E
+    E -->|Yes| F[Apply status filter]
+    E -->|No| G[Sort by associated period startDate ascending]
+    F --> G
+    G --> H[Return period close list]
+```
+
+## External Dependencies
+
+- None
+
+## Error Scenarios
+
+- **EMPTY_RESULT**: No period close records match the given criteria — returns empty list
+
+## Test Cases
+
+- returns all period closes for a company
+- returns period closes filtered by fiscal year
+- returns period closes filtered by status
+- returns empty list when no period closes match

package/src/modules/finance-ledger/docs/queries/ListTrialBalances.md

@@ -0,0 +1,51 @@
+# ListTrialBalances
+
+## Overview
+
+ListTrialBalances retrieves a list of trial balance snapshots for a given company, with optional filters by accounting period and variant (PRE_CLOSE or POST_CLOSE). Results are sorted by generation timestamp descending. This query supports multi-period comparison, audit preparation, and period-end close workflows.
+
+## Business Rules
+
+- companyId is required — trial balances are always scoped to a company
+- Optional filters:
+  - `accountingPeriodId` — filter to a specific period
+  - `variant` — filter by PRE_CLOSE or POST_CLOSE
+  - `fiscalYearId` — filter to all periods within a fiscal year
+- All filters can be combined; when multiple filters are provided, results must match all criteria (AND logic)
+- Returns trial balance header records (generation parameters, variant, timestamp — line items are not included in list results for performance)
+- Results are sorted by generatedAt timestamp descending (most recent first)
+- Returns an empty list if no trial balances match the filters
+
+## Process Flow
+
+```mermaid
+flowchart TD
+    A[Receive input with companyId] --> B[Build query scoped to companyId]
+    B --> C{Period filter provided?}
+    C -->|Yes| D[Apply accounting period filter]
+    C -->|No| E{Fiscal year filter provided?}
+    D --> F{Variant filter provided?}
+    E -->|Yes| G[Apply fiscal year filter via period lookup]
+    E -->|No| F
+    G --> F
+    F -->|Yes| H[Apply variant filter]
+    F -->|No| I[Sort by generatedAt descending]
+    H --> I
+    I --> J[Return trial balance list]
+```
+
+## External Dependencies
+
+- None
+
+## Error Scenarios
+
+- **EMPTY_RESULT**: No trial balances match the given criteria — returns empty list
+
+## Test Cases
+
+- returns all trial balances for a company
+- returns trial balances filtered by accounting period
+- returns trial balances filtered by variant
+- returns trial balances filtered by fiscal year via subquery
+- returns empty list when no trial balances match

package/src/modules/finance-ledger/generated/enums.ts

@@ -0,0 +1,109 @@
+/**
+ * Period type
+ */
+export const AccountingPeriodPeriodType = {
+  "OPERATING": "OPERATING",
+  "ADJUSTMENT": "ADJUSTMENT"
+} as const;
+export type AccountingPeriodPeriodType = (typeof AccountingPeriodPeriodType)[keyof typeof AccountingPeriodPeriodType];
+
+/**
+ * Accounting period lifecycle status
+ */
+export const AccountingPeriodStatus = {
+  "NEVER_OPENED": "NEVER_OPENED",
+  "FUTURE_ENTERABLE": "FUTURE_ENTERABLE",
+  "OPEN": "OPEN",
+  "CLOSED": "CLOSED",
+  "PERMANENTLY_CLOSED": "PERMANENTLY_CLOSED"
+} as const;
+export type AccountingPeriodStatus = (typeof AccountingPeriodStatus)[keyof typeof AccountingPeriodStatus];
+
+/**
+ * Type of financial statement
+ */
+export const FinancialStatementStatementType = {
+  "BALANCE_SHEET": "BALANCE_SHEET",
+  "PROFIT_AND_LOSS": "PROFIT_AND_LOSS",
+  "CASH_FLOW": "CASH_FLOW"
+} as const;
+export type FinancialStatementStatementType = (typeof FinancialStatementStatementType)[keyof typeof FinancialStatementStatementType];
+
+/**
+ * Financial statement lifecycle status
+ */
+export const FinancialStatementStatus = {
+  "DRAFT": "DRAFT",
+  "FINALIZED": "FINALIZED"
+} as const;
+export type FinancialStatementStatus = (typeof FinancialStatementStatus)[keyof typeof FinancialStatementStatus];
+
+/**
+ * Line type: DETAIL, SUBTOTAL, or TOTAL
+ */
+export const FinancialStatementLineItemLineType = {
+  "DETAIL": "DETAIL",
+  "SUBTOTAL": "SUBTOTAL",
+  "TOTAL": "TOTAL"
+} as const;
+export type FinancialStatementLineItemLineType = (typeof FinancialStatementLineItemLineType)[keyof typeof FinancialStatementLineItemLineType];
+
+/**
+ * Journal type categorizing the business origin (SALES, PURCHASE, CASH, BANK, MISCELLANEOUS, OPENING, CLOSING, INVENTORY, MANUFACTURING)
+ */
+export const JournalEntryJournalType = {
+  "SALES": "SALES",
+  "PURCHASE": "PURCHASE",
+  "CASH": "CASH",
+  "BANK": "BANK",
+  "MISCELLANEOUS": "MISCELLANEOUS",
+  "OPENING": "OPENING",
+  "CLOSING": "CLOSING",
+  "INVENTORY": "INVENTORY",
+  "MANUFACTURING": "MANUFACTURING"
+} as const;
+export type JournalEntryJournalType = (typeof JournalEntryJournalType)[keyof typeof JournalEntryJournalType];
+
+/**
+ * Journal entry lifecycle status (DRAFT, POSTED, REVERSED)
+ */
+export const JournalEntryStatus = {
+  "DRAFT": "DRAFT",
+  "POSTED": "POSTED",
+  "REVERSED": "REVERSED"
+} as const;
+export type JournalEntryStatus = (typeof JournalEntryStatus)[keyof typeof JournalEntryStatus];
+
+/**
+ * Optional adjusting entry type for period-end adjustments (ACCRUAL, DEFERRAL, RECLASSIFICATION)
+ */
+export const JournalEntryAdjustingEntryType = {
+  "ACCRUAL": "ACCRUAL",
+  "DEFERRAL": "DEFERRAL",
+  "RECLASSIFICATION": "RECLASSIFICATION"
+} as const;
+export type JournalEntryAdjustingEntryType = (typeof JournalEntryAdjustingEntryType)[keyof typeof JournalEntryAdjustingEntryType];
+
+/**
+ * Period close lifecycle status
+ */
+export const PeriodCloseStatus = {
+  "NOT_STARTED": "NOT_STARTED",
+  "IN_PROGRESS": "IN_PROGRESS",
+  "SUBLEDGERS_VERIFIED": "SUBLEDGERS_VERIFIED",
+  "ADJUSTMENTS_POSTED": "ADJUSTMENTS_POSTED",
+  "TRIAL_BALANCE_VERIFIED": "TRIAL_BALANCE_VERIFIED",
+  "UNDER_REVIEW": "UNDER_REVIEW",
+  "SOFT_LOCKED": "SOFT_LOCKED",
+  "PERMANENTLY_CLOSED": "PERMANENTLY_CLOSED"
+} as const;
+export type PeriodCloseStatus = (typeof PeriodCloseStatus)[keyof typeof PeriodCloseStatus];
+
+/**
+ * Trial balance variant (PRE_CLOSE or POST_CLOSE)
+ */
+export const TrialBalanceVariant = {
+  "PRE_CLOSE": "PRE_CLOSE",
+  "POST_CLOSE": "POST_CLOSE"
+} as const;
+export type TrialBalanceVariant = (typeof TrialBalanceVariant)[keyof typeof TrialBalanceVariant];

package/src/modules/finance-ledger/generated/kysely-tailordb.ts

@@ -0,0 +1,202 @@
+import {
+  createGetDB,
+  type Generated,
+  type Timestamp,
+  type NamespaceDB,
+  type NamespaceInsertable,
+  type NamespaceSelectable,
+  type NamespaceTable,
+  type NamespaceTableName,
+  type NamespaceTransaction,
+  type NamespaceUpdateable,
+} from "@tailor-platform/sdk/kysely";
+
+export interface Namespace {
+  "main-db": {
+    AccountingPeriod: {
+      id: Generated<string>;
+      companyId: string;
+      fiscalYearId: string;
+      name: string;
+      startDate: Timestamp;
+      endDate: Timestamp;
+      periodType: "OPERATING" | "ADJUSTMENT";
+      status: "NEVER_OPENED" | "FUTURE_ENTERABLE" | "OPEN" | "CLOSED" | "PERMANENTLY_CLOSED";
+      createdAt: Generated<Timestamp>;
+      updatedAt: Timestamp | null;
+    }
+
+    FinancialStatement: {
+      id: Generated<string>;
+      companyId: string;
+      chartOfAccountsId: string;
+      trialBalanceId: string;
+      comparativePeriodTrialBalanceId: string | null;
+      statementType: "BALANCE_SHEET" | "PROFIT_AND_LOSS" | "CASH_FLOW";
+      status: "DRAFT" | "FINALIZED";
+      reportingDate: Timestamp | null;
+      startDate: Timestamp | null;
+      endDate: Timestamp | null;
+      cashFlowMethod: string | null;
+      generatedAt: Timestamp;
+      finalizedAt: Timestamp | null;
+      createdAt: Generated<Timestamp>;
+      updatedAt: Timestamp | null;
+    }
+
+    FinancialStatementLineItem: {
+      id: Generated<string>;
+      financialStatementId: string;
+      accountId: string | null;
+      accountGroupId: string | null;
+      label: string;
+      amount: number;
+      comparativeAmount: number | null;
+      lineType: "DETAIL" | "SUBTOTAL" | "TOTAL";
+      sectionType: string;
+      sortOrder: number;
+      createdAt: Generated<Timestamp>;
+      updatedAt: Timestamp | null;
+    }
+
+    FiscalYear: {
+      id: Generated<string>;
+      companyId: string;
+      name: string;
+      startDate: Timestamp;
+      endDate: Timestamp;
+      yearEndCloseExecuted: boolean;
+      createdAt: Generated<Timestamp>;
+      updatedAt: Timestamp | null;
+    }
+
+    JournalEntry: {
+      id: Generated<string>;
+      companyId: string;
+      accountingPeriodId: string;
+      entryDate: Timestamp;
+      journalType: "SALES" | "PURCHASE" | "CASH" | "BANK" | "MISCELLANEOUS" | "OPENING" | "CLOSING" | "INVENTORY" | "MANUFACTURING";
+      referenceNumber: string;
+      status: "DRAFT" | "POSTED" | "REVERSED";
+      description: string | null;
+      sourceDocumentReference: string | null;
+      adjustingEntryType: "ACCRUAL" | "DEFERRAL" | "RECLASSIFICATION" | null;
+      reversalOfId: string | null;
+      postedAt: Timestamp | null;
+      createdAt: Generated<Timestamp>;
+      updatedAt: Timestamp | null;
+    }
+
+    JournalLine: {
+      id: Generated<string>;
+      journalEntryId: string;
+      accountId: string;
+      debitAmount: number | null;
+      creditAmount: number | null;
+      description: string | null;
+      currencyCode: string | null;
+      exchangeRate: number | null;
+      functionalDebitAmount: number | null;
+      functionalCreditAmount: number | null;
+      createdAt: Generated<Timestamp>;
+      updatedAt: Timestamp | null;
+    }
+
+    PeriodClose: {
+      id: Generated<string>;
+      accountingPeriodId: string;
+      status: "NOT_STARTED" | "IN_PROGRESS" | "SUBLEDGERS_VERIFIED" | "ADJUSTMENTS_POSTED" | "TRIAL_BALANCE_VERIFIED" | "UNDER_REVIEW" | "SOFT_LOCKED" | "PERMANENTLY_CLOSED";
+      initiatedByUserId: string;
+      completionPercentage: number;
+      subledgerVerificationDetails: string | null;
+      trialBalanceId: string | null;
+      preliminaryStatementIds: string | null;
+      approvedByUserId: string | null;
+      finalizedByUserId: string | null;
+      yearEndCloseExecuted: boolean;
+      createdAt: Generated<Timestamp>;
+      updatedAt: Timestamp | null;
+    }
+
+    TrialBalance: {
+      id: Generated<string>;
+      companyId: string;
+      accountingPeriodId: string;
+      chartOfAccountsId: string;
+      variant: "PRE_CLOSE" | "POST_CLOSE";
+      generatedAt: Timestamp;
+      totalDebits: number;
+      totalCredits: number;
+      isBalanced: boolean;
+      createdAt: Generated<Timestamp>;
+      updatedAt: Timestamp | null;
+    }
+
+    TrialBalanceLine: {
+      id: Generated<string>;
+      trialBalanceId: string;
+      accountId: string;
+      accountGroupId: string | null;
+      accountCode: string;
+      accountName: string;
+      openingBalance: number;
+      periodDebits: number;
+      periodCredits: number;
+      closingBalance: number;
+      sortOrder: number;
+      createdAt: Generated<Timestamp>;
+      updatedAt: Timestamp | null;
+    }
+
+    Account: {
+      id: Generated<string>;
+      code: string | null;
+      name: string | null;
+      classification: string | null;
+      status: string | null;
+      successorAccountId: string | null;
+    }
+
+    AccountGroup: {
+      id: Generated<string>;
+      name: string | null;
+      code: string | null;
+    }
+
+    ChartOfAccounts: {
+      id: Generated<string>;
+      companyId: string | null;
+      status: string | null;
+    }
+
+    Company: {
+      id: Generated<string>;
+      status: string | null;
+    }
+
+    Currency: {
+      id: Generated<string>;
+      code: string | null;
+      isActive: boolean | null;
+    }
+
+    User: {
+      id: Generated<string>;
+      status: string | null;
+    }
+  }
+}
+
+export const getDB = createGetDB<Namespace>();
+
+export type DB<N extends keyof Namespace = keyof Namespace> = NamespaceDB<Namespace, N>;
+
+export type Transaction<K extends keyof Namespace | DB = keyof Namespace> =
+  NamespaceTransaction<Namespace, K>;
+
+type TableName = NamespaceTableName<Namespace>;
+export type Table<T extends TableName> = NamespaceTable<Namespace, T>;
+
+export type Insertable<T extends TableName> = NamespaceInsertable<Namespace, T>;
+export type Selectable<T extends TableName> = NamespaceSelectable<Namespace, T>;
+export type Updateable<T extends TableName> = NamespaceUpdateable<Namespace, T>;

package/src/modules/finance-ledger/index.ts

@@ -0,0 +1,2 @@
+export { defineModule } from "./module";
+export { permissions, own, all } from "./lib/permissions.generated";

package/src/modules/finance-ledger/lib/_db_deps.ts

@@ -0,0 +1,56 @@
+// Stub types for cross-module dependencies — used only for codegen.
+// At runtime, actual types are injected via defineModule() params.
+import {
+  db,
+  unsafeAllowAllGqlPermission,
+  unsafeAllowAllTypePermission,
+} from "@tailor-platform/sdk";
+
+export const company = db
+  .type("Company", {
+    status: db.string({ optional: true }),
+  })
+  .permission(unsafeAllowAllTypePermission)
+  .gqlPermission(unsafeAllowAllGqlPermission);
+
+export const account = db
+  .type("Account", {
+    code: db.string({ optional: true }),
+    name: db.string({ optional: true }),
+    classification: db.string({ optional: true }),
+    status: db.string({ optional: true }),
+    successorAccountId: db.uuid({ optional: true }),
+  })
+  .permission(unsafeAllowAllTypePermission)
+  .gqlPermission(unsafeAllowAllGqlPermission);
+
+export const accountGroup = db
+  .type("AccountGroup", {
+    name: db.string({ optional: true }),
+    code: db.string({ optional: true }),
+  })
+  .permission(unsafeAllowAllTypePermission)
+  .gqlPermission(unsafeAllowAllGqlPermission);
+
+export const chartOfAccounts = db
+  .type(["ChartOfAccounts", "ChartsOfAccounts"], {
+    companyId: db.uuid({ optional: true }),
+    status: db.string({ optional: true }),
+  })
+  .permission(unsafeAllowAllTypePermission)
+  .gqlPermission(unsafeAllowAllGqlPermission);
+
+export const currency = db
+  .type("Currency", {
+    code: db.string({ optional: true }),
+    isActive: db.bool({ optional: true }),
+  })
+  .permission(unsafeAllowAllTypePermission)
+  .gqlPermission(unsafeAllowAllGqlPermission);
+
+export const user = db
+  .type("User", {
+    status: db.string({ optional: true }),
+  })
+  .permission(unsafeAllowAllTypePermission)
+  .gqlPermission(unsafeAllowAllGqlPermission);