@atlassian/clientside-extensions 2.4.0-e0cce94-kuewz5ow

package/dist/types/LinkExtension.d.ts

@@ -0,0 +1,11 @@
+import type { ExtensionAttributes, ExtensionAttributesProvider, OnAction } from '@atlassian/clientside-extensions-registry';
+import { ExtensionType } from './extension-type';
+export interface LinkAttributes extends ExtensionAttributes {
+    onAction?: OnAction;
+    url: string;
+    label: string;
+    type?: ExtensionType.link;
+}
+export declare type LinkAttributesProvider<ContextT> = ExtensionAttributesProvider<LinkAttributes, ContextT>;
+export declare const factory: <ContextT>(provider: ExtensionAttributesProvider<LinkAttributes, ContextT>) => ExtensionAttributesProvider<LinkAttributes, ContextT>;
+//# sourceMappingURL=LinkExtension.d.ts.map

package/dist/types/LinkExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkExtension.d.ts","sourceRoot":"","sources":["../../lib/LinkExtension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,QAAQ,EAAE,MAAM,2CAA2C,CAAC;AAE5H,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACvD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC;CAC7B;AAED,oBAAY,sBAAsB,CAAC,QAAQ,IAAI,2BAA2B,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAGrG,eAAO,MAAM,OAAO,sIAOnB,CAAC"}

package/dist/types/LinkExtension.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=LinkExtension.test.d.ts.map

package/dist/types/LinkExtension.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkExtension.test.d.ts","sourceRoot":"","sources":["../../lib/LinkExtension.test.ts"],"names":[],"mappings":""}

package/dist/types/ModalExtension.d.ts

@@ -0,0 +1,60 @@
+import type { ExtensionAttributes, ExtensionAttributesProvider } from '@atlassian/clientside-extensions-registry';
+import type { Dispatch as ReactDispatch, KeyboardEvent as ReactKeyboardEvent, MouseEvent as ReactMouseEvent, SetStateAction as ReactSetStateAction } from 'react';
+import { ExtensionType } from './extension-type';
+import type { LifecycleCallback, MountableExtension } from './AbstractExtension';
+declare type KeyboardOrMouseEvent = ReactMouseEvent<HTMLElement> | ReactKeyboardEvent<HTMLElement> | KeyboardEvent;
+interface ModalCloseCallback {
+    (e: KeyboardOrMouseEvent): boolean | void;
+}
+export declare type ModalAction = {
+    text: string;
+    onClick: () => void;
+    isDisabled?: boolean;
+    isLoading?: boolean;
+    testId?: string;
+};
+export declare type ModalRenderExtension = (api: Api) => void;
+export interface ModalAttributes extends ExtensionAttributes {
+    onAction: ModalRenderExtension;
+    label: string;
+    type?: ExtensionType.modal;
+}
+export declare type ModalAttributesProvider<ContextT> = ExtensionAttributesProvider<ModalAttributes, ContextT>;
+export declare const factory: <ContextT>(provider: ExtensionAttributesProvider<ModalAttributes, ContextT>) => ExtensionAttributesProvider<ModalAttributes, ContextT>;
+export declare enum Appearance {
+    'danger' = "danger",
+    'warning' = "warning"
+}
+export declare enum Width {
+    'small' = "small",
+    'medium' = "medium",
+    'large' = "large",
+    'x-large' = "x-large"
+}
+export declare class Api implements MountableExtension {
+    private title;
+    private width;
+    private appearance;
+    private renderCallback;
+    private cleanupCallback;
+    private readonly closeModalFn;
+    private onCloseCallback;
+    constructor(closeModalFn: () => void, setActions: ReactDispatch<ReactSetStateAction<ModalAction[]>>);
+    setTitle: (title: string) => this;
+    setWidth: (width: Width) => this;
+    setAppearance: (appearance: Appearance) => this;
+    onMount: (callback: LifecycleCallback) => this;
+    onUnmount: (callback: LifecycleCallback) => this;
+    closeModal: () => void;
+    getTitle(): string;
+    getWidth(): Width;
+    getAppearance(): Appearance;
+    getRenderCallback(): LifecycleCallback;
+    getCleanupCallback(): LifecycleCallback;
+    setActions: (actions: ModalAction[]) => void;
+    onClose(callback: ModalCloseCallback): this;
+    getOnCloseCallback(): ModalCloseCallback;
+    static filterActionProps(actions: unknown[]): ModalAction[];
+}
+export {};
+//# sourceMappingURL=ModalExtension.d.ts.map

package/dist/types/ModalExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalExtension.d.ts","sourceRoot":"","sources":["../../lib/ModalExtension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAElH,OAAO,KAAK,EACR,QAAQ,IAAI,aAAa,EACzB,aAAa,IAAI,kBAAkB,EACnC,UAAU,IAAI,eAAe,EAC7B,cAAc,IAAI,mBAAmB,EAExC,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIjF,aAAK,oBAAoB,GAAG,eAAe,CAAC,WAAW,CAAC,GAAG,kBAAkB,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC;AAE3G,UAAU,kBAAkB;IACxB,CAAC,CAAC,EAAE,oBAAoB,GAAG,OAAO,GAAG,IAAI,CAAC;CAC7C;AAED,oBAAY,WAAW,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,oBAAY,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAEtD,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IACxD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC;CAC9B;AAED,oBAAY,uBAAuB,CAAC,QAAQ,IAAI,2BAA2B,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AAEvG,eAAO,MAAM,OAAO,wIAQnB,CAAC;AAIF,oBAAY,UAAU;IAClB,QAAQ,WAAW;IACnB,SAAS,YAAY;CACxB;AAED,oBAAY,KAAK;IACb,OAAO,UAAU;IACjB,QAAQ,WAAW;IACnB,OAAO,UAAU;IACjB,SAAS,YAAY;CACxB;AAED,qBAAa,GAAI,YAAW,kBAAkB;IAC1C,OAAO,CAAC,KAAK,CAAM;IAEnB,OAAO,CAAC,KAAK,CAAS;IAEtB,OAAO,CAAC,UAAU,CAAc;IAEhC,OAAO,CAAC,cAAc,CAA2B;IAEjD,OAAO,CAAC,eAAe,CAA2B;IAElD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IAEjD,OAAO,CAAC,eAAe,CAAkC;gBAE7C,YAAY,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,WAAW,EAAE,CAAC,CAAC;IAU5F,QAAQ,UAAW,MAAM,UAI9B;IAEK,QAAQ,UAAW,KAAK,UAgB7B;IAEK,aAAa,eAAgB,UAAU,UAgB5C;IAEK,OAAO,aAAc,iBAAiB,UAI3C;IAEK,SAAS,aAAc,iBAAiB,UAI7C;IAEK,UAAU,aAEf;IAEK,QAAQ;IAIR,QAAQ;IAIR,aAAa;IAIb,iBAAiB;IAIjB,kBAAkB;IAIlB,UAAU,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAE7C,OAAO,CAAC,QAAQ,EAAE,kBAAkB;IAMpC,kBAAkB;IAIzB,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE;CAS9D"}

package/dist/types/ModalExtension.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ModalExtension.test.d.ts.map

package/dist/types/ModalExtension.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalExtension.test.d.ts","sourceRoot":"","sources":["../../lib/ModalExtension.test.ts"],"names":[],"mappings":""}

package/dist/types/PageExtension.d.ts

@@ -0,0 +1,11 @@
+import type { DataProviderPayload, ExtensionAttributes } from '@atlassian/clientside-extensions-registry';
+import { ExtensionType } from './extension-type';
+declare type RenderCallback<DataProviderT> = (node: HTMLElement, data: DataProviderPayload<DataProviderT>) => void;
+export interface PageAttributes<DataProviderT> extends ExtensionAttributes {
+    onAction: RenderCallback<DataProviderT>;
+    type: ExtensionType.page;
+}
+export declare type PageAttributesProvider<DataProviderT = unknown> = () => PageAttributes<DataProviderT>;
+export declare const factory: <DataProviderT>(renderCallback: RenderCallback<DataProviderT>) => PageAttributesProvider<DataProviderT>;
+export {};
+//# sourceMappingURL=PageExtension.d.ts.map

package/dist/types/PageExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageExtension.d.ts","sourceRoot":"","sources":["../../lib/PageExtension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAE1G,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,aAAK,cAAc,CAAC,aAAa,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;AAE3G,MAAM,WAAW,cAAc,CAAC,aAAa,CAAE,SAAQ,mBAAmB;IACtE,QAAQ,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;CAC5B;AAED,oBAAY,sBAAsB,CAAC,aAAa,GAAG,OAAO,IAAI,MAAM,cAAc,CAAC,aAAa,CAAC,CAAC;AAElG,eAAO,MAAM,OAAO,yGAOnB,CAAC"}

package/dist/types/PageExtension.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @jest-environment jsdom
+ */
+export {};
+//# sourceMappingURL=PageExtension.test.d.ts.map

package/dist/types/PageExtension.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageExtension.test.d.ts","sourceRoot":"","sources":["../../lib/PageExtension.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/PanelExtension.d.ts

@@ -0,0 +1,19 @@
+import type { Context, ExtensionAttributes, ExtensionAttributesProvider } from '@atlassian/clientside-extensions-registry';
+import { ExtensionType } from './extension-type';
+import type { LifecycleCallback, MountableExtension } from './AbstractExtension';
+export declare type PanelRenderExtension = (api: Api, context?: Context<{}>, data?: unknown) => void;
+export interface PanelAttributes extends ExtensionAttributes {
+    onAction: PanelRenderExtension;
+    type?: ExtensionType.panel;
+}
+export declare type PanelAttributesProvider<ContextT> = ExtensionAttributesProvider<PanelAttributes, ContextT>;
+export declare const factory: <ContextT>(provider: ExtensionAttributesProvider<PanelAttributes, ContextT>) => ExtensionAttributesProvider<PanelAttributes, ContextT>;
+export declare class Api implements MountableExtension {
+    private renderCallback;
+    private cleanupCallback;
+    onMount(callback: LifecycleCallback): this;
+    onUnmount(callback: LifecycleCallback): this;
+    getRenderCallback(): LifecycleCallback;
+    getCleanupCallback(): LifecycleCallback;
+}
+//# sourceMappingURL=PanelExtension.d.ts.map

package/dist/types/PanelExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PanelExtension.d.ts","sourceRoot":"","sources":["../../lib/PanelExtension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAE3H,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGjF,oBAAY,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAE7F,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IACxD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC;CAC9B;AAED,oBAAY,uBAAuB,CAAC,QAAQ,IAAI,2BAA2B,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AAEvG,eAAO,MAAM,OAAO,wIAOnB,CAAC;AAIF,qBAAa,GAAI,YAAW,kBAAkB;IAC1C,OAAO,CAAC,cAAc,CAA2B;IAEjD,OAAO,CAAC,eAAe,CAA2B;IAE3C,OAAO,CAAC,QAAQ,EAAE,iBAAiB;IAMnC,SAAS,CAAC,QAAQ,EAAE,iBAAiB;IAMrC,iBAAiB;IAIjB,kBAAkB;CAG5B"}

package/dist/types/PanelExtension.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PanelExtension.test.d.ts.map

package/dist/types/PanelExtension.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PanelExtension.test.d.ts","sourceRoot":"","sources":["../../lib/PanelExtension.test.ts"],"names":[],"mappings":""}

package/dist/types/SectionExtension.d.ts

@@ -0,0 +1,8 @@
+import type { ExtensionAttributes, ExtensionAttributesProvider } from '@atlassian/clientside-extensions-registry';
+import { ExtensionType } from './extension-type';
+export interface SectionAttributes extends ExtensionAttributes {
+    type?: ExtensionType.section;
+}
+export declare type SectionAttributesProvider<ContextT> = ExtensionAttributesProvider<SectionAttributes, ContextT>;
+export declare const factory: <ContextT>(provider: ExtensionAttributesProvider<SectionAttributes, ContextT>) => ExtensionAttributesProvider<SectionAttributes, ContextT>;
+//# sourceMappingURL=SectionExtension.d.ts.map

package/dist/types/SectionExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionExtension.d.ts","sourceRoot":"","sources":["../../lib/SectionExtension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAElH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC1D,IAAI,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC;CAChC;AAED,oBAAY,yBAAyB,CAAC,QAAQ,IAAI,2BAA2B,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AAE3G,eAAO,MAAM,OAAO,4IAOnB,CAAC"}

package/dist/types/SectionExtension.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SectionExtension.test.d.ts.map

package/dist/types/SectionExtension.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionExtension.test.d.ts","sourceRoot":"","sources":["../../lib/SectionExtension.test.ts"],"names":[],"mappings":""}

package/dist/types/extension-type.d.ts

@@ -0,0 +1,10 @@
+export declare enum ExtensionType {
+    'asyncPanel' = "async-panel",
+    button = "button",
+    link = "link",
+    modal = "modal",
+    panel = "panel",
+    page = "page",
+    section = "section"
+}
+//# sourceMappingURL=extension-type.d.ts.map

package/dist/types/extension-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-type.d.ts","sourceRoot":"","sources":["../../lib/extension-type.ts"],"names":[],"mappings":"AACA,oBAAY,aAAa;IACrB,YAAY,gBAAgB;IAC5B,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACtB"}

package/dist/types/index.d.ts

@@ -0,0 +1,11 @@
+import * as AsyncPanelExtension from './AsyncPanelExtension';
+import * as ButtonExtension from './ButtonExtension';
+import * as LinkExtension from './LinkExtension';
+import * as ModalExtension from './ModalExtension';
+import * as PanelExtension from './PanelExtension';
+import * as SectionExtension from './SectionExtension';
+import * as PageExtension from './PageExtension';
+import { ExtensionType } from './extension-type';
+export type { MountableExtension, LifecycleCallback } from './AbstractExtension';
+export { AsyncPanelExtension, ButtonExtension, LinkExtension, ModalExtension, PanelExtension, SectionExtension, PageExtension, ExtensionType, };
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,mBAAmB,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,eAAe,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,gBAAgB,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,OAAO,EACH,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,GAChB,CAAC"}

package/lib/AbstractExtension.ts

@@ -0,0 +1,31 @@
+import { onDebug } from '@atlassian/clientside-extensions-debug';
+
+// We are fine with any type here
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type Callable = (...args: any[]) => any;
+
+export interface LifecycleCallback {
+    (element: HTMLElement): void;
+}
+
+export interface MountableExtension {
+    onMount(mountCallback: LifecycleCallback): MountableExtension;
+
+    onUnmount(unmountCallback: LifecycleCallback): MountableExtension;
+}
+
+export function safeguard<T extends Callable>(callbackDebugName: string, callback: T): (...args: Parameters<T>) => ReturnType<T> {
+    return (...args: Parameters<T>) => {
+        let result;
+        try {
+            result = callback(...args);
+        } catch (e) {
+            onDebug(({ error }) => ({
+                level: error,
+                message: `Failed to execute ${callbackDebugName} callback.
+    Error: ${e}`,
+            }));
+        }
+        return result;
+    };
+}

package/lib/AsyncPanelExtension.test.ts

@@ -0,0 +1,145 @@
+import type { ExtensionAPI } from '@atlassian/clientside-extensions-registry';
+import { onDebug } from '@atlassian/clientside-extensions-debug';
+import * as AsyncPanelExtension from './AsyncPanelExtension';
+
+jest.mock('@atlassian/clientside-extensions-debug');
+
+interface TestContext {
+    value?: number;
+}
+
+describe('AsyncPanelExtension', () => {
+    // @ts-expect-error - invalid values for contextProvider and type. Factory should overwrite them.
+    const testAttributesProvider: AsyncPanelExtension.AsyncPanelAttributesProvider = (api, context: TestContext) => {
+        api.onCleanup(jest.fn());
+        api.updateAttributes({});
+
+        return {
+            type: 'not-valid',
+            contextProvider: 'not-valid-context-provider',
+            label: context.value === 42 ? 'The meaning of life' : 'A label',
+            onAction: jest.fn(),
+        };
+    };
+
+    const testAPI: ExtensionAPI<typeof testAttributesProvider> = {
+        onCleanup: jest.fn(),
+        updateAttributes: jest.fn(),
+    };
+
+    it('should generate the extension descriptor with the correct type and contextProvider', () => {
+        const extensionProvider = AsyncPanelExtension.factory(testAttributesProvider);
+        const extension = extensionProvider(testAPI, {});
+
+        // expect all attributes to be merged, type and contextProvider to be overwritten with the correct values.
+        expect(extension).toEqual({
+            type: 'async-panel',
+            label: 'A label',
+            onAction: expect.any(Function),
+            contextProvider: expect.any(Function),
+        });
+    });
+
+    it('should provide a extensionAPI object to the extension provider', () => {
+        expect(testAPI.onCleanup).toHaveBeenCalledTimes(0);
+        expect(testAPI.updateAttributes).toHaveBeenCalledTimes(0);
+
+        const extensionProvider = AsyncPanelExtension.factory(testAttributesProvider);
+        extensionProvider(testAPI, {});
+
+        expect(testAPI.onCleanup).toHaveBeenCalledTimes(1);
+        expect(testAPI.updateAttributes).toHaveBeenCalledTimes(1);
+    });
+
+    it('should share any provided context with the attributes provider', () => {
+        const extensionProvider = AsyncPanelExtension.factory(testAttributesProvider);
+        const extension = extensionProvider(testAPI, { value: 42 });
+
+        // expect label to change because of context
+        expect(extension).toEqual({
+            type: 'async-panel',
+            label: 'The meaning of life',
+            onAction: expect.any(Function),
+            contextProvider: expect.any(Function),
+        });
+    });
+
+    it('should add a contextProvider method to retreive the shared context', () => {
+        const extensionProvider = AsyncPanelExtension.factory(testAttributesProvider);
+        const testContext: TestContext = { value: 42 };
+        const extension = extensionProvider(testAPI, testContext);
+
+        expect(extension.contextProvider()).toBe(testContext);
+    });
+
+    describe('API', () => {
+        let api: AsyncPanelExtension.Api;
+        const el: HTMLElement = document.createElement('div');
+
+        beforeEach(() => {
+            api = new AsyncPanelExtension.Api();
+        });
+
+        it('#onMount callback used in getRenderCallback', () => {
+            const cb = jest.fn();
+            api.onMount(cb);
+            api.getRenderCallback()(el);
+            expect(cb).toHaveBeenCalledTimes(1);
+        });
+
+        it('#onMount does nothing if not set', () => {
+            expect(() => {
+                api.getRenderCallback()(el);
+            }).not.toThrow();
+        });
+
+        it('#onMount does nothing if callback is not function', () => {
+            // @ts-expect-error checking that non-TS consumers don't shoot themselves (or others) in the foot
+            api.onMount(null);
+            expect(() => {
+                api.getRenderCallback()(el);
+            }).not.toThrow();
+        });
+
+        it('#onMount fails gracefully if callback throws error', () => {
+            api.onMount(() => {
+                throw Error('whoops');
+            });
+            expect(() => {
+                api.getRenderCallback()(el);
+            }).not.toThrow();
+        });
+
+        it('#onUnmount callback used in getCleanupCallback', () => {
+            const cb = jest.fn();
+            api.onUnmount(cb);
+            api.getCleanupCallback()(el);
+            expect(cb).toHaveBeenCalledTimes(1);
+        });
+
+        it('#onUnmount does nothing if not set', () => {
+            expect(() => {
+                api.getCleanupCallback()(el);
+            }).not.toThrow();
+        });
+
+        it('#onUnmount does nothing if callback is not function', () => {
+            // @ts-expect-error checking that non-TS consumers don't shoot themselves (or others) in the foot
+            api.onUnmount(null);
+            expect(() => {
+                api.getCleanupCallback()(el);
+            }).not.toThrow();
+            expect(onDebug).toHaveBeenCalledTimes(1);
+        });
+
+        it('#onUnmount fails gracefully if callback throws error', () => {
+            api.onUnmount(() => {
+                throw Error('whoops');
+            });
+            expect(() => {
+                api.getCleanupCallback()(el);
+            }).not.toThrow();
+            expect(onDebug).toHaveBeenCalledTimes(1);
+        });
+    });
+});

package/lib/AsyncPanelExtension.ts

@@ -0,0 +1,34 @@
+import type { ExtensionAttributes, ExtensionAttributesProvider, Context } from '@atlassian/clientside-extensions-registry';
+import type { PanelRenderExtension } from './PanelExtension';
+import { Api } from './PanelExtension';
+import { ExtensionType } from './extension-type';
+
+export interface AsyncPanelRenderExtension extends PanelRenderExtension {}
+
+export interface AsyncPanelAttributes extends ExtensionAttributes {
+    onAction: AsyncPanelRenderExtension;
+    type?: ExtensionType.asyncPanel;
+}
+
+export type AsyncPanelAttributesProvider<ContextT> = ExtensionAttributesProvider<AsyncPanelAttributes, ContextT>;
+
+export interface AsyncPanelAttributesWithContext extends AsyncPanelAttributes {
+    contextProvider: () => Context<{}>;
+}
+
+export type AsyncPanelAttributesProviderWithContext<ContextT> = ExtensionAttributesProvider<AsyncPanelAttributesWithContext, ContextT>;
+
+export const factory = <ContextT>(provider: AsyncPanelAttributesProvider<ContextT>): AsyncPanelAttributesProviderWithContext<ContextT> => {
+    return (extensionApi, context): AsyncPanelAttributesWithContext => {
+        return {
+            ...provider(extensionApi, context),
+            // We are passing the context provider function reference into the <AsyncPanelHandler.AsyncPanelRenderer> component
+            contextProvider() {
+                return context;
+            },
+            type: ExtensionType.asyncPanel,
+        };
+    };
+};
+
+export { Api };

package/lib/ButtonExtension.test.ts

@@ -0,0 +1,61 @@
+import type { ExtensionAPI } from '@atlassian/clientside-extensions-registry';
+import * as ButtonExtension from './ButtonExtension';
+import type { ButtonAttributesProvider } from './ButtonExtension';
+
+interface TestContext {
+    value?: number;
+}
+
+describe('ButtonExtension', () => {
+    // @ts-expect-error We set the invalid type
+    const testAttributesProvider: ButtonAttributesProvider = (api, context: TestContext) => {
+        api.onCleanup(jest.fn());
+        api.updateAttributes({});
+
+        return {
+            type: 'not-valid',
+            label: context.value === 42 ? 'The meaning of life' : 'A label',
+            onAction: jest.fn(),
+        };
+    };
+
+    const testAPI: ExtensionAPI<typeof testAttributesProvider> = {
+        onCleanup: jest.fn(),
+        updateAttributes: jest.fn(),
+    };
+
+    it('should generate the extension descriptor with the correct type', () => {
+        const extensionProvider = ButtonExtension.factory(testAttributesProvider);
+        const extension = extensionProvider(testAPI, {});
+
+        // expect all atributes to be merged, and type to be overwritten with the correct value.
+        expect(extension).toEqual({
+            type: 'button',
+            label: 'A label',
+            onAction: expect.any(Function),
+        });
+    });
+
+    it('should provide a extensionAPI object to the extension provider', () => {
+        expect(testAPI.onCleanup).toHaveBeenCalledTimes(0);
+        expect(testAPI.updateAttributes).toHaveBeenCalledTimes(0);
+
+        const extensionProvider = ButtonExtension.factory(testAttributesProvider);
+        extensionProvider(testAPI, {});
+
+        expect(testAPI.onCleanup).toHaveBeenCalledTimes(1);
+        expect(testAPI.updateAttributes).toHaveBeenCalledTimes(1);
+    });
+
+    it('should share any provided context with the attributes provider', () => {
+        const extensionProvider = ButtonExtension.factory(testAttributesProvider);
+        const extension = extensionProvider(testAPI, { value: 42 });
+
+        // expect label to change because of context
+        expect(extension).toEqual({
+            type: 'button',
+            label: 'The meaning of life',
+            onAction: expect.any(Function),
+        });
+    });
+});

package/lib/ButtonExtension.ts

@@ -0,0 +1,20 @@
+import type { ExtensionAttributes, ExtensionAttributesProvider, OnAction } from '@atlassian/clientside-extensions-registry';
+
+import { ExtensionType } from './extension-type';
+
+export interface ButtonAttributes extends ExtensionAttributes {
+    onAction?: OnAction;
+    label: string;
+    type?: ExtensionType.button;
+}
+
+export type ButtonAttributesProvider<ContextT> = ExtensionAttributesProvider<ButtonAttributes, ContextT>;
+
+export const factory = <ContextT>(provider: ButtonAttributesProvider<ContextT>): ButtonAttributesProvider<ContextT> => {
+    return (...args) => {
+        return {
+            ...provider(...args),
+            type: ExtensionType.button,
+        };
+    };
+};

package/lib/LinkExtension.test.ts

@@ -0,0 +1,61 @@
+import type { ExtensionAPI } from '@atlassian/clientside-extensions-registry';
+import * as LinkExtension from './LinkExtension';
+import type { LinkAttributesProvider } from './LinkExtension';
+
+interface TestContext {
+    value?: number;
+}
+
+describe('LinkExtension', () => {
+    // @ts-expect-error we set the invalid type
+    const testAttributesProvider: LinkAttributesProvider = (api, context: TestContext) => {
+        api.onCleanup(jest.fn());
+        api.updateAttributes({});
+
+        return {
+            type: 'not-valid',
+            label: context.value === 42 ? 'The meaning of life' : 'A label',
+            link: 'https://go.atlassian.com/clientside-extensions',
+        };
+    };
+
+    const testAPI: ExtensionAPI<typeof testAttributesProvider> = {
+        onCleanup: jest.fn(),
+        updateAttributes: jest.fn(),
+    };
+
+    it('should generate the extension descriptor with the correct type', () => {
+        const extensionProvider = LinkExtension.factory(testAttributesProvider);
+        const extension = extensionProvider(testAPI, {});
+
+        // expect all attributes to be merged, and type to be overwritten with the correct value.
+        expect(extension).toEqual({
+            type: 'link',
+            label: 'A label',
+            link: 'https://go.atlassian.com/clientside-extensions',
+        });
+    });
+
+    it('should provide a extensionAPI object to the extension provider', () => {
+        expect(testAPI.onCleanup).toHaveBeenCalledTimes(0);
+        expect(testAPI.updateAttributes).toHaveBeenCalledTimes(0);
+
+        const extensionProvider = LinkExtension.factory(testAttributesProvider);
+        extensionProvider(testAPI, {});
+
+        expect(testAPI.onCleanup).toHaveBeenCalledTimes(1);
+        expect(testAPI.updateAttributes).toHaveBeenCalledTimes(1);
+    });
+
+    it('should share any provided context with the attributes provider', () => {
+        const extensionProvider = LinkExtension.factory(testAttributesProvider);
+        const extension = extensionProvider(testAPI, { value: 42 });
+
+        // expect label to change because of context
+        expect(extension).toEqual({
+            type: 'link',
+            label: 'The meaning of life',
+            link: 'https://go.atlassian.com/clientside-extensions',
+        });
+    });
+});

package/lib/LinkExtension.ts

@@ -0,0 +1,22 @@
+import type { ExtensionAttributes, ExtensionAttributesProvider, OnAction } from '@atlassian/clientside-extensions-registry';
+
+import { ExtensionType } from './extension-type';
+
+export interface LinkAttributes extends ExtensionAttributes {
+    onAction?: OnAction;
+    url: string;
+    label: string;
+    type?: ExtensionType.link;
+}
+
+export type LinkAttributesProvider<ContextT> = ExtensionAttributesProvider<LinkAttributes, ContextT>;
+
+// eslint-disable-next-line import/prefer-default-export
+export const factory = <ContextT>(provider: LinkAttributesProvider<ContextT>): LinkAttributesProvider<ContextT> => {
+    return (...args) => {
+        return {
+            ...provider(...args),
+            type: ExtensionType.link,
+        };
+    };
+};