@conduction/nextcloud-vue 0.1.0-beta.10 → 0.1.0-beta.12

package/src/components/CnVersionInfoCard/CnVersionInfoCard.vue

@@ -70,6 +70,7 @@
 </template>
 
 <script>
+import { translate as t } from '@nextcloud/l10n'
 import { CnSettingsSection } from '../CnSettingsSection/index.js'
 import { NcLoadingIcon, NcButton } from '@nextcloud/vue'
 import Check from 'vue-material-design-icons/Check.vue'
@@ -122,12 +123,12 @@ export default {
 		/** Section title */
 		title: {
 			type: String,
-			default: 'Version Information',
+			default: () => t('nextcloud-vue', 'Version information'),
 		},
 		/** Section description */
 		description: {
 			type: String,
-			default: 'Information about the current application installation',
+			default: () => t('nextcloud-vue', 'Information about the current application installation'),
 		},
 		/** Documentation URL (shows info icon next to title) */
 		docUrl: {
@@ -137,7 +138,7 @@ export default {
 		/** Card heading text */
 		cardTitle: {
 			type: String,
-			default: 'Application Information',
+			default: () => t('nextcloud-vue', 'Application information'),
 		},
 		/** Application name to display */
 		appName: {

package/src/components/CnWidgetWrapper/CnWidgetWrapper.vue

@@ -55,6 +55,8 @@
 </template>
 
 <script>
+import { translate as t } from '@nextcloud/l10n'
+
 /**
  * CnWidgetWrapper — Widget container with header, content, and footer.
  *
@@ -79,7 +81,7 @@ export default {
 		/** Widget title */
 		title: {
 			type: String,
-			default: 'Widget',
+			default: () => t('nextcloud-vue', 'Widget'),
 		},
 		/** Whether to show the header with title */
 		showTitle: {

package/src/index.js

@@ -74,6 +74,7 @@ export {
 	relationsPlugin,
 	filesPlugin,
 	lifecyclePlugin,
+	logsPlugin,
 	registerMappingPlugin,
 	selectionPlugin,
 	searchPlugin,
@@ -85,6 +86,9 @@ export {
 // Composables
 export { useListView, useDetailView, useSubResource, useDashboardView, useContextMenu } from './composables/index.js'
 
+// Localization
+export { registerTranslations } from './l10n/index.js'
+
 // Utilities
 export { buildHeaders, buildQueryString, parseResponseError, networkError, genericError } from './utils/index.js'
 export { columnsFromSchema, formatValue, filtersFromSchema, fieldsFromSchema } from './utils/index.js'

package/src/l10n/index.js

@@ -0,0 +1,12 @@
+import { getLanguage, register } from '@nextcloud/l10n'
+import en from '../../l10n/en.json'
+import nl from '../../l10n/nl.json'
+
+const BUNDLES = { en, nl }
+const APP_NAME = 'nextcloud-vue'
+
+export function registerTranslations() {
+	const lang = (getLanguage() || 'en').split(/[-_]/)[0]
+	const bundle = BUNDLES[lang] ?? BUNDLES.en
+	register(APP_NAME, bundle.translations)
+}

package/src/store/createCrudStore.d.ts

@@ -0,0 +1,350 @@
+/**
+ * Hand-written type definitions for `createCrudStore` (implementation is in
+ * `createCrudStore.js`). The library ships as JavaScript, but this file gives
+ * TypeScript consumers full entity inference, feature-flag gating, and
+ * `extend` merging with correct `this` typing.
+ *
+ * Design notes:
+ * - `const Id extends string` / `const F extends Features` preserves literal
+ *   types so `features: { loading: true }` flows `true` through the
+ *   conditional types without requiring `as const` at the call site.
+ *   Requires TypeScript 5.0+.
+ * - Entity inference: if `config.entity` is a class constructor, `T` is the
+ *   instance type. Otherwise `T` falls back to `unknown` unless the caller
+ *   passes it explicitly via the second overload.
+ * - `ThisType<...>` inside `extend.actions` / `extend.getters` makes `this`
+ *   resolve to the fully-merged store (state + getters + base actions +
+ *   extended actions), matching Pinia's own runtime semantics.
+ * - `Omit<BaseActions<T>, keyof ExtActions>` implements override precedence:
+ *   an extend action with the same name as a base action replaces it.
+ */
+
+import type { StoreDefinition, _GettersTree } from 'pinia'
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Utility types
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Forces TypeScript to eagerly evaluate an intersection of types into a
+ * single flat object shape. Purely a hover/tooltip ergonomics helper —
+ * semantically identical to the input.
+ *
+ * Without this, VSCode's quick-info tooltip shows `StoreDefinition<...,
+ * FullState<Source, ...> & ..., ..., MergedActions<...>>` with the aliases
+ * left unexpanded, making it hard to see which properties the store has.
+ * With this, hover shows `{ item: Source | null; list: Source[]; ... }`
+ * directly.
+ */
+export type Prettify<T> = { [K in keyof T]: T[K] } & {}
+
+/**
+ * A class constructor accepting raw data (e.g. `new Source(data)`).
+ */
+export type EntityClass<T> = new (data: any) => T
+
+/**
+ * Extract the instance type from an entity-class config field.
+ * Falls back to `unknown` when no class is provided.
+ */
+export type InferEntity<E> =
+	E extends EntityClass<infer T> ? T :
+	E extends null | undefined ? unknown :
+	unknown
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Feature flags
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Optional behavioral toggles. When a flag is set, the factory adds the
+ * corresponding state fields, getters, and actions to the store.
+ */
+export interface Features {
+	/** Add `loading` / `error` state plus the `isLoading` / `getError` getters. */
+	loading?: boolean
+	/** Add `viewMode` state, the `getViewMode` getter, and a `setViewMode(mode)` action. */
+	viewMode?: boolean
+}
+
+export type LoadingState<F>  = F extends { loading: true }  ? { loading: boolean; error: string | null } : {}
+export type ViewModeState<F> = F extends { viewMode: true } ? { viewMode: string } : {}
+
+// Getter trees are declared as `(state) => value` and Pinia exposes them on
+// the store as `.name: value`. We declare them as getter functions so the
+// `StoreDefinition<..., Getters, ...>` return-type mapping kicks in.
+export type LoadingGetters<F> = F extends { loading: true }
+	? {
+		isLoading: (state: { loading: boolean }) => boolean
+		getError: (state: { error: string | null }) => string | null
+	}
+	: {}
+export type ViewModeGetters<F> = F extends { viewMode: true }
+	? { getViewMode: (state: { viewMode: string }) => string }
+	: {}
+
+export type ViewModeActions<F> = F extends { viewMode: true } ? { setViewMode(mode: string): void } : {}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Base state, getters and actions
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * State shape every store receives by default, independent of features and
+ * extensions. Feature-specific fields (`loading`, `error`, `viewMode`) and
+ * anything contributed by `extend.state` / plugins are added on top.
+ */
+export interface BaseState<T> {
+	/** The currently active/selected item, or `null` when nothing is selected. */
+	item: T | null
+	/** The full list of items as last returned by `refreshList`. */
+	list: T[]
+	/** Active filter criteria (merged via `setFilters`). */
+	filters: Record<string, unknown>
+	/** Current pagination position. `limit` defaults to 20. */
+	pagination: { page: number; limit: number }
+	/**
+	 * Internal, runtime-resolved configuration exposed so extend actions and
+	 * plugins can build URLs, clean fields, or instantiate the entity class
+	 * without re-reading user config.
+	 */
+	_options: {
+		/** The raw endpoint segment supplied to the factory (e.g. `'sources'`). */
+		endpoint: string
+		/** Fields stripped by `cleanForSave` before POST/PUT. */
+		cleanFields: readonly string[]
+		/** Fully-qualified base URL for this store's REST endpoint, already `prefixUrl`-normalized. */
+		baseApiUrl: string
+		/** Entity class constructor, or `null` when the store returns raw data. */
+		entity: EntityClass<T> | null
+	}
+}
+
+/**
+ * Actions available on every store regardless of configuration. Extend
+ * actions with the same name replace these (see `MergedActions`).
+ */
+export interface BaseActions<T> {
+	/** Set the active item. Wraps in the configured Entity class when present; pass `null` to clear. */
+	setItem(data: T | Partial<T> | null): void
+	/** Replace the item list. Maps each entry through the Entity class when configured. */
+	setList(data: Array<T | Partial<T>>): void
+	/** Set `pagination.page` and `pagination.limit`. `limit` defaults to 20. */
+	setPagination(page: number, limit?: number): void
+	/** Merge filter key/value pairs into the current `filters` object. */
+	setFilters(filters: Record<string, unknown>): void
+	/** GET the list endpoint. Optional `search` is appended as `?_search=`; `soft=true` skips the loading toggle. */
+	refreshList(search?: string | null, soft?: boolean): Promise<{ response: Response; data: T[] }>
+	/** GET `/:id`, set it as the active item, and return the raw response data. */
+	getOne(id: string | number): Promise<T>
+	/** DELETE `/:id`, refresh the list, and clear the active item. */
+	deleteOne(idOrItem: string | number | { id: string | number }): Promise<{ response: Response }>
+	/** POST or PUT the item depending on whether it has an `id`, then refresh the list. */
+	save(item: Partial<T>): Promise<{ response: Response; data: T }>
+	/** Return a copy of `item` with `cleanFields` stripped, suitable for POST/PUT bodies. */
+	cleanForSave(item: T | Partial<T>): Partial<T>
+}
+
+/**
+ * Action merge rule:
+ *   - Base actions not overridden by the extend block are preserved.
+ *   - Actions declared in `extend.actions` replace base actions of the same name.
+ *   - `viewMode` feature action is appended when the flag is set.
+ *   - Plugin-contributed actions are reachable via the loose index signature
+ *     on `PluginActionContribution` below (typed as `any`-returning callables).
+ */
+export type PluginActionContribution = { [key: string]: (...args: any[]) => any }
+
+export type MergedActions<T, ExtActions, F> =
+	Omit<BaseActions<T>, keyof ExtActions> & ExtActions & ViewModeActions<F> & PluginActionContribution
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Full store shape (state + getters + actions) used inside ThisType<...>
+// ─────────────────────────────────────────────────────────────────────────────
+
+// Plugins contribute arbitrary state, getters, and actions at runtime. We spread
+// a loose index signature into the resolved store shape so plugin-contributed
+// members are reachable via dot access without `as any`. The index signature
+// returns `any` (not `unknown`) so callable plugin actions (`store.refreshLogs()`)
+// type-check without an intermediate cast — trade-off is that typos on
+// plugin-contributed members are not caught. Plugins needing strict typing
+// should ship their own `.d.ts` augmenting the specific store.
+export type PluginContribution = { [key: string]: any }
+
+export type FullState<T, ExtState, F> =
+	BaseState<T> & ExtState & LoadingState<F> & ViewModeState<F> & PluginContribution
+
+export type FullGetters<ExtGetters, F> =
+	ExtGetters & LoadingGetters<F> & ViewModeGetters<F>
+
+export type StoreThis<T, ExtState, ExtGetters, ExtActions, F> =
+	FullState<T, ExtState, F> &
+	// Getters are callable-free on the Pinia store instance — accessed as properties.
+	// We narrow each getter declaration to its return type so `this.myGetter` is typed.
+	{ [K in keyof ExtGetters]: ExtGetters[K] extends (state: any) => infer R ? R : never } &
+	LoadingGetters<F> & ViewModeGetters<F> &
+	MergedActions<T, ExtActions, F>
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Plugins
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * A plugin definition. Merged into the store at creation time:
+ * state is spread into store state, getters into getters, actions into actions.
+ *
+ * Merge precedence: base actions → plugin actions → extend.actions.
+ *
+ * Plugin-contributed properties are loosely typed on the resulting store
+ * (they appear as unknown state / any-returning actions). Consumers needing
+ * strict types on plugin output should augment the store's types at the
+ * call site, or use a plugin that ships a dedicated `.d.ts` with the shape.
+ *
+ * If `setup` is provided, it is invoked once per store instance the first
+ * time `useStore()` resolves it. Use this to register
+ * `store.$onAction` / `store.$subscribe` observers that react to base or
+ * other plugin actions without having to override them.
+ */
+export interface CrudPlugin {
+	/** Unique plugin identifier; used by `clearAllSubResources` and for debugging. */
+	name: string
+	/** State factory returning the state fields this plugin contributes. */
+	state?: () => Record<string, unknown>
+	/** Getters this plugin contributes — each receives the store state. */
+	getters?: Record<string, (state: any) => unknown>
+	/** Actions this plugin contributes. May override a base action with the same name. */
+	actions?: Record<string, (...args: any[]) => any>
+	/**
+	 * Optional lifecycle hook run once per store instance, the first time
+	 * `useStore()` resolves it. Typically used to register
+	 * `store.$onAction` / `store.$subscribe` subscribers so the plugin can
+	 * react to base or other-plugin actions without overriding them.
+	 */
+	setup?: (store: any) => void
+}
+
+export interface PluginContrib {
+	[key: string]: unknown
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Config & extend shapes
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Domain-specific additions layered on top of the base store. Merged last,
+ * so `extend` can still override anything a plugin contributed.
+ */
+export interface ExtendConfig<
+	T,
+	ExtState extends Record<string, unknown>,
+	ExtGetters extends _GettersTree<BaseState<T> & ExtState>,
+	ExtActions extends Record<string, (...args: any[]) => any>,
+	F extends Features,
+> {
+	/** State factory returning extra state properties merged into the store. */
+	state?: () => ExtState
+	/** Extra getters, or overrides of base/plugin getters with the same name. */
+	getters?: ExtGetters & ThisType<StoreThis<T, ExtState, ExtGetters, ExtActions, F>>
+	/** Extra actions, or overrides of base/plugin actions with the same name. */
+	actions?: ExtActions & ThisType<StoreThis<T, ExtState, ExtGetters, ExtActions, F>>
+}
+
+/**
+ * Full configuration object accepted by `createCrudStore`. Mirrors the
+ * runtime options documented in `createCrudStore.js`.
+ */
+export interface CrudConfig<
+	T,
+	ExtState extends Record<string, unknown>,
+	ExtGetters extends _GettersTree<BaseState<T> & ExtState>,
+	ExtActions extends Record<string, (...args: any[]) => any>,
+	F extends Features,
+	Entity = EntityClass<T> | null | undefined,
+> {
+	/** API resource path segment appended to `baseUrl` (e.g. `'sources'`). Required. */
+	endpoint: string
+	/** API base URL before the endpoint. Defaults to `'/apps/openregister/api'`. */
+	baseUrl?: string
+	/** Entity class constructor used to wrap raw API data; pass `null` for raw data. */
+	entity?: Entity
+	/** Fields stripped from items before POST/PUT. Defaults to `['id','uuid','created','updated']`. */
+	cleanFields?: readonly string[]
+	/** Feature flags enabling optional state/getters/actions. See `Features`. */
+	features?: F
+	/**
+	 * Custom parser for `refreshList`'s JSON response body. Called with the
+	 * store as `this`, so it can also perform side-effects (e.g. storing
+	 * pagination info). Must return an array of items. Default:
+	 * `(json) => json.results`.
+	 */
+	parseListResponse?: (this: StoreThis<T, ExtState, ExtGetters, ExtActions, F>, json: unknown) => T[] | Array<Partial<T>>
+	/**
+	 * Plugin definitions merged into the store. Same shape as object-store
+	 * plugins (`{ name, state?, getters?, actions?, setup? }`). Merge order
+	 * is base → plugins → extend.
+	 */
+	plugins?: readonly CrudPlugin[]
+	/** Extra state/getters/actions merged on top of base and plugin contributions. */
+	extend?: ExtendConfig<T, ExtState, ExtGetters, ExtActions, F>
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// The factory — overloaded
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Overload 1 — entity inference.
+ *
+ * Provide `config.entity` as a class constructor; `T` is inferred as the
+ * instance type:
+ *
+ * ```ts
+ * const useSourceStore = createCrudStore('source', {
+ *     endpoint: 'sources',
+ *     entity: Source,            // T = Source
+ *     features: { loading: true },
+ * })
+ * ```
+ */
+export function createCrudStore<
+	Entity extends EntityClass<any>,
+	const Id extends string = string,
+	const F extends Features = {},
+	ExtState extends Record<string, unknown> = {},
+	ExtGetters extends _GettersTree<BaseState<InferEntity<Entity>> & ExtState> = {},
+	ExtActions extends Record<string, (...args: any[]) => any> = {},
+>(
+	name: Id,
+	config: CrudConfig<InferEntity<Entity>, ExtState, ExtGetters, ExtActions, F, Entity>,
+): StoreDefinition<
+	Id,
+	Prettify<FullState<InferEntity<Entity>, ExtState, F>>,
+	Prettify<FullGetters<ExtGetters, F>>,
+	Prettify<MergedActions<InferEntity<Entity>, ExtActions, F>>
+>
+
+/**
+ * Overload 2 — explicit `T` for raw-data stores (no entity class).
+ *
+ * ```ts
+ * interface LogShape { id: number; message: string }
+ * const useLogStore = createCrudStore<'log', LogShape>('log', { endpoint: 'logs' })
+ * ```
+ */
+export function createCrudStore<
+	const Id extends string,
+	T,
+	const F extends Features = {},
+	ExtState extends Record<string, unknown> = {},
+	ExtGetters extends _GettersTree<BaseState<T> & ExtState> = {},
+	ExtActions extends Record<string, (...args: any[]) => any> = {},
+>(
+	name: Id,
+	config: CrudConfig<T, ExtState, ExtGetters, ExtActions, F, null | undefined>,
+): StoreDefinition<
+	Id,
+	FullState<T, ExtState, F>,
+	FullGetters<ExtGetters, F>,
+	MergedActions<T, ExtActions, F>
+>

package/src/store/createCrudStore.js

@@ -1,6 +1,7 @@
 import { defineStore } from 'pinia'
 import { buildHeaders, prefixUrl } from '../utils/headers.js'
 import { parseResponseError } from '../utils/errors.js'
+import { mergePluginState, mergePluginGetters, mergePluginActions } from './pluginMerge.js'
 
 /**
  * Default fields stripped from items before POST/PUT.
@@ -76,10 +77,14 @@ function defaultParseListResponse(json) {
  * @param {Function} [config.parseListResponse] Custom response parser for refreshList.
  *   Receives the parsed JSON body with the store instance as `this`.
  *   Must return an array of items. Default: `(json) => json.results`
+ * @param {Array} [config.plugins] Array of plugin definitions to merge into the store.
+ *   Each plugin is `{ name, state?, getters?, actions? }` — same shape as object-store
+ *   plugins. Merge order is base → plugins → extend, so `extend` can still override
+ *   anything a plugin provides.
  * @param {object} [config.extend] Extra state/getters/actions to merge into the store
  * @param {Function} [config.extend.state] State factory returning extra state properties
  * @param {object} [config.extend.getters] Extra getters (or overrides of base getters)
- * @param {object} [config.extend.actions] Extra actions (or overrides of base actions)
+ * @param {object} [config.extend.actions] Extra actions (or overrides of base/plugin actions)
  * @return {Function} Pinia store composable (useXxxStore)
  */
 export function createCrudStore(name, config = {}) {
@@ -90,6 +95,7 @@ export function createCrudStore(name, config = {}) {
 		cleanFields = DEFAULT_CLEAN_FIELDS,
 		features = {},
 		parseListResponse = defaultParseListResponse,
+		plugins = [],
 		extend = {},
 	} = config
 
@@ -99,7 +105,18 @@ export function createCrudStore(name, config = {}) {
 
 	const baseApiUrl = prefixUrl(`${baseUrl}/${endpoint}`)
 
-	return defineStore(name, {
+	const pluginState = mergePluginState(plugins)
+	const pluginGetters = mergePluginGetters(plugins)
+	const pluginActions = mergePluginActions(plugins)
+	const setupPlugins = plugins.filter((p) => typeof p.setup === 'function')
+	// Track which store instances have already been set up so plugin setup
+	// hooks run exactly once per instance, even if useStore() is called many
+	// times. WeakSet lets garbage collection reclaim entries when a Pinia
+	// instance (and therefore its stores) are discarded — e.g. between tests
+	// that call createPinia() afresh.
+	const initialized = new WeakSet()
+
+	const useStore = defineStore(name, {
 		state: () => ({
 			// ── Core state ──
 			item: null,
@@ -111,8 +128,11 @@ export function createCrudStore(name, config = {}) {
 			...(features.loading ? { loading: false, error: null } : {}),
 			...(features.viewMode ? { viewMode: 'cards' } : {}),
 
-			// ── Internal config (available to extend actions) ──
-			_options: { endpoint, cleanFields, baseApiUrl },
+			// ── Plugin state ──
+			...pluginState,
+
+			// ── Internal config (available to extend actions and plugins) ──
+			_options: { endpoint, cleanFields, baseApiUrl, entity: Entity },
 
 			// ── Domain-specific state ──
 			...(typeof extend.state === 'function' ? extend.state() : {}),
@@ -128,6 +148,9 @@ export function createCrudStore(name, config = {}) {
 				}
 				: {}),
 
+			// ── Plugin getters ──
+			...pluginGetters,
+
 			// ── Domain-specific getters ──
 			...(extend.getters ?? {}),
 		},
@@ -353,8 +376,38 @@ export function createCrudStore(name, config = {}) {
 				}
 			},
 
-			// ── Domain-specific actions (may override base actions) ──
+			// ── Plugin actions (may override base actions) ──
+			...pluginActions,
+
+			// ── Domain-specific actions (may override base/plugin actions) ──
 			...(extend.actions ?? {}),
 		},
 	})
+
+	// When no plugin declares a setup hook, return Pinia's composable
+	// directly — zero runtime overhead for the common case.
+	if (setupPlugins.length === 0) {
+		return useStore
+	}
+
+	/**
+	 * Wrapped composable: resolves the Pinia store, then runs each plugin's
+	 * `setup(store)` exactly once per instance. Plugins typically use the
+	 * setup hook to register `store.$onAction` / `store.$subscribe`
+	 * subscriptions that observe base or other plugin actions without
+	 * overriding them.
+	 *
+	 * @param {import('pinia').Pinia} [pinia] Optional Pinia instance override
+	 * @return {object} The Pinia store instance with all plugin setups applied
+	 */
+	return function useCrudStore(pinia) {
+		const store = useStore(pinia)
+		if (!initialized.has(store)) {
+			initialized.add(store)
+			for (const plugin of setupPlugins) {
+				plugin.setup(store)
+			}
+		}
+		return store
+	}
 }

package/src/store/pluginMerge.js

@@ -0,0 +1,55 @@
+/**
+ * Shared helpers for merging Pinia store plugins into a store definition.
+ *
+ * Used by both `createObjectStore` (via `useObjectStore.js`) and
+ * `createCrudStore`, so plugin authors get the same shape everywhere:
+ * `{ name, state?, getters?, actions? }`.
+ */
+
+/**
+ * Merge plugin state factories into a single state object.
+ *
+ * @param {Array} plugins Array of plugin definitions
+ * @return {object} Merged state object
+ */
+export function mergePluginState(plugins) {
+	const merged = {}
+	for (const plugin of plugins) {
+		if (plugin.state) {
+			Object.assign(merged, plugin.state())
+		}
+	}
+	return merged
+}
+
+/**
+ * Merge plugin getters into a single getters object.
+ *
+ * @param {Array} plugins Array of plugin definitions
+ * @return {object} Merged getters object
+ */
+export function mergePluginGetters(plugins) {
+	const merged = {}
+	for (const plugin of plugins) {
+		if (plugin.getters) {
+			Object.assign(merged, plugin.getters)
+		}
+	}
+	return merged
+}
+
+/**
+ * Merge plugin actions into a single actions object.
+ *
+ * @param {Array} plugins Array of plugin definitions
+ * @return {object} Merged actions object
+ */
+export function mergePluginActions(plugins) {
+	const merged = {}
+	for (const plugin of plugins) {
+		if (plugin.actions) {
+			Object.assign(merged, plugin.actions)
+		}
+	}
+	return merged
+}

package/src/store/plugins/index.js

@@ -2,6 +2,7 @@ export { auditTrailsPlugin } from './auditTrails.js'
 export { relationsPlugin } from './relations.js'
 export { filesPlugin } from './files.js'
 export { lifecyclePlugin } from './lifecycle.js'
+export { logsPlugin } from './logs.js'
 export { registerMappingPlugin } from './registerMapping.js'
 export { selectionPlugin } from './selection.js'
 export { searchPlugin, SEARCH_TYPE, getRegisterApiUrl, getSchemaApiUrl } from './search.js'

package/src/store/plugins/logs.d.ts

@@ -0,0 +1,22 @@
+import type { CrudPlugin } from '../createCrudStore'
+
+export interface LogsPluginOptions {
+	/** Required. Query-param name carrying the active item's id (e.g. 'source_id'). */
+	parentIdParam: string
+	/** Path segment appended to the store's base API URL. Default: 'logs'. */
+	path?: string
+	/** Default query params merged before caller-supplied filters. Default: `{ '_sort[created]': 'desc' }`. */
+	defaultSort?: Record<string, string>
+	/**
+	 * When true, the plugin's `setup` hook registers a `store.$onAction`
+	 * subscriber that auto-fires `refreshLogs()` after every `setItem` with
+	 * an id (or `clearLogs()` when the item is cleared). Composes with other
+	 * plugins that observe `setItem`.
+	 */
+	autoRefreshOnItemChange?: boolean
+}
+
+/**
+ * Create a logs sub-resource plugin for a `createCrudStore`.
+ */
+export function logsPlugin(options: LogsPluginOptions): CrudPlugin