feat(core): make inner option of ThrottlingRequestManager optional

[harryautomazione]

Summary

Closes #4027

This PR makes the inner option of ThrottlingRequestManagerOptions optional (inner?: T). When omitted, ThrottlingRequestManager automatically opens and defaults to a standard RequestQueue via requestManagerOpener during #ensureSubManagers().

Changes

• ThrottlingRequestManagerOptions & Schema (packages/core/src/storages/throttling_request_manager.ts):
  • Made inner?: T optional in ThrottlingRequestManagerOptions.
  • Updated Zod validation schema throttlingRequestManagerOptionsSchema with inner: schemas.anyObject.optional().
• ThrottlingRequestManager:
  • Lazily initializes #inner in #ensureSubManagers() via await this.#requestManagerOpener(null, { configuration: this.config }) if options.inner was omitted.
  • Ensured thread-safety across all aggregation/forwarding methods (isEmpty, purge, #forEachManager, #sumOverManagers, #everyManager).
• Tests (test/core/storages/throttling_request_manager.test.ts):
  • Added unit test coverage verifying that ThrottlingRequestManager can be instantiated without inner and correctly routes and processes requests.

Checklist

• Code follows the style guidelines of Crawlee
• Self-review performed
• Unit tests added and passing

[B4nan]

heads up: the v4 branch was merged into master (v3 development moved to the 3.x branch), so I rebased this branch onto master and force-pushed it to your fork. Your commits are unchanged, just replayed on the new base. Before adding more changes, reset your local branch to the remote one (e.g. git fetch && git reset --hard @{u}), otherwise you'd reintroduce the old history.

[harryautomazione]

Thanks for the rebase @B4nan, I've synced the branch with master, updated the public API reports and resolved a relative import issue. All CI checks are green now.

[janbuchar]

Thanks @harryautomazione — and sorry, I've folded this into #4061 rather than asking you to rebase it.

That branch replaced #inner with a lazy factory (inner takes T | (() => T | Promise<T>), resolved once in #getInner()), so the this.#inner! / await this.#ensureSubManagers() pairs here land in code that no longer exists — a trial merge conflicts in 10 places in throttling_request_manager.ts, two of them inside isEmpty() / isFinished(), which are now a single checkReadiness(). On top of that branch the feature is a schema .optional(), inner?:, and one constructor branch defaulting the factory to the default queue, so rebasing this would have meant rewriting it.

Your RequestManagerOpener signature change went in as-is — a defaulted opener needs exactly that identifier?: string | StorageIdentifier | null. The zod (value: number) annotations I left out; master builds clean without them here, so if you are still hitting that error it is worth its own PR.

Closing as superseded by #4061, which closes #4027 with it.

[harryautomazione]

Thanks for the detailed explanation and for incorporating the opener signature changes into #4061, @janbuchar! Makes complete sense with the new checkReadiness() architecture.