@notur/sdk 1.2.0 → 1.2.8

package/README.md

@@ -1,20 +1,17 @@
 # @notur/sdk
 
-Notur Extension Developer SDK. This package provides the runtime helpers and React hooks needed to register Notur extensions, define UI slots and routes, and interact with the Notur bridge at runtime.
+Notur Extension Developer SDK for [Pterodactyl Panel v1](https://github.com/pterodactyl/panel). Provides the runtime API, React hooks, CLI tools, webpack config, and starter templates for building Notur extensions.
 
 ## Install
 
 ```bash
-# Using npm, yarn, pnpm, or bun
 npm install @notur/sdk
 # or: yarn add @notur/sdk
 # or: pnpm add @notur/sdk
 # or: bun add @notur/sdk
 ```
 
-Peer dependencies:
-- `react` `^16.14.0`
-- `react-dom` `^16.14.0`
+Peer dependencies: `react ^16.14.0`, `react-dom ^16.14.0`
 
 ## Quick Start
 
@@ -24,7 +21,7 @@ import AnalyticsWidget from './components/AnalyticsWidget';
 import AnalyticsPage from './pages/AnalyticsPage';
 
 createExtension({
-  config: { id: 'acme/analytics', name: 'Analytics', version: '1.0.0' },
+  id: 'acme/analytics',
   slots: [
     { slot: 'dashboard.widgets', component: AnalyticsWidget, order: 10 },
   ],
@@ -34,104 +31,238 @@ createExtension({
 });
 ```
 
-Notes:
-- The Notur bridge must be loaded before your bundle. The SDK reads the bridge from `window.__NOTUR__`.
-- Extension IDs should be stable and unique (e.g., `vendor/name`).
+Name and version are auto-resolved from `extension.yaml`. The full `config: { id, name, version }` syntax is still supported for backward compatibility.
+
+---
 
 ## API
 
 ### `createExtension(definition)`
 
-Registers the extension with Notur, wires routes and slots, and runs optional lifecycle hooks.
+Registers the extension with the Notur bridge, wiring slots, routes, and lifecycle hooks.
+
+Two calling conventions:
+
+```ts
+// Simplified (recommended) — name/version auto-resolved from extension.yaml:
+createExtension({ id: 'acme/analytics', slots: [...], routes: [...] });
+
+// Full (backward compatible):
+createExtension({ config: { id: 'acme/analytics' }, slots: [...], routes: [...] });
+```
+
+**Definition fields:**
 
-Definition fields:
-- `config`: `{ id, name, version }`
-- `slots`: UI slot registrations (`slot`, `component`, `order`, `when`, etc.)
-- `routes`: Panel routes (`area`, `path`, `name`, `component`, `permission`, etc.)
-- `cssIsolation`: `true` or `{ mode: 'root-class', className?: string }`
-- `onInit`: Called after registration.
-- `onDestroy`: Called when the extension is unloaded.
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Extension ID (simplified form) |
+| `config` | `{ id, name?, version? }` | Extension identity (full form) |
+| `slots` | `SlotConfig[]` | UI slot registrations |
+| `routes` | `RouteConfig[]` | Panel route registrations |
+| `cssIsolation` | `boolean \| CssIsolationConfig` | CSS isolation (`true` for defaults, or `{ mode: 'root-class', className? }`) |
+| `onInit` | `() => void` | Called after registration |
+| `onDestroy` | `() => void` | Called when the extension is unloaded |
 
 ### Hooks
 
 All hooks are exported from `@notur/sdk`.
 
-- `useServerContext()`: Returns server context or `null` when not on a server page.
-- `useUserContext()`: Returns user info or `null` while loading.
-- `usePermission(permission)`: Checks for a specific extension permission.
-- `useExtensionConfig(extensionId, options)`: Loads public settings for the extension.
-  - `options`: `{ baseUrl?, initial?, pollInterval? }`
-- `useNoturEvent(event, handler)`: Subscribe to inter-extension events.
-- `useEmitEvent()`: Returns a function to emit inter-extension events.
-- `useNavigate({ extensionId })`: Navigate inside your extension namespace.
+| Hook | Description |
+|------|-------------|
+| `useServerContext()` | Returns server context or `null` when not on a server page |
+| `useUserContext()` | Returns user info or `null` while loading |
+| `usePermission(permission)` | Checks a specific extension permission |
+| `useExtensionConfig(extensionId, options?)` | Loads public settings (`options: { baseUrl?, initial?, pollInterval? }`) |
+| `useNoturEvent(event, handler)` | Subscribe to inter-extension events |
+| `useEmitEvent()` | Returns a function to emit inter-extension events |
+| `useNavigate({ extensionId })` | Navigate inside your extension namespace |
+
+### TypeScript Types
+
+```ts
+import type {
+  ExtensionConfig,
+  ExtensionDefinition,
+  SimpleExtensionDefinition,
+  SlotConfig,
+  RouteConfig,
+  NoturApi,
+} from '@notur/sdk';
+```
+
+---
+
+## CLI Tools
+
+The SDK ships two CLI tools, available via `npx`, `yarn dlx`, `pnpm dlx`, or `bunx`.
 
-## Packaging Your Extension
+### `notur-pack` — Package extensions
 
-The SDK includes a CLI tool to package your extension into a `.notur` archive that can be uploaded to the Pterodactyl admin panel.
+Creates a `.notur` archive (tar.gz) from your extension directory, ready to upload to the Pterodactyl admin panel.
 
 ```bash
-# From your extension directory (using npx, yarn dlx, pnpm dlx, or bunx)
+# Pack current directory
 npx notur-pack
 
-# Specify a different path
+# Pack a specific path
 npx notur-pack /path/to/my-extension
 
 # Custom output filename
 npx notur-pack --output my-extension.notur
+npx notur-pack -o my-extension.notur
 ```
 
-This creates a `.notur` file (tar.gz archive) containing:
-- All extension files (excluding `node_modules`, `.git`, `vendor`, `.idea`, `.vscode`)
-- A `checksums.json` with SHA-256 hashes for integrity verification
+The archive includes all extension files (excluding `node_modules`, `.git`, `vendor`, `.idea`, `.vscode`, `.DS_Store`) plus a generated `checksums.json` with SHA-256 hashes for integrity verification.
 
-Upload the resulting `.notur` file to your Pterodactyl admin panel at `/admin/notur/extensions`.
+Output:
+- `vendor-name-1.0.0.notur` — the extension archive
+- `vendor-name-1.0.0.notur.sha256` — SHA-256 checksum file
 
-## Signing Extensions
+Upload the `.notur` file at `/admin/notur/extensions` in your panel.
 
-The SDK provides tools for Ed25519 signing of extension archives, compatible with the PHP `notur:keygen` and `notur:export --sign` commands.
+#### Signing archives
 
-### Generating a Keypair
+Sign your archive with Ed25519 for panels that have `require_signatures` enabled. Compatible with the PHP `notur:keygen` / `notur:export --sign` commands.
 
 ```bash
-npx notur-keygen
+# Sign using environment variable
+NOTUR_SECRET_KEY=<your_secret_key> npx notur-pack --sign
+
+# Sign using flag
+npx notur-pack --sign --secret-key <your_secret_key>
 ```
 
-This generates a new Ed25519 keypair and outputs:
-- **Public Key** (64 hex characters) -- Share with panel administrators
-- **Secret Key** (128 hex characters) -- Keep private, used for signing
+This additionally produces:
+- `vendor-name-1.0.0.notur.sig` — Ed25519 signature (hex-encoded)
 
-### Signing an Archive
+The `.sig` format is compatible with PHP's `SignatureVerifier::verify()`.
 
-```bash
-# Using environment variable
-NOTUR_SECRET_KEY=your_secret_key npx notur-pack --sign
+### `notur-keygen` — Generate signing keypair
+
+Generates a new Ed25519 keypair for extension signing.
 
-# Or with --secret-key flag
-npx notur-pack --sign --secret-key your_secret_key
+```bash
+npx notur-keygen
 ```
 
-This produces three files:
-- `vendor-name-1.0.0.notur` -- The extension archive
-- `vendor-name-1.0.0.notur.sha256` -- SHA-256 checksum
-- `vendor-name-1.0.0.notur.sig` -- Ed25519 signature (hex-encoded)
+Output:
+- **Public Key** (64 hex chars) — add to your panel config as `NOTUR_PUBLIC_KEY`
+- **Secret Key** (128 hex chars) — keep private, use with `notur-pack --sign`
 
-The `.sig` file format is compatible with PHP's `SignatureVerifier::verify()` and panels with `require_signatures` enabled.
+The output format matches the PHP `php artisan notur:keygen` command.
 
-## Build
+---
 
-```bash
-# Using npm, yarn, pnpm, or bun
-npm run build
+## Webpack Config
+
+The SDK includes a base webpack configuration that extension developers can import and extend. This handles TypeScript compilation, CSS loading, React externalization, and UMD output format.
+
+```js
+// webpack.config.js
+const base = require('@notur/sdk/webpack.extension.config');
+
+module.exports = {
+  ...base,
+  entry: './resources/frontend/src/index.tsx',
+  output: {
+    ...base.output,
+    filename: 'extension.js',
+    path: require('path').resolve(__dirname, 'resources/frontend/dist'),
+  },
+};
 ```
 
-Outputs are written to `dist/`.
+**What the base config provides:**
+
+| Setting | Value |
+|---------|-------|
+| Entry | `./src/index.ts` |
+| Output | `dist/bundle.js` (UMD) |
+| Resolve | `.ts`, `.tsx`, `.js`, `.jsx` |
+| Loaders | `ts-loader` for TypeScript, `style-loader`/`css-loader` for CSS |
+| Externals | `react` → `React`, `react-dom` → `ReactDOM`, `@notur/sdk` → `__NOTUR__` |
+
+Override `entry` and `output` to match your extension's directory structure.
+
+---
 
 ## Templates
 
-The SDK package ships a few templates in `templates/`:
-- `extension.yaml.template` for extension manifests
-- `ServiceProvider.php.template` for backend registration
-- `ExampleComponent.tsx.template` for a starter UI component
+The SDK ships starter templates in `templates/`, used by the PHP `notur:new` scaffolding command. They can also serve as reference when creating extensions manually.
+
+### `extension.yaml.template`
+
+Minimal extension manifest with placeholders:
+
+```yaml
+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"
+```
+
+### `ServiceProvider.php.template`
+
+PHP entrypoint using the `NoturExtension` base class. Metadata (`getId()`, `getName()`, `getVersion()`, `getBasePath()`) is auto-resolved from `extension.yaml` — no boilerplate needed:
+
+```php
+namespace {{namespace}};
+
+use Notur\Support\NoturExtension;
+use Notur\Contracts\HasRoutes;
+
+class {{className}} extends NoturExtension implements HasRoutes
+{
+    public function register(): void { }
+    public function boot(): void { }
+
+    public function getRouteFiles(): array
+    {
+        return ['api-client' => 'src/routes/api-client.php'];
+    }
+}
+```
+
+### `ExampleComponent.tsx.template`
+
+Starter React component with `createExtension()` registration using the simplified syntax:
+
+```tsx
+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-bg-secondary)' }}>
+            <h3>{{displayName}}</h3>
+            <p>Hello from {{vendor}}/{{name}}!</p>
+        </div>
+    );
+};
+
+createExtension({
+    id: '{{vendor}}/{{name}}',
+    slots: [{ slot: 'dashboard.widgets', component: ExampleWidget, order: 100 }],
+});
+```
+
+---
+
+## Build
+
+```bash
+npm run build    # Compiles TypeScript to dist/
+npm run dev      # Watch mode
+```
 
 ## License
 

package/bin/notur-pack.js

@@ -18,7 +18,7 @@
 const fs = require('fs');
 const path = require('path');
 const crypto = require('crypto');
-const { execSync } = require('child_process');
+const { spawnSync } = require('child_process');
 const yaml = require('yaml');
 
 const EXCLUDE_PATTERNS = [
@@ -38,6 +38,7 @@ function parseArgs() {
         output: null,
         sign: false,
         secretKey: null,
+        dryRun: false,
     };
 
     for (let i = 0; i < args.length; i++) {
@@ -47,6 +48,8 @@ function parseArgs() {
             options.sign = true;
         } else if (args[i] === '--secret-key') {
             options.secretKey = args[++i];
+        } else if (args[i] === '--dry-run') {
+            options.dryRun = true;
         } else if (!args[i].startsWith('-')) {
             options.path = args[i];
         }
@@ -55,6 +58,20 @@ function parseArgs() {
     return options;
 }
 
+function isGnuTarAvailable() {
+    const result = spawnSync('tar', ['--version'], {
+        stdio: 'pipe',
+        encoding: 'utf8',
+    });
+
+    if (result.error || result.status !== 0) {
+        return false;
+    }
+
+    const stdout = `${result.stdout || ''}${result.stderr || ''}`;
+    return /gnu tar/i.test(stdout);
+}
+
 function loadManifest(dir) {
     const manifestPath = path.join(dir, 'extension.yaml');
     if (!fs.existsSync(manifestPath)) {
@@ -188,6 +205,10 @@ async function pack(sourceDir, outputPath, options = {}) {
 
     // Collect files and compute checksums
     const files = collectFiles(resolvedDir);
+    if (files.length === 0) {
+        console.error('Error: no packageable files found in extension directory.');
+        process.exit(1);
+    }
     const checksums = computeChecksums(resolvedDir, files);
 
     console.log(`  Found ${files.length} files`);
@@ -201,15 +222,46 @@ async function pack(sourceDir, outputPath, options = {}) {
     const filename = outputPath || `${manifest.id.replace('/', '-')}-${manifest.version}.notur`;
     const outputFullPath = path.resolve(filename);
 
-    // Build exclude args for tar
-    const excludeArgs = EXCLUDE_PATTERNS.map(p => `--exclude='${p}'`).join(' ');
+    // Build safe argument list for tar (no shell interpolation).
+    const deterministicArgs = isGnuTarAvailable()
+        ? ['--sort=name', '--mtime=UTC 1970-01-01', '--owner=0', '--group=0', '--numeric-owner']
+        : [];
+
+    const tarArgs = [
+        ...deterministicArgs,
+        ...EXCLUDE_PATTERNS.flatMap(p => ['--exclude', p]),
+        '-czf',
+        outputFullPath,
+        '.',
+    ];
+
+    if (options.dryRun) {
+        console.log('\nDry run mode (no archive written).');
+        console.log(`Would create: ${outputFullPath}`);
+        console.log(`Would include: ${files.length} files`);
+        if (deterministicArgs.length > 0) {
+            console.log('Deterministic archive mode: enabled (GNU tar flags).');
+        } else {
+            console.log('Deterministic archive mode: not available (GNU tar not detected).');
+        }
+        return;
+    }
 
     try {
-        // Create tar.gz archive
-        execSync(
-            `tar ${excludeArgs} -czvf "${outputFullPath}" .`,
-            { cwd: resolvedDir, stdio: 'pipe' }
-        );
+        const tarResult = spawnSync('tar', tarArgs, {
+            cwd: resolvedDir,
+            stdio: 'pipe',
+            encoding: 'utf8',
+        });
+
+        if (tarResult.error) {
+            throw new Error(`Failed to execute tar: ${tarResult.error.message}`);
+        }
+
+        if (tarResult.status !== 0) {
+            const stderr = (tarResult.stderr || '').trim();
+            throw new Error(`tar failed with exit code ${tarResult.status}${stderr ? `: ${stderr}` : ''}`);
+        }
 
         // Compute archive checksum
         const archiveChecksum = computeChecksum(outputFullPath);

package/dist/createExtension.d.ts

@@ -1,21 +1,29 @@
-import { ExtensionDefinition } from './types';
+import { ExtensionDefinition, SimpleExtensionDefinition } from './types';
 /**
  * Factory for registering a Notur extension.
  *
- * Usage:
+ * Supports two calling conventions:
+ *
+ * **Simplified** (recommended) — `id` at the top level, name/version auto-resolved from manifest:
  * ```ts
- * import { createExtension } from '@notur/sdk';
+ * createExtension({
+ *     id: 'acme/analytics',
+ *     slots: [
+ *         { slot: 'dashboard.widgets', component: AnalyticsWidget, order: 10 },
+ *     ],
+ * });
+ * ```
  *
+ * **Full** — explicit config object (backward compatible):
+ * ```ts
  * 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 },
- *   ],
+ *     config: { id: 'acme/analytics', name: 'Analytics', version: '1.0.0' },
+ *     slots: [
+ *         { slot: 'dashboard.widgets', component: AnalyticsWidget, order: 10 },
+ *     ],
  * });
  * ```
  */
 export declare function createExtension(definition: ExtensionDefinition): void;
+export declare function createExtension(definition: SimpleExtensionDefinition): void;
 //# sourceMappingURL=createExtension.d.ts.map

package/dist/createExtension.d.ts.map

@@ -1 +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,CAiCrE"}
+{"version":3,"file":"createExtension.d.ts","sourceRoot":"","sources":["../src/createExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAe,MAAM,SAAS,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;AACvE,wBAAgB,eAAe,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,CAAC"}

package/dist/createExtension.js

@@ -1,25 +1,12 @@
 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;
+    // Normalize: if 'id' is at top level (simplified form), wrap in config
+    const normalized = isSimpleDefinition(definition)
+        ? { ...definition, config: { id: definition.id } }
+        : definition;
+    const { config, slots = [], routes = [], onInit, onDestroy, cssIsolation } = normalized;
     const api = getNoturApi();
+    warnOnMisconfiguration(config.id, slots, routes);
     const resolvedConfig = resolveConfig(api, config);
     const resolvedCssIsolation = resolveCssIsolation(api, config.id, cssIsolation);
     // Register the extension
@@ -46,6 +33,12 @@ export function createExtension(definition) {
     }
     console.log(`[Notur] Extension registered: ${resolvedConfig.id} v${resolvedConfig.version}`);
 }
+/**
+ * Check if the definition uses the simplified form (id at top level).
+ */
+function isSimpleDefinition(definition) {
+    return 'id' in definition && !('config' in definition);
+}
 function resolveConfig(api, config) {
     var _a, _b, _c;
     const manifestEntry = (_a = api.extensions) === null || _a === void 0 ? void 0 : _a.find(ext => ext.id === config.id);
@@ -77,4 +70,38 @@ function resolveCssIsolation(api, extensionId, local) {
     }
     return undefined;
 }
+function warnOnMisconfiguration(extensionId, slots, routes) {
+    if (!/^[a-z0-9-]+\/[a-z0-9-]+$/.test(extensionId)) {
+        console.warn(`[Notur SDK] Extension id "${extensionId}" does not match vendor/name format (lowercase, hyphen-safe).`);
+    }
+    const normalizedSlots = slots !== null && slots !== void 0 ? slots : [];
+    const normalizedRoutes = routes !== null && routes !== void 0 ? routes : [];
+    const routeKeys = new Set();
+    for (const slot of normalizedSlots) {
+        if (!slot.slot || typeof slot.slot !== 'string') {
+            console.warn(`[Notur SDK] Extension ${extensionId} has a slot registration without a valid slot id.`);
+        }
+        if (typeof slot.component !== 'function') {
+            console.warn(`[Notur SDK] Extension ${extensionId} slot "${slot.slot}" has a non-component value. Expected a React component.`);
+        }
+    }
+    for (const route of normalizedRoutes) {
+        if (!route.path.startsWith('/')) {
+            console.warn(`[Notur SDK] Extension ${extensionId} route "${route.name}" should start with "/". Received "${route.path}".`);
+        }
+        if (typeof route.component !== 'function') {
+            console.warn(`[Notur SDK] Extension ${extensionId} route "${route.name}" has a non-component value. Expected a React component.`);
+        }
+        if (route.permission && !route.permission.includes('.')) {
+            console.warn(`[Notur SDK] Extension ${extensionId} route "${route.name}" uses permission "${route.permission}" without namespace (recommended: vendor.action).`);
+        }
+        const routeKey = `${route.area}:${route.path}`;
+        if (routeKeys.has(routeKey)) {
+            console.warn(`[Notur SDK] Extension ${extensionId} registers duplicate route path "${route.path}" in area "${route.area}".`);
+        }
+        else {
+            routeKeys.add(routeKey);
+        }
+    }
+}
 //# sourceMappingURL=createExtension.js.map

package/dist/createExtension.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,13 @@
+export interface ScopedEventChannel {
+    eventName: (name: string) => string;
+    emit: (name: string, data?: unknown) => void;
+    on: (name: string, callback: (data?: unknown) => void) => () => void;
+}
+/**
+ * Create a namespaced inter-extension event channel.
+ *
+ * This avoids accidental collisions in global event names by scoping
+ * all events to `ext:<extensionId>:<event>`.
+ */
+export declare function createScopedEventChannel(extensionId: string): ScopedEventChannel;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACxE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAchF"}

package/dist/events.js

@@ -0,0 +1,21 @@
+import { getNoturApi } from './types';
+/**
+ * Create a namespaced inter-extension event channel.
+ *
+ * This avoids accidental collisions in global event names by scoping
+ * all events to `ext:<extensionId>:<event>`.
+ */
+export function createScopedEventChannel(extensionId) {
+    const api = getNoturApi();
+    const eventName = (name) => `ext:${extensionId}:${name}`;
+    return {
+        eventName,
+        emit: (name, data) => {
+            api.registry.emitEvent(eventName(name), data);
+        },
+        on: (name, callback) => {
+            return api.registry.onEvent(eventName(name), callback);
+        },
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQtC;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IACxD,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;IAE1B,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,OAAO,WAAW,IAAI,IAAI,EAAE,CAAC;IAEzE,OAAO;QACH,SAAS;QACT,IAAI,EAAE,CAAC,IAAY,EAAE,IAAc,EAAQ,EAAE;YACzC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,EAAE,EAAE,CAAC,IAAY,EAAE,QAAkC,EAAgB,EAAE;YACnE,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC3D,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/hooks/usePermission.js

@@ -18,7 +18,7 @@ export function usePermission(permission) {
         }
         // Check permissions array
         const perms = serverContext.permissions || [];
-        setHasPermission(perms.includes('*') || perms.includes(permission));
+        setHasPermission(perms.indexOf('*') !== -1 || perms.indexOf(permission) !== -1);
     }, [serverContext, permission]);
     return hasPermission;
 }

package/dist/hooks/usePermission.js.map

@@ -1 +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"}
+{"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,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAChE,CAAC;IACN,CAAC,EAAE,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;IAEhC,OAAO,aAAa,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 export { createExtension } from './createExtension';
 export { getNoturApi } from './types';
-export type { ExtensionConfig, SlotConfig, RouteConfig, ExtensionDefinition, NoturApi, } from './types';
+export type { ExtensionConfig, SlotConfig, RouteConfig, ExtensionDefinition, SimpleExtensionDefinition, 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';
+export { createScopedEventChannel } from './events';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,yBAAyB,EACzB,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;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -6,4 +6,5 @@ export { usePermission } from './hooks/usePermission';
 export { useExtensionConfig } from './hooks/useExtensionConfig';
 export { useNoturEvent, useEmitEvent } from './hooks/useNoturEvent';
 export { useNavigate } from './hooks/useNavigate';
+export { createScopedEventChannel } from './events';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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;AAStC,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;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC"}

package/dist/types.d.ts

@@ -1,6 +1,15 @@
+/**
+ * Extension identity configuration.
+ *
+ * Only `id` is required. `name` and `version` are auto-resolved from
+ * the extension.yaml manifest if omitted.
+ */
 export interface ExtensionConfig {
+    /** Unique extension identifier in vendor/name format (e.g. "acme/analytics"). */
     id: string;
+    /** Human-readable name. Auto-resolved from extension.yaml if omitted. */
     name?: string;
+    /** Semantic version string. Auto-resolved from extension.yaml if omitted. */
     version?: string;
 }
 export interface CssIsolationConfig {
@@ -51,6 +60,17 @@ export interface RouteConfig {
     icon?: string;
     permission?: string;
 }
+/**
+ * Full extension definition passed to `createExtension()`.
+ *
+ * @example
+ * ```ts
+ * createExtension({
+ *     config: { id: 'acme/analytics' },
+ *     slots: [{ slot: 'dashboard.widgets', component: Widget }],
+ * });
+ * ```
+ */
 export interface ExtensionDefinition {
     config: ExtensionConfig;
     slots?: SlotConfig[];
@@ -59,6 +79,24 @@ export interface ExtensionDefinition {
     onInit?: () => void;
     onDestroy?: () => void;
 }
+/**
+ * Simplified extension definition with `id` at the top level.
+ *
+ * Name and version are auto-resolved from the extension.yaml manifest.
+ * This is the recommended format for most extensions.
+ *
+ * @example
+ * ```ts
+ * createExtension({
+ *     id: 'acme/analytics',
+ *     slots: [{ slot: 'dashboard.widgets', component: Widget }],
+ * });
+ * ```
+ */
+export type SimpleExtensionDefinition = Omit<ExtensionDefinition, 'config'> & {
+    /** Unique extension identifier in vendor/name format (e.g. "acme/analytics"). */
+    id: string;
+};
 export interface SlotRegistration {
     extensionId: string;
     slot: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC5B,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACtE,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,GACzB,OAAO,GACP,cAAc,GACd,CAAC,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC;AAEhD,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAAG;IAC1E,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACN,YAAY,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,GAAG;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;QACvG,aAAa,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,MAAM,CAAC,GAAG;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;QAC5I,iBAAiB,EAAE,CAAC,GAAG,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC;YAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;YAAC,KAAK,CAAC,EAAE;gBAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,YAAY,CAAC,EAAE,kBAAkB,CAAA;SAAE,KAAK,IAAI,CAAC;QAC7O,uBAAuB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;QAC7E,mBAAmB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;QACnD,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAChD,SAAS,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAAK,iBAAiB,EAAE,CAAC;QACpE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;QACxD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;QACnD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;KAC9E,CAAC;IACF,KAAK,EAAE;QACH,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAChD,eAAe,EAAE,CAAC,OAAO,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK;YACrE,IAAI,EAAE,OAAO,CAAC;YACd,OAAO,EAAE,OAAO,CAAC;YACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YACrB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;YACzD,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;YACxD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SACtE,CAAC;QACF,iBAAiB,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,CAAC,KACd,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC;QACpD,aAAa,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/C,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;CAC5I;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAMtC"}

package/dist/types.js.map

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

@@ -1,6 +1,6 @@
 {
   "name": "@notur/sdk",
-  "version": "1.2.0",
+  "version": "1.2.8",
   "description": "Notur Extension Developer SDK",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/templates/ExampleComponent.tsx.template

@@ -25,11 +25,7 @@ const ExampleWidget: React.FC<{ extensionId: string }> = ({ extensionId }) => {
 };
 
 createExtension({
-    config: {
-        id: '{{vendor}}/{{name}}',
-        name: '{{displayName}}',
-        version: '1.0.0',
-    },
+    id: '{{vendor}}/{{name}}',
     slots: [
         {
             slot: 'dashboard.widgets',

package/templates/ServiceProvider.php.template

@@ -4,27 +4,11 @@ declare(strict_types=1);
 
 namespace {{namespace}};
 
-use Notur\Contracts\ExtensionInterface;
+use Notur\Support\NoturExtension;
 use Notur\Contracts\HasRoutes;
-use Notur\Contracts\HasFrontendSlots;
 
-class {{className}} implements ExtensionInterface, HasRoutes, HasFrontendSlots
+class {{className}} extends NoturExtension implements HasRoutes
 {
-    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
     {
         //
@@ -35,20 +19,10 @@ class {{className}} implements ExtensionInterface, HasRoutes, HasFrontendSlots
         //
     }
 
-    public function getBasePath(): string
-    {
-        return __DIR__ . '/..';
-    }
-
     public function getRouteFiles(): array
     {
         return [
             'api-client' => 'src/routes/api-client.php',
         ];
     }
-
-    public function getFrontendSlots(): array
-    {
-        return [];
-    }
 }

package/webpack.extension.config.js

@@ -45,8 +45,18 @@ module.exports = {
         ],
     },
     externals: {
-        react: 'React',
-        'react-dom': 'ReactDOM',
+        react: {
+            root: 'React',
+            commonjs: 'react',
+            commonjs2: 'react',
+            amd: 'react',
+        },
+        'react-dom': {
+            root: 'ReactDOM',
+            commonjs: 'react-dom',
+            commonjs2: 'react-dom',
+            amd: 'react-dom',
+        },
         '@notur/sdk': '__NOTUR__',
     },
 };