@plyaz/types 1.29.3 → 1.31.0

package/dist/core/frontend/types.d.ts

@@ -799,6 +799,27 @@ export interface CoreBaseFrontendServiceConfig<TData = Record<string, unknown>,
      * @default undefined (auto-detect from 'error' or 'errors')
      */
     responseErrorKey?: string;
+    /**
+     * Key to use when syncing entities to the store.
+     *
+     * When fetching entities, the service will wrap them in an object with this key
+     * before calling store.setData(). Supports nested keys via dot notation.
+     *
+     * @example
+     * ```typescript
+     * // Store expects: { items: ExampleEntity[] }
+     * storeDataKey: 'items'
+     *
+     * // Store expects: { data: ExampleEntity[] }
+     * storeDataKey: 'data'
+     *
+     * // Store expects: { nested: { items: ExampleEntity[] } }
+     * storeDataKey: 'nested.items'
+     * ```
+     *
+     * @default 'items'
+     */
+    storeDataKey?: string;
     /** Fetcher functions for API operations (replaces direct apiClient usage) */
     fetchers?: CoreServiceFetchers<unknown, unknown, unknown, unknown, unknown, unknown, unknown>;
     /**
@@ -840,6 +861,26 @@ export interface CoreBaseFrontendServiceConfig<TData = Record<string, unknown>,
      * ```
      */
     optimisticUpdates?: CoreOptimisticUpdateConfig;
+    /**
+     * Polling interval in milliseconds.
+     *
+     * When set to a value > 0, enables automatic polling via startPolling().
+     * The service will call fetchAll() at this interval.
+     *
+     * Set to 0 or omit to disable auto-polling (use default 30s when startPolling() is called).
+     *
+     * @example
+     * ```typescript
+     * // Poll every 5 seconds
+     * pollingInterval: 5000
+     *
+     * // Disable auto-polling, use default 30s when startPolling() is called
+     * pollingInterval: 0
+     * ```
+     *
+     * @default 0 (disabled, uses 30s default when startPolling() is called)
+     */
+    pollingInterval?: number;
 }
 /**
  * Base interface for frontend domain services with store integration.

package/dist/examples/types.d.ts

@@ -106,10 +106,12 @@ export type ExampleDeletedPayload = CoreEntityDeletedPayload;
 export type ExampleValidationFailedPayload = CoreValidationFailedPayload;
 /**
  * Example frontend store data type
+ * Used for setData() - only items is required, selectedId is preserved if not provided
  */
 export interface ExampleFrontendStoreData {
     items: ExampleEntity[];
-    selectedId: string | null;
+    /** Optional - if not provided, current selection is preserved */
+    selectedId?: string | null;
 }
 /**
  * Example frontend store state shape.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.29.3",
+  "version": "1.31.0",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",