@combeenation/custom-code-sdk 0.0.1-alpha3 → 0.0.1-alpha4

package/dist/index.d.ts

@@ -3,7 +3,6 @@ import { z } from 'zod';
 export declare class Button {
     #private;
     readonly id: CtrlId;
-    readonly sdkBridgeVersion = "v1";
     constructor(id: CtrlId);
     onRendered(callback: OnRenderedCallback<HTMLButtonElement>): CallbackUnsubscribeOption;
     onClick(callback: OnClickCallback): CallbackUnsubscribeOption;
@@ -15,19 +14,10 @@ declare type CallbackUnsubscribeOption = {
     unsubscribe: () => void;
 };
 
-/**
- * Why we need this?
- *
- * Our custom code SDK is using the `ConfiguratorClient` as its main gateway to communicate with cmps. It comes with the
- * `ConfiguratorClient` built in and only knows about the API of the version is was built with.
- *
- * Therefore, we'll always have to support older versions of the public API for custom code as well at "system runtime".
- *
- * Custom code shall always access the `ConfiguratorClient` via some well defined "gateway fn" like
- * `window.Cbn.getCustomCodeSdkBridge().createCfgrClient` which is responsible for returning the correct versioned API
- * e.g. by "hotpatching" the returned runtime object based on the requested version.
- */
+declare type CfgrClient = NonNullable<typeof client>;
+
 declare interface CfgrClientApi_v1 {
+    finishConfiguration: (input?: string) => Promise<FinishResult>;
     onAnyCmpValueChanged<TInput extends ValueComponent_2>(listener: CmpValuesChangedListener<TInput['name']>, components: TInput[], lazy?: boolean): Promise<void>;
     getCmpValue<T extends CmpValue_2>(cmpName: CmpName_2): Promise<T | undefined>;
     onCmpValueChanged<TValue extends CmpValue_2>(cmpName: CmpName_2, listener: CmpValueChangedListener_2<TValue>, condition?: CmpValueChangedCondition_2<TValue>, callImmediately?: boolean): Promise<void>;
@@ -36,7 +26,6 @@ declare interface CfgrClientApi_v1 {
 export declare class Checkbox {
     #private;
     readonly id: CtrlId;
-    readonly sdkBridgeVersion = "v1";
     constructor(id: CtrlId);
     onRendered(callback: OnRenderedCallback<HTMLLabelElement>): CallbackUnsubscribeOption;
     setVisible(visible: boolean): Promise<void>;
@@ -79,7 +68,6 @@ declare interface CmpValuesChangedListener<TName extends string = string> {
 export declare class Collapsible {
     #private;
     readonly id: CtrlId;
-    readonly sdkBridgeVersion = "v1";
     constructor(id: CtrlId);
     onRendered(callback: OnRenderedCallback<HTMLDivElement>): CallbackUnsubscribeOption;
     setVisible(visible: boolean): Promise<void>;
@@ -90,10 +78,28 @@ declare type CtrlId = z.infer<typeof ZCtrlId>;
 export declare class CustomControl {
     #private;
     readonly id: CtrlId;
-    readonly sdkBridgeVersion = "v1";
     constructor(id: CtrlId);
+    /**
+     * Things to mention when writing docs:
+     *   - Given `el` is only disconnected when ctrl is hidden
+     *     -> Event listener on that element shall only be installed once in custom code
+     *     Explicitly mention that this is only the case for `customCtrl.renderFn` and not for `otherCtrls.onRendered`.
+     *   - Assigning a new fn does not trigger a re-render
+     *   - Explain, when this fn is being called (automatically on show, manually on `.render()`)
+     *   - Explain, why this should be used instead of a pattern like the following:
+     *     ```ts
+     *     const el = myCtrl.getElement();
+     *     el.innerHTML = '...';
+     *     ```
+     *   - Explain difference to `onRendered` (see comments on `useCustomCodeSdkBridgeStoreBase`)
+     *   - ...
+     */
     set renderFn(callback: CustomCtrlRenderFn);
-    render(): Promise<void>;
+    /**
+     * @param renderFn Convenience param which allows setting the `renderFn` and triggering a render in one call.
+     *                 The `renderFn` will be permanently installed and will override any existing `renderFn`.
+     */
+    render(renderFn?: CustomCtrlRenderFn): Promise<void>;
     getElement(): HTMLElement | undefined;
     setVisible(visible: boolean): Promise<void>;
 }
@@ -103,24 +109,39 @@ declare type CustomCtrlRenderFn = (element: HTMLDivElement, rawHtml: string | un
 export declare class Dataview {
     #private;
     readonly id: CtrlId;
-    readonly sdkBridgeVersion = "v1";
     constructor(id: CtrlId);
     onRendered(callback: OnRenderedCallback<HTMLDivElement>): CallbackUnsubscribeOption;
     setVisible(visible: boolean): Promise<void>;
 }
 
+export declare const finishConfiguration: CfgrClient['finishConfiguration'];
+
+/**
+ * Why we need this?
+ *
+ * Our custom code SDK is using the `ConfiguratorClient` as its main gateway to communicate with cmps. It comes with the
+ * `ConfiguratorClient` built in and only knows about the API of the version is was built with.
+ *
+ * Therefore, we'll always have to support older versions of the public API for custom code as well at "system runtime".
+ *
+ * Custom code shall always access the `ConfiguratorClient` via some well defined "gateway fn" like
+ * `window.Cbn.getCustomCodeSdkBridge().createCfgrClient` which is responsible for returning the correct versioned API
+ * e.g. by "hotpatching" the returned runtime object based on the requested version.
+ */
+declare type FinishResult = {
+    newEditCfgnUrl: string;
+    actionResults: {};
+};
+
 export declare class Input {
     #private;
     readonly id: CtrlId;
-    readonly sdkBridgeVersion = "v1";
     constructor(id: CtrlId);
     onRendered(callback: OnRenderedCallback<HTMLDivElement>): CallbackUnsubscribeOption;
     setVisible(visible: boolean): Promise<void>;
 }
 
-declare type OnAnyCmpValueChanged = NonNullable<typeof client>['onAnyCmpValueChanged'];
-
-export declare const onAnyCmpValueChanged: OnAnyCmpValueChanged;
+export declare const onAnyCmpValueChanged: CfgrClient['onAnyCmpValueChanged'];
 
 declare type OnClickCallback = () => void;
 
@@ -129,7 +150,6 @@ declare type OnRenderedCallback<T extends HTMLElement = HTMLElement> = (element:
 export declare class Panel {
     #private;
     readonly id: CtrlId;
-    readonly sdkBridgeVersion = "v1";
     constructor(id: CtrlId);
     onRendered(callback: OnRenderedCallback<HTMLDivElement>): CallbackUnsubscribeOption;
     setVisible(visible: boolean): Promise<void>;
@@ -138,7 +158,6 @@ export declare class Panel {
 declare class Text_2 {
     #private;
     readonly id: CtrlId;
-    readonly sdkBridgeVersion = "v1";
     constructor(id: CtrlId);
     onRendered(callback: OnRenderedCallback<HTMLSpanElement>): CallbackUnsubscribeOption;
     setVisible(visible: boolean): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combeenation/custom-code-sdk",
-  "version": "0.0.1-alpha3",
+  "version": "0.0.1-alpha4",
   "description": "Combeenation custom code SDK package",
   "keywords": [],
   "homepage": "",