refactor app management client to prepare for new BP mutation

[gordonhirsch]

WHY are these changes introduced?

This Refactor/cleanup of the business platform interface allows the addition of new BP calls in the future and makes the existing code clearer.

WHAT is this pull request doing?

This PR renames the encodedGidFromId function to encodedGidFromOrganizationId to make its purpose more explicit and to make room for encoding other id types in the future.

Additionally, it updates the type signature for businessPlatformOrganizationsRequestDoc to properly handle generic variables, improving type safety. This makes it consistent with other *RequestDoc functions and seems to allow proper usage with mutations.

How to test your changes?

Run the existing test suite to ensure all tests pass with the renamed function. It was not necessary to add new test.

Measuring impact

How do we know this change was effective? Please choose one:

• n/a - this doesn't need measurement, e.g. a linting rule or a bug-fix

Checklist

• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've considered possible documentation changes

[gordonhirsch]

• Provision user access to stores only when permitted #5596
• refactor store fetch, remove dead code #5597
• Ensure user access to selected dev stores #5531
• Add BP mutation to ensure access to a dev store #5530
• refactor app management client to prepare for new BP mutation #5529 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟡	Statements	76.62% (+0.01% 🔼)	9410/12282
🟡	Branches	71.79% (+0.02% 🔼)	4611/6423
🟡	Functions	76.38%	2444/3200
🟡	Lines	77.12% (+0.01% 🔼)	8894/11532

Test suite run success

2169 tests passing in 950 suites.

Report generated by 🧪jest coverage report action from 6f7f603

[github-actions]

Differences in type declarations

We detected differences in the type declarations generated by Typescript for this branch compared to the baseline ('main' branch). Please, review them to ensure they are backward-compatible. Here are some important things to keep in mind:

• Some seemingly private modules might be re-exported through public modules.
• If the branch is behind main you might see odd diffs, rebase main into this branch.

New type declarations

We found no new type declarations in this PR

Existing type declarations

packages/cli-kit/dist/public/node/api/business-platform.d.ts

@@ -40,6 +40,6 @@ export declare function businessPlatformOrganizationsRequest<T>(query: string, t
  * @param variables - GraphQL variables to pass to the query.
  * @returns The response of the query of generic type <T>.
  */
-export declare function businessPlatformOrganizationsRequestDoc<TResult>(query: TypedDocumentNode<TResult, GraphQLVariables> | TypedDocumentNode<TResult, Exact<{
+export declare function businessPlatformOrganizationsRequestDoc<TResult, TVariables extends Variables>(query: TypedDocumentNode<TResult, TVariables> | TypedDocumentNode<TResult, Exact<{
     [key: string]: never;
-}>>, token: string, organizationId: string, variables?: GraphQLVariables): Promise<TResult>;
\ No newline at end of file
+}>>, token: string, organizationId: string, variables?: TVariables): Promise<TResult>;
\ No newline at end of file