@edenapp/types 0.3.0 → 0.3.1

package/AppManifest.d.ts

@@ -86,6 +86,72 @@ export interface FileHandlerConfig {
   icon?: string;
 }
 
+/**
+ * Supported setting input types
+ */
+export type SettingType =
+  | "text"
+  | "number"
+  | "checkbox"
+  | "radio"
+  | "select"
+  | "toggle"
+  | "textarea"
+  | "color"
+  | "range";
+
+/**
+ * Option for radio/select settings
+ */
+export interface SettingOption {
+  /** Value stored when this option is selected */
+  value: string;
+  /** Display label for this option */
+  label: string;
+  /** Optional description for this option */
+  description?: string;
+}
+
+/**
+ * Individual setting definition
+ */
+export interface SettingDefinition {
+  /** Unique key for this setting */
+  key: string;
+  /** Display label */
+  label: string;
+  /** Description shown as help text */
+  description?: string;
+  /** Input type */
+  type: SettingType;
+  /** Default value (as string, will be parsed based on type) */
+  defaultValue?: string;
+  /** Options for radio/select types */
+  options?: SettingOption[];
+  /** Placeholder for text/textarea */
+  placeholder?: string;
+  /** Min value for number/range */
+  min?: number;
+  /** Max value for number/range */
+  max?: number;
+  /** Step for number/range */
+  step?: number;
+}
+
+/**
+ * Settings category (group of related settings)
+ */
+export interface SettingsCategory {
+  /** Category ID */
+  id: string;
+  /** Display name */
+  name: string;
+  /** Category icon (optional) */
+  icon?: string;
+  /** Settings in this category */
+  settings: SettingDefinition[];
+}
+
 /**
  * App Manifest Interface
  *
@@ -195,4 +261,10 @@ export interface AppManifest {
    * optional access control via allowedClients.
    */
   services?: ServiceDeclaration[];
+
+  /**
+   * App settings configuration.
+   * Defines settings categories and individual settings that can be configured.
+   */
+  settings?: SettingsCategory[];
 }

package/commands.generated.d.ts

@@ -243,7 +243,7 @@ export interface FsCommands {
   "fs/read": {
     args: {
     path: string;
-    encoding?: BufferEncoding };
+    encoding?: string };
     response: string;
   };
   /**
@@ -253,7 +253,7 @@ export interface FsCommands {
     args: {
     path: string;
     content: string;
-    encoding?: BufferEncoding };
+    encoding?: string };
     response: void;
   };
   /**
@@ -427,6 +427,104 @@ export interface ProcessCommands {
   };
 }
 
+/**
+ * SettingsCommands - Commands for the "settings" namespace
+ */
+export interface SettingsCommands {
+  /**
+   * Get a setting value (scoped to caller's app)
+   */
+  "settings/get": {
+    args: {
+    key: string };
+    response: { value: string | undefined };
+  };
+  /**
+   * Set a setting value (scoped to caller's app)
+   */
+  "settings/set": {
+    args: {
+    key: string;
+    value: string };
+    response: { success: boolean };
+  };
+  /**
+   * List all settings keys (scoped to caller's app)
+   */
+  "settings/list": {
+    args: { };
+    response: { keys: string[] };
+  };
+  /**
+   * Get all settings with values (scoped to caller's app)
+   */
+  "settings/get-all": {
+    args: { };
+    response: { settings: Record<string, string> };
+  };
+  /**
+   * Reset a setting to default (scoped to caller's app)
+   */
+  "settings/reset": {
+    args: {
+    key: string;
+    schema?: import("./index").SettingsCategory[] };
+    response: { success: boolean };
+  };
+  /**
+   * Get a setting from any app's namespace (superuser only)
+   */
+  "settings/get/su": {
+    args: {
+    appId: string;
+    key: string };
+    response: { value: string | undefined };
+  };
+  /**
+   * Set a setting in any app's namespace (superuser only)
+   */
+  "settings/set/su": {
+    args: {
+    appId: string;
+    key: string;
+    value: string };
+    response: { success: boolean };
+  };
+  /**
+   * List all settings in any app's namespace (superuser only)
+   */
+  "settings/list/su": {
+    args: {
+    appId: string };
+    response: { keys: string[] };
+  };
+  /**
+   * Get all settings with values for any app (superuser only)
+   */
+  "settings/get-all/su": {
+    args: {
+    appId: string };
+    response: { settings: Record<string, string> };
+  };
+  /**
+   * Reset a setting for any app (superuser only)
+   */
+  "settings/reset/su": {
+    args: {
+    appId: string;
+    key: string;
+    schema?: import("./index").SettingsCategory[] };
+    response: { success: boolean };
+  };
+  /**
+   * Get the Eden settings schema
+   */
+  "settings/schema": {
+    args: Record<string, never>;
+    response: { schema: import("./index").SettingsCategory[] };
+  };
+}
+
 /**
  * ViewCommands - Commands for the "view" namespace
  */
@@ -528,4 +626,4 @@ export interface ViewCommands {
 /**
  * Global command map - merge all command namespaces
  */
-export interface CommandMap extends SystemCommands, AppbusCommands, DbCommands, FileCommands, FsCommands, EventCommands, NotificationCommands, PackageCommands, ProcessCommands, ViewCommands {}
+export interface CommandMap extends SystemCommands, AppbusCommands, DbCommands, FileCommands, FsCommands, EventCommands, NotificationCommands, PackageCommands, ProcessCommands, SettingsCommands, ViewCommands {}

package/events.generated.d.ts

@@ -38,6 +38,13 @@ export interface ProcessEvents {
   "process/exited": { appId: string; code: number };
 }
 
+/**
+ * SettingsEvents - Events for the "settings" namespace
+ */
+export interface SettingsEvents {
+  "settings/changed": { appId: string; key: string; value: string };
+}
+
 /**
  * ViewEvents - Events for the "view" namespace
  */
@@ -60,4 +67,4 @@ export interface ViewEvents {
 /**
  * Global event map - merge all event namespaces
  */
-export interface AppEvents extends FileEvents, NotificationEvents, PackageEvents, ProcessEvents, ViewEvents {}
+export interface AppEvents extends FileEvents, NotificationEvents, PackageEvents, ProcessEvents, SettingsEvents, ViewEvents {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edenapp/types",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "TypeScript type definitions for the Eden platform",
   "types": "index.d.ts",
   "author": "Dariusz Majnert",

package/runtime.generated.d.ts

@@ -1,13 +0,0 @@
-/**
- * AUTO-GENERATED FILE - DO NOT EDIT
- * 
- * Type declarations for runtime arrays.
- * Generated by scripts/generate-commands.ts
- * Run 'pnpm run codegen' to regenerate.
- */
-
-// Command names array
-export declare const COMMAND_NAMES: readonly string[];
-
-// Event names array
-export declare const APP_EVENT_NAMES: readonly string[];