create-supaslidev 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,241 @@
+import { Document } from "yaml";
+import { ArrayLiteralExpression, ExportDeclaration, ImportDeclaration, ObjectLiteralExpression, Project, PropertyAssignment, SourceFile } from "ts-morph";
+
+//#region src/cli.d.ts
+declare function run$1(): Promise<void>;
+//#endregion
+//#region src/state.d.ts
+interface AppliedMigration {
+  id: string;
+  appliedAt: string;
+}
+interface ImportedPresentation {
+  name: string;
+  importedAt: string;
+  sourcePath: string;
+}
+interface StateSchema {
+  cliVersion: string;
+  createdAt: string;
+  lastUpdatedAt: string;
+  appliedMigrations: AppliedMigration[];
+  importedPresentations?: ImportedPresentation[];
+}
+declare function createInitialState(): StateSchema;
+declare function readState(workspaceDir: string): StateSchema | null;
+declare function writeState(workspaceDir: string, state: StateSchema): void;
+declare function initializeState(workspaceDir: string): StateSchema;
+declare function stateExists(workspaceDir: string): boolean;
+declare function addMigration(workspaceDir: string, migrationId: string): void;
+declare function hasMigration(workspaceDir: string, migrationId: string): boolean;
+declare function updateCliVersion(workspaceDir: string): void;
+declare function findWorkspaceRoot(startDir?: string): string | null;
+declare function addImportedPresentation(workspaceDir: string, presentation: ImportedPresentation): void;
+declare function getImportedPresentations(workspaceDir: string): ImportedPresentation[];
+declare function removeImportedPresentation(workspaceDir: string, name: string): void;
+//#endregion
+//#region src/migrations/types.d.ts
+interface MigrationContext {
+  workspaceDir: string;
+  state: StateSchema;
+  backupPath: string | null;
+  options?: Record<string, unknown>;
+}
+interface PresentationInfo {
+  name: string;
+  path: string;
+  currentVersion: string;
+}
+interface InteractiveMigration {
+  id: string;
+  description: string;
+  getAffectedPresentations: (workspaceDir: string) => PresentationInfo[];
+  up: (context: MigrationContext) => Promise<void>;
+  down?: (context: MigrationContext) => Promise<void>;
+}
+interface Migration {
+  id: string;
+  description: string;
+  up: (context: MigrationContext) => Promise<void>;
+  down?: (context: MigrationContext) => Promise<void>;
+}
+interface MigrationResult {
+  migrationId: string;
+  success: boolean;
+  error?: Error;
+  rolledBack: boolean;
+}
+interface BackupMetadata {
+  backupId: string;
+  createdAt: string;
+  workspaceDir: string;
+  cliVersion: string;
+  files: string[];
+}
+interface JournalEntry {
+  migrationId: string;
+  appliedAt: string;
+  backupId: string | null;
+  success: boolean;
+  rolledBack: boolean;
+  error?: string;
+}
+//#endregion
+//#region src/migrations/backup.d.ts
+declare function createBackup(workspaceDir: string): string;
+declare function restoreBackup(workspaceDir: string, backupId: string): void;
+declare function deleteBackup(workspaceDir: string, backupId: string): void;
+declare function listBackups(workspaceDir: string): BackupMetadata[];
+declare function getBackupMetadata(workspaceDir: string, backupId: string): BackupMetadata | null;
+declare function backupExists(workspaceDir: string, backupId: string): boolean;
+//#endregion
+//#region src/migrations/journal.d.ts
+interface JournalSchema {
+  entries: JournalEntry[];
+}
+declare function readJournal(workspaceDir: string): JournalSchema;
+declare function writeJournal(workspaceDir: string, journal: JournalSchema): void;
+declare function addJournalEntry(workspaceDir: string, entry: JournalEntry): void;
+declare function createJournalEntry(migrationId: string, backupId: string | null, success: boolean, rolledBack?: boolean, error?: Error): JournalEntry;
+declare function getJournalEntries(workspaceDir: string): JournalEntry[];
+declare function getLastSuccessfulEntry(workspaceDir: string): JournalEntry | null;
+declare function getMigrationHistory(workspaceDir: string, migrationId: string): JournalEntry[];
+declare function wasMigrationSuccessful(workspaceDir: string, migrationId: string): boolean;
+declare function getFailedMigrations(workspaceDir: string): JournalEntry[];
+declare function clearJournal(workspaceDir: string): void;
+//#endregion
+//#region src/migrations/loader.d.ts
+interface LoadedMigrations {
+  migrations: Migration[];
+  order: string[];
+}
+interface LoadedInteractiveMigration {
+  migration: Migration;
+  getAffectedPresentations?: (workspaceDir: string) => PresentationInfo[];
+}
+declare function loadMigrations(): Promise<LoadedMigrations>;
+declare function getMigrationById(id: string): Promise<Migration | null>;
+declare function loadInteractiveMigration(id: string): Promise<LoadedInteractiveMigration | null>;
+//#endregion
+//#region src/migrations/manifest.d.ts
+interface MigrationManifestEntry {
+  id: string;
+  description: string;
+  version: string;
+  breaking?: boolean;
+  dependencies?: string[];
+}
+interface MigrationsManifest {
+  version: string;
+  migrations: MigrationManifestEntry[];
+}
+declare function readManifest(migrationsDir: string): MigrationsManifest | null;
+declare function writeManifest(migrationsDir: string, manifest: MigrationsManifest): void;
+declare function createEmptyManifest(): MigrationsManifest;
+declare function validateManifest(manifest: MigrationsManifest): string[];
+declare function getMigrationOrder(manifest: MigrationsManifest): string[];
+//#endregion
+//#region src/migrations/runner.d.ts
+interface RunnerOptions {
+  workspaceDir: string;
+  migrationsDir: string;
+  apply?: boolean;
+  migrations?: Migration[];
+  migrationOptions?: Record<string, Record<string, unknown>>;
+}
+interface DryRunResult {
+  migrationId: string;
+  description: string;
+  wouldApply: boolean;
+  alreadyApplied: boolean;
+  breaking?: boolean;
+}
+interface RunResult {
+  success: boolean;
+  applied: MigrationResult[];
+  skipped: string[];
+  failed: MigrationResult | null;
+  backupId: string | null;
+  rolledBack: boolean;
+}
+declare function dryRun(options: RunnerOptions): DryRunResult[];
+declare function formatDryRunOutput(results: DryRunResult[]): string;
+declare function run(options: RunnerOptions): Promise<RunResult>;
+declare function formatRunOutput(result: RunResult): string;
+//#endregion
+//#region src/transformers/json.d.ts
+interface JsonTransformResult<T = unknown> {
+  original: T;
+  transformed: T;
+  changed: boolean;
+}
+declare function readJsonFile<T = unknown>(filePath: string): T;
+declare function writeJsonFile<T>(filePath: string, data: T, indent?: number): void;
+declare function transformJson<T = unknown>(filePath: string, transformer: (data: T) => T): JsonTransformResult<T>;
+declare function getJsonValue<T = unknown>(data: unknown, path: string): T | undefined;
+declare function setJsonValue<T>(data: T, path: string, value: unknown): T;
+declare function deleteJsonValue<T>(data: T, path: string): T;
+declare function mergeJson<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
+//#endregion
+//#region src/transformers/yaml.d.ts
+interface YamlTransformResult<T = unknown> {
+  original: T;
+  transformed: T;
+  changed: boolean;
+}
+declare function readYamlFile<T = unknown>(filePath: string): T;
+declare function writeYamlFile<T>(filePath: string, data: T): void;
+declare function readYamlDocument(filePath: string): Document;
+declare function writeYamlDocument(filePath: string, doc: Document): void;
+declare function transformYaml<T = unknown>(filePath: string, transformer: (data: T) => T): YamlTransformResult<T>;
+declare function transformYamlDocument(filePath: string, transformer: (doc: Document) => void): {
+  changed: boolean;
+};
+declare function getYamlValue<T = unknown>(data: unknown, path: string): T | undefined;
+declare function setYamlValue<T>(data: T, path: string, value: unknown): T;
+declare function deleteYamlValue<T>(data: T, path: string): T;
+declare function mergeYaml<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
+//#endregion
+//#region src/transformers/typescript.d.ts
+interface TypeScriptTransformResult {
+  changed: boolean;
+  originalContent: string;
+  newContent: string;
+}
+interface TypeScriptTransformer {
+  project: Project;
+  sourceFile: SourceFile;
+  save: () => TypeScriptTransformResult;
+}
+declare function createTransformer(filePath: string): TypeScriptTransformer;
+declare function transformTypeScript(filePath: string, transformer: (sourceFile: SourceFile) => void): TypeScriptTransformResult;
+declare function addImport(sourceFile: SourceFile, moduleSpecifier: string, namedImports: string[]): ImportDeclaration | null;
+declare function removeImport(sourceFile: SourceFile, moduleSpecifier: string, namedImports?: string[]): boolean;
+declare function addExport(sourceFile: SourceFile, moduleSpecifier: string, namedExports: string[]): ExportDeclaration;
+declare function findObjectLiteral(sourceFile: SourceFile, variableName: string): ObjectLiteralExpression | undefined;
+declare function findArrayLiteral(sourceFile: SourceFile, variableName: string): ArrayLiteralExpression | undefined;
+declare function getObjectProperty(obj: ObjectLiteralExpression, propertyName: string): PropertyAssignment | undefined;
+declare function setObjectProperty(obj: ObjectLiteralExpression, propertyName: string, value: string): void;
+declare function removeObjectProperty(obj: ObjectLiteralExpression, propertyName: string): boolean;
+declare function addArrayElement(arr: ArrayLiteralExpression, element: string): void;
+declare function removeArrayElement(arr: ArrayLiteralExpression, element: string): boolean;
+declare function findDefaultExportObject(sourceFile: SourceFile): ObjectLiteralExpression | undefined;
+declare function findCallExpression(sourceFile: SourceFile, functionName: string): ObjectLiteralExpression | undefined;
+//#endregion
+//#region src/commands/status.d.ts
+interface StatusResult {
+  cliVersion: string;
+  stateVersion: string | null;
+  createdAt: string | null;
+  lastUpdatedAt: string | null;
+  pendingMigrations: number;
+  latestVersion: string | null;
+  updateAvailable: boolean;
+  nativePresentations: string[];
+  importedPresentations: ImportedPresentation[];
+}
+declare function getStatus(workspaceDir?: string): Promise<StatusResult>;
+declare function formatStatus(status: StatusResult): string;
+declare function status(workspaceDir?: string): Promise<void>;
+//#endregion
+export { AppliedMigration, BackupMetadata, DryRunResult, ImportedPresentation, InteractiveMigration, JournalEntry, JsonTransformResult, LoadedInteractiveMigration, LoadedMigrations, Migration, MigrationContext, MigrationManifestEntry, MigrationResult, MigrationsManifest, PresentationInfo, RunResult, RunnerOptions, StateSchema, StatusResult, TypeScriptTransformResult, TypeScriptTransformer, YamlTransformResult, addArrayElement, addExport, addImport, addImportedPresentation, addJournalEntry, addMigration, backupExists, clearJournal, createBackup, createEmptyManifest, createInitialState, createJournalEntry, createTransformer, deleteBackup, deleteJsonValue, deleteYamlValue, dryRun, findArrayLiteral, findCallExpression, findDefaultExportObject, findObjectLiteral, findWorkspaceRoot, formatDryRunOutput, formatRunOutput, formatStatus, getBackupMetadata, getFailedMigrations, getImportedPresentations, getJournalEntries, getJsonValue, getLastSuccessfulEntry, getMigrationById, getMigrationHistory, getMigrationOrder, getObjectProperty, getStatus, getYamlValue, hasMigration, initializeState, listBackups, loadInteractiveMigration, loadMigrations, mergeJson, mergeYaml, readJournal, readJsonFile, readManifest, readState, readYamlDocument, readYamlFile, removeArrayElement, removeImport, removeImportedPresentation, removeObjectProperty, restoreBackup, run, run$1 as runCli, setJsonValue, setObjectProperty, setYamlValue, stateExists, status, transformJson, transformTypeScript, transformYaml, transformYamlDocument, updateCliVersion, validateManifest, wasMigrationSuccessful, writeJournal, writeJsonFile, writeManifest, writeState, writeYamlDocument, writeYamlFile };