@notur/sdk 1.0.0

package/dist/createExtension.d.ts

@@ -0,0 +1,21 @@
+import { ExtensionDefinition } from './types';
+/**
+ * Factory for registering a Notur extension.
+ *
+ * Usage:
+ * ```ts
+ * import { createExtension } from '@notur/sdk';
+ *
+ * createExtension({
+ *   config: { id: 'acme/analytics', name: 'Analytics', version: '1.0.0' },
+ *   slots: [
+ *     { slot: 'dashboard.widgets', component: AnalyticsWidget, order: 10 },
+ *   ],
+ *   routes: [
+ *     { area: 'server', path: '/analytics', name: 'Analytics', component: AnalyticsPage },
+ *   ],
+ * });
+ * ```
+ */
+export declare function createExtension(definition: ExtensionDefinition): void;
+//# sourceMappingURL=createExtension.d.ts.map

package/dist/createExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExtension.d.ts","sourceRoot":"","sources":["../src/createExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAe,MAAM,SAAS,CAAC;AAE3D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CA+BrE"}

package/dist/createExtension.js

@@ -0,0 +1,65 @@
+import { getNoturApi } from './types';
+/**
+ * Factory for registering a Notur extension.
+ *
+ * Usage:
+ * ```ts
+ * import { createExtension } from '@notur/sdk';
+ *
+ * createExtension({
+ *   config: { id: 'acme/analytics', name: 'Analytics', version: '1.0.0' },
+ *   slots: [
+ *     { slot: 'dashboard.widgets', component: AnalyticsWidget, order: 10 },
+ *   ],
+ *   routes: [
+ *     { area: 'server', path: '/analytics', name: 'Analytics', component: AnalyticsPage },
+ *   ],
+ * });
+ * ```
+ */
+export function createExtension(definition) {
+    const { config, slots = [], routes = [], onInit, onDestroy, cssIsolation } = definition;
+    const api = getNoturApi();
+    const resolvedCssIsolation = resolveCssIsolation(api, config.id, cssIsolation);
+    // Register the extension
+    api.registry.registerExtension({
+        id: config.id,
+        name: config.name,
+        version: config.version,
+        slots: slots.map(s => ({ ...s, extensionId: config.id })),
+        routes: routes.map(r => ({ ...r, extensionId: config.id })),
+        cssIsolation: resolvedCssIsolation,
+    });
+    // Register destroy callback
+    if (onDestroy) {
+        api.registry.registerDestroyCallback(config.id, onDestroy);
+    }
+    // Run init callback
+    if (onInit) {
+        try {
+            onInit();
+        }
+        catch (e) {
+            console.error(`[Notur] Extension ${config.id} init error:`, e);
+        }
+    }
+    console.log(`[Notur] Extension registered: ${config.id} v${config.version}`);
+}
+function resolveCssIsolation(api, extensionId, local) {
+    var _a, _b;
+    if (local === true) {
+        return { mode: 'root-class' };
+    }
+    if (local && typeof local === 'object') {
+        return local;
+    }
+    const manifestConfig = (_b = (_a = api.extensions) === null || _a === void 0 ? void 0 : _a.find(ext => ext.id === extensionId)) === null || _b === void 0 ? void 0 : _b.cssIsolation;
+    if (manifestConfig && typeof manifestConfig === 'object') {
+        if ('class' in manifestConfig && !manifestConfig.className) {
+            return { ...manifestConfig, className: manifestConfig.class };
+        }
+        return manifestConfig;
+    }
+    return undefined;
+}
+//# sourceMappingURL=createExtension.js.map

package/dist/createExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExtension.js","sourceRoot":"","sources":["../src/createExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAAC,UAA+B;IAC3D,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,UAAU,CAAC;IACxF,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;IAE1B,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAE/E,yBAAyB;IACzB,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC3B,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACzD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,YAAY,EAAE,oBAAoB;KACrC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,IAAI,SAAS,EAAE,CAAC;QACZ,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED,oBAAoB;IACpB,IAAI,MAAM,EAAE,CAAC;QACT,IAAI,CAAC;YACD,MAAM,EAAE,CAAC;QACb,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,qBAAqB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;QACnE,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,mBAAmB,CACxB,GAAmC,EACnC,WAAmB,EACnB,KAA2C;;IAE3C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,YAAqB,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,cAAc,GAAG,MAAA,MAAA,GAAG,CAAC,UAAU,0CAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,WAAW,CAAC,0CAAE,YAAY,CAAC;IACzF,IAAI,cAAc,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QACvD,IAAI,OAAO,IAAK,cAAsB,IAAI,CAAE,cAAsB,CAAC,SAAS,EAAE,CAAC;YAC3E,OAAO,EAAE,GAAG,cAAc,EAAE,SAAS,EAAG,cAAsB,CAAC,KAAK,EAAE,CAAC;QAC3E,CAAC;QACD,OAAO,cAAc,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/hooks/useExtensionConfig.d.ts

@@ -0,0 +1,17 @@
+interface UseExtensionConfigOptions<T> {
+    baseUrl?: string;
+    initial?: T;
+    pollInterval?: number;
+}
+interface ExtensionConfigState<T> {
+    config: T;
+    loading: boolean;
+    error: string | null;
+    refresh: () => Promise<T>;
+}
+/**
+ * Fetch public extension settings exposed via admin.settings.*.public.
+ */
+export declare function useExtensionConfig<T extends Record<string, any> = Record<string, any>>(extensionId: string, options?: UseExtensionConfigOptions<T>): ExtensionConfigState<T>;
+export {};
+//# sourceMappingURL=useExtensionConfig.d.ts.map

package/dist/hooks/useExtensionConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExtensionConfig.d.ts","sourceRoot":"","sources":["../../src/hooks/useExtensionConfig.ts"],"names":[],"mappings":"AAEA,UAAU,yBAAyB,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,oBAAoB,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClF,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,yBAAyB,CAAC,CAAC,CAAM,GAC3C,oBAAoB,CAAC,CAAC,CAAC,CAoGzB"}

package/dist/hooks/useExtensionConfig.js

@@ -0,0 +1,94 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+/**
+ * Fetch public extension settings exposed via admin.settings.*.public.
+ */
+export function useExtensionConfig(extensionId, options = {}) {
+    const { baseUrl, initial, pollInterval } = options;
+    const [config, setConfig] = useState((initial !== null && initial !== void 0 ? initial : {}));
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const refresh = useCallback(async () => {
+        var _a;
+        if (!extensionId) {
+            const empty = (initial !== null && initial !== void 0 ? initial : {});
+            if (mountedRef.current) {
+                setConfig(empty);
+                setLoading(false);
+                setError(null);
+            }
+            return empty;
+        }
+        if (mountedRef.current) {
+            setLoading(true);
+            setError(null);
+        }
+        const apiBase = baseUrl || '/api/client/notur';
+        const url = `${apiBase}/extensions/${extensionId}/settings`;
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: { Accept: 'application/json' },
+                credentials: 'same-origin',
+            });
+            if (!response.ok) {
+                let message = `Settings request failed: ${response.status} ${response.statusText}`;
+                try {
+                    const body = await response.json();
+                    if (body === null || body === void 0 ? void 0 : body.message) {
+                        message = body.message;
+                    }
+                }
+                catch (_b) {
+                    // Ignore JSON parse failures
+                }
+                throw new Error(message);
+            }
+            const payload = await response.json();
+            const data = ((_a = payload === null || payload === void 0 ? void 0 : payload.data) !== null && _a !== void 0 ? _a : {});
+            if (mountedRef.current) {
+                setConfig(data);
+                setLoading(false);
+                setError(null);
+            }
+            return data;
+        }
+        catch (err) {
+            const message = (err === null || err === void 0 ? void 0 : err.message) || 'Failed to load settings.';
+            if (mountedRef.current) {
+                setLoading(false);
+                setError(message);
+            }
+            throw err;
+        }
+    }, [baseUrl, extensionId, initial]);
+    useEffect(() => {
+        refresh();
+    }, [refresh]);
+    useEffect(() => {
+        if (!pollInterval || pollInterval <= 0) {
+            return;
+        }
+        const id = window.setInterval(() => {
+            refresh().catch(() => {
+                // ignore polling errors; surface via hook state
+            });
+        }, pollInterval);
+        return () => {
+            window.clearInterval(id);
+        };
+    }, [pollInterval, refresh]);
+    return {
+        config,
+        loading,
+        error,
+        refresh,
+    };
+}
+//# sourceMappingURL=useExtensionConfig.js.map

package/dist/hooks/useExtensionConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExtensionConfig.js","sourceRoot":"","sources":["../../src/hooks/useExtensionConfig.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useNavigate.d.ts

@@ -0,0 +1,12 @@
+interface UseNavigateOptions {
+    extensionId: string;
+}
+/**
+ * Returns a navigate function scoped to the extension's route namespace.
+ * Navigates to `/notur/{extensionId}/{path}` using pushState.
+ */
+export declare function useNavigate({ extensionId }: UseNavigateOptions): (path: string, options?: {
+    replace?: boolean;
+}) => void;
+export {};
+//# sourceMappingURL=useNavigate.d.ts.map

package/dist/hooks/useNavigate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigate.d.ts","sourceRoot":"","sources":["../../src/hooks/useNavigate.ts"],"names":[],"mappings":"AAEA,UAAU,kBAAkB;IACxB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,WAAW,EAAE,EAAE,kBAAkB,UAEhD,MAAM,YAAY;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,UAYrD"}

package/dist/hooks/useNavigate.js

@@ -0,0 +1,19 @@
+import { useCallback } from 'react';
+/**
+ * Returns a navigate function scoped to the extension's route namespace.
+ * Navigates to `/notur/{extensionId}/{path}` using pushState.
+ */
+export function useNavigate({ extensionId }) {
+    return useCallback((path, options) => {
+        const fullPath = `/notur/${extensionId}${path.startsWith('/') ? path : '/' + path}`;
+        if (options === null || options === void 0 ? void 0 : options.replace) {
+            window.history.replaceState(null, '', fullPath);
+        }
+        else {
+            window.history.pushState(null, '', fullPath);
+        }
+        // Dispatch popstate so RouteRenderer picks up the change
+        window.dispatchEvent(new PopStateEvent('popstate'));
+    }, [extensionId]);
+}
+//# sourceMappingURL=useNavigate.js.map

package/dist/hooks/useNavigate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigate.js","sourceRoot":"","sources":["../../src/hooks/useNavigate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAMpC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,WAAW,EAAsB;IAC3D,OAAO,WAAW,CACd,CAAC,IAAY,EAAE,OAA+B,EAAE,EAAE;QAC9C,MAAM,QAAQ,GAAG,UAAU,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;QACpF,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;QACjD,CAAC;QACD,yDAAyD;QACzD,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACxD,CAAC,EACD,CAAC,WAAW,CAAC,CAChB,CAAC;AACN,CAAC"}

package/dist/hooks/useNoturEvent.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Subscribe to an inter-extension event.
+ * Automatically unsubscribes on unmount.
+ */
+export declare function useNoturEvent(event: string, handler: (data?: unknown) => void): void;
+/**
+ * Returns a function to emit events on the inter-extension event bus.
+ */
+export declare function useEmitEvent(): (event: string, data?: unknown) => void;
+//# sourceMappingURL=useNoturEvent.d.ts.map

package/dist/hooks/useNoturEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNoturEvent.d.ts","sourceRoot":"","sources":["../../src/hooks/useNoturEvent.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAMpF;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAKtE"}

package/dist/hooks/useNoturEvent.js

@@ -0,0 +1,23 @@
+import { useEffect, useCallback } from 'react';
+import { getNoturApi } from '../types';
+/**
+ * Subscribe to an inter-extension event.
+ * Automatically unsubscribes on unmount.
+ */
+export function useNoturEvent(event, handler) {
+    useEffect(() => {
+        const api = getNoturApi();
+        const unsubscribe = api.registry.onEvent(event, handler);
+        return unsubscribe;
+    }, [event, handler]);
+}
+/**
+ * Returns a function to emit events on the inter-extension event bus.
+ */
+export function useEmitEvent() {
+    return useCallback((event, data) => {
+        const api = getNoturApi();
+        api.registry.emitEvent(event, data);
+    }, []);
+}
+//# sourceMappingURL=useNoturEvent.js.map

package/dist/hooks/useNoturEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNoturEvent.js","sourceRoot":"","sources":["../../src/hooks/useNoturEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,OAAiC;IAC1E,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,WAAW,CAAC;IACvB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IACxB,OAAO,WAAW,CAAC,CAAC,KAAa,EAAE,IAAc,EAAE,EAAE;QACjD,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC,EAAE,EAAE,CAAC,CAAC;AACX,CAAC"}

package/dist/hooks/usePermission.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Hook to check if the current user has a specific extension permission.
+ */
+export declare function usePermission(permission: string): boolean;
+//# sourceMappingURL=usePermission.d.ts.map

package/dist/hooks/usePermission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePermission.d.ts","sourceRoot":"","sources":["../../src/hooks/usePermission.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAwBzD"}

package/dist/hooks/usePermission.js

@@ -0,0 +1,25 @@
+import { useState, useEffect } from 'react';
+import { useServerContext } from './useServerContext';
+/**
+ * Hook to check if the current user has a specific extension permission.
+ */
+export function usePermission(permission) {
+    const serverContext = useServerContext();
+    const [hasPermission, setHasPermission] = useState(false);
+    useEffect(() => {
+        if (!serverContext) {
+            setHasPermission(false);
+            return;
+        }
+        // Admin override
+        if (serverContext.isOwner) {
+            setHasPermission(true);
+            return;
+        }
+        // Check permissions array
+        const perms = serverContext.permissions || [];
+        setHasPermission(perms.includes('*') || perms.includes(permission));
+    }, [serverContext, permission]);
+    return hasPermission;
+}
+//# sourceMappingURL=usePermission.js.map

package/dist/hooks/usePermission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePermission.js","sourceRoot":"","sources":["../../src/hooks/usePermission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC5C,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE1D,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,aAAa,EAAE,CAAC;YACjB,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACxB,OAAO;QACX,CAAC;QAED,iBAAiB;QACjB,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YACxB,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACvB,OAAO;QACX,CAAC;QAED,0BAA0B;QAC1B,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,IAAI,EAAE,CAAC;QAC9C,gBAAgB,CACZ,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CACpD,CAAC;IACN,CAAC,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;IAEhC,OAAO,aAAa,CAAC;AACzB,CAAC"}

package/dist/hooks/useServerContext.d.ts

@@ -0,0 +1,15 @@
+interface ServerContext {
+    uuid: string;
+    name: string;
+    node: string;
+    isOwner: boolean;
+    status: string | null;
+    permissions: string[];
+}
+/**
+ * Hook to access the current server context from the Pterodactyl panel.
+ * Only available within server-scoped pages.
+ */
+export declare function useServerContext(): ServerContext | null;
+export {};
+//# sourceMappingURL=useServerContext.d.ts.map

package/dist/hooks/useServerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useServerContext.d.ts","sourceRoot":"","sources":["../../src/hooks/useServerContext.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CA0BvD"}

package/dist/hooks/useServerContext.js

@@ -0,0 +1,31 @@
+import { useState, useEffect } from 'react';
+/**
+ * Hook to access the current server context from the Pterodactyl panel.
+ * Only available within server-scoped pages.
+ */
+export function useServerContext() {
+    const [context, setContext] = useState(null);
+    useEffect(() => {
+        // Pterodactyl stores server data in the ServerContext React context
+        // We read it from the DOM data attribute as a fallback
+        const serverElement = document.getElementById('app');
+        if (!serverElement)
+            return;
+        const serverData = serverElement.dataset.server;
+        if (serverData) {
+            try {
+                setContext(JSON.parse(serverData));
+            }
+            catch (_a) {
+                // Not on a server page
+            }
+        }
+        // Also check the URL for server UUID
+        const match = window.location.pathname.match(/\/server\/([a-f0-9-]+)/);
+        if (match) {
+            setContext(prev => prev || { uuid: match[1], name: '', node: '', isOwner: false, status: null, permissions: [] });
+        }
+    }, []);
+    return context;
+}
+//# sourceMappingURL=useServerContext.js.map

package/dist/hooks/useServerContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useServerContext.js","sourceRoot":"","sources":["../../src/hooks/useServerContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAW5C;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC5B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAuB,IAAI,CAAC,CAAC;IAEnE,SAAS,CAAC,GAAG,EAAE;QACX,oEAAoE;QACpE,uDAAuD;QACvD,MAAM,aAAa,GAAG,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa;YAAE,OAAO;QAE3B,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC;QAChD,IAAI,UAAU,EAAE,CAAC;YACb,IAAI,CAAC;gBACD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;YACvC,CAAC;YAAC,WAAM,CAAC;gBACL,uBAAuB;YAC3B,CAAC;QACL,CAAC;QAED,qCAAqC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACvE,IAAI,KAAK,EAAE,CAAC;YACR,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QACtH,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/hooks/useUserContext.d.ts

@@ -0,0 +1,12 @@
+interface UserContext {
+    uuid: string;
+    username: string;
+    email: string;
+    isAdmin: boolean;
+}
+/**
+ * Hook to access the current user context from the Pterodactyl panel.
+ */
+export declare function useUserContext(): UserContext | null;
+export {};
+//# sourceMappingURL=useUserContext.d.ts.map

package/dist/hooks/useUserContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserContext.d.ts","sourceRoot":"","sources":["../../src/hooks/useUserContext.ts"],"names":[],"mappings":"AAEA,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAoCnD"}

package/dist/hooks/useUserContext.js

@@ -0,0 +1,38 @@
+import { useState, useEffect } from 'react';
+/**
+ * Hook to access the current user context from the Pterodactyl panel.
+ */
+export function useUserContext() {
+    const [user, setUser] = useState(null);
+    useEffect(() => {
+        let cancelled = false;
+        // Try reading from Pterodactyl's global state
+        const storeState = window.PterodactylUser;
+        if (storeState) {
+            setUser(storeState);
+            return;
+        }
+        // Fallback: fetch from API
+        fetch('/api/client/account', {
+            headers: { Accept: 'application/json' },
+            credentials: 'same-origin',
+        })
+            .then(r => r.json())
+            .then(data => {
+            if (cancelled)
+                return;
+            if (data.attributes) {
+                setUser({
+                    uuid: data.attributes.uuid,
+                    username: data.attributes.username,
+                    email: data.attributes.email,
+                    isAdmin: data.attributes.admin || false,
+                });
+            }
+        })
+            .catch(() => { });
+        return () => { cancelled = true; };
+    }, []);
+    return user;
+}
+//# sourceMappingURL=useUserContext.js.map

package/dist/hooks/useUserContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserContext.js","sourceRoot":"","sources":["../../src/hooks/useUserContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAS5C;;GAEG;AACH,MAAM,UAAU,cAAc;IAC1B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAE3D,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,8CAA8C;QAC9C,MAAM,UAAU,GAAI,MAAc,CAAC,eAAe,CAAC;QACnD,IAAI,UAAU,EAAE,CAAC;YACb,OAAO,CAAC,UAAU,CAAC,CAAC;YACpB,OAAO;QACX,CAAC;QAED,2BAA2B;QAC3B,KAAK,CAAC,qBAAqB,EAAE;YACzB,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YACvC,WAAW,EAAE,aAAa;SAC7B,CAAC;aACG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACnB,IAAI,CAAC,IAAI,CAAC,EAAE;YACT,IAAI,SAAS;gBAAE,OAAO;YACtB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClB,OAAO,CAAC;oBACJ,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;oBAC1B,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ;oBAClC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK;oBAC5B,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,KAAK;iBAC1C,CAAC,CAAC;YACP,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAErB,OAAO,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { createExtension } from './createExtension';
+export { getNoturApi } from './types';
+export type { ExtensionConfig, SlotConfig, RouteConfig, ExtensionDefinition, NoturApi, } from './types';
+export { useServerContext } from './hooks/useServerContext';
+export { useUserContext } from './hooks/useUserContext';
+export { usePermission } from './hooks/usePermission';
+export { useExtensionConfig } from './hooks/useExtensionConfig';
+export { useNoturEvent, useEmitEvent } from './hooks/useNoturEvent';
+export { useNavigate } from './hooks/useNavigate';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,YAAY,EACR,eAAe,EACf,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,QAAQ,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { createExtension } from './createExtension';
+export { getNoturApi } from './types';
+export { useServerContext } from './hooks/useServerContext';
+export { useUserContext } from './hooks/useUserContext';
+export { usePermission } from './hooks/usePermission';
+export { useExtensionConfig } from './hooks/useExtensionConfig';
+export { useNoturEvent, useEmitEvent } from './hooks/useNoturEvent';
+export { useNavigate } from './hooks/useNavigate';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,146 @@
+export interface ExtensionConfig {
+    id: string;
+    name: string;
+    version: string;
+}
+export interface CssIsolationConfig {
+    mode: 'root-class';
+    className?: string;
+}
+export interface SlotRenderContext {
+    path: string;
+    area: 'server' | 'dashboard' | 'account' | 'admin' | 'auth' | 'other';
+    isServer: boolean;
+    isDashboard: boolean;
+    isAccount: boolean;
+    isAdmin: boolean;
+    isAuth: boolean;
+    permissions: string[] | null;
+}
+export interface SlotRenderWhen {
+    area?: SlotRenderContext['area'];
+    areas?: Array<SlotRenderContext['area']>;
+    path?: string | string[];
+    pathStartsWith?: string | string[];
+    pathIncludes?: string | string[];
+    pathMatches?: string | RegExp;
+    permission?: string | string[];
+    server?: boolean;
+    dashboard?: boolean;
+    account?: boolean;
+    admin?: boolean;
+    auth?: boolean;
+}
+export type SlotRenderCondition = boolean | SlotRenderWhen | ((context: SlotRenderContext) => boolean);
+export interface SlotConfig {
+    slot: string;
+    component: React.ComponentType<any>;
+    order?: number;
+    priority?: number;
+    label?: string;
+    icon?: string;
+    permission?: string;
+    props?: Record<string, any>;
+    when?: SlotRenderCondition;
+}
+export interface RouteConfig {
+    area: 'server' | 'dashboard' | 'account';
+    path: string;
+    name: string;
+    component: React.ComponentType<any>;
+    icon?: string;
+    permission?: string;
+}
+export interface ExtensionDefinition {
+    config: ExtensionConfig;
+    slots?: SlotConfig[];
+    routes?: RouteConfig[];
+    cssIsolation?: CssIsolationConfig | boolean;
+    onInit?: () => void;
+    onDestroy?: () => void;
+}
+export interface SlotRegistration {
+    extensionId: string;
+    slot: string;
+    component: React.ComponentType<any>;
+    order?: number;
+    priority?: number;
+    label?: string;
+    icon?: string;
+    permission?: string;
+    scopeClass?: string;
+    props?: Record<string, any>;
+    when?: SlotRenderCondition;
+}
+export interface RouteRegistration {
+    extensionId: string;
+    area: 'server' | 'dashboard' | 'account';
+    path: string;
+    name: string;
+    component: React.ComponentType<any>;
+    icon?: string;
+    permission?: string;
+    scopeClass?: string;
+}
+export interface NoturApi {
+    version: string;
+    registry: {
+        registerSlot: (registration: Omit<SlotRegistration, 'extensionId'> & {
+            extensionId?: string;
+        }) => void;
+        registerRoute: (area: RouteRegistration['area'], route: Omit<RouteRegistration, 'extensionId' | 'area'> & {
+            extensionId?: string;
+        }) => void;
+        registerExtension: (ext: {
+            id: string;
+            name: string;
+            version: string;
+            slots: SlotRegistration[];
+            routes: RouteRegistration[];
+            theme?: {
+                variables: Record<string, string>;
+                priority?: number;
+            };
+            cssIsolation?: CssIsolationConfig;
+        }) => void;
+        registerDestroyCallback: (extensionId: string, callback: () => void) => void;
+        unregisterExtension: (extensionId: string) => void;
+        getSlot: (slotId: string) => SlotRegistration[];
+        getRoutes: (area: RouteRegistration['area']) => RouteRegistration[];
+        on: (event: string, callback: () => void) => () => void;
+        emitEvent: (event: string, data?: unknown) => void;
+        onEvent: (event: string, callback: (data?: unknown) => void) => () => void;
+    };
+    hooks: {
+        useSlot: (slotId: string) => SlotRegistration[];
+        useExtensionApi: (options: {
+            extensionId: string;
+            baseUrl?: string;
+        }) => {
+            data: unknown;
+            loading: boolean;
+            error: string | null;
+            get: (path: string) => Promise<unknown>;
+            post: (path: string, body?: unknown) => Promise<unknown>;
+            put: (path: string, body?: unknown) => Promise<unknown>;
+            patch: (path: string, body?: unknown) => Promise<unknown>;
+            delete: (path: string) => Promise<unknown>;
+            request: (path: string, options?: RequestInit) => Promise<unknown>;
+        };
+        useExtensionState: <T extends Record<string, any>>(extensionId: string, initialState: T) => [T, (partial: Partial<T>) => void, () => void];
+        useNoturTheme: () => Record<string, string>;
+    };
+    SLOT_IDS: Record<string, string>;
+    unregisterExtension: (id: string) => void;
+    extensions?: Array<{
+        id: string;
+        bundle?: string;
+        styles?: string;
+        cssIsolation?: CssIsolationConfig;
+    }>;
+}
+/**
+ * Get the Notur API from the window global.
+ */
+export declare function getNoturApi(): NoturApi;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * Get the Notur API from the window global.
+ */
+export function getNoturApi() {
+    const api = window.__NOTUR__;
+    if (!api) {
+        throw new Error('[Notur SDK] Bridge runtime not found. Ensure bridge.js is loaded first.');
+    }
+    return api;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAuIA;;GAEG;AACH,MAAM,UAAU,WAAW;IACvB,MAAM,GAAG,GAAI,MAAc,CAAC,SAAS,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@notur/sdk",
+  "version": "1.0.0",
+  "description": "Notur Extension Developer SDK",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sak0a/notur.git",
+    "directory": "sdk"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "notur",
+    "pterodactyl",
+    "extension",
+    "plugin",
+    "sdk"
+  ],
+  "files": [
+    "dist/",
+    "webpack.extension.config.js",
+    "templates/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "bun run build"
+  },
+  "peerDependencies": {
+    "react": "^16.14.0",
+    "react-dom": "^16.14.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "@types/react": "^16.14.0",
+    "@types/react-dom": "^16.9.0"
+  }
+}

package/templates/ExampleComponent.tsx.template

@@ -0,0 +1,40 @@
+import * as React from 'react';
+import { createExtension } from '@notur/sdk';
+
+const ExampleWidget: React.FC<{ extensionId: string }> = ({ extensionId }) => {
+    return (
+        <div
+            style={{
+                padding: '1rem',
+                background: 'var(--notur-glass-bg, var(--notur-bg-secondary))',
+                border: '1px solid var(--notur-glass-border, var(--notur-border))',
+                borderRadius: 'var(--notur-radius-lg)',
+                boxShadow: 'var(--notur-glass-shadow, 0 12px 30px rgba(0, 0, 0, 0.35))',
+                backdropFilter: 'blur(var(--notur-glass-blur, 12px))',
+                WebkitBackdropFilter: 'blur(var(--notur-glass-blur, 12px))',
+            }}
+        >
+            <h3 style={{ color: 'var(--notur-text-primary)' }}>
+                {{displayName}}
+            </h3>
+            <p style={{ color: 'var(--notur-text-secondary)' }}>
+                Hello from {{vendor}}/{{name}}!
+            </p>
+        </div>
+    );
+};
+
+createExtension({
+    config: {
+        id: '{{vendor}}/{{name}}',
+        name: '{{displayName}}',
+        version: '1.0.0',
+    },
+    slots: [
+        {
+            slot: 'dashboard.widgets',
+            component: ExampleWidget,
+            order: 100,
+        },
+    ],
+});

package/templates/ServiceProvider.php.template

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace {{namespace}};
+
+use Notur\Contracts\ExtensionInterface;
+use Notur\Contracts\HasRoutes;
+use Notur\Contracts\HasFrontendSlots;
+
+class {{className}} implements ExtensionInterface, HasRoutes, HasFrontendSlots
+{
+    public function getId(): string
+    {
+        return '{{vendor}}/{{name}}';
+    }
+
+    public function getName(): string
+    {
+        return '{{displayName}}';
+    }
+
+    public function getVersion(): string
+    {
+        return '1.0.0';
+    }
+
+    public function register(): void
+    {
+        //
+    }
+
+    public function boot(): void
+    {
+        //
+    }
+
+    public function getBasePath(): string
+    {
+        return __DIR__ . '/..';
+    }
+
+    public function getRouteFiles(): array
+    {
+        return [
+            'api-client' => 'src/routes/api-client.php',
+        ];
+    }
+
+    public function getFrontendSlots(): array
+    {
+        return [];
+    }
+}

package/templates/extension.yaml.template

@@ -0,0 +1,43 @@
+notur: "1.0"
+id: "{{vendor}}/{{name}}"
+name: "{{displayName}}"
+version: "1.0.0"
+description: "{{description}}"
+authors:
+  - name: "{{authorName}}"
+license: "MIT"
+
+requires:
+  notur: "^1.0"
+  pterodactyl: "^1.11"
+  php: "^8.2"
+
+capabilities:
+  routes: "^1"
+  health: "^1"
+  schedules: "^1"
+  css_isolation: "^1"
+
+entrypoint: "{{namespace}}\\{{className}}"
+
+autoload:
+  psr-4:
+    "{{namespace}}\\": "src/"
+
+backend:
+  routes:
+    api-client: "src/routes/api-client.php"
+  migrations: "database/migrations"
+  permissions: []
+
+frontend:
+  bundle: "resources/frontend/dist/extension.js"
+  css_isolation:
+    mode: "root-class"
+  slots: {}
+
+health:
+  checks: []
+
+schedules:
+  tasks: []

package/webpack.extension.config.js

@@ -0,0 +1,52 @@
+/**
+ * Base webpack configuration for Notur extensions.
+ *
+ * Extension developers can import and extend this config:
+ *
+ * ```js
+ * const base = require('@notur/sdk/webpack.extension.config');
+ *
+ * module.exports = {
+ *     ...base,
+ *     output: {
+ *         ...base.output,
+ *         library: { name: '__NOTUR_EXT_MyExtension__', type: 'umd' },
+ *     },
+ * };
+ * ```
+ */
+const path = require('path');
+
+module.exports = {
+    entry: './src/index.ts',
+    output: {
+        filename: 'bundle.js',
+        path: path.resolve(process.cwd(), 'dist'),
+        library: {
+            name: '__NOTUR_EXT__',
+            type: 'umd',
+        },
+        clean: true,
+    },
+    resolve: {
+        extensions: ['.ts', '.tsx', '.js', '.jsx'],
+    },
+    module: {
+        rules: [
+            {
+                test: /\.tsx?$/,
+                use: 'ts-loader',
+                exclude: /node_modules/,
+            },
+            {
+                test: /\.css$/,
+                use: ['style-loader', 'css-loader'],
+            },
+        ],
+    },
+    externals: {
+        react: 'React',
+        'react-dom': 'ReactDOM',
+        '@notur/sdk': '__NOTUR__',
+    },
+};