@wildo-ai/saas-models 1.0.1

package/dist/esm/testing/resource-config-builders.js

@@ -0,0 +1,240 @@
+import { EmailVerificationMode, RegistrationMode, } from '../config/entity-identity-config.shared.schemas.js';
+import { HttpMethod } from '../requests/http-requests.shared.js';
+import { AuthMethod } from '../security/authentications/authentication.shared.schemas.js';
+import { CoreResourceOperation, } from '../resources/resources.shared.core.definitions.js';
+import { ResourceOperationRiskLevel, ResourceOperationVariantType, ResourceParentResourceRequirement, ResourcePrimaryScope, ResourceRelationshipAccessScopeStrategy, ResourceRelationshipCardinality, ResourceTranspositionPolicy, } from '../resources/resources.shared.schemas.js';
+import { Resources_SharedUtils } from '../resources/resources.shared.utils.js';
+export function makeUserTypeAuth(overrides) {
+    return {
+        authMethodsEnabled: { [AuthMethod.PASSWORD]: true, [AuthMethod.MAGIC_LINK]: true },
+        mfaPolicy: {
+            requireMFA: false,
+            requireStrongMFA: false,
+            acceptableMFAMethods: undefined,
+            enrollmentGracePeriodDays: 14,
+            passkeyExemptFromMFA: true,
+        },
+        registration: {
+            mode: RegistrationMode.OPEN,
+            allowedMethods: [AuthMethod.PASSWORD],
+            requirePasswordOnRegister: true,
+            emailVerification: EmailVerificationMode.REQUIRED_BEFORE_ACCESS,
+            blockForSSODomains: false,
+        },
+        passwordPolicy: {
+            minLength: 8,
+            maxLength: 128,
+            requireUppercase: true,
+            requireLowercase: true,
+            requireNumbers: false,
+            requireSpecialChars: false,
+            expiryDays: 0,
+        },
+        sessionDurationMinutes: 30,
+        lockoutPolicy: {
+            maxLoginAttempts: 5,
+            lockoutDurationMinutes: 30,
+            progressiveLockout: false,
+            maxProgressiveLockoutHours: 24,
+        },
+        autoLinkByEmail: true,
+        methodManagement: {
+            allowUserMethodRemoval: true,
+            requireReauthForMethodChanges: false,
+        },
+        ...overrides,
+    };
+}
+/**
+ * Minimal `ResourceConfiguration_Operation` for **saas-models** DTO / resource-config unit tests.
+ *
+ * **Not** the same symbol as `createTestOperation` in `@wildo-ai/saas-backend-lib/testing`
+ * (`feature-test-utils.ts`), which builds operation stubs for **feature-gate** tests.
+ */
+export function createTestOperation(mainSchema, operationIdentifier = CoreResourceOperation.READ) {
+    return {
+        isDisabled: false,
+        mainSchema,
+        resourcePrimaryScope: ResourcePrimaryScope.ORGANIZATIONS,
+        resourceIdentifier: 'TEST_RESOURCE',
+        resourceFieldIdentifier: 'testId',
+        resourceRelationships: {
+            parentRelationships: [],
+            childRelationships: [],
+            selfRelationships: [],
+        },
+        isSystemResource: false,
+        operationIdentifier,
+        isOperationDefault: true,
+        serviceRuntimeMode: 'INLINE',
+        notificationBadgeOperations: [],
+        userNotifications: [],
+        m2mNotifications: [],
+        variantType: ResourceOperationVariantType.API_CALL,
+        resourceOperationLike: undefined,
+        requiredFeatures: undefined,
+        riskLevel: ResourceOperationRiskLevel.LOW,
+        roles: [],
+        customServiceImplementationModes: [],
+        basicPrefixOperation: undefined,
+        httpVerb: HttpMethod.GET,
+        isApiKeyAccessDisabled: false,
+        isBulkOperation: false,
+        consumableToken: undefined,
+        enabledCondition: undefined,
+        isDefault: true,
+        variantKey: undefined,
+    };
+}
+export function createTestResourceConfig(mainSchema, operations) {
+    return {
+        isDisabled: false,
+        resourcePrimaryScope: ResourcePrimaryScope.ORGANIZATIONS,
+        resourceIdentifier: 'TEST_RESOURCE',
+        resourceFieldIdentifier: 'testId',
+        coreOperations: [],
+        customOperation: undefined,
+        mainSchema,
+        resourceRelationships: {
+            parentRelationships: [],
+            childRelationships: [],
+            selfRelationships: [],
+        },
+        inheritenceSchemaDefinition: undefined,
+        isSystemResource: false,
+        /** W7.3a: test fixtures default to non-anonymizable unless overrides replace the full config. */
+        isAnonymizable: false,
+        /** Required by type; only applied when `isAnonymizable` is true (engine default is ADD). */
+        transpositionPolicy: ResourceTranspositionPolicy.ADD,
+        operations,
+    };
+}
+/**
+ * Process relationships for a resource — mirrors the logic in createResourceConfiguration_Initialization.
+ * M:N relationships are transformed into 1:N relationships for the junction table.
+ *
+ * The helper expects compiled runtime relationships, matching the production
+ * factory output from `createResourcesRelationship()` / registry initialization.
+ */
+export function processResourceRelationships(resourceIdentifier, resourceRelationships) {
+    const compileSyntheticRelationship = (relationshipDeclaration) => Resources_SharedUtils.compileRelationshipDeclaration(relationshipDeclaration);
+    const activeRelationships = resourceRelationships.filter((rel) => !rel.isDisabled);
+    const isManyToMany = (rel) => rel.cardinality1 === ResourceRelationshipCardinality.MANY &&
+        rel.cardinality2 === ResourceRelationshipCardinality.MANY &&
+        rel.jointResourceType;
+    const processedResourceRelationships = {
+        parentRelationships: activeRelationships.filter((rel) => rel.resourceType2 === resourceIdentifier &&
+            rel.resourceType1 !== resourceIdentifier &&
+            !isManyToMany(rel)),
+        childRelationships: activeRelationships.filter((rel) => rel.resourceType1 === resourceIdentifier &&
+            rel.resourceType2 !== resourceIdentifier &&
+            !isManyToMany(rel)),
+        selfRelationships: activeRelationships.filter((rel) => rel.resourceType1 === resourceIdentifier &&
+            rel.resourceType2 === resourceIdentifier &&
+            !isManyToMany(rel)),
+    };
+    const manyToManyRelationships = activeRelationships.filter((rel) => rel.cardinality1 === ResourceRelationshipCardinality.MANY &&
+        rel.cardinality2 === ResourceRelationshipCardinality.MANY &&
+        rel.jointResourceType);
+    manyToManyRelationships.forEach((m2mRel) => {
+        Resources_SharedUtils.assertSupportedManyToManySyntheticExpansion(m2mRel);
+        const { resourceType1: entity1Type, resourceType2: entity2Type, jointResourceType } = m2mRel;
+        if (resourceIdentifier === jointResourceType) {
+            const relationFromEntity1 = compileSyntheticRelationship({
+                cardinality1: ResourceRelationshipCardinality.ONE,
+                cardinality2: ResourceRelationshipCardinality.MANY,
+                resourceType1: entity1Type,
+                resourceType2: resourceIdentifier,
+                jointResourceType,
+                nature: m2mRel.resolvedSemantics.nature,
+                parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,
+                accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT,
+                isPrimaryScope: false,
+                isDisabled: m2mRel.isDisabled || false,
+                allowCycle: false,
+                contextPolicy: m2mRel.contextPolicy,
+                childOperations: m2mRel.childOperations,
+                foreignKeyField: m2mRel.foreignKeyField,
+            });
+            processedResourceRelationships.parentRelationships.push(relationFromEntity1);
+            const relationFromEntity2 = compileSyntheticRelationship({
+                cardinality1: ResourceRelationshipCardinality.ONE,
+                cardinality2: ResourceRelationshipCardinality.MANY,
+                resourceType1: entity2Type,
+                resourceType2: resourceIdentifier,
+                jointResourceType,
+                nature: m2mRel.resolvedSemantics.nature,
+                parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,
+                accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT,
+                isPrimaryScope: false,
+                isDisabled: m2mRel.isDisabled || false,
+                allowCycle: false,
+                contextPolicy: m2mRel.contextPolicy,
+                childOperations: m2mRel.childOperations,
+                foreignKeyField: m2mRel.foreignKeyField,
+            });
+            processedResourceRelationships.parentRelationships.push(relationFromEntity2);
+        }
+        else if (resourceIdentifier === entity1Type) {
+            if (!jointResourceType) {
+                throw new Error(`Many-to-many relationship between ${entity1Type} and ${entity2Type} must have a jointResourceType`);
+            }
+            const relationToJoint = compileSyntheticRelationship({
+                cardinality1: ResourceRelationshipCardinality.ONE,
+                cardinality2: ResourceRelationshipCardinality.MANY,
+                resourceType1: resourceIdentifier,
+                resourceType2: jointResourceType,
+                jointResourceType,
+                nature: m2mRel.resolvedSemantics.nature,
+                parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,
+                accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT,
+                isPrimaryScope: false,
+                isDisabled: m2mRel.isDisabled || false,
+                allowCycle: m2mRel.allowCycle || false,
+                contextPolicy: m2mRel.contextPolicy,
+                childOperations: m2mRel.childOperations,
+                foreignKeyField: m2mRel.foreignKeyField,
+                discriminator: m2mRel.discriminator,
+                condition: m2mRel.condition,
+                display: m2mRel.display,
+            });
+            processedResourceRelationships.childRelationships.push(relationToJoint);
+        }
+        else if (resourceIdentifier === entity2Type) {
+            if (!jointResourceType) {
+                throw new Error(`Many-to-many relationship between ${entity1Type} and ${entity2Type} must have a jointResourceType`);
+            }
+            const relationToJoint = compileSyntheticRelationship({
+                cardinality1: ResourceRelationshipCardinality.ONE,
+                cardinality2: ResourceRelationshipCardinality.MANY,
+                resourceType1: resourceIdentifier,
+                resourceType2: jointResourceType,
+                jointResourceType,
+                nature: m2mRel.resolvedSemantics.nature,
+                parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,
+                accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT,
+                isPrimaryScope: false,
+                isDisabled: m2mRel.isDisabled || false,
+                allowCycle: m2mRel.allowCycle || false,
+                contextPolicy: m2mRel.contextPolicy,
+                childOperations: m2mRel.childOperations,
+                foreignKeyField: m2mRel.foreignKeyField,
+                discriminator: m2mRel.discriminator,
+                condition: m2mRel.condition,
+                display: m2mRel.display,
+            });
+            processedResourceRelationships.childRelationships.push(relationToJoint);
+        }
+    });
+    return processedResourceRelationships;
+}
+/**
+ * Conditional relationships — active only for specific discriminator variants.
+ */
+export function getConditionalRelationships(resourceIdentifier, resourceRelationships) {
+    return resourceRelationships.filter((rel) => rel.discriminator?.discriminatorField &&
+        rel.discriminator.values &&
+        rel.discriminator.values.length > 0 &&
+        (rel.resourceType1 === resourceIdentifier || rel.resourceType2 === resourceIdentifier));
+}
+//# sourceMappingURL=resource-config-builders.js.map

package/dist/esm/testing/resource-config-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-config-builders.js","sourceRoot":"","sources":["../../../src/testing/resource-config-builders.ts"],"names":[],"mappings":"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"}

package/dist/esm/testing/schema-decorator-utils.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Schema Decorator Test Utilities
+ *
+ * Singleton utility class with static methods for testing decorated schemas.
+ * Provides assertion helpers for verifying decorator presence and preservation.
+ *
+ * @see Section 23.3.D of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md
+ */
+import { z } from 'zod';
+import { ZodDecorator } from '@wildo-ai/zod-decorators';
+/**
+ * Result of an assertion check
+ */
+export interface AssertionResult {
+    passed: boolean;
+    message: string;
+}
+/**
+ * Singleton utility class for testing decorated schemas.
+ * All methods are static - no instantiation needed.
+ */
+export declare class SchemaDecoratorTestUtils {
+    /**
+     * Assert that a field has a specific decorator.
+     *
+     * @param schema - The schema containing the field
+     * @param fieldName - Name of the field to check
+     * @param decorator - The decorator to check for
+     * @throws Error if the assertion fails
+     */
+    static assertFieldHasDecorator(schema: z.ZodTypeAny, fieldName: string, decorator: ZodDecorator): void;
+    /**
+     * Check (without throwing) that a field has a specific decorator.
+     */
+    static checkFieldHasDecorator(schema: z.ZodTypeAny, fieldName: string, decorator: ZodDecorator): AssertionResult;
+    /**
+     * Assert that a field does NOT have a specific decorator.
+     */
+    static assertFieldLacksDecorator(schema: z.ZodTypeAny, fieldName: string, decorator: ZodDecorator): void;
+    /**
+     * Check (without throwing) that a field does NOT have a specific decorator.
+     */
+    static checkFieldLacksDecorator(schema: z.ZodTypeAny, fieldName: string, decorator: ZodDecorator): AssertionResult;
+    /**
+     * Assert that a derived summary schema includes specific fields.
+     */
+    static assertSummaryIncludes(schema: z.ZodTypeAny, expectedFields: string[]): void;
+    /**
+     * Check that a derived summary schema includes specific fields.
+     */
+    static checkSummaryIncludes(schema: z.ZodTypeAny, expectedFields: string[]): AssertionResult;
+    /**
+     * Assert that a derived summary schema excludes specific fields.
+     */
+    static assertSummaryExcludes(schema: z.ZodTypeAny, excludedFields: string[]): void;
+    /**
+     * Check that a derived summary schema excludes specific fields.
+     */
+    static checkSummaryExcludes(schema: z.ZodTypeAny, excludedFields: string[]): AssertionResult;
+    /**
+     * Assert that decorators are preserved when extending a schema.
+     * Checks that all decorated fields in baseSchema still have their decorators
+     * in the extendedSchema.
+     */
+    static assertDecoratorPreservation(baseSchema: z.ZodTypeAny, extendedSchema: z.ZodTypeAny): void;
+    /**
+     * Check that decorators are preserved when extending a schema.
+     */
+    static checkDecoratorPreservation(baseSchema: z.ZodTypeAny, extendedSchema: z.ZodTypeAny): AssertionResult;
+    /**
+     * Get all virtual field names from a schema.
+     */
+    static getVirtualFieldNames(schema: z.ZodTypeAny): string[];
+    /**
+     * Get all backend-only field names from a schema.
+     */
+    static getBackendOnlyFieldNames(schema: z.ZodTypeAny): string[];
+    /**
+     * Get all summary field names from a schema.
+     */
+    static getSummaryFieldNames(schema: z.ZodTypeAny): string[];
+    /**
+     * Get all discriminator field names from a schema.
+     */
+    static getDiscriminatorFieldNames(schema: z.ZodTypeAny): string[];
+    /**
+     * Get a comprehensive decorator report for a schema.
+     */
+    static getDecoratorReport(schema: z.ZodTypeAny): Record<string, ZodDecorator[]>;
+}
+//# sourceMappingURL=schema-decorator-utils.d.ts.map

package/dist/esm/testing/schema-decorator-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-decorator-utils.d.ts","sourceRoot":"","sources":["../../../src/testing/schema-decorator-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,YAAY,EAWb,MAAM,0BAA0B,CAAC;AAGlC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IACnC;;;;;;;OAOG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI;IAOtG;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAC3B,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,GACtB,eAAe;IA8BlB;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI;IAOxG;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAC7B,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,GACtB,eAAe;IA8BlB;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAOlF;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,eAAe;IAqB5F;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAOlF;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,eAAe;IAqB5F;;;;OAIG;IACH,MAAM,CAAC,2BAA2B,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,UAAU,GAAG,IAAI;IAOhG;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC,UAAU,GAAG,eAAe;IA8C1G;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE;IAkB3D;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE;IAkB/D;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE;IAkB3D;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE;IAkBjE;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;CA8BhF"}

package/dist/esm/testing/schema-decorator-utils.js

@@ -0,0 +1,325 @@
+/**
+ * Schema Decorator Test Utilities
+ *
+ * Singleton utility class with static methods for testing decorated schemas.
+ * Provides assertion helpers for verifying decorator presence and preservation.
+ *
+ * @see Section 23.3.D of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md
+ */
+import { getZodObjectShape, ZodDecorator, getFieldMetadataRecursive, isVirtualField, isBackendOnlyField, isSummaryField, isDiscriminatorField, isExcludedFromCreate, isExcludedFromUpdate, isForeignKeyField, isHiddenField, isNotEditableField, } from '@wildo-ai/zod-decorators';
+import { ResourcesSummaryUtils } from '../resources/utils/resources-summary.utils.js';
+/**
+ * Singleton utility class for testing decorated schemas.
+ * All methods are static - no instantiation needed.
+ */
+export class SchemaDecoratorTestUtils {
+    /**
+     * Assert that a field has a specific decorator.
+     *
+     * @param schema - The schema containing the field
+     * @param fieldName - Name of the field to check
+     * @param decorator - The decorator to check for
+     * @throws Error if the assertion fails
+     */
+    static assertFieldHasDecorator(schema, fieldName, decorator) {
+        const result = this.checkFieldHasDecorator(schema, fieldName, decorator);
+        if (!result.passed) {
+            throw new Error(result.message);
+        }
+    }
+    /**
+     * Check (without throwing) that a field has a specific decorator.
+     */
+    static checkFieldHasDecorator(schema, fieldName, decorator) {
+        try {
+            const shape = getZodObjectShape(schema);
+            const fieldSchema = shape[fieldName];
+            if (!fieldSchema) {
+                return {
+                    passed: false,
+                    message: `Field '${fieldName}' does not exist in schema`,
+                };
+            }
+            // Use recursive lookup to find metadata through wrapper types (ZodOptional, etc.)
+            const metadata = getFieldMetadataRecursive(fieldSchema);
+            if (!metadata || metadata[decorator] === undefined) {
+                return {
+                    passed: false,
+                    message: `Field '${fieldName}' does not have '${decorator}' decorator`,
+                };
+            }
+            return { passed: true, message: 'OK' };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                message: `Failed to check decorator: ${error}`,
+            };
+        }
+    }
+    /**
+     * Assert that a field does NOT have a specific decorator.
+     */
+    static assertFieldLacksDecorator(schema, fieldName, decorator) {
+        const result = this.checkFieldLacksDecorator(schema, fieldName, decorator);
+        if (!result.passed) {
+            throw new Error(result.message);
+        }
+    }
+    /**
+     * Check (without throwing) that a field does NOT have a specific decorator.
+     */
+    static checkFieldLacksDecorator(schema, fieldName, decorator) {
+        try {
+            const shape = getZodObjectShape(schema);
+            const fieldSchema = shape[fieldName];
+            if (!fieldSchema) {
+                return {
+                    passed: false,
+                    message: `Field '${fieldName}' does not exist in schema`,
+                };
+            }
+            // Use recursive lookup to find metadata through wrapper types (ZodOptional, etc.)
+            const metadata = getFieldMetadataRecursive(fieldSchema);
+            if (metadata && metadata[decorator] !== undefined) {
+                return {
+                    passed: false,
+                    message: `Field '${fieldName}' unexpectedly has '${decorator}' decorator`,
+                };
+            }
+            return { passed: true, message: 'OK' };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                message: `Failed to check decorator: ${error}`,
+            };
+        }
+    }
+    /**
+     * Assert that a derived summary schema includes specific fields.
+     */
+    static assertSummaryIncludes(schema, expectedFields) {
+        const result = this.checkSummaryIncludes(schema, expectedFields);
+        if (!result.passed) {
+            throw new Error(result.message);
+        }
+    }
+    /**
+     * Check that a derived summary schema includes specific fields.
+     */
+    static checkSummaryIncludes(schema, expectedFields) {
+        try {
+            const summaryFields = ResourcesSummaryUtils.getSummaryFieldNames(schema);
+            const missing = expectedFields.filter((f) => !summaryFields.includes(f));
+            if (missing.length > 0) {
+                return {
+                    passed: false,
+                    message: `Summary is missing expected fields: ${missing.join(', ')}`,
+                };
+            }
+            return { passed: true, message: 'OK' };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                message: `Failed to check summary: ${error}`,
+            };
+        }
+    }
+    /**
+     * Assert that a derived summary schema excludes specific fields.
+     */
+    static assertSummaryExcludes(schema, excludedFields) {
+        const result = this.checkSummaryExcludes(schema, excludedFields);
+        if (!result.passed) {
+            throw new Error(result.message);
+        }
+    }
+    /**
+     * Check that a derived summary schema excludes specific fields.
+     */
+    static checkSummaryExcludes(schema, excludedFields) {
+        try {
+            const summaryFields = ResourcesSummaryUtils.getSummaryFieldNames(schema);
+            const included = excludedFields.filter((f) => summaryFields.includes(f));
+            if (included.length > 0) {
+                return {
+                    passed: false,
+                    message: `Summary unexpectedly includes: ${included.join(', ')}`,
+                };
+            }
+            return { passed: true, message: 'OK' };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                message: `Failed to check summary: ${error}`,
+            };
+        }
+    }
+    /**
+     * Assert that decorators are preserved when extending a schema.
+     * Checks that all decorated fields in baseSchema still have their decorators
+     * in the extendedSchema.
+     */
+    static assertDecoratorPreservation(baseSchema, extendedSchema) {
+        const result = this.checkDecoratorPreservation(baseSchema, extendedSchema);
+        if (!result.passed) {
+            throw new Error(result.message);
+        }
+    }
+    /**
+     * Check that decorators are preserved when extending a schema.
+     */
+    static checkDecoratorPreservation(baseSchema, extendedSchema) {
+        const issues = [];
+        try {
+            const baseShape = getZodObjectShape(baseSchema);
+            const extendedShape = getZodObjectShape(extendedSchema);
+            for (const [fieldName, baseFieldSchema] of Object.entries(baseShape)) {
+                const extendedFieldSchema = extendedShape[fieldName];
+                if (!extendedFieldSchema) {
+                    issues.push(`Field '${fieldName}' is missing in extended schema`);
+                    continue;
+                }
+                // Use recursive lookup to find metadata through wrapper types (ZodOptional, etc.)
+                const baseMetadata = getFieldMetadataRecursive(baseFieldSchema);
+                const extendedMetadata = getFieldMetadataRecursive(extendedFieldSchema);
+                if (baseMetadata) {
+                    for (const [key, value] of Object.entries(baseMetadata)) {
+                        if (value !== undefined) {
+                            if (!extendedMetadata || extendedMetadata[key] === undefined) {
+                                issues.push(`Field '${fieldName}' lost decorator '${key}'`);
+                            }
+                        }
+                    }
+                }
+            }
+            if (issues.length > 0) {
+                return {
+                    passed: false,
+                    message: `Decorator preservation failed:\n${issues.join('\n')}`,
+                };
+            }
+            return { passed: true, message: 'OK' };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                message: `Failed to check decorator preservation: ${error}`,
+            };
+        }
+    }
+    /**
+     * Get all virtual field names from a schema.
+     */
+    static getVirtualFieldNames(schema) {
+        const result = [];
+        try {
+            const shape = getZodObjectShape(schema);
+            for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+                if (isVirtualField(fieldSchema)) {
+                    result.push(fieldName);
+                }
+            }
+        }
+        catch {
+            // Schema may not be an object
+        }
+        return result;
+    }
+    /**
+     * Get all backend-only field names from a schema.
+     */
+    static getBackendOnlyFieldNames(schema) {
+        const result = [];
+        try {
+            const shape = getZodObjectShape(schema);
+            for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+                if (isBackendOnlyField(fieldSchema)) {
+                    result.push(fieldName);
+                }
+            }
+        }
+        catch {
+            // Schema may not be an object
+        }
+        return result;
+    }
+    /**
+     * Get all summary field names from a schema.
+     */
+    static getSummaryFieldNames(schema) {
+        const result = [];
+        try {
+            const shape = getZodObjectShape(schema);
+            for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+                if (isSummaryField(fieldSchema)) {
+                    result.push(fieldName);
+                }
+            }
+        }
+        catch {
+            // Schema may not be an object
+        }
+        return result;
+    }
+    /**
+     * Get all discriminator field names from a schema.
+     */
+    static getDiscriminatorFieldNames(schema) {
+        const result = [];
+        try {
+            const shape = getZodObjectShape(schema);
+            for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+                if (isDiscriminatorField(fieldSchema)) {
+                    result.push(fieldName);
+                }
+            }
+        }
+        catch {
+            // Schema may not be an object
+        }
+        return result;
+    }
+    /**
+     * Get a comprehensive decorator report for a schema.
+     */
+    static getDecoratorReport(schema) {
+        const report = {};
+        try {
+            const shape = getZodObjectShape(schema);
+            for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+                const decorators = [];
+                const typedSchema = fieldSchema;
+                if (isVirtualField(typedSchema))
+                    decorators.push(ZodDecorator.IS_VIRTUAL);
+                if (isBackendOnlyField(typedSchema))
+                    decorators.push(ZodDecorator.IS_BACKEND_ONLY);
+                if (isSummaryField(typedSchema))
+                    decorators.push(ZodDecorator.IS_SUMMARY_FIELD);
+                if (isDiscriminatorField(typedSchema))
+                    decorators.push(ZodDecorator.IS_DISCRIMINATOR);
+                if (isExcludedFromCreate(typedSchema))
+                    decorators.push(ZodDecorator.EXCLUDE_FROM_CREATE);
+                if (isExcludedFromUpdate(typedSchema))
+                    decorators.push(ZodDecorator.EXCLUDE_FROM_UPDATE);
+                if (isForeignKeyField(typedSchema))
+                    decorators.push(ZodDecorator.IS_FOREIGN_KEY);
+                if (isHiddenField(typedSchema))
+                    decorators.push(ZodDecorator.IS_HIDDEN);
+                if (isNotEditableField(typedSchema))
+                    decorators.push(ZodDecorator.IS_NOT_EDITABLE);
+                if (decorators.length > 0) {
+                    report[fieldName] = decorators;
+                }
+            }
+        }
+        catch {
+            // Schema may not be an object
+        }
+        return report;
+    }
+}
+//# sourceMappingURL=schema-decorator-utils.js.map