@revoengine/cli 1.0.10 → 1.0.11

package/dist/src/resource-syncs/schedule-sync.d.ts

@@ -0,0 +1,111 @@
+import type { RevoClient } from '../client.ts';
+export declare const SCHEDULES_DIRECTORY = "Schedules";
+export declare const SCHEDULE_MANIFEST_FILE = "schedule.json";
+export type JobTemplateScheduleTarget = {
+    type: 'JOB_TEMPLATE';
+    jobTemplateStableKey: string;
+};
+export type MaterializedViewScheduleTarget = {
+    type: 'MATERIALIZED_VIEW';
+    databaseViewStableKey: string;
+    refreshMode: 'CONCURRENT' | 'BLOCKING';
+};
+export type ScheduleTarget = JobTemplateScheduleTarget | MaterializedViewScheduleTarget;
+export type ScheduleManifest = {
+    kind: 'schedule';
+    stableKey: string;
+    name: string;
+    category?: string | null;
+    description?: string;
+    metadata: Record<string, unknown>;
+    cron: string;
+    timezone: string;
+    target: ScheduleTarget;
+    /** Retained for operator context only. It is never used in a target write. */
+    sourceTargetConfig?: Record<string, unknown> | null;
+    /** Source active state, intentionally editable before a later activation phase. */
+    activationCandidate: boolean;
+};
+export type SchedulePullWarning = {
+    stableKey: string;
+    reason: string;
+};
+export type SchedulePullResult = {
+    pulled: Array<{
+        manifest: ScheduleManifest;
+        targetPath: string;
+    }>;
+    warnings: SchedulePullWarning[];
+};
+export type SchedulePlanStatus = 'clean' | 'create' | 'safe-update' | 'remote-changed' | 'conflict' | 'missing-lock' | 'orphan' | 'collision' | 'skipped';
+export type SchedulePlanItem = {
+    status: SchedulePlanStatus;
+    stableKey?: string;
+    name: string;
+    reason?: string;
+    changedFields?: string[];
+    desiredHash?: string;
+    currentHash?: string;
+    baselineHash?: string;
+    jobTemplateStableKey?: string;
+    databaseViewStableKey?: string;
+};
+export type SchedulesPlan = {
+    resourceType: 'schedule';
+    env: string;
+    counts: Record<SchedulePlanStatus, number>;
+    blockers: string[];
+    warnings: string[];
+    items: SchedulePlanItem[];
+    exclusions: string[];
+};
+export type SchedulePushResult = {
+    stableKey: string;
+    action: 'create' | 'update' | 'noop' | 'orphan' | 'skipped' | 'activate';
+    status: 'deployed' | 'skipped' | 'failed';
+    targetPath: string;
+    reason?: string;
+    error?: string;
+};
+export type VerifiedScheduleActivation = {
+    stableKey: string;
+    scheduleId: string;
+    targetPath: string;
+    stableKeyName: string;
+    targetId: string;
+    target: ScheduleTarget;
+};
+export declare function scheduleManifestPath(workspaceRoot: string, manifest: ScheduleManifest): string;
+/** Desired target shape. Source-only configuration and activation are excluded. */
+export declare function hashPortableSchedule(manifest: ScheduleManifest): string;
+/** Local baseline shape. It deliberately includes editable/source-only pull data. */
+export declare function hashScheduleManifest(manifest: ScheduleManifest): string;
+export declare function buildSchedulesPlan(input: {
+    client: RevoClient;
+    cwd: string;
+    envName: string;
+    stableKeyName: string;
+}): Promise<SchedulesPlan>;
+export declare function pullSchedulesToWorkspace(input: {
+    client: RevoClient;
+    cwd: string;
+    envName: string;
+    stableKeyName: string;
+    force?: boolean;
+}): Promise<SchedulePullResult>;
+export declare function pushSchedules(input: {
+    client: RevoClient;
+    cwd: string;
+    envName: string;
+    stableKeyName: string;
+    force?: boolean;
+    allowMaterialized?: boolean;
+}): Promise<{
+    plan: SchedulesPlan;
+    results: SchedulePushResult[];
+    verifiedActivationCandidates: VerifiedScheduleActivation[];
+}>;
+export declare function activateVerifiedSchedules(input: {
+    client: RevoClient;
+    candidates: ReadonlyArray<VerifiedScheduleActivation>;
+}): Promise<SchedulePushResult[]>;