@fonderie/client 0.30.0 → 1.0.0

package/brain/signatures.md

@@ -279,12 +279,14 @@ new AdminClient(opts: IAdminClientOptions): AdminClient
   .attention(): Promise<IApiResponse<IAdminAttention>>
   .manifest(): Promise<IApiResponse<IAdminManifest>>
   .doctor(): Promise<IApiResponse<IAdminDoctorReport>>
-  .config(): Promise<IApiResponse<IAdminConfigReport>>
+  .environment(): Promise<IApiResponse<IAdminEnvironmentReport>>
   .routes(): Promise<IApiResponse<IAdminRoutesReport>>
   .tokens(): Promise<IApiResponse<IAdminTokensReport>>
   .adminLog(query?: IAdminLogQuery): Promise<IApiResponse<IAdminLogPage>>
   .issueToken(input: IAdminIssueTokenInput): Promise<IApiResponse<IAdminIssuedToken>>
   .revokeToken(id: string): Promise<IApiResponse<undefined>>
+  .migrations(): Promise<IApiResponse<IAdminMigrationsReport>>
+  .applyMigrations(module: string, expect: readonly string[]): Promise<IApiResponse<IAdminMigrationModule>>
 
 interface IAuthAdminClientOptions {
     baseUrl: string;
@@ -743,7 +745,7 @@ interface IAdminCheckResult {
     durationMs: number;
 }
 
-interface IAdminConfigReport {
+interface IAdminEnvironmentReport {
     generatedAt: string;
     readiness: IAdminReadiness;
     modules: Array<{
@@ -861,6 +863,26 @@ interface IAdminIssuedToken extends IAdminTokenRecord {
     token: string;
 }
 
+type MigrationImpact = 'additive' | 'destructive';
+
+interface IAdminPendingMigration {
+    file: string;
+    impact: MigrationImpact;
+    destructive: string[];
+}
+
+interface IAdminMigrationModule {
+    name: string;
+    pending: IAdminPendingMigration[];
+    blockedBy: string | null;
+    appliable: boolean;
+}
+
+interface IAdminMigrationsReport {
+    everApplied: boolean;
+    modules: IAdminMigrationModule[];
+}
+
 interface IAdminUserDTO extends IUserDTO {
     deletedAt: string | null;
 }

package/dist/index.cjs

@@ -1804,8 +1804,8 @@ var AdminClient = class {
   doctor() {
     return this.get("/doctor");
   }
-  config() {
-    return this.get("/config");
+  environment() {
+    return this.get("/environment");
   }
   routes() {
     return this.get("/routes");
@@ -1828,6 +1828,26 @@ var AdminClient = class {
   revokeToken(id) {
     return this.call("DELETE", `/access/tokens/${encodeURIComponent(id)}`);
   }
+  // What each module is waiting on, with every pending file's impact. Empty
+  // when the deployment did not hand its migration sequence to the surface.
+  migrations() {
+    return this.get("/migrations");
+  }
+  /**
+   * Apply one module's pending migrations — all of them, or none.
+   *
+   * `expect` is the pending list you were shown, in order. If it no longer
+   * matches, the server refuses with 409 MIGRATIONS_CHANGED rather than
+   * applying something nobody reviewed. Also refuses 409 when an earlier
+   * module is behind, and 422 when any pending file deletes data.
+   */
+  applyMigrations(module2, expect) {
+    return this.call(
+      "POST",
+      `/migrations/${encodeURIComponent(module2)}/apply`,
+      { expect }
+    );
+  }
 };
 
 // src/modules/auth-admin.ts