From 10821f26649a99b5350b270eba98b9672e86fb92 Mon Sep 17 00:00:00 2001
From: Tim Otten <totten@civicrm.org>
Date: Sat, 17 Apr 2021 04:28:04 -0700
Subject: [PATCH] Extensions - Define the upgrader interface

---
 CRM/Extension/Upgrader/Interface.php | 29 ++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 CRM/Extension/Upgrader/Interface.php

diff --git a/CRM/Extension/Upgrader/Interface.php b/CRM/Extension/Upgrader/Interface.php
new file mode 100644
index 0000000000..c8ad824019
--- /dev/null
+++ b/CRM/Extension/Upgrader/Interface.php
@@ -0,0 +1,29 @@
+<?php
+
+/**
+ * An "upgrader" is a class that handles the DB install+upgrade lifecycle
+ * for an extension.
+ */
+interface CRM_Extension_Upgrader_Interface {
+
+  /**
+   * @param array $params
+   *   - string $key: Long form name ('org.example.myext')
+   */
+  public function init(array $params);
+
+  /**
+   * Notify the upgrader about a key lifecycle event, such as installation or uninstallation.
+   *
+   * Each event corresponds to a hook, such as `hook_civicrm_install` or `hook_civicrm_upgrade`.
+   *
+   * @param string $event
+   *   One of the following: 'install', 'onPostInstall', 'enable', 'disable', 'uninstall', 'upgrade'
+   * @param array $params
+   *   Any data that would ordinarily be provided via the equivalent hook.
+   *
+   * @return mixed
+   */
+  public function notify(string $event, array $params = []);
+
+}
-- 
2.25.1