deprecate everything in backend-tasks

Signed-off-by: Fredrik Adelöw <freben@gmail.com>

.changeset/calm-cars-serve.md

@@ -0,0 +1,5 @@
+---
+'@backstage/backend-tasks': patch
+---
+
+Marked all exports as deprecated and pointed at `@backstage/backend-plugin-api/scheduler` and `@backstage/backend-defaults/scheduler`

packages/backend-tasks/api-report.md

@@ -14,7 +14,7 @@ import { PluginDatabaseManager } from '@backstage/backend-common';
 // @public @deprecated
 export type HumanDuration = HumanDuration_2;
 
-// @public
+// @public @deprecated
 export interface PluginTaskScheduler {
   createScheduledTaskRunner(schedule: TaskScheduleDefinition): TaskRunner;
   getScheduledTasks(): Promise<TaskDescriptor[]>;
@@ -24,12 +24,12 @@ export interface PluginTaskScheduler {
   triggerTask(id: string): Promise<void>;
 }
 
-// @public
+// @public @deprecated
 export function readTaskScheduleDefinitionFromConfig(
   config: Config,
 ): TaskScheduleDefinition;
 
-// @public
+// @public @deprecated
 export type TaskDescriptor = {
   id: string;
   scope: 'global' | 'local';
@@ -38,24 +38,24 @@ export type TaskDescriptor = {
   } & JsonObject;
 };
 
-// @public
+// @public @deprecated
 export type TaskFunction =
   | ((abortSignal: AbortSignal) => void | Promise<void>)
   | (() => void | Promise<void>);
 
-// @public
+// @public @deprecated
 export interface TaskInvocationDefinition {
   fn: TaskFunction;
   id: string;
   signal?: AbortSignal;
 }
 
-// @public
+// @public @deprecated
 export interface TaskRunner {
   run(task: TaskInvocationDefinition): Promise<void>;
 }
 
-// @public
+// @public @deprecated
 export interface TaskScheduleDefinition {
   frequency:
     | {
@@ -68,7 +68,7 @@ export interface TaskScheduleDefinition {
   timeout: Duration | HumanDuration_2;
 }
 
-// @public
+// @public @deprecated
 export interface TaskScheduleDefinitionConfig {
   frequency:
     | {
@@ -81,7 +81,7 @@ export interface TaskScheduleDefinitionConfig {
   timeout: string | HumanDuration_2;
 }
 
-// @public
+// @public @deprecated
 export class TaskScheduler {
   constructor(
     databaseManager: LegacyRootDatabaseService,

packages/backend-tasks/src/deprecated.ts

@@ -23,3 +23,5 @@ import { HumanDuration as TypesHumanDuration } from '@backstage/types';
  * @deprecated Import from `@backstage/types` instead
  */
 export type HumanDuration = TypesHumanDuration;
+
+export * from './tasks';

packages/backend-tasks/src/index.ts

@@ -20,5 +20,4 @@
  * @packageDocumentation
  */
 
-export * from './tasks';
 export * from './deprecated';

packages/backend-tasks/src/tasks/TaskScheduler.ts

@@ -33,6 +33,7 @@ import { LoggerService } from '@backstage/backend-plugin-api';
  * Deals with the scheduling of distributed tasks.
  *
  * @public
+ * @deprecated Please migrate to the new backend system, and depend on `coreServices.scheduler` from  `@backstage/backend-plugin-api` instead. The new default implementation of this service lives in `@backstage/backend-defaults/scheduler`.
  */
 export class TaskScheduler {
   static fromConfig(

packages/backend-tasks/src/tasks/readTaskScheduleDefinitionFromConfig.ts

@@ -51,6 +51,7 @@ function readCronOrDuration(
  *
  * @param config - config for a TaskScheduleDefinition.
  * @public
+ * @deprecated Please import from `@backstage/backend-plugin-api/scheduler` instead
  */
 export function readTaskScheduleDefinitionFromConfig(
   config: Config,

packages/backend-tasks/src/tasks/types.ts

@@ -26,6 +26,7 @@ import { z } from 'zod';
  * processing should abort and return as quickly as possible.
  *
  * @public
+ * @deprecated Please import from `@backstage/backend-plugin-api/scheduler` instead
  */
 export type TaskFunction =
   | ((abortSignal: AbortSignal) => void | Promise<void>)
@@ -35,6 +36,7 @@ export type TaskFunction =
  * A semi-opaque type to describe an actively scheduled task.
  *
  * @public
+ * @deprecated Please import from `@backstage/backend-plugin-api/scheduler` instead
  */
 export type TaskDescriptor = {
   /**
@@ -57,6 +59,7 @@ export type TaskDescriptor = {
  * Options that control the scheduling of a task.
  *
  * @public
+ * @deprecated Please import from `@backstage/backend-plugin-api/scheduler` instead
  */
 export interface TaskScheduleDefinition {
   /**
@@ -154,6 +157,7 @@ export interface TaskScheduleDefinition {
  * that control the scheduling of a task.
  *
  * @public
+ * @deprecated Please import from `@backstage/backend-plugin-api/scheduler` instead
  */
 export interface TaskScheduleDefinitionConfig {
   /**
@@ -250,6 +254,7 @@ export interface TaskScheduleDefinitionConfig {
  * Options that apply to the invocation of a given task.
  *
  * @public
+ * @deprecated Please import from `@backstage/backend-plugin-api/scheduler` instead
  */
 export interface TaskInvocationDefinition {
   /**
@@ -273,6 +278,7 @@ export interface TaskInvocationDefinition {
  * A previously prepared task schedule, ready to be invoked.
  *
  * @public
+ * @deprecated Please import from `@backstage/backend-plugin-api/scheduler` instead
  */
 export interface TaskRunner {
   /**
@@ -287,6 +293,7 @@ export interface TaskRunner {
  * Deals with the scheduling of distributed tasks, for a given plugin.
  *
  * @public
+ * @deprecated Please use `SchedulerService` from `@backstage/backend-plugin-api/scheduler` instead
  */
 export interface PluginTaskScheduler {
   /**