@stndrds/schema 0.1.0-alpha.41 → 0.1.0-alpha.43

package/dist/{runtime-Vg_IW6IO.d.mts → runtime-CvRbtIhb.d.mts}

@@ -7023,58 +7023,9 @@ declare class RecordService extends TenantAwareService {
     private permissionService?;
     private auditService?;
     private policyRegistry;
+    private labelResolver;
+    private rollupContext;
     constructor(adapter: DatabaseAdapter, options?: RecordServiceOptions);
-    /**
-     * Check permission for an action on an object.
-     * Only checks if permissionService and userId are configured.
-     * @internal
-     */
-    private checkPermission;
-    /**
-     * Get policy for an object if one exists and userId is configured.
-     * @internal
-     */
-    private getPolicy;
-    /**
-     * Build policy context for the current request.
-     * @internal
-     */
-    private buildPolicyContext;
-    /**
-     * Check if user can access a record based on policy.
-     * Returns true if no policy exists or user can access.
-     * @internal
-     */
-    private checkRecordAccess;
-    /**
-     * Check if user can modify a record based on policy.
-     * Throws PolicyViolationError if denied.
-     * @internal
-     */
-    private checkRecordModify;
-    /**
-     * Check if user can delete a record based on policy.
-     * Throws PolicyViolationError if denied.
-     * @internal
-     */
-    private checkRecordDelete;
-    /**
-     * Resolve relation IDs to their display labels
-     * @internal
-     */
-    private resolveRelationLabels;
-    /**
-     * Extract relation IDs from a value (string or array)
-     * @internal
-     */
-    private extractRelationIds;
-    /**
-     * Compute display label from schema expression
-     * Automatically resolves relation attribute values to their labels
-     * and select/multiselect values to their option labels
-     * @internal
-     */
-    private computeLabel;
     /**
      * Create a new record with validation
      *
@@ -7084,84 +7035,23 @@ declare class RecordService extends TenantAwareService {
      * @param data - Record data (attribute values)
      * @param options - Creation options
      * @returns Created record with computed completionStatus
-     *
-     * @example
-     * ```typescript
-     * const service = new RecordService(adapter, "tenant-123");
-     *
-     * // Create a complete record (strict validation)
-     * const product = await service.createRecord("obj-product", {
-     *   name: "Nike Air Max",
-     *   price: 129.99,
-     *   status: "active"
-     * });
-     * // → product.completionStatus = "complete"
-     *
-     * // Create a draft record (allows missing required fields)
-     * const draft = await service.createRecord("obj-product", {
-     *   name: "Draft Product"
-     * }, { allowDraft: true });
-     * // → draft.completionStatus = "draft"
-     * ```
      */
     createRecord(objectId: string, data: Record<string, unknown>, options?: {
-        /**
-         * Allow creating records with missing required fields.
-         * Format validation still applies to provided values.
-         * @default false
-         */
         allowDraft?: boolean;
-        /**
-         * Skip all validation (format + relations).
-         * @default true
-         */
         validate?: boolean;
-        /**
-         * Skip relation validation only.
-         * Useful for bulk imports where relations are validated separately.
-         * @default false
-         */
         skipRelationValidation?: boolean;
-        /**
-         * Skip user validation only.
-         * Useful for bulk imports where users are validated separately.
-         * @default false
-         */
         skipUserValidation?: boolean;
         skipSystemCheck?: boolean;
-        /**
-         * Skip hook execution.
-         * @default false
-         */
         skipHooks?: boolean;
-        /**
-         * Additional metadata to pass to hooks (e.g., userId, requestId).
-         */
         hookMetadata?: Record<string, unknown>;
-        /**
-         * Developer-managed metadata for the record.
-         * Use this for internal IDs, external references, or any application-specific data.
-         */
         metadata?: Record<string, unknown>;
     }): Promise<ObjectRecord>;
     /**
      * Get a record by ID
-     *
-     * @param recordId - Record UUID
-     * @param options - Query options
-     * @returns Record or null if not found
      */
     getRecord(recordId: string, options?: {
         includeSchema?: boolean;
-        /**
-         * Skip formula computation (useful for internal operations)
-         * @default false
-         */
         skipFormulas?: boolean;
-        /**
-         * Skip policy access check (internal use only)
-         * @default false
-         */
         skipPolicyCheck?: boolean;
     }): Promise<ObjectRecord | null>;
     /**
@@ -7170,206 +7060,41 @@ declare class RecordService extends TenantAwareService {
     getRecordOrThrow(recordId: string): Promise<ObjectRecord>;
     /**
      * Update a record with validation
-     *
-     * The completion status is automatically recalculated after each update.
-     * A draft record becomes complete when all required fields are filled.
-     *
-     * Triggers beforeUpdate and afterUpdate hooks if a HookRegistry is configured.
-     *
-     * @param recordId - Record UUID
-     * @param data - Partial data to update
-     * @param options - Update options
-     * @returns Updated record with recalculated completionStatus
-     *
-     * @example
-     * ```typescript
-     * // Update a draft record to make it complete
-     * const updated = await service.updateRecord(draftId, {
-     *   price: 99.99,
-     *   status: "active"
-     * });
-     * // → updated.completionStatus = "complete" if all required fields now present
-     * ```
      */
     updateRecord(recordId: string, data: Partial<Record<string, unknown>>, options?: {
-        /**
-         * Skip validation entirely (format + relations).
-         * @default true
-         */
         validate?: boolean;
-        /**
-         * Allow partial updates without strict validation.
-         * Format validation still applies to provided values.
-         * @default false
-         */
         partial?: boolean;
-        /**
-         * Skip relation validation only.
-         * @default false
-         */
         skipRelationValidation?: boolean;
-        /**
-         * Skip user validation only.
-         * @default false
-         */
         skipUserValidation?: boolean;
-        /**
-         * Skip hook execution.
-         * @default false
-         */
         skipHooks?: boolean;
-        /**
-         * Additional metadata to pass to hooks (e.g., userId, requestId).
-         */
         hookMetadata?: Record<string, unknown>;
-        /**
-         * Developer-managed metadata for the record.
-         * Merged with existing metadata (not replaced).
-         * Set a key to `undefined` to remove it.
-         *
-         * @example
-         * ```typescript
-         * // Existing: { externalId: "ext-123", source: "import" }
-         * // Update with: { source: "api", newKey: "value", externalId: undefined }
-         * // Result: { source: "api", newKey: "value" }
-         * ```
-         */
         metadata?: Record<string, unknown>;
     }): Promise<ObjectRecord>;
     /**
-     * Build hook context for update operations
-     * @internal
-     */
-    private buildHookContext;
-    /**
-     * Build hook context for create operations (no existing record)
-     * @internal
-     */
-    private buildCreateHookContext;
-    /**
-     * Build hook context for delete operations
-     * @internal
-     */
-    private buildDeleteHookContext;
-    /**
-     * Delete a record
-     *
-     * Triggers beforeDelete and afterDelete hooks if a HookRegistry is configured.
-     *
-     * @param recordId - Record UUID
-     * @param options - Delete options
+     * Delete a record (soft delete)
      */
     deleteRecord(recordId: string, options?: {
         checkSystem?: boolean;
-        /**
-         * Skip hook execution.
-         * @default false
-         */
         skipHooks?: boolean;
-        /**
-         * Skip relation reference check (use with caution).
-         * @default false
-         */
         skipReferenceCheck?: boolean;
-        /**
-         * Additional metadata to pass to hooks (e.g., userId, requestId).
-         */
         hookMetadata?: Record<string, unknown>;
     }): Promise<void>;
+    /**
+     * Permanently delete a record (hard delete)
+     */
+    hardDeleteRecord(recordId: string): Promise<void>;
     /**
      * Restore a soft-deleted record
-     *
-     * Triggers beforeRestore and afterRestore hooks if a HookRegistry is configured.
-     *
-     * @param recordId - Record UUID
-     * @param options - Restore options
-     * @returns Restored record
-     *
-     * @example
-     * ```typescript
-     * // Restore a deleted record
-     * const restored = await service.restoreRecord("rec-123");
-     * console.log(restored.deletedAt); // null
-     * ```
      */
     restoreRecord(recordId: string, options?: {
-        /**
-         * Skip hook execution.
-         * @default false
-         */
         skipHooks?: boolean;
-        /**
-         * Additional metadata to pass to hooks (e.g., userId, requestId).
-         */
         hookMetadata?: Record<string, unknown>;
     }): Promise<ObjectRecord>;
-    /**
-     * Build hook context for restore operations
-     * @internal
-     */
-    private buildRestoreHookContext;
-    /**
-     * Enrich a record with computed formula values
-     *
-     * Formula attributes are calculated at read-time from the record's values.
-     * This method adds the computed values to the record's values object.
-     *
-     * @param record - The record to enrich
-     * @param schema - The object schema containing attribute definitions
-     * @returns Record with formula values computed
-     * @internal
-     */
-    private enrichWithFormulas;
-    /**
-     * Enrich multiple records with computed formula values
-     * @internal
-     */
-    private enrichRecordsWithFormulas;
-    /**
-     * Recalculate rollups after a record changes
-     *
-     * This handles three cases:
-     * 1. The record itself has rollups (e.g., aggregating from related records it points to)
-     * 2. Parent records have rollups that aggregate from this record (reverse pattern)
-     * 3. Records that have forward rollups pointing to this record (forward pattern)
-     *
-     * @param record - The record that was modified
-     * @param schema - Schema of the record's object
-     * @internal
-     */
-    private recalculateParentRollups;
-    /**
-     * Permanently delete a record (hard delete)
-     *
-     * This cannot be undone. Use with caution - prefer soft delete for data safety.
-     * Does NOT trigger delete hooks (already triggered on soft delete).
-     *
-     * @param recordId - Record UUID
-     *
-     * @example
-     * ```typescript
-     * // Permanently delete a record
-     * await service.hardDeleteRecord("rec-123");
-     * ```
-     */
-    hardDeleteRecord(recordId: string): Promise<void>;
     /**
      * List records for an object with pagination
-     *
-     * @param objectId - Object UUID
-     * @param options - List options
-     * @returns Records and total count
      */
     listRecords(objectId: string, options?: ListOptions & {
-        /**
-         * Skip formula computation (useful for internal operations)
-         * @default false
-         */
         skipFormulas?: boolean;
-        /**
-         * Skip policy filtering (internal use only)
-         * @default false
-         */
         skipPolicyFilter?: boolean;
     }): Promise<{
         records: ObjectRecord[];
@@ -7377,17 +7102,8 @@ declare class RecordService extends TenantAwareService {
     }>;
     /**
      * Search records using full-text search
-     *
-     * @param objectId - Object UUID
-     * @param query - Search query
-     * @param options - Search options
-     * @returns Matching records and total count
      */
     searchRecords(objectId: string, query: string, options?: SearchOptions & {
-        /**
-         * Skip formula computation (useful for internal operations)
-         * @default false
-         */
         skipFormulas?: boolean;
     }): Promise<{
         records: ObjectRecord[];
@@ -7395,27 +7111,14 @@ declare class RecordService extends TenantAwareService {
     }>;
     /**
      * Validate data against object schema without saving
-     *
-     * @param objectId - Object UUID
-     * @param data - Data to validate
-     * @returns Validation result
      */
     validateData(objectId: string, data: Record<string, unknown>): Promise<ValidationResult>;
     /**
-     * Compute the completion status for given data without saving.
-     * Useful for UI to show draft/complete status before submitting.
-     *
-     * @param objectId - Object UUID
-     * @param data - Data to check
-     * @returns Computed completion status
+     * Compute the completion status for given data without saving
      */
     computeStatus(objectId: string, data: Record<string, unknown>): Promise<CompletionStatus>;
     /**
-     * Refresh the completion status of an existing record.
-     * Useful when schema changes and you need to recompute statuses.
-     *
-     * @param recordId - Record UUID
-     * @returns Updated completion status
+     * Refresh the completion status of an existing record
      */
     refreshRecordStatus(recordId: string): Promise<CompletionStatus>;
 }