@yunsoft/yuncms-core 0.1.1 → 0.1.3

package/src/services/items-service.js

@@ -9,6 +9,7 @@ import {
   parseItemsQuery,
 } from '../query.js';
 import { SchemaCache } from '../schema.js';
+import { isSystemManagedField, systemMutationEntries } from '../system-fields.js';
 import { withTransaction } from '../transaction.js';
 import { BaseService } from './base-service.js';
 import { PermissionsService } from './permissions-service.js';
@@ -74,6 +75,10 @@ function createCandidateRecord(schema, id, entries) {
       continue;
     }
     const metadata = parseMetadata(fieldSchema.schema_metadata);
+    if (metadata.defaultPreset === 'now') {
+      candidate[fieldSchema.field] = new Date();
+      continue;
+    }
     candidate[fieldSchema.field] = Object.hasOwn(metadata, 'defaultValue')
       ? metadata.defaultValue
       : null;
@@ -82,6 +87,10 @@ function createCandidateRecord(schema, id, entries) {
   return candidate;
 }
 
+function mergeSystemEntries(entries, schema, accountability, operation, now = new Date()) {
+  return [...entries, ...systemMutationEntries(schema, accountability, operation, now)];
+}
+
 export class ItemsService extends BaseService {
   constructor(collection, options = {}) {
     super(options);
@@ -114,6 +123,12 @@ export class ItemsService extends BaseService {
     if (!collectionSchema) {
       throw serviceError('COLLECTION_NOT_FOUND', `Unknown collection: ${this.collection}`);
     }
+    if (collectionSchema.system) {
+      throw serviceError(
+        'SYSTEM_COLLECTION_USE_DEDICATED_SERVICE',
+        `System collection ${this.collection} must be accessed through its dedicated service`,
+      );
+    }
     return collectionSchema;
   }
 
@@ -150,8 +165,9 @@ export class ItemsService extends BaseService {
       for (const fieldSchema of Object.values(schema.fields)) {
         if (!fieldSchema.required || fieldSchema.field === schema.primary_key) continue;
         if (Object.hasOwn(payload, fieldSchema.field)) continue;
+        if (isSystemManagedField(fieldSchema)) continue;
         const metadata = parseMetadata(fieldSchema.schema_metadata);
-        if (Object.hasOwn(metadata, 'defaultValue')) continue;
+        if (Object.hasOwn(metadata, 'defaultValue') || metadata.defaultPreset != null) continue;
         throw serviceError('REQUIRED_FIELD_MISSING', `Required field is missing: ${fieldSchema.field}`, fieldSchema.field);
       }
     }
@@ -230,7 +246,8 @@ export class ItemsService extends BaseService {
     const schema = await this.getCollectionSchema();
     const permission = await this.resolvePermission('create');
     const filteredPayload = await this.filterMutation('items.create', payload, { operation: 'create' });
-    const entries = this.validatePayload(filteredPayload, schema, permission, { creating: true });
+    const callerEntries = this.validatePayload(filteredPayload, schema, permission, { creating: true });
+    const entries = mergeSystemEntries(callerEntries, schema, this.accountability, 'create');
     const id = randomUUID();
     const candidate = createCandidateRecord(schema, id, entries);
     enforcePermissionValidation(candidate, permission.validation, schema);
@@ -264,7 +281,8 @@ export class ItemsService extends BaseService {
         operation: 'create',
         bulk: true,
       });
-      const entries = this.validatePayload(filteredPayload, schema, permission, { creating: true });
+      const callerEntries = this.validatePayload(filteredPayload, schema, permission, { creating: true });
+      const entries = mergeSystemEntries(callerEntries, schema, this.accountability, 'create');
       const id = randomUUID();
       const candidate = createCandidateRecord(schema, id, entries);
       enforcePermissionValidation(candidate, permission.validation, schema);
@@ -306,8 +324,10 @@ export class ItemsService extends BaseService {
       operation: 'update',
       key: id,
     });
-    const entries = this.validatePayload(filteredPayload, schema, permission);
-    if (entries.length === 0) throw serviceError('INVALID_PAYLOAD', 'Update payload cannot be empty');
+    const callerEntries = this.validatePayload(filteredPayload, schema, permission);
+    if (callerEntries.length === 0) throw serviceError('INVALID_PAYLOAD', 'Update payload cannot be empty');
+    const entries = mergeSystemEntries(callerEntries, schema, this.accountability, 'update');
+    const effectiveChanges = Object.fromEntries(entries);
 
     const table = quoteIdentifier(this.collection, 'collection name');
     const filter = combineCompiledFilters(
@@ -322,7 +342,7 @@ export class ItemsService extends BaseService {
       );
       const current = currentRows[0];
       if (!current) return null;
-      enforcePermissionValidation({ ...current, ...filteredPayload }, permission.validation, schema);
+      enforcePermissionValidation({ ...current, ...effectiveChanges }, permission.validation, schema);
     }
 
     const setSql = entries.map(([field]) => `${quoteIdentifier(field, 'field name')} = ?`).join(', ');
@@ -336,7 +356,7 @@ export class ItemsService extends BaseService {
     await this.actionMutation('items.update', {
       key: id,
       item: record,
-      changes: filteredPayload,
+      changes: effectiveChanges,
     }, { operation: 'update' });
     return record;
   }
@@ -354,8 +374,10 @@ export class ItemsService extends BaseService {
       bulk: true,
       filter: filterInput,
     });
-    const entries = this.validatePayload(filteredPayload, schema, permission);
-    if (entries.length === 0) throw serviceError('INVALID_PAYLOAD', 'Update payload cannot be empty');
+    const callerEntries = this.validatePayload(filteredPayload, schema, permission);
+    if (callerEntries.length === 0) throw serviceError('INVALID_PAYLOAD', 'Update payload cannot be empty');
+    const entries = mergeSystemEntries(callerEntries, schema, this.accountability, 'update');
+    const effectiveChanges = Object.fromEntries(entries);
     const filter = this.compileActionFilters(filterInput, permission.filter, accessSchema, schema);
     const table = quoteIdentifier(this.collection, 'collection name');
 
@@ -371,7 +393,7 @@ export class ItemsService extends BaseService {
         );
       }
       for (const row of rows) {
-        enforcePermissionValidation({ ...row, ...filteredPayload }, permission.validation, schema);
+        enforcePermissionValidation({ ...row, ...effectiveChanges }, permission.validation, schema);
       }
     }
 
@@ -382,7 +404,7 @@ export class ItemsService extends BaseService {
     );
     await this.actionMutation('items.update', {
       filter: filterInput,
-      changes: filteredPayload,
+      changes: effectiveChanges,
       affected: result.affectedRows,
     }, { operation: 'update', bulk: true });
     return result.affectedRows;
@@ -442,4 +464,4 @@ export class ItemsService extends BaseService {
   }
 }
 
-export { MAX_BULK_VALIDATION_ROWS, createCandidateRecord };
+export { MAX_BULK_VALIDATION_ROWS, createCandidateRecord };

package/src/services/permissions-service.js

@@ -3,6 +3,11 @@ import { randomUUID } from 'node:crypto';
 import { assertPermissionValidationRule } from '../permission-validation.js';
 import { compileFilter } from '../query.js';
 import { SchemaCache } from '../schema.js';
+import {
+  assertActionOnlyPermissionPayload,
+  assertSystemResourceAction,
+  isPermissionManagedSystemResource,
+} from '../system-permissions.js';
 import { BaseService } from './base-service.js';
 
 const ACTIONS = new Set(['create', 'read', 'update', 'delete']);
@@ -81,6 +86,17 @@ export class PermissionsService extends BaseService {
     this.schemaCache = options.schemaCache ?? defaultSchemaCache;
   }
 
+  async #collectionSchema(collection) {
+    const snapshot = this.schema ?? await this.schemaCache.get(this.database);
+    const collectionSchema = snapshot.collections?.[collection];
+    if (!collectionSchema) {
+      const error = new Error(`Unknown permission collection: ${collection}`);
+      error.code = 'COLLECTION_NOT_FOUND';
+      throw error;
+    }
+    return collectionSchema;
+  }
+
   async resolve(action, collection) {
     assertAction(action);
     const key = cacheKey(this.accountability, action, collection);
@@ -102,6 +118,19 @@ export class PermissionsService extends BaseService {
         throw forbidden(`No role is available for ${action} access to ${collection}`);
       }
 
+      const collectionSchema = await this.#collectionSchema(collection);
+      if (collectionSchema.system) {
+        if (!isPermissionManagedSystemResource(collectionSchema)) {
+          throw forbidden(`System resource is not delegatable: ${collection}`);
+        }
+        try {
+          assertSystemResourceAction(collectionSchema, action);
+        } catch (error) {
+          if (error.code === 'SYSTEM_PERMISSION_ACTION_PROTECTED') throw forbidden(error.message);
+          throw error;
+        }
+      }
+
       const [rows] = await this.database.query(
         `SELECT id, role, collection, action, fields, filter, validation
          FROM yuncms_permissions
@@ -154,17 +183,6 @@ export class PermissionsService extends BaseService {
     return normalizePermissionRow(rows[0]);
   }
 
-  async #collectionSchema(collection) {
-    const snapshot = this.schema ?? await this.schemaCache.get(this.database);
-    const collectionSchema = snapshot.collections?.[collection];
-    if (!collectionSchema) {
-      const error = new Error(`Unknown permission collection: ${collection}`);
-      error.code = 'COLLECTION_NOT_FOUND';
-      throw error;
-    }
-    return collectionSchema;
-  }
-
   async createOne(input = {}) {
     assertPermissionManager(this.accountability);
     const action = assertAction(input.action);
@@ -180,6 +198,16 @@ export class PermissionsService extends BaseService {
     }
 
     const collectionSchema = await this.#collectionSchema(input.collection);
+    if (collectionSchema.system) {
+      if (!isPermissionManagedSystemResource(collectionSchema)) {
+        const error = new Error(`System resource permissions are protected: ${input.collection}`);
+        error.code = 'SYSTEM_PERMISSION_RESOURCE_PROTECTED';
+        throw error;
+      }
+      assertSystemResourceAction(collectionSchema, action);
+      assertActionOnlyPermissionPayload(collectionSchema, input);
+    }
+
     const fields = normalizePermissionFields(input.fields ?? null, collectionSchema);
     const filter = input.filter ?? null;
     const validation = input.validation ?? null;
@@ -187,14 +215,20 @@ export class PermissionsService extends BaseService {
     assertPermissionValidationRule(validation, collectionSchema);
 
     const [roleRows] = await this.database.query(
-      'SELECT id FROM yuncms_roles WHERE id = ? LIMIT 1',
+      'SELECT id, admin, public FROM yuncms_roles WHERE id = ? LIMIT 1',
       [input.role],
     );
-    if (!roleRows[0]) {
+    const role = roleRows[0];
+    if (!role) {
       const error = new Error(`Unknown permission role: ${input.role}`);
       error.code = 'ROLE_NOT_FOUND';
       throw error;
     }
+    if (collectionSchema.system && role.public) {
+      const error = new Error('Public role cannot be granted access to protected system resources');
+      error.code = 'PUBLIC_SYSTEM_ACCESS_FORBIDDEN';
+      throw error;
+    }
 
     const id = randomUUID();
     await this.database.query(
@@ -235,6 +269,7 @@ export class PermissionsService extends BaseService {
       throw error;
     }
     const collectionSchema = await this.#collectionSchema(existing.collection);
+    if (collectionSchema.system) assertActionOnlyPermissionPayload(collectionSchema, patch);
 
     const assignments = [];
     const params = [];

package/src/services/roles-service.js

@@ -1,6 +1,7 @@
 import { randomUUID } from 'node:crypto';
 
 import { BaseService } from './base-service.js';
+import { resolveSystemResourceAccess } from './system-resource-access.js';
 
 function assertRoleManager(accountability) {
   if (accountability.admin === true || accountability.system === true) return;
@@ -26,7 +27,7 @@ function normalizeRoleName(name) {
 
 export class RolesService extends BaseService {
   async readMany() {
-    assertRoleManager(this.accountability);
+    await resolveSystemResourceAccess(this, 'read', 'yuncms_roles');
     const [rows] = await this.database.query(
       `SELECT id, name, description, admin, public, created_at, updated_at
        FROM yuncms_roles
@@ -36,7 +37,7 @@ export class RolesService extends BaseService {
   }
 
   async readOne(id) {
-    assertRoleManager(this.accountability);
+    await resolveSystemResourceAccess(this, 'read', 'yuncms_roles');
     const [rows] = await this.database.query(
       `SELECT id, name, description, admin, public, created_at, updated_at
        FROM yuncms_roles
@@ -157,4 +158,4 @@ export class RolesService extends BaseService {
     }
     return true;
   }
-}
+}

package/src/services/sessions-service.js

@@ -20,6 +20,7 @@ function identityFromRow(row) {
   return {
     user: row.user,
     role: row.role ?? null,
+    role_name: row.role_name ?? null,
     admin: Boolean(row.role_admin),
     email: row.email,
     session: row.session_id,
@@ -71,7 +72,7 @@ export class SessionsService extends BaseService {
     const hash = hashToken(token);
     const [rows] = await this.database.query(
       `SELECT s.id AS session_id, s.user, u.email, u.role, u.status,
-              r.admin AS role_admin
+              r.name AS role_name, r.admin AS role_admin
        FROM yuncms_sessions s
        INNER JOIN yuncms_users u ON u.id = s.user
        LEFT JOIN yuncms_roles r ON r.id = u.role
@@ -105,7 +106,7 @@ export class SessionsService extends BaseService {
     const oldHash = hashToken(token);
     const [rows] = await this.database.query(
       `SELECT s.id AS session_id, s.user, u.email, u.role, u.status,
-              r.admin AS role_admin
+              r.name AS role_name, r.admin AS role_admin
        FROM yuncms_sessions s
        INNER JOIN yuncms_users u ON u.id = s.user
        LEFT JOIN yuncms_roles r ON r.id = u.role
@@ -164,7 +165,6 @@ export class SessionsService extends BaseService {
       error.code = 'FORBIDDEN';
       throw error;
     }
-
     const [result] = await this.database.query(
       'DELETE FROM yuncms_sessions WHERE user = ?',
       [userId],

package/src/services/studio-settings-service.js

@@ -3,6 +3,11 @@ import { BaseService } from './base-service.js';
 const THEMES = new Set(['system', 'light', 'dark']);
 const LOCALES = new Set(['en', 'tr']);
 const ACCENT_PATTERN = /^#[0-9a-f]{6}$/i;
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const YUNSOFT_LOGOS = new Set([
+  'https://yunsoft.com/light-logo.png',
+  'https://yunsoft.com/dark-logo.png',
+]);
 
 function invalid(message) {
   const error = new Error(message);
@@ -10,6 +15,12 @@ function invalid(message) {
   return error;
 }
 
+function notFound(message) {
+  const error = new Error(message);
+  error.code = 'NOT_FOUND';
+  return error;
+}
+
 function assertManager(accountability) {
   if (accountability.admin === true || accountability.system === true) return;
   const error = new Error('Studio settings require administrator accountability');
@@ -25,16 +36,17 @@ function normalizeBrandName(value) {
 }
 
 function normalizeLogoUrl(value) {
-  if (typeof value !== 'string' || !value.trim()) throw invalid('Logo URL is required');
-  const normalized = value.trim();
-  if (normalized.length > 512) throw invalid('Logo URL cannot exceed 512 characters');
-  let url;
-  try {
-    url = new URL(normalized);
-  } catch {
-    throw invalid('Logo URL must be a valid URL');
+  const normalized = String(value ?? '').trim();
+  if (!YUNSOFT_LOGOS.has(normalized)) {
+    throw invalid('External logo URLs are not supported; choose an image from Files');
   }
-  if (!['http:', 'https:'].includes(url.protocol)) throw invalid('Logo URL must use HTTP or HTTPS');
+  return normalized;
+}
+
+function normalizeImageFile(value, label) {
+  if (value == null || value === '') return null;
+  const normalized = String(value).trim();
+  if (!UUID_PATTERN.test(normalized)) throw invalid(`${label} file id must be a UUID`);
   return normalized;
 }
 
@@ -60,6 +72,8 @@ function publicSettings(row) {
   return {
     brand_name: row.brand_name,
     logo_url: row.logo_url,
+    logo_file: row.logo_file ?? null,
+    favicon_file: row.favicon_file ?? null,
     accent_color: row.accent_color,
     theme: row.theme,
     default_locale: row.default_locale,
@@ -70,7 +84,7 @@ function publicSettings(row) {
 export class StudioSettingsService extends BaseService {
   async readPublic() {
     const [rows] = await this.database.query(
-      `SELECT brand_name, logo_url, accent_color, theme, default_locale, updated_at
+      `SELECT brand_name, logo_url, logo_file, favicon_file, accent_color, theme, default_locale, updated_at
        FROM yuncms_studio_settings
        WHERE id = 1
        LIMIT 1`,
@@ -89,12 +103,56 @@ export class StudioSettingsService extends BaseService {
     return this.readPublic();
   }
 
+  async readImageAssetContent(settingKey, label) {
+    const settings = await this.readPublic();
+    const fileId = settings[settingKey];
+    if (!fileId) throw notFound(`No file-backed Studio ${label.toLowerCase()} is configured`);
+    if (!this.storage) throw new Error(`StudioSettingsService requires storage to read a file-backed ${label.toLowerCase()}`);
+
+    const [rows] = await this.database.query(
+      `SELECT id, storage, filename_disk, mimetype, filesize
+       FROM yuncms_files
+       WHERE id = ?
+       LIMIT 1`,
+      [fileId],
+    );
+    const file = rows[0];
+    if (!file) throw notFound(`Configured Studio ${label.toLowerCase()} file does not exist`);
+    if (!String(file.mimetype || '').toLowerCase().startsWith('image/')) {
+      throw invalid(`Configured Studio ${label.toLowerCase()} must be an image`);
+    }
+
+    const driver = this.storage.get(file.storage);
+    const contents = await driver.get(file.filename_disk);
+    return { file, contents };
+  }
+
+  async readLogoContent() {
+    return this.readImageAssetContent('logo_file', 'Logo');
+  }
+
+  async readFaviconContent() {
+    return this.readImageAssetContent('favicon_file', 'Favicon');
+  }
+
+  async validateSelectedImage(fileId, label) {
+    if (!fileId) return;
+    const [files] = await this.database.query(
+      'SELECT id, mimetype FROM yuncms_files WHERE id = ? LIMIT 1',
+      [fileId],
+    );
+    if (!files[0]) throw invalid(`Selected ${label.toLowerCase()} file does not exist`);
+    if (!String(files[0].mimetype || '').toLowerCase().startsWith('image/')) {
+      throw invalid(`Selected ${label.toLowerCase()} file must be an image`);
+    }
+  }
+
   async updateOne(patch = {}) {
     assertManager(this.accountability);
     if (!patch || typeof patch !== 'object' || Array.isArray(patch)) throw invalid('Studio settings patch must be an object');
 
     const keys = Object.keys(patch);
-    const allowed = new Set(['brand_name', 'logo_url', 'accent_color', 'theme', 'default_locale']);
+    const allowed = new Set(['brand_name', 'logo_url', 'logo_file', 'favicon_file', 'accent_color', 'theme', 'default_locale']);
     if (keys.length === 0 || keys.some((key) => !allowed.has(key))) {
       throw invalid('Studio settings patch contains unsupported properties');
     }
@@ -109,6 +167,18 @@ export class StudioSettingsService extends BaseService {
       assignments.push('logo_url = ?');
       params.push(normalizeLogoUrl(patch.logo_url));
     }
+    if (Object.hasOwn(patch, 'logo_file')) {
+      const fileId = normalizeImageFile(patch.logo_file, 'Logo');
+      await this.validateSelectedImage(fileId, 'Logo');
+      assignments.push('logo_file = ?');
+      params.push(fileId);
+    }
+    if (Object.hasOwn(patch, 'favicon_file')) {
+      const fileId = normalizeImageFile(patch.favicon_file, 'Favicon');
+      await this.validateSelectedImage(fileId, 'Favicon');
+      assignments.push('favicon_file = ?');
+      params.push(fileId);
+    }
     if (Object.hasOwn(patch, 'accent_color')) {
       assignments.push('accent_color = ?');
       params.push(normalizeAccent(patch.accent_color));
@@ -134,6 +204,8 @@ export class StudioSettingsService extends BaseService {
 export const STUDIO_SETTING_DEFAULTS = Object.freeze({
   brand_name: 'YunCMS',
   logo_url: 'https://yunsoft.com/light-logo.png',
+  logo_file: null,
+  favicon_file: null,
   accent_color: '#2563eb',
   theme: 'system',
   default_locale: 'en',

package/src/services/system-collection-fields-service.js

@@ -0,0 +1,122 @@
+import { withAdvisoryLock } from '../advisory-lock.js';
+import { compileFieldColumn } from '../field-types.js';
+import { assertIdentifier, quoteIdentifier } from '../identifier.js';
+import { SchemaMetadataRepository } from '../schema-metadata-repository.js';
+import { resolveSchemaName } from '../schema-key.js';
+import { incrementSchemaVersion } from '../schema-version.js';
+import { isPermissionManagedSystemResource } from '../system-permissions.js';
+import { withConnectionTransaction } from '../transaction.js';
+import { BaseService } from './base-service.js';
+import { assertSchemaManager } from './schema-access.js';
+
+function fieldName(value) {
+  assertIdentifier(value, 'field name');
+  if (value.length > 64) {
+    const error = new Error('Field name cannot exceed 64 characters');
+    error.code = 'INVALID_SCHEMA_PAYLOAD';
+    throw error;
+  }
+  if (value === 'id') {
+    const error = new Error('The id field cannot be replaced');
+    error.code = 'FIELD_EXISTS';
+    throw error;
+  }
+  return value;
+}
+
+function assertExtensibleSystemCollection(collection) {
+  if (!collection?.system || !isPermissionManagedSystemResource(collection)) {
+    const error = new Error(`System collection is not extensible: ${collection?.collection || 'unknown'}`);
+    error.code = 'SYSTEM_SCHEMA_READ_ONLY';
+    throw error;
+  }
+}
+
+function assertSystemExtensionInput(input = {}) {
+  if (input.required === true) {
+    const error = new Error('Custom system collection fields must be optional in V1');
+    error.code = 'SYSTEM_EXTENSION_REQUIRED_UNSUPPORTED';
+    throw error;
+  }
+}
+
+export class SystemCollectionFieldsService extends BaseService {
+  async createOne(collectionName, input = {}) {
+    assertSchemaManager(this.accountability);
+    assertIdentifier(collectionName, 'collection name');
+    assertSystemExtensionInput(input);
+    const resolvedName = resolveSchemaName({
+      displayName: input.name ?? input.field,
+      key: input.field,
+      prefix: 'field',
+    });
+    const field = fieldName(resolvedName.key);
+    const name = resolvedName.name;
+    const compiled = compileFieldColumn({ ...input, required: false });
+
+    return withAdvisoryLock(this.database, 'yuncms:schema', async (connection) => {
+      const metadata = new SchemaMetadataRepository(connection);
+      const collection = await metadata.readCollection(collectionName);
+      if (!collection) {
+        const error = new Error(`Unknown collection: ${collectionName}`);
+        error.code = 'COLLECTION_NOT_FOUND';
+        throw error;
+      }
+      assertExtensibleSystemCollection(collection);
+
+      const existing = await metadata.readField(collectionName, field);
+      if (existing) {
+        const error = new Error(`Field already exists: ${collectionName}.${field}`);
+        error.code = 'FIELD_EXISTS';
+        throw error;
+      }
+
+      const table = quoteIdentifier(collectionName, 'collection name');
+      const column = quoteIdentifier(field, 'field name');
+      let physicalCreated = false;
+
+      try {
+        await connection.query(`ALTER TABLE ${table} ADD COLUMN ${column} ${compiled.sql}`, compiled.params);
+        physicalCreated = true;
+
+        return await withConnectionTransaction(connection, async () => {
+          const created = await metadata.createField({
+            collection: collectionName,
+            field,
+            name,
+            type: input.type,
+            required: false,
+            readonly: input.readonly === true,
+            hidden: input.hidden === true,
+            sort: input.sort ?? null,
+            interface: input.interface ?? null,
+            options: input.options ?? null,
+            schemaMetadata: {
+              ...compiled.schemaMetadata,
+              systemExtension: true,
+            },
+          });
+          const schemaVersion = await incrementSchemaVersion(connection);
+          return { ...created, schemaVersion };
+        });
+      } catch (error) {
+        try {
+          await metadata.deleteField(collectionName, field);
+        } catch (cleanupError) {
+          error.cleanupMetadataError = cleanupError;
+        }
+        if (physicalCreated) {
+          try {
+            await connection.query(`ALTER TABLE ${table} DROP COLUMN ${column}`);
+          } catch (cleanupError) {
+            error.cleanupPhysicalError = cleanupError;
+            error.code ||= 'SCHEMA_PARTIAL_FAILURE';
+          }
+        }
+        throw error;
+      }
+    });
+  }
+}
+
+export { assertExtensibleSystemCollection, assertSystemExtensionInput };

package/src/services/system-resource-access.js

@@ -0,0 +1,23 @@
+import { PermissionsService } from './permissions-service.js';
+
+export async function resolveSystemResourceAccess(service, action, collection) {
+  if (service.accountability.admin === true || service.accountability.system === true) {
+    return {
+      fullAccess: true,
+      action,
+      collection,
+      role: service.accountability.role ?? null,
+    };
+  }
+
+  const permissions = new PermissionsService({
+    accountability: service.accountability,
+    database: service.database,
+    schema: service.schema,
+    emitter: service.emitter,
+    logger: service.logger,
+    permissionCache: service.permissionCache,
+    requestId: service.requestId,
+  });
+  return permissions.resolve(action, collection);
+}