layrz_models

📋 Release Notes

This release includes the following changes:

🐛 Bug Fixes

• addBrickhouseUser query name (7718935 by @LuisReyes98)
• edit brickhouse user gql name (d06cd4d by @LuisReyes98)
• updates to User gql fragment , and gql brickhouseUsers naming convention (612414b by @LuisReyes98)
• _getGqlQueryName for brickhouseUsers (ea1569f by @LuisReyes98)

📊 Diff Stats

_{🤖 Auto-generated by changelog workflow}

• Updated the User gql fragment, and gql brickhouseUsers naming convention

📋 Release Notes

This release includes the following changes:

✨ Features

• Update icon handling to use MdiRemapIcon and remove LayrzIcons dependency (c5dea8c by @PHKenny)

🐛 Bug Fixes

• update avatar tests to correct base64 and icon values (59a5deb by @PHKenny)

📊 Diff Stats

_{🤖 Auto-generated by changelog workflow}

• Fully removal of layrz_icons in favor of flutter_material_design_icons
• layrz_sdk version dump

📋 Release Notes

This release includes the following changes:

✨ Features

• add AtsCfSkidModel enum for terminal SKID reception (ATSPV2-1294) (58721e4 by @mask-03)

📊 Diff Stats

_{🤖 Auto-generated by changelog workflow}

• Added AtsCfSkidModel (none/sil), the enum backing the new ats.custom.skid.model fixed custom field on Terminal assets (kindId 44) that lets ATS Mobile know whether — and with which equipment brand — a terminal receives product via SKID before routing it through the SIL integration. Follows the same manual toJson/fromJson/getLocaleKey pattern as AtsCfFuelType; unlike it, fromJson falls back to none instead of throwing, since the value comes from a custom field that may be empty or hold stale data.

📋 Release Notes

This release includes the following changes:

✨ Features

• rework SIL SKID models to match backend contract and add response entities (40c0ec5 by @ManuelRomeroA)

📊 Diff Stats

_{🤖 Auto-generated by changelog workflow}

• Reworked the SIL SKID reception models to match the backend createSilUnloadingOrder contract 1:1, and moved them to a dedicated src/ats/src/sil/ folder.
  • Renamed (breaking vs. 3.28.0): AtsSilInput → AtsSilUnloadingOrderInput, AtsSilCarreta → AtsSilTrailerInput, AtsSilCompartimento → AtsSilCompartmentInput. Fields are now English and aligned with the backend SilUnloadingOrderInput: numRef → operationId (the backend derives SIL Num_Ref from the operation, so the client sends the operation id), nomeMotorista/rgMotorista/cpfMotorista → driverName/driverRg/driverCpf, placaCavalo → truckPlate, carretas → trailers, corDoVeiculo → vehicleColor, possuiDnit → hasDnit, lacres → seals; trailer placaCarreta → trailerPlate, compartimentos → compartments; compartment numCompart → compartmentNumber, volDescarga (now int, backend requires an integer) → dischargeVolume, produto → productCode.
  • Added response entities for the mutation result: AtsSilUnloadingOrder (reuses the existing AtsOperation), AtsSilTrailer, AtsSilCompartment and its certified AtsSilCompartmentResult, plus the AtsSilUnloadingOrderStatus enum (pending/sent/sendFailed/completed).

📋 Release Notes

This release includes the following changes:

✨ Features

• add SIL SKID reception input models and remittance-sale CFOPs (ff2dfd5 by @ManuelRomeroA)

📊 Diff Stats

_{🤖 Auto-generated by changelog workflow}

• Added AtsSilInput, AtsSilCarreta and AtsSilCompartimento — the payload collected in ATS Mobile for the SKID reception flow and forwarded to the SIL integration. Fields use camelCase (GraphQL convention); the backend maps them to SIL's snake_case keys. Every field is nullable (obligatoriness is enforced by the backend). AtsSilInput/AtsSilCarreta expose a private constructor that seeds their nested lists as growable and with one initial row, so consumers can add/remove without hitting an unmodifiable list.
• Added CFOP codes 5923 and 6923 to AtsPurchaseOrderCategoriesEntity.cfop, mapping them to AtsPurchaseOrderCategoriesEntity.remittanceSale.

📋 Release Notes

This release includes the following changes:

🐛 Bug Fixes

• honour useFragment and extraFields in DeviceCommand.fetchAll (d4e14e0 by Jose Prieto, Claude Sonnet 4.6)

📊 Diff Stats

_{🤖 Auto-generated by changelog workflow}

• Corrected DeviceCommand.fetchAll(), which documented useFragment and extraFields but honoured neither: the result selection was hardcoded to id, name, source, isGlobal, protocol and model, so callers asking for the full fragment never received data, deviceId, protocolId, modelId, payload, modbusParameter or access. Consumers could not execute a fetched command over BLE, since its definition and payload live in data

📋 Release Notes

This release includes the following changes:

• No changes detected

📊 Diff Stats

_{🤖 Auto-generated by changelog workflow}

• Removed @Deprecated decorator in favor of backwards compatibility and prevent issues on CI until layrz_sdk is completed.

📋 Release Notes

This release includes the following changes:

✨ Features

• update LayrzAppLocalizationsDelegate to use LayrzAppLocalizations and enhance localization support (4e047f3 by @PHKenny)

🐛 Bug Fixes

• return LayrzAppLocalizationsDelegate from delegate() and bump to 3.27.1 (36badb1 by @ManuelRomeroA)

📊 Diff Stats

_{🤖 Auto-generated by changelog workflow}

• Fixed LayrzAppLocalizations.delegate() to return a LayrzAppLocalizationsDelegate (typed to LayrzAppLocalizations) instead of a LayrzI18nDelegate. The wrong delegate type registered a LayrzI18n in the widget tree, so LayrzAppLocalizations.of(context) never resolved and threw LayrzAppLocalizations was used before it was initialized — breaking any consumer (e.g. layrz_session's login) that still looks up LayrzAppLocalizations. Restored the LayrzAppLocalizationsDelegate class that plants the correct type.

📋 Release Notes

This release includes the following changes:

✨ Features

• replace LayrzAppLocalizations with LayrzI18n in fix_data.yaml (f84a8c3 by @PHKenny)
• replace LayrzAppLocalizationsDelegate with LayrzI18nDelegate and remove deprecated class (a2e96c6 by @PHKenny)
• refactor LayrzAppLocalizations to extend LayrzI18n and remove native/web detection files (d1dd44f by @PHKenny)
• un-deprecate LayrzAppLocalizations for ecosystem coexistence (5fc8fdf by @ManuelRomeroA)

🐛 Bug Fixes

• remove unused debugCheckHasLayrzI18n import (0a12aa8 by @PHKenny)

📊 Diff Stats

_{🤖 Auto-generated by changelog workflow}

• Removed the @Deprecated annotation from LayrzAppLocalizations. The 3.26.0 deprecation (in favor of LayrzI18n from package:layrz_i18n) was premature: layrz_theme and many ecosystem widgets still consume LayrzAppLocalizations, and both localization engines are meant to coexist during the migration. The class is supported again; LayrzI18n remains the recommended API for new code.

📋 Release Notes

This release includes the following changes:

🐛 Bug Fixes

• pass ids to deleteDeviceCommands, add FirmwareBuild.fragment and firmwares on Model.fragment (94f8fd7 by Jose Prieto, Claude Sonnet 4.6)

📊 Diff Stats

_{🤖 Auto-generated by changelog workflow}

• Corrected DeviceCommand.delete() and DeviceCommand.deleteMany(), the deleteDeviceCommands field now receives the ids argument. Without it the declared $ids variable went unused and the request failed GraphQL validation with a 400, so nothing was ever deleted
• Added FirmwareBuild.fragment
• Added firmwares to Model.fragment, using FirmwareBuild.fragment

• Migrated core user, authentication, and i18n types from layrz_models to layrz_sdk, with re-exports so consumers keep seeing them: Avatar, Department, Employee, Token, UserPreferences, I18nKey, I18nTranslation, Language, ApiResponse.
• Migrated API and GraphQL utilities to layrz_sdk: LayrzConnector, LayrzApiExtras, StandardResponse, Gql, GqlQuery, GqlMutation, GqlSubscription, and related types.
• Migrated all JSON converters to layrz_sdk: ColorConverter, IconConverter, DurationConverter, TimestampConverter, DateConverter, RegExpConverter, ByteListConverter, TimeOfDayConverter, DynamicMapConverter, ParamDataMapConverter and their nullable variants.
• Breaking: TimeOfDay is deliberately hidden from the layrz_sdk re-export to preserve Flutter's TimeOfDay resolution; code annotating Flutter TimeOfDay fields with TimeOfDayConverter must switch to the locally retained FlutterTimeOfDayConverter.
• Migrated all six enums to layrz_sdk — ApiStatus, AppPlatform, AvatarType, ColorblindMode, MfaMethod and TokenAudience — re-exported so consumers see no change.
• Breaking: The localization engine moved to the layrz_i18n package; LayrzAppLocalizations is now @Deprecated in favor of LayrzI18n from package:layrz_i18n/layrz_i18n.dart.
• Added a dart fix migration that renames LayrzAppLocalizations to LayrzI18n, but the fix does NOT add the import—run dart fix --apply and manually add import 'package:layrz_i18n/layrz_i18n.dart';.
• Asset.mappitLaborStartTime and Asset.mappitLaborEndTime keep their Flutter TimeOfDay type, with no behavior changes for consumers.
• Adds dependencies: layrz_sdk: ^4.4.3 and layrz_i18n: ^1.0.1.

• Corrected CommandInput.save(), the status/errors/result selection now hangs off the addDeviceCommand/editDeviceCommand mutation field instead of the mutation root
• Corrected DeviceCommand.execute(), the mutation field is executeDeviceCommand and not deviceCommands
• Corrected Device.zigbeePermitJoinExpiresAt, removed the snake_case JsonKey that never matched the fragment field and always decoded to null
• Corrected Device.delete(), Device.deleteMany() and Device.importDevicesIntoApp() to be sent as mutations, plus the field is importDevicesIntoApp and not importDevicesToApp
• Added InboundProtocol.detailedFragment, which is fragment plus the protocol's models, and used it on InboundProtocol.fetch()

• Added saleFromThirdPartyDeliveredBySeller value to AtsPurchaseOrderCategoriesEntity enum (SALE_FROM_THIRD_PARTY_DELIVERED_BY_SELLER, CFOP 5120/6120), so it no longer falls back to notDefined.

• Added hasPreviousStockClosing value in StockClosingInfoPa model

• Added StockClosingInfoPa model
• Added totalWithdrawalsByComboio value in StockClosingTank and StockClosingInput models

• Fixes on RegisteredApp.load()
• This version was released manually

• Fixes on ZigbeeDeviceExpose and ZigbeeDevice
• Corrected FlespiSubmoduleConfig, wrong type and fields on GraphQL fragment
• This version was released manually

• Forgot to do the freezed
• This version was released manually

• Corrected lastSeen on ZigbeeDevice to have a converter.
• This version was released manually

• Added an API connector to ExternalAccount, with fetch(), fetchAll() and deleteMany(), plus ExternalAccountInput.save()
• Added ExternalAccountVariant to target the Mappit-prefixed fields, defaulting to standard
• Added ExternalAccount.gqlFragment, so consumers no longer need to declare the fragment themselves
• Geofence now requests the errors field on every API call and logs its content whenever the response status is not OK, matching Action, Operation and ExternalAccount

• Added onlyConfiot argument on Device.fetchAll() to include it in the GraphQL query and variables, allowing callers to filter devices that have Confiot enabled.
• This version was released manually

• Device, DeviceCommand, DeviceTelemetry and other models related to device entity now use the LayrzConnector.query() and LayrzConnector.mutate().

• Added API Connector on DeviceCommand
• Standarized all tupled returns to StandardResponse<T>

• Added API connector for InboundProtocol, Model, FlespiProtocol, FlespiModel and FlespiChannel

• Updated layrz_logging dependency to now include colors on logs emitted by the system
• This version was released manually

• Added LayrzApiExtras to include extra information on the usage of LayrzConnector, including version and name of the app.
• This version was released manually

• Adjustments on User.fetch() to include parentId.
• This version was released manually

• Adjustments on RegisteredApp.load() to use the toJson() on enums
• This version was released manually

• Fixed User loginAsSubaccount gql mutation implementation

• Fixed Brickhouse Graphql query name in _getGqlQueryName

• Fixed GraphQL fragment emission order. Fragments were collected in pre-order, so a fragment that spread another was written above the fragment it depended on, producing documents where a fragment is referenced before it is defined. Nested dependencies are now emitted first, and cyclic fragment references are broken safely instead of overflowing the stack.
• Added fragment getters to TagOnStudent, TagOnBusRoute and TagOnNotification.
• Added API connectors for the TagOn entities with fetchAll, fetch and deleteMultiple on the models, and save on the existing TagOnStudentInput, TagOnBusRouteInput and TagOnNotificationInput models.
• Added TagOnStudent.bulkLoad for bulk importing students from raw data rows. The data parameter is List<Map<String, dynamic>> (raw rows), not the typed TagOnStudentInput model, because the bulk endpoint resolves bus routes by name from nested objects in the raw data (e.g., {'busRoute': {'name': 'Route 4'}}), whereas TagOnStudentInput only has a flat busRouteId. Returns (ApiStatus, Map<String, dynamic>?) where the map has exactly three keys: 'status' (the serialized ApiStatus), 'errors' and 'studentsWithErrors' (a List<Map<String, dynamic>>, each entry holding errors and data for a row that failed to import).
• Added TagOnStudent.export to export students to a downloadable file, returning (ApiStatus, String?) with the generated resultUri.
• Added TagOnNotification.send static method to send a notification by its ID.
• All TagOn API connectors (TagOnStudent, TagOnBusRoute, TagOnNotification) authenticate via the Authorization: LayrzToken <token> header that LayrzConnector sets automatically. Authentication is no longer sent as a GraphQL field argument. The apiToken parameter remains on every method signature for consistency.

• Breaking: Renamed MappitReportInputMulti to MappitReportMultiInput to match the backend GraphQL schema, which renamed the input type. Queries declaring MappitReportInputMulti are rejected by the server with Unknown type 'MappitReportInputMulti'. The source file was also renamed from report_input_multi.dart to report_multi_input.dart. Field names and types are unchanged.
• Fixed the $id variable type in Geofence.fetch, which was declared as String! instead of ID!, causing the server to reject the query with Variable $id of type String! used in position expecting type ID.
• Fixed Geofence.fetchAll, which ignored the variant argument and always queried the geofences field, and referenced an undeclared $id variable in its arguments, making the query invalid for every variant.
• Removed the apiToken GraphQL variable and argument from every caller in the geofences module (Geofence, GeofenceInput and SearchItem). Authentication travels in the Authorization header, which LayrzConnector already sets, so sending it as a query variable was redundant. The apiToken parameter remains on every method signature.

• Updated Geofence.fetch, Geofence.fetchAll, Geofence.save and Geofence.deleteMultiple to accept a variant argument (standard, mappit, sdm) to resolve the query/mutation names and fragments per variant, aligning with the backend GraphQL schema.

• Fixed Geofence.fragment, removed name on telemetry subgraph

• Added SdmPenInput, SdmIngredientInput, SdmOperatorInput and SdmRecipeInput unfreezed input models for the SDM entities.
• Added fragment getters to SdmPen, SdmIngredient, SdmOperator and SdmRecipe.
• Added API connectors for the SDM entities with fetchAll, fetch, deleteMultiple and save (on the input models).
• Added bulk operations to SdmPen, SdmIngredient and SdmRecipe: bulkLoad, export and formatExcel, returning the generated resultUri where applicable.
• Added UserVariant enum (standard, ats, atsAdmin, brickhouse, sdm, tagon and the mappit* variants) to drive user queries and mutations from a single source of truth.
• Added variant-aware API connectors to User: fetchAll, fetch, deleteMultiple and save (on UserInput), resolving the query, mutation and input type names per variant, with optional appId, languageId and mappitModule arguments.
• Added User.fragment(variant:) covering access, referencesIds, categoryId, tagsIds plus the variant-specific fields, and a withDetails option on User.fetch for the tags, references, category and allowedApps expansions.
• Added account action connectors to User: importIntoApp, resetPassword, setPaymentWarning, lock, suspend, invite and requestActivityReport.
• Migrated User.fetchAll and User.fetchAllForAppUsers to the typed connector.query API; fetchAllForAppUsers remains locked to the standard variant by design.
• Added ReferenceVariant enum (standard, mappit, sdm) and ReferenceInput input model.
• Added variant-aware API connectors to Reference: fragment(variant:), fetchAll, fetch, clone, deleteMultiple and save (on ReferenceInput).
• New GqlVariableType.unix for GraphQL Unix timestamp variables.
• Added ReferenceVariant enum (standard, mappit, sdm) to drive reference queries and mutations from a single source of truth.
• Added variant-aware API connectors to Reference: fetchAll, fetch, deleteMultiple and save (on ReferenceInput), resolving the query, mutation and input type names per variant — references/mappitReferences/sdmReferences for queries, and add/edit/delete mutations with the Mappit and Sdm infixes.
• Added Reference.fragment(variant:) covering id, name, category, customFields, qrCode and access, reusing CustomField.fragment and Access.idFragment.
• Added Reference.clone, which uses the cloneReference mutation for every variant.

• Updated Gql to now auto-include name from the next field in the query or mutation if no name is provided, ensuring that all GraphQL operations have a valid name for better debugging and logging.

• New GqlVariableType.enum_() factory for GraphQL enum variables, allowing type-safe enum variable declarations in queries and mutations.
• Corrected RegisteredApp.load() to fix the platform and technology fields to be their respective enums AppPlatform and AppTechnology instead of plain strings, ensuring proper type safety and deserialization.

• Added API connector for Geofence with full GraphQL support (fetch, fetchAll, save, delete, exportMany).
• Added API connector for GeofenceInput with full GraphQL support (save).

• Fixed an issue on AvailableApp.fetchAll() where the apiToken variable was not being passed to the GraphQL query, resulting in an empty response. The query now correctly includes the apiToken argument.

• Corrected Fragment names on AppFont.fragment and InstanceDns.fragment to match the GraphQL schema types (AppFont and InstanceDns) instead of the previous incorrect names (FontInformation and DnsConfiguration).

• Fixed an issue with the API connector RegisteredApp.fechAll

• LayrzConnector now exposes typed query() and mutate() methods returning a decoded ApiResponse with status, errors and result
• RegisteredApp.registerWithoutCustomization(), registerWithCustomization() and edit() now return (ApiStatus, Map<String, dynamic>?, RegisteredApp?) records with the operation status, field errors and decoded result
• AppInstance, PushDevice and AvailableApp API callers migrated to the typed connector API
• Fixed registerWithCustomization() reporting INTERNAL_ERROR on successful responses

• Added API connectors for Country, RegisteredApp and AvailableApp

• Add new value REMITTANCE_SALE in enum AtsPurchaseOrderCategoriesEntity

• Add PushDevice model with validate() API caller to check device registration status on the backend and retrieve associated operation IDs
• Add PushDevice.register() to register a new push device for an app and retrieve the created device ID
• Add PushDevice.bindOperations() to bind or unbind a list of operations to a push device
• Add PushDevice.deregister() to deregister a push device by its ID

• Fix Operation GraphQL fragment: query accountId instead of externalAccountId, remove unexposed emailTemplateId, align access sub-selection with AccessPermission schema (id, read, write, manage, objectId, userId, module)
• Add appId argument to Operation.fetch() to filter operations by app
• Slim Operation.fetchAll() result selection to id, name, operationType
• Invoke onResponse only on error responses across RegisteredApp and Operation API callers
• Parse OperationInput.save() result as a single object

• Fixes on Registered Apps import modules

• Expanded Operation.gqlFragment to cover the full operation configuration (webhook, email, SMS/Twilio, push, in-app fields) so Operation.fetch/fetchAll return complete data.
• Added RegisteredApp lifecycle callers (registerWithoutCustomization, registerWithCustomization, edit, delete) and completed app management coverage.
• Added User.fetchAllForAppUsers for app user management contexts (includes username and email fields).
• Add tolerant API status parsing accepting both legacy (NOTFOUND) and modern (NOT_FOUND) backend status formats
  • ApiStatus.fromJson() now handles both underscore-separated (e.g., 'NOT_FOUND', 'INTERNAL_ERROR') and legacy squashed (e.g., 'NOTFOUND', 'INTERNALERROR') formats through case-insensitive normalization.

• PushSecrets model; RegisteredApp iosPushSecrets/androidPushSecrets (typed) and hasSvcPushSecrets (boolean status).
• Operation/OperationInput appId for app-bound PUSH_NOTIFICATION operations.
• App management API callers on RegisteredApp (fetch, setPushSecrets, access grant/revoke, asset/device import), AppInstance (deprecate/migrate/request), User (loginAs).
• Operations API callers (fetch, fetchAll, save, delete).
• GqlVariableType redesigned as a composable type builder (list(of:, isRequired:)/input(of:)); GqlVariable simplified.

• Made performedBy nullable (User?) in MappitRouteLinkingHistory. When an employee is removed, the relation is soft-deleted and the backend sends performedBy: null for historical records, while performedById still holds the plain ID. The previous non-nullable declaration crashed fromJson with type 'Null' is not a subtype of type 'Map<String, dynamic>'. This aligns performedBy with the already-nullable currentSeller field.

• Added constant.number value to AtsStreamExitStructureType enum, a sibling of constant for ATAK outbound structure entries whose value should be sent as a real JSON number instead of a string.

• Added ActionType.zigbeeChange (ZIGBEE_CHANGE) plus the ActionZigbeeSetting, ActionZigbeeSettings and ActionZigbeeSettingsInput models, with a new zigbeeSettings field on Action and ActionInput.
• Added API callers Action.fetch, Action.fetchAll, Action.deleteMultiple and ActionInput.save, following the GqlQuery builder pattern.
• Added Device.fetchZigbeeCapable, returning the devices that have Zigbee exposes bound to them (id, name, ident and exposes).
• The Action, Device and User callers no longer send the apiToken GraphQL argument — authentication relies on the Authorization: LayrzToken header; requires a layrz-api deployment with the dual-auth actions, devices and users endpoints.

• Changed vgNavio value type from int to String in CaclTFBDetails and CaclTFBDetailsInput models

• Added AssetWidget, AssetWidgetConfig, and AssetWidgetRange models (with matching input variants) plus a read-only widgets field on Asset, backing the per-asset live-data widgets feature. Writes go through the dedicated updateAssetWidgets mutation, not the asset model.
• Added NUMERIC and LINE_CHART values to the RenderWidget enum.
• LayrzConnector now requires an apiToken and injects an Authorization: LayrzToken {token} header on every request and subscription, migrating authentication off the GraphQL apiToken variable.

• Breaking: Fixed null icon handling in WorkspaceInput.fromJson. Previously, workspaces with no icon set would crash with a Null check operator used on a null value error during JSON deserialization. The icon field now falls back to solarOutlineQuestionSquare when null. This is a breaking change because any workspace that had a null icon will now render with the default icon instead of its previously expected icon — verify your workspace icon assignments.

• Added numericSlider, enumSelector, textCommand and rawValue values to RenderWidget enum.
• Added receptionAssetId (String?) field to AtsPurchaseOrder model.

• Added StockClosingGeneralInfo new model
• Updated StockClosing, StockClosingInput, StockClosingTank and StockClosingTankInput with new values openingBalanceAmbient, totalEntriesAmbient, totalWithdrawalsAmbient and closingBalanceAmbient

• Added json and json.array values to AtsStreamExitStructureType enum, allowing ATAK outbound services to nest a group of structure fields into a single JSON object or a single-element JSON array.
• Added attendant.id and attendant.user.id values to AtsStreamExitStructureType enum.
• Added source (String?) and nested (List<OutboundStructureInput>/List<OutboundStructure>) fields to OutboundStructureInput and OutboundStructure models, to support the new json/json.array structure types.

• Fixed issue on Token.create where duration variable was being sent as int instead of Duration type, causing GraphQL validation errors. Now, the duration variable is correctly sent as a Duration type in seconds.

• Added finalStop value in CaclTFBDetails model
• Added AtsCaclAsset model