Wingman.Application

Hangfire job that runs one document sync for a single integration. Invoked by a recurring job per integration (schedule from integration's SyncIntervalMinutes).

Runs sync for the given integration. Sets tenant context for the scope so repository uses correct tenant.

Background job that polls for Google Drive integrations ready for auto-sync and enqueues sync jobs based on their configured SyncIntervalMinutes. This job runs continuously (every 5 minutes) and dynamically schedules syncs based on the NextSyncAt timestamp and SyncIntervalMinutes configuration.

Polls for Google Drive integrations ready for auto-sync and enqueues sync jobs. This method is called by Hangfire on a recurring schedule (every 5 minutes).

Background job to sync Jotform forms from API to database for all operators Runs every 15-30 minutes to keep cache fresh Syncs forms per operator using their respective Jotform integrations

Sync all Jotform forms from API to database for all operators with active integrations This job runs periodically to keep the cache fresh

Sync only stale forms (older than cutoff time) for all operators This is a lighter operation that only updates forms that need refreshing

Background job to clean up old sync logs based on configurable retention period. Retains only the last N days of sync logs (default 7); runs on a configurable cron (default every 5 days).

Clean up sync logs older than retention period (from config; default 7 days). Schedule is configured via SyncLogCleanupSettings.CronSchedule (e.g. every 5 days).

Clean up abandoned sync logs that are stuck in "Started" status for too long These are likely from crashed processes or failed background jobs

Archive old sync logs to separate storage (future enhancement)

Specification to get old sync logs for cleanup

Specification to get abandoned sync logs stuck in "Started" status

Sets the current tenant for the current async context when running a background job. Used so repository and DbContext use the correct tenant when the job has no HTTP context.

Set the tenant id for the current async context (e.g. for this job execution). Pass null to clear.

Get the tenant id currently set for the current async context, or null.

Service for encrypting and decrypting sensitive credentials

Encrypt plain text credentials

Decrypt encrypted credentials

Resolves operator roles assigned to synced documents via role–document mappings.

Returns roles grouped by document id for the current tenant. Missing document ids are omitted from the dictionary.

Document ids that have a role–document mapping for in .

Interface for document source adapters (ClickHelp, SharePoint, Google Drive, etc.) NOTE: This interface does NOT extend ITransientService because adapters are created by the factory with a DocumentIntegration instance

Get all available documents from the source for a specific operator

Download a specific document from the source

Check for document updates since the last sync

Validate the connection and credentials

Provider name (ClickHelp, SharePoint, GoogleDrive, etc.)

Metadata for a document from an external source

Result of a sync operation

Result of connection validation

Factory for creating document source adapters

Create an adapter for the given integration

Factory for creating document source adapters for validation purposes (with plain text credentials)

Create an adapter for validation using plain text credentials

Provider name (ClickHelp, SharePoint, GoogleDrive) Base URL for the integration Username or service account email Plain text password or private key Optional API key Document source adapter for validation

Sends push notifications to operator users when a document integration sync completes with file changes (new, updated, or deleted).

Notifies all users of the integration's operator that documents were synced (new/updated/deleted). Call only when sync succeeded and at least one change was applied. Does not throw; push failures are logged and do not affect sync result.

Notifies users that a sync completed with file changes. Recipient selection is expected to use RoleDocumentAccess mappings (so pushes align with mobile visibility rules).

Notifies users when one or more documents were newly assigned to an Identity operator-scoped role.

Notifies users when a document publication category changed. Recipients should be users mapped to the document via RoleDocumentAccess (after the change).

Service for synchronizing documents from external sources

Execute a sync operation for a specific integration

Process file changes (detect new, updated, deleted files). Uses integration.AllowedFileTypes when set to filter which files to sync.

Download a file and store it

Update the file index with changes

Result of a sync execution

Error categories for sync failures

Error codes for specific error scenarios

Detected file changes

Information about a stored file

Service for sending push notifications when entities are created. Provides a generic, reusable way to notify users about new entities.

Sends push notifications to all users of an operator when an entity is created.

The entity type The created entity The operator ID associated with the entity Configuration for the notification (title, body, data, etc.) Cancellation token Results of the push notification sends

Configuration for entity-created notifications

Notification title (e.g., "New link available")

Notification body template. Use {PropertyName} to reference entity properties. Example: "A new link '{Title}' is now available."

Function to build notification data dictionary from the entity. Should return a dictionary with keys like "entity_id", "type", etc.

Function to get the image URL from the entity (e.g., IconUrl, LogoUrl)

Function to get the action URL from the entity (e.g., Url, LinkUrl)

Function to determine if notification should be sent (e.g., check IsActive) Returns true by default if not specified.

Module for the notification (e.g., Contact, Link, Form, Training, Publication, General)

Message type for the notification (e.g., Alert, Update)

Service for managing and monitoring Hangfire background jobs

Get job information by job ID

Get list of jobs with optional filtering

Get jobs by state (e.g., "Succeeded", "Failed", "Processing", "Enqueued")

Get failed jobs

Get succeeded jobs

Get processing (running) jobs

Get scheduled jobs

Delete a job

Requeue a failed job

Get job statistics

Service interface for interacting with Jotform API

Get all forms from database (no API sync). Forms must be synced separately using the sync endpoint.

Operator ID to scope forms to Pagination offset Pagination limit Ignored - kept for backward compatibility Filter by IsTraining flag (null = no filter) Filter by IsForm flag (null = no filter) Ignored - kept for backward compatibility Ignored - kept for backward compatibility Cancellation token

Sync forms from Jotform API to database

Operator ID to sync forms for API key from integration Base URL from integration Cancellation token Number of forms synced and API limit remaining

Get form details by ID including analytics

External form ID from Jotform Operator ID to scope the form lookup API key from integration Base URL from integration Cancellation token

Get form submissions with pagination and filtering

External form ID from Jotform Operator ID to scope the form lookup Pagination offset Pagination limit Optional filter dictionary Optional order by clause API key from integration Base URL from integration Cancellation token

Get a single submission by ID

Submission ID from Jotform Operator ID to scope the submission lookup API key from integration Base URL from integration Cancellation token

Get form reports/analytics

External form ID from Jotform Operator ID to scope the form lookup API key from integration Base URL from integration Cancellation token

Service for generating sequential occurrence report numbers per operator Format: OR-YYYY-00001, OR-YYYY-00002, etc. Each operator maintains their own sequence counter per year

Generates the next sequential report number for the specified operator Format: OR-YYYY-00001 Thread-safe operation that ensures unique sequential numbering per operator per year

The operator ID Cancellation token The next report number in sequence

Gets the current sequence number for an operator in a specific year (for informational purposes)

The operator ID The year to check Cancellation token Current sequence number, or 0 if no reports have been created

Ensures and resolves the default operator-scoped role used for automatic user role assignment and default document access.

Resolves the operator role for only when default_role_id is set and the role exists. Does not create roles or update the operator.

Batch-counts synced documents per publication category for a given operator and Identity role (via RoleDocumentAccess).

Returns counts keyed by publication category id. Categories with no matching documents are omitted from the dictionary.

Sends a push notification to a specific device using its push token

Sends a push notification to multiple devices

Sends a push notification to all devices of a specific user

Sends a push notification to all devices of multiple users

Sends a push notification based on Notification entity

Rate limiter for throttling API calls per integration type

Wait if necessary to respect rate limits for the given provider

Schedules or unschedules a Hangfire recurring job for a document integration's auto-sync. Used when integration is created/updated with auto-sync, or when auto-sync is disabled or integration is deleted.

Remove the recurring sync job for the integration.

Service for managing sync locks to prevent concurrent syncs

Acquires a lock for a sync operation

Integration ID to lock Timeout for lock acquisition Cancellation token Disposable lock handle

Represents an acquired sync lock

Integration ID that is locked

Whether the lock is still held

Manages database transactions

Begins a new transaction

Executes the given action inside a transaction as a retriable unit. Use this when using a retrying execution strategy (e.g. EnableRetryOnFailure) so the entire transaction is retried on transient failures.

Represents a database transaction

Commits the transaction

Rolls back the transaction

Resolves which synced documents the current user may access (non-admin: union of role-document mappings).

Returns null if the user has full document access (Admin). Otherwise returns the set of allowed document IDs (may be empty).

True if the current user may access all documents for their operator (Admin).

Configuration settings for the sync log cleanup background job.

Number of days of sync logs to retain. Logs older than this are deleted. Default: 7 (retain last 7 days only).

Cron expression for how often the cleanup job runs (e.g. every 5 days). Default: "0 2 */5 * *" (every 5 days at 2:00 AM UTC).

Batch size for deleting old sync logs per iteration (avoids memory issues). Default: 1000.

Configuration settings for document synchronization

Batch size for processing files

Delay between batches in milliseconds

Interval for updating checkpoint (every N files)

Maximum file size in bytes (0 = no limit)

Timeout for sync lock acquisition in minutes

Enable transaction support for sync operations

Model for occurrence notification email template

Column Wise Search is Supported.

Keyword to Search in All the available columns of the Resource.

Marker interface for specifications that need to bypass Finbuckle's automatic tenant filtering. Used by background jobs that need to query across all tenants.

Get an using raw sql string with parameters.

The type of the entity. The sql string. The paramters in the sql string. The transaction to be performed. The to observe while waiting for the task to complete. Returns of .

Get a using raw sql string with parameters.

The type of the entity. The sql string. The paramters in the sql string. The transaction to be performed. The to observe while waiting for the task to complete. Returns of .

Get a using raw sql string with parameters.

The type of the entity. The sql string. The paramters in the sql string. The transaction to be performed. The to observe while waiting for the task to complete. Returns of .

The regular read/write repository for an aggregate root.

The read-only repository for an aggregate root.

A special (read/write) repository for an aggregate root, that also adds EntityCreated, EntityUpdated or EntityDeleted events to the DomainEvents of the entities before adding, updating or deleting them.

Unified API response structure for all endpoints ensuring consistent JSON format. All API responses will follow this structure: { succeeded, message, type, data }

The type of data being returned

Indicates whether the operation was successful

Human-readable message describing the result

Message type for UI presentation (Success=0, Info=1, Warning=2, Error=3)

The response data (can be an object, list, ID, or null)

Creates a successful response with data

Creates a successful response without data

Creates an error response

Creates an info response

Creates a warning response

Non-generic ApiResponse for operations that don't return data

Message type enumeration for UI presentation

Success message (green UI)

Informational message (blue UI)

Warning message (yellow UI)

Error message (red UI)

Response type for operations that return a simple success/error message with optional data. Commonly used in MediatR handlers for Create, Update, Delete operations.

Indicates whether the operation was successful

The response message

Message type (for UI presentation)

Optional data payload (e.g., created entity ID)

Creates a success response

Creates an error response

Creates an info response

Creates a warning response

Standard API response wrapper providing consistent structure for all endpoints.

The type of data being returned

Indicates whether the operation was successful

The response data (null for errors or operations with no return value)

Primary message describing the result

Collection of error messages (empty for successful operations)

Creates a successful response with data

Creates a successful response without data

Creates an error response with a single message

Creates an error response with multiple errors (typically validation errors)

Creates an error response from an exception

Wrapper class that implements IOrderedSpecificationBuilder to allow chaining of ThenBy operations

User-visible role name. The same value is allowed for different operators (uniqueness is per operator).

Required when creating a new operator-scoped custom role (not Admin/Operator). Roles with the same may exist for different operator ids.

When true, only roles with OperatorId set (custom operator roles) are returned.

Marks an operator-scoped role as the operator default role.

Maps synced documents to an operator-scoped custom role (skips duplicates).

Removes document mappings from a role.

Returns synced document IDs mapped to the role.

Builds Identity role names for operator-scoped custom roles. The internal name embeds the operator id, so the same display label (e.g. "Engineers") may exist for Operator 1 and Operator 2; only duplicates for the same operator and the same alphanumeric slug collide.

Returns {operatorId:N}_{slug} where is alphanumeric from . Different operators always get different prefixes, so display names can repeat across operators.

Label suitable for UI and APIs. For operator-scoped roles uses stored when set; otherwise derives the slug portion from the internal Identity name ({operatorId:N}_{slug}).

Returns the segment after {operatorId:N}_ when matches that pattern.

User-visible role name. For operator custom roles this matches what the user entered, not the internal Identity key.

ASP.NET Identity role name (e.g. {operatorId}_{slug}). Set when is set; use with assign-role APIs if not sending role id.

Same as for operator roles when stored; may duplicate in responses.

When set, the role applies only to this operator.

Name of the operator when is set.

True when this role is configured as default for its operator.

Operator branding information for mobile app theming.

User role with detailed information.

Logged-in user information.

When Admin, the user is created in the admin email lane (same mailbox may also exist as an operator/custom-role user). When empty, the user gets the default Operator role and the operator email lane.

True if an account already uses this email in the same lane (admin vs operator/custom role).

Lane for an existing user (for email change validation).

Counts users assigned to (same scope as operator user lists).

Whether the Identity role exists and, if it does, its operator scope (null for system roles).

ASP.NET Identity role name (internal key for operator custom roles). Prefer or this value for assign-role APIs, not .

User-visible role title (what the operator entered, not the internal {operatorId}_{slug} key).

OperatorId is required when assigning the Operator role. This will be updated in the user table.

Lightweight DTO for bulletin dropdown (ID and display label).

DTO for Bulletin entity - operator-scoped PDF bulletins with enable/disable.

Response for GET /dashboard/integrations-overview. Groups integration issues, banner, health top 5, and operator summary.

Operator-scoped roles that can access this document (via role–document mapping).

Role assigned to a synced document for access control.

User-visible role name (same semantics as role list APIs).

ASP.NET Identity role name when the role is operator-scoped (internal key).

DTO for EmergencyContent entity.

Information about a Hangfire job

List of jobs with pagination

Job statistics

DTO for LoginHistory entity - tracks all login attempts for security and auditing.

User ID from ASP.NET Identity (ApplicationUser.Id)

Mobile app main navigation tab labels (fixed tab order, per-operator overrides).

Document metadata for mobile app

Simple file type for mobile (e.g. "pdf", "zip") derived from file extension. Use this to decide how to open or display the file.

SHA256 checksum (Base64 encoded) for comparing local file with source Used to determine GREEN (matches) vs AMBER (differs) status indicators

Request for mobile delta sync

Response for mobile delta sync

DTO for Notification entity (FR-NOTIF).

Deep link URL (FR-NOTIF-004)

Target roles for notification delivery

Target user IDs for notification delivery

List of users who received the notification with their platform types

DTO for notification recipient information

Lightweight DTO for dropdown/select components - contains only ID and Name.

DTO for OccurrenceCategory entity - supports hierarchical categorization of occurrences.

DTO for hierarchical tree structure of occurrence categories with nested children.

Nested children categories for tree structure

DTO for Occurrence entity - safety/occurrence reporting.

Related files

Related categories

DTO for OccurrenceFile entity.

Lightweight DTO for dropdown/select components - contains only ID and Name.

DTO for OccurrenceReportType entity - classification types for safety occurrences.

Operator web dashboard for operator administrators (RoleAccountType.OperatorAdmin).

Provider / integration type (e.g. ClickHelp).

Computed health label for UI (e.g. Healthy, Degraded, Error, Inactive, Pending).

Display name for Occurrence.ReportedByUserId, when resolvable.

Active / inactive user counts for an operator (mobile app users).

DTO for OperatorContact entity - supports Contacts, Quick Calls, and Emergency contacts.

Contact type: Contact, QuickCall, or Emergency

Short label for Quick Call buttons (FR-QUICK-002)

Icon URL for Quick Call buttons

Grid position for Quick Call buttons (0-8 for 3x3 grid)

DTO for operator mobile dashboard counts.

Lightweight DTO for dropdown/select components - contains only ID and Name.

DTO for Operator entity - aviation operator/company.

When false, mobile users cannot download synced documents for this operator.

Resolved mobile tab labels (defaults applied when operator has no override).

DTO for OperatorEmergencyPlan entity (FR-EMERG-001). Emergency Response Plan content for operators.

Rich text/HTML content for the ERP section

URL to PDF document if ERP is file-based

DTO for OperatorFeature entity - feature flags for operators.

JSON feature value/configuration

DTO for OperatorLink entity (FR-LINK).

DTO for OperatorNews entity (FR-AUTH-023, FR-AUTH-024). News and announcements displayed on mobile app home screen.

Lightweight DTO for dropdown/select - ID and Name only.

DTO for PublicationCategory entity - categories for publications within an operator and integration.

When the list request includes roleId, count of non-deleted synced documents in this category for that operator and role (RoleDocumentAccess), with a publication category assigned.

Lightweight DTO for dropdown/select components - contains only ID and Name.

DTO for SubscriptionPlan entity - subscription tier definitions.

DTO for TrainingBulletin entity (FR-TRAIN).

Target roles for this training bulletin

DTO for TrainingUserStatus entity - tracks user acknowledgment of training bulletins.

Email delivery log details

DTO for Translation entity - localization strings.

Applies global tenant mapping configuration for all TenantEntity types This ensures consistent PascalCase TenantId property usage across all mappings

Default mobile tab labels and helpers to resolve effective labels from storage.

Used when no operator is resolved (e.g. token fallback).

Effective labels for API/token: null or empty stored values fall back to defaults (8th tab falls back to empty).

Computes success rate from sync logs. Excludes "Started" (in-progress) from the denominator. Treats "Cancelled" with "abandoned" in the message as success (benign cleanup when starting a new sync). Uses >= 95% for Connected so integrations with 19/20 or 20/20 success are not marked Degraded.

Activate a contact

Create a new contact.

Deactivate a contact

Delete a contact

Get contact by ID

Get contacts by type (Contact, Quick, Emergency)

Get paginated list of contacts with filtering

Get emergency contacts (FR-EMERG).

Get all operator contacts (Contact type)

Get quick call contacts for speed dial grid (FR-QUICK)

Update an existing contact

Create emergency content.

Delete emergency content.

Get emergency content by ID.

Get paginated list of emergency content.

When set, filters by active/inactive. Omit to return all.

Toggle emergency content IsActive (switch between active and inactive).

Update emergency content.

Activate a link

Create a new link

Deactivate a link

Delete a link

Get link by ID

Get links by category

Get paginated list of links

Update an existing link

Handler for paginated list of document integrations

Handler for sync logs list

Handler for folders list

Handler for synced documents list

Minutes after which a sync still in "Started" is considered abandoned and cleaned up before allowing a new trigger. Kept short so stuck/hung syncs don't block manual sync for hours.

Clean up abandoned sync logs for a specific integration (Status=Started and older than the window).

Comma-separated file types to sync (e.g. PDF,WebHelp,URL). Empty = sync all.

When set, only documents mapped to this Identity role id (via role–document access) are returned.

Loads a single DocumentIntegration by id and tenant. Does not include Folders, Documents, or SyncLogs to avoid a single huge JOIN that times out when an integration has many records. Use the dedicated paginated endpoints for folders (GetIntegrationFolders) and documents (GetSyncedDocuments) when needed.

Specification to check if an operator already has an active integration Used to enforce single integration per operator constraint

Loads all synced documents by a set of IDs for the given tenant. Used by bulk operations that update multiple documents at once.

Specification to get all active document integrations

Specification to get all document integrations that have auto-sync enabled (for bootstrap of per-integration recurring jobs). Implements IBypassTenantFilter to load across all tenants.

Specification to get Google Drive integrations that are ready for auto-sync This specification is used by background jobs that need to process all tenants Implements IBypassTenantFilter to bypass Finbuckle's automatic tenant filtering Includes Operator navigation property for better logging and context

Request to resume a failed or interrupted sync from checkpoint

Specification to get the latest checkpoint for a sync log

Request to assign a publication category to a synced document.

Bulk request to assign a publication category to multiple synced documents.

Document IDs to update.

Publication category ID to assign. Null clears the category.

Request to validate connection to a document source without saving

Request to validate an existing integration by ID

Handler to validate an existing integration's connection

Specification to get Jotform forms from database Handles all combinations of IsTraining and IsForm (true, false, null) If cacheCutoff is DateTime.MinValue, returns all forms regardless of LastSyncedAt If operatorId is provided and not Guid.Empty, filters by operatorId; otherwise returns all forms

Specification to get a Jotform form by external form ID and operator

Specification to get a Jotform form by external form ID only (for finding forms without operatorId)

Specification to get all Jotform forms that need syncing (older than specified time) for an operator

Specification to get Jotform forms with empty operatorId (for fallback when no forms found)

Specification to get all active Jotform integrations (for background jobs)

Request to download a document

Result of document download

Request to get delta sync for mobile

Derives simple file type (e.g. "pdf", "zip") from file name for mobile to know how to open/display the file.

Specification to get documents synced after a specific timestamp

Specification to get SyncedDocument with Integration navigation property for operator validation

Specification to get device sync state by user and device

Specification to get user document statuses

Request to get favorite documents for the current user

Specification to get favorite user document statuses

Specification to get documents by IDs for a specific operator

Response DTO for favorite documents

Request to mark a document as completed

Specification to get user document status

Request to mark a document as favorite

Request to enable or disable mobile access for a document

Send a support/contact email to tech@growing.aero.

Type of support/contact email.

Archive an occurrence. The user who reported the occurrence or an Admin can archive it.

Sends email notification to operator about new occurrence using professional template.

Specification to get occurrence categories by IDs

Specification to get occurrence report types by IDs

Delete an occurrence by ID.

Get occurrence details by ID.

Get paginated list of occurrences with filtering.

When set, filter by archived state. Only the reporting user can archive occurrences.

Ensures DateTime is in UTC format for PostgreSQL compatibility

Create a new occurrence category.

Delete an occurrence category.

Get paginated list of occurrence categories with filtering

Get occurrence category details by ID.

Get hierarchical tree of occurrence categories.

Get root occurrence categories (categories without parent ID) for dropdown

Update an occurrence category.

Get all active occurrence categories for dropdown/select components (ID and Name only).

When true, only returns categories that don't have a parent (root/parent categories only).

Submit an occurrence by ID.

Unarchive an occurrence. The user who reported the occurrence or an Admin can unarchive it.

Update an existing occurrence.

Set to true to archive, false to unarchive. Only the user who reported the occurrence can change this.

Create a new occurrence report type.

Delete an occurrence report type.

Get active occurrence report types only, ordered by sort order

Get occurrence report type by ID

Get active occurrence report types for dropdown/select components (ID and Name only).

Get paginated list of occurrence report types with filtering

Toggle the active status of an occurrence report type.

Update an existing occurrence report type.

Activate an operator.

Create a new operator.

When false, mobile users cannot download synced documents. Defaults to true.

Optional overrides for mobile app tab labels (fixed order). Omit to use defaults.

Deactivate an operator.

Delete an operator.

Get operator details by ID.

Request to get mobile dashboard counts for an operator.

Identity role id. When set, counts only documents mapped in RoleDocumentAccess for this role and operator.

Get all operators for dropdown/select components (ID and Name only).

Get paginated list of operators with filtering.

Specification to count contacts by operator ID (only Quick and Operator types, excluding Emergency).

Specification to count links by operator ID.

Specification to count documents by operator ID (through DocumentIntegration).

Counts synced documents for an operator that are explicitly allowed for the given Identity role (via RoleDocumentAccess).

Specification to count training Jotform forms (IsTraining = true) for a specific operator (and tenant).

Specification to count Jotform forms (IsForm = true, IsTraining = false) for a specific operator (and tenant).

Update an existing operator.

When set, updates whether mobile users can download synced documents for this operator.

Optional overrides for mobile app tab labels. Omit a field to leave unchanged; empty clears override (use default).

Create a new bulletin (PDF upload) for an operator.

Delete a bulletin and remove its file from storage.

Get a bulletin by ID.

Get paginated list of bulletins with filtering.

Keyword to filter bulletins by title (case-insensitive).

Toggle a bulletin's enabled state.

Update an existing bulletin (metadata and optionally replace PDF).

Create a new publication category.

Delete a publication category.

Get active publication categories for dropdown/select (ID and Name only).

Get paginated list of publication categories with filtering.

Identity role id. When set, each category includes for that operator and role.

Get publication category details by ID.

Gets other publication categories that are currently marked as default for the same operator and integration (optionally excluding one by id). Used to clear IsDefault on others when setting a single category as default.

Gets the default publication category for an integration (IsDefault = true). Used when syncing new documents to assign them to the default category.

Gets the default publication category for an operator (IsDefault = true). Used when assigning category by operator-level default.

Gets publication categories for a specific operator. Used as a fallback when no category is explicitly marked as default.

Update an existing publication category.

Create a new subscription plan.

Delete a subscription plan.

Get subscription plan details by ID.

Get all subscription plans for dropdown/select components (ID and Name only).

Get paginated list of subscription plans with filtering.

Update an existing subscription plan.

Service for synchronizing documents from external sources

Normalizes a DateTime to UTC for comparison with stored ExternalUpdatedAt (always UTC).

Returns true if the document matches the integration's AllowedFileTypes filter. When allowedFileTypes is null or empty, all documents are allowed. Values are comma-separated: extensions (e.g. PDF) match FileName or ContentType; "WebHelp" = ClickHelp WebHelp/PureHtml (HTML5 delivered as ZIP); "URL" = documents with DownloadUrl.

Returns true if contentType matches the given extension token (e.g. PDF -> application/pdf).

Processes files in batches (common logic for new and updated files)

Categorizes HTTP errors to determine error category and code

Check if the sync log has been cancelled and throw if so

Service for generating sequential occurrence report numbers per operator Thread-safe implementation ensuring unique sequential numbering

Specification for finding an operator's report sequence for a specific year