@zhin.js/schedule-feature 1.1.15 → 1.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/schedule-feature",
-  "version": "1.1.15",
+  "version": "1.1.16",
   "description": "Generation-owned schedule Feature for Zhin Plugin Runtime",
   "type": "module",
   "main": "./lib/index.js",
@@ -12,12 +12,11 @@
     }
   },
   "files": [
-    "lib",
-    "src"
+    "lib"
   ],
   "dependencies": {
-    "@zhin.js/feature-kit": "1.1.15",
-    "@zhin.js/plugin-runtime": "1.1.23"
+    "@zhin.js/feature-kit": "1.1.16",
+    "@zhin.js/plugin-runtime": "1.2.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",

package/src/definition.ts

@@ -1,52 +0,0 @@
-import type { CapabilityContext } from '@zhin.js/feature-kit';
-
-/** Operation-scoped owner, configuration and resources; never persist this context. */
-export type ScheduleContext<TConfig = unknown> = CapabilityContext<TConfig>;
-
-export interface ScheduleDefinition<TConfig = unknown> {
-  readonly cron: string;
-  readonly description?: string;
-  execute(context: ScheduleContext<TConfig>): void | Promise<void>;
-}
-
-declare module '@zhin.js/plugin-runtime' {
-  interface PluginSetupContext<TConfig = unknown> {
-    addSchedule(localName: string, definition: ScheduleDefinition<TConfig>): void;
-  }
-}
-
-export type ScheduleDefiner<TConfig> = (
-  definition: ScheduleDefinition<TConfig>,
-) => Readonly<ScheduleDefinition<TConfig>>;
-
-export function defineSchedule<TConfig = unknown>(definition: ScheduleDefinition<TConfig>): Readonly<ScheduleDefinition<TConfig>> {
-  return parseScheduleDefinition<TConfig>(definition);
-}
-
-/**
- * Fix the plugin config type first, then define the schedule.
- */
-defineSchedule.withConfig = function withConfig<TConfig = unknown>(): ScheduleDefiner<TConfig> {
-  return (definition) => defineSchedule(definition);
-};
-
-export function parseScheduleDefinition<TConfig = unknown>(value: unknown): Readonly<ScheduleDefinition<TConfig>> {
-  if (!value || typeof value !== 'object') {
-    throw new TypeError('Schedule definition must be an object');
-  }
-  const definition = value as Partial<ScheduleDefinition<TConfig>>;
-  if (typeof definition.cron !== 'string' || definition.cron.trim() === '') {
-    throw new TypeError('Schedule definition requires a non-empty cron string');
-  }
-  if (typeof definition.execute !== 'function') {
-    throw new TypeError('Schedule definition requires execute()');
-  }
-  if (definition.description !== undefined && typeof definition.description !== 'string') {
-    throw new TypeError('Schedule definition description must be a string');
-  }
-  return Object.freeze({
-    cron: definition.cron,
-    ...(definition.description === undefined ? {} : { description: definition.description }),
-    execute: definition.execute,
-  });
-}

package/src/index.ts

@@ -1,4 +0,0 @@
-export { defineSchedule, parseScheduleDefinition } from './definition.js';
-export type { ScheduleDefinition, ScheduleContext } from './definition.js';
-export { ScheduleIndex } from './schedule-index.js';
-export { default, scheduleFeatureId } from './provider.js';

package/src/provider.ts

@@ -1,34 +0,0 @@
-import { featureId } from '@zhin.js/plugin-runtime';
-import { capture, captured, defineFeatureProvider, directoryModules } from '@zhin.js/feature-kit';
-import { parseScheduleDefinition } from './definition.js';
-import { ScheduleIndex } from './schedule-index.js';
-
-export const scheduleFeatureId = featureId('zhin.schedule');
-
-const scheduleFeature = defineFeatureProvider({
-  protocol: 1,
-  id: scheduleFeatureId,
-  authoring: {
-    setupMethod: 'addSchedule',
-    conventions: [directoryModules({
-      id: 'schedules-index',
-      layouts: [{ segments: ['schedules', capture('name')], localName: (values) => captured(values, 'name') }],
-    })],
-    validate: value => parseScheduleDefinition(value),
-  },
-  runtime: {
-    project(slots, context) {
-      const index = new ScheduleIndex(slots, context.snapshot);
-      return {
-        value: index,
-        dispose: () => index.stop(),
-        handoff: {
-          activateNext: () => index.start(),
-          deactivateNext: () => index.stop(),
-        },
-      };
-    },
-  },
-});
-
-export default scheduleFeature;

package/src/schedule-index.ts

@@ -1,70 +0,0 @@
-import {
-  scheduleHostToken,
-  stagePluginScheduleRegistration,
-  createGenerationAdmissionGate,
-  createPluginScheduleCandidate,
-  generationAdmissionSource,
-  scopeSetupFinalizer,
-  type CapabilitySlot,
-  type Dispose,
-  type PluginScheduleHost,
-  type RuntimeSnapshot,
-  type PluginId,
-} from '@zhin.js/plugin-runtime';
-import type { ScheduleDefinition } from './definition.js';
-import { createCapabilityContext } from '@zhin.js/feature-kit';
-
-export class ScheduleIndex {
-  readonly $projection = 'zhin.schedule-index/1' as const;
-  readonly #disposers: Dispose[] = [];
-  readonly #admission = createGenerationAdmissionGate();
-  readonly #hosts = new Map<PluginId, PluginScheduleHost>();
-  #started = false;
-
-  constructor(
-    private readonly slots: readonly Readonly<CapabilitySlot<ScheduleDefinition>>[],
-    private readonly snapshot: RuntimeSnapshot,
-  ) {}
-
-  start(): void {
-    if (this.#started) return;
-    this.#started = true;
-    try {
-      for (const slot of this.slots) {
-        const resources = this.snapshot.resources.get(slot.owner);
-        const host = resources?.get(scheduleHostToken.id) as PluginScheduleHost | undefined;
-        if (!host) throw new Error(`Schedule Host is unavailable for ${slot.owner}`);
-        let candidate = this.#hosts.get(slot.owner);
-        if (!candidate) {
-          candidate = createPluginScheduleCandidate(host, this.#admission);
-          this.#hosts.set(slot.owner, candidate);
-        }
-        this.#disposers.push(stagePluginScheduleRegistration(candidate, {
-          id: slot.localName,
-          cron: slot.definition.cron,
-          description: slot.definition.description,
-          execute: () => slot.definition.execute(createCapabilityContext({ snapshot: this.snapshot, ownerId: slot.owner, admission: this.#admission })),
-        }));
-      }
-    } catch (error) {
-      const cleanupErrors: unknown[] = [];
-      try { this.stop(); } catch (cleanupError) { cleanupErrors.push(cleanupError); }
-      if (cleanupErrors.length > 0) throw new AggregateError([error, ...cleanupErrors], 'Schedule activation and cleanup both failed', { cause: error });
-      throw error;
-    }
-  }
-
-  stop(): void {
-    const errors: unknown[] = [];
-    for (const dispose of this.#disposers.splice(0).reverse()) {
-      try { dispose(); } catch (error) { errors.push(error); }
-    }
-    for (const host of this.#hosts.values()) host[scopeSetupFinalizer]('dispose');
-    this.#hosts.clear();
-    this.#started = false;
-    if (errors.length > 0) throw new AggregateError(errors, 'Schedule cleanup failed');
-  }
-
-  /** @internal Candidate callbacks only enter after their projection is published. */
-  get [generationAdmissionSource]() { return [this.#admission]; }
-}