@fonderie/client 0.30.0 → 0.31.0

package/brain/signatures.md

@@ -285,6 +285,8 @@ new AdminClient(opts: IAdminClientOptions): AdminClient
   .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;
@@ -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

@@ -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