Deprecated API
Remove the external assert export from @fluidframework/core-utils. This API is available from the package's default and /legacy entry points.
Context
The API is intended only for Fluid Framework client code. An external export creates an API support commitment for functionality that external consumers must not use. PR #28080 deprecates the external export and keeps a non-deprecated API at @fluidframework/core-utils/internal for Fluid Framework repository code.
This issue supersedes #28083, which specified the incorrect removal version.
Approach
Remove the external assert export in version 3.10.0. Keep the internal export for Fluid Framework repository code. External consumers must use an assertion utility that is appropriate for their application or throw an Error directly.
Dependencies
Compatibility Concerns
This removal is a compile-time breaking change for consumers that import assert from @fluidframework/core-utils or @fluidframework/core-utils/legacy. It does not change persisted data, loader compatibility, or runtime compatibility. Fluid Framework repository code can continue to import assert from @fluidframework/core-utils/internal.
Phases
Expected Timeline
Remove the API in version 3.10.0.
Open Questions
None.
Deprecated API
Remove the external
assertexport from@fluidframework/core-utils. This API is available from the package's default and/legacyentry points.Context
The API is intended only for Fluid Framework client code. An external export creates an API support commitment for functionality that external consumers must not use. PR #28080 deprecates the external export and keeps a non-deprecated API at
@fluidframework/core-utils/internalfor Fluid Framework repository code.This issue supersedes #28083, which specified the incorrect removal version.
Approach
Remove the external
assertexport in version 3.10.0. Keep the internal export for Fluid Framework repository code. External consumers must use an assertion utility that is appropriate for their application or throw anErrordirectly.Dependencies
assertfor external use #28080 in version 3.0.0.Compatibility Concerns
This removal is a compile-time breaking change for consumers that import
assertfrom@fluidframework/core-utilsor@fluidframework/core-utils/legacy. It does not change persisted data, loader compatibility, or runtime compatibility. Fluid Framework repository code can continue to importassertfrom@fluidframework/core-utils/internal.Phases
test/breaks/client/3.10.0/branch.Expected Timeline
Remove the API in version 3.10.0.
Open Questions
None.