@hamak/ui-remote-resource 0.5.1

package/dist/impl/providers/rest-resource-provider.js

@@ -0,0 +1,128 @@
+import axios from 'axios';
+/**
+ * REST API resource provider using Axios
+ */
+export class RestResourceProvider {
+    constructor(config = {}) {
+        Object.defineProperty(this, "type", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 'rest'
+        });
+        Object.defineProperty(this, "axios", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.axios =
+            config.axiosInstance ||
+                axios.create({
+                    baseURL: config.baseUrl,
+                    timeout: config.timeout || 30000,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        ...config.headers
+                    }
+                });
+    }
+    /**
+     * Execute a resource call
+     */
+    async call(endpoint, params, operation) {
+        switch (operation) {
+            case 'fetch':
+                return this.executeFetch(endpoint, params);
+            case 'create':
+                return this.executeCreate(endpoint, params);
+            case 'update':
+                return this.executeUpdate(endpoint, params);
+            case 'delete':
+                return this.executeDelete(endpoint, params);
+            default:
+                throw new Error(`Unknown operation: ${operation}`);
+        }
+    }
+    /**
+     * Execute fetch operation (GET)
+     */
+    async executeFetch(endpoint, params) {
+        const url = this.buildUrl(endpoint, params.params);
+        const response = await this.axios.get(url, {
+            params: params.query,
+            headers: params.headers
+        });
+        return {
+            data: response.data,
+            metadata: {
+                status: response.status,
+                headers: response.headers
+            }
+        };
+    }
+    /**
+     * Execute create operation (POST)
+     */
+    async executeCreate(endpoint, params) {
+        const response = await this.axios.post(endpoint, params.body, {
+            params: params.query,
+            headers: params.headers
+        });
+        return {
+            data: response.data,
+            metadata: {
+                status: response.status,
+                headers: response.headers
+            }
+        };
+    }
+    /**
+     * Execute update operation (PUT)
+     */
+    async executeUpdate(endpoint, params) {
+        const url = this.buildUrl(endpoint, params.params);
+        const response = await this.axios.put(url, params.body, {
+            params: params.query,
+            headers: params.headers
+        });
+        return {
+            data: response.data,
+            metadata: {
+                status: response.status,
+                headers: response.headers
+            }
+        };
+    }
+    /**
+     * Execute delete operation (DELETE)
+     */
+    async executeDelete(endpoint, params) {
+        const url = this.buildUrl(endpoint, params.params);
+        const response = await this.axios.delete(url, {
+            params: params.query,
+            headers: params.headers
+        });
+        return {
+            data: response.data,
+            metadata: {
+                status: response.status,
+                headers: response.headers
+            }
+        };
+    }
+    /**
+     * Build URL with path parameters
+     * Replaces :param placeholders with actual values
+     * Example: /users/:id + { id: "123" } → /users/123
+     */
+    buildUrl(endpoint, params) {
+        if (!params)
+            return endpoint;
+        let url = endpoint;
+        Object.entries(params).forEach(([key, value]) => {
+            url = url.replace(`:${key}`, String(value));
+        });
+        return url;
+    }
+}

package/dist/impl/registry/entity-registry.d.ts

@@ -0,0 +1,54 @@
+import type { EntityDefinition } from '../../spi';
+/**
+ * Internal entity registry interface with write operations
+ */
+export interface IEntityRegistryInternal {
+    /**
+     * Register an entity definition
+     */
+    registerEntity(definition: EntityDefinition): void;
+    /**
+     * Unregister an entity definition
+     */
+    unregisterEntity(id: string): void;
+    /**
+     * Get entity definition by ID
+     */
+    getEntity(id: string): EntityDefinition | undefined;
+    /**
+     * Get all registered entities
+     */
+    getAllEntities(): EntityDefinition[];
+    /**
+     * Check if entity exists
+     */
+    hasEntity(id: string): boolean;
+}
+/**
+ * Entity registry implementation
+ * Manages entity definitions
+ */
+export declare class EntityRegistry implements IEntityRegistryInternal {
+    private entities;
+    /**
+     * Register an entity definition
+     */
+    registerEntity(definition: EntityDefinition): void;
+    /**
+     * Unregister an entity definition
+     */
+    unregisterEntity(id: string): void;
+    /**
+     * Get entity definition by ID
+     */
+    getEntity(id: string): EntityDefinition | undefined;
+    /**
+     * Get all registered entities
+     */
+    getAllEntities(): EntityDefinition[];
+    /**
+     * Check if entity exists
+     */
+    hasEntity(id: string): boolean;
+}
+//# sourceMappingURL=entity-registry.d.ts.map

package/dist/impl/registry/entity-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-registry.d.ts","sourceRoot":"","sources":["../../../src/impl/registry/entity-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAEpD;;OAEG;IACH,cAAc,IAAI,gBAAgB,EAAE,CAAC;IAErC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,uBAAuB;IAC5D,OAAO,CAAC,QAAQ,CAA4C;IAE5D;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAiBlD;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAInD;;OAEG;IACH,cAAc,IAAI,gBAAgB,EAAE;IAIpC;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAG/B"}

package/dist/impl/registry/entity-registry.js

@@ -0,0 +1,51 @@
+/**
+ * Entity registry implementation
+ * Manages entity definitions
+ */
+export class EntityRegistry {
+    constructor() {
+        Object.defineProperty(this, "entities", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    /**
+     * Register an entity definition
+     */
+    registerEntity(definition) {
+        // Validate key schema
+        if (!definition.keySchema.fields || definition.keySchema.fields.length === 0) {
+            throw new Error(`Entity "${definition.id}" must have at least one key field in keySchema.fields`);
+        }
+        if (this.entities.has(definition.id)) {
+            console.warn(`Entity "${definition.id}" is already registered. Overwriting.`);
+        }
+        this.entities.set(definition.id, definition);
+    }
+    /**
+     * Unregister an entity definition
+     */
+    unregisterEntity(id) {
+        this.entities.delete(id);
+    }
+    /**
+     * Get entity definition by ID
+     */
+    getEntity(id) {
+        return this.entities.get(id);
+    }
+    /**
+     * Get all registered entities
+     */
+    getAllEntities() {
+        return Array.from(this.entities.values());
+    }
+    /**
+     * Check if entity exists
+     */
+    hasEntity(id) {
+        return this.entities.has(id);
+    }
+}

package/dist/impl/registry/resource-registry.d.ts

@@ -0,0 +1,80 @@
+import type { IResourceProvider } from '../../spi';
+import type { ResourceEndpointDefinition } from '../../spi';
+/**
+ * Internal registry interface with write operations
+ */
+export interface IResourceRegistryInternal {
+    /**
+     * Register a resource endpoint
+     */
+    registerEndpoint(definition: ResourceEndpointDefinition): void;
+    /**
+     * Unregister a resource endpoint
+     */
+    unregisterEndpoint(id: string): void;
+    /**
+     * Get endpoint definition by ID
+     */
+    getEndpoint(id: string): ResourceEndpointDefinition | undefined;
+    /**
+     * Get all registered endpoints
+     */
+    getAllEndpoints(): ResourceEndpointDefinition[];
+    /**
+     * Check if endpoint exists
+     */
+    hasEndpoint(id: string): boolean;
+    /**
+     * Register a resource provider
+     */
+    registerProvider(provider: IResourceProvider): void;
+    /**
+     * Get provider by type
+     */
+    getProvider(type: string): IResourceProvider | undefined;
+    /**
+     * Get all registered providers
+     */
+    getAllProviders(): IResourceProvider[];
+}
+/**
+ * Resource registry implementation
+ * Manages resource endpoint definitions and providers
+ */
+export declare class ResourceRegistry implements IResourceRegistryInternal {
+    private endpoints;
+    private providers;
+    /**
+     * Register a resource endpoint
+     */
+    registerEndpoint(definition: ResourceEndpointDefinition): void;
+    /**
+     * Unregister a resource endpoint
+     */
+    unregisterEndpoint(id: string): void;
+    /**
+     * Get endpoint definition by ID
+     */
+    getEndpoint(id: string): ResourceEndpointDefinition | undefined;
+    /**
+     * Get all registered endpoints
+     */
+    getAllEndpoints(): ResourceEndpointDefinition[];
+    /**
+     * Check if endpoint exists
+     */
+    hasEndpoint(id: string): boolean;
+    /**
+     * Register a resource provider
+     */
+    registerProvider(provider: IResourceProvider): void;
+    /**
+     * Get provider by type
+     */
+    getProvider(type: string): IResourceProvider | undefined;
+    /**
+     * Get all registered providers
+     */
+    getAllProviders(): IResourceProvider[];
+}
+//# sourceMappingURL=resource-registry.d.ts.map

package/dist/impl/registry/resource-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-registry.d.ts","sourceRoot":"","sources":["../../../src/impl/registry/resource-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAE/D;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAAC;IAEhE;;OAEG;IACH,eAAe,IAAI,0BAA0B,EAAE,CAAC;IAEhD;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEpD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAEzD;;OAEG;IACH,eAAe,IAAI,iBAAiB,EAAE,CAAC;CACxC;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,yBAAyB;IAChE,OAAO,CAAC,SAAS,CAAsD;IACvE,OAAO,CAAC,SAAS,CAA6C;IAE9D;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,0BAA0B,GAAG,IAAI;IAU9D;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAI/D;;OAEG;IACH,eAAe,IAAI,0BAA0B,EAAE;IAI/C;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAUnD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIxD;;OAEG;IACH,eAAe,IAAI,iBAAiB,EAAE;CAGvC"}

package/dist/impl/registry/resource-registry.js

@@ -0,0 +1,74 @@
+/**
+ * Resource registry implementation
+ * Manages resource endpoint definitions and providers
+ */
+export class ResourceRegistry {
+    constructor() {
+        Object.defineProperty(this, "endpoints", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "providers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    /**
+     * Register a resource endpoint
+     */
+    registerEndpoint(definition) {
+        if (this.endpoints.has(definition.id)) {
+            console.warn(`Resource endpoint "${definition.id}" is already registered. Overwriting.`);
+        }
+        this.endpoints.set(definition.id, definition);
+    }
+    /**
+     * Unregister a resource endpoint
+     */
+    unregisterEndpoint(id) {
+        this.endpoints.delete(id);
+    }
+    /**
+     * Get endpoint definition by ID
+     */
+    getEndpoint(id) {
+        return this.endpoints.get(id);
+    }
+    /**
+     * Get all registered endpoints
+     */
+    getAllEndpoints() {
+        return Array.from(this.endpoints.values());
+    }
+    /**
+     * Check if endpoint exists
+     */
+    hasEndpoint(id) {
+        return this.endpoints.has(id);
+    }
+    /**
+     * Register a resource provider
+     */
+    registerProvider(provider) {
+        if (this.providers.has(provider.type)) {
+            console.warn(`Resource provider "${provider.type}" is already registered. Overwriting.`);
+        }
+        this.providers.set(provider.type, provider);
+    }
+    /**
+     * Get provider by type
+     */
+    getProvider(type) {
+        return this.providers.get(type);
+    }
+    /**
+     * Get all registered providers
+     */
+    getAllProviders() {
+        return Array.from(this.providers.values());
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @hamak/ui-remote-resource
+ * Remote resource management for microkernel-based applications
+ */
+export * from './impl';
+//# 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;;;GAGG;AAEH,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * @hamak/ui-remote-resource
+ * Remote resource management for microkernel-based applications
+ */
+export * from './impl';

package/dist/spi/config/endpoint-definition.d.ts

@@ -0,0 +1,46 @@
+import type { ResourceCallAction } from '../../api';
+import type { ResourceCallParams } from '../providers/i-resource-provider';
+/**
+ * Maps entire action to API call parameters
+ */
+export type PayloadMapper = (action: ResourceCallAction) => ResourceCallParams;
+/**
+ * Transforms API response before storing
+ */
+export type ResponseTransformer<TData = any> = (data: any, metadata: any | undefined, action: ResourceCallAction) => TData;
+/**
+ * Resource endpoint registration configuration
+ * Used when configuring the plugin
+ */
+export interface ResourceEndpointDefinition {
+    /** Unique endpoint identifier */
+    id: string;
+    /** Provider type (must match a registered provider) */
+    providerType: string;
+    /** Base endpoint/URL for the resource */
+    endpoint: string;
+    /**
+     * Default directory where resources are stored when action doesn't specify path
+     */
+    defaultFolder?: string | string[];
+    /** Optional schema reference for validation */
+    schema?: string;
+    /** Maps action to provider call params */
+    payloadMapper?: PayloadMapper;
+    /** Transforms response data before storing */
+    responseTransformer?: ResponseTransformer;
+    /** Additional endpoint configuration */
+    config?: {
+        /** Auto-fetch on registration */
+        autoFetch?: boolean;
+        /** Cache duration in ms */
+        cacheDurationMs?: number;
+        /** Retry configuration */
+        retry?: {
+            maxAttempts?: number;
+            backoff?: 'linear' | 'exponential';
+        };
+        [key: string]: any;
+    };
+}
+//# sourceMappingURL=endpoint-definition.d.ts.map

package/dist/spi/config/endpoint-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-definition.d.ts","sourceRoot":"","sources":["../../../src/spi/config/endpoint-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,GAAG,GAAG,IAAI,CAC7C,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,GAAG,GAAG,SAAS,EACzB,MAAM,EAAE,kBAAkB,KACvB,KAAK,CAAC;AAEX;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IAEX,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IAErB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAElC,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B,8CAA8C;IAC9C,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C,wCAAwC;IACxC,MAAM,CAAC,EAAE;QACP,iCAAiC;QACjC,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,2BAA2B;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,0BAA0B;QAC1B,KAAK,CAAC,EAAE;YACN,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;SACpC,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH"}

package/dist/spi/config/endpoint-definition.js

@@ -0,0 +1 @@
+export {};

package/dist/spi/config/entity-definition.d.ts

@@ -0,0 +1,50 @@
+import type { EntityKey, ResourceOperation } from '../../api';
+import type { ResourceCallParams } from '../providers/i-resource-provider';
+/**
+ * Entity key schema definition
+ */
+export interface EntityKeySchema {
+    /** Key field names in order (for composite keys) */
+    fields: string[];
+    /** Optional separator for path generation (default: "/") */
+    separator?: string;
+    /** Optional validation */
+    validate?: (key: EntityKey) => boolean | string;
+}
+/**
+ * Maps entity keys to resource call params
+ */
+export type EntityKeyMapper = (keys: EntityKey, operation: ResourceOperation) => ResourceCallParams;
+/**
+ * Generates file path from entity keys
+ */
+export type EntityPathGenerator = (keys: EntityKey, entityId: string) => string | string[];
+/**
+ * Entity definition configuration
+ * Used when configuring the plugin
+ */
+export interface EntityDefinition {
+    /** Unique entity identifier (e.g., "user", "product") */
+    id: string;
+    /** Entity key schema */
+    keySchema: EntityKeySchema;
+    /** Resource endpoint ID to use for API calls */
+    resourceEndpointId: string;
+    /** Maps entity keys to resource call params */
+    keyMapper: EntityKeyMapper;
+    /** Generates file path from entity keys */
+    pathGenerator?: EntityPathGenerator;
+    /** Default folder for entities */
+    defaultFolder?: string | string[];
+    /** Optional schema reference for validation */
+    schema?: string;
+    /** Additional configuration */
+    config?: {
+        /** Auto-fetch on key change */
+        autoFetch?: boolean;
+        /** Cache duration in ms */
+        cacheDurationMs?: number;
+        [key: string]: any;
+    };
+}
+//# sourceMappingURL=entity-definition.d.ts.map

package/dist/spi/config/entity-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-definition.d.ts","sourceRoot":"","sources":["../../../src/spi/config/entity-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,GAAG,MAAM,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,iBAAiB,KACzB,kBAAkB,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,KACb,MAAM,GAAG,MAAM,EAAE,CAAC;AAEvB;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,SAAS,EAAE,eAAe,CAAC;IAE3B,gDAAgD;IAChD,kBAAkB,EAAE,MAAM,CAAC;IAE3B,+CAA+C;IAC/C,SAAS,EAAE,eAAe,CAAC;IAE3B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAElC,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,MAAM,CAAC,EAAE;QACP,+BAA+B;QAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,2BAA2B;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH"}

package/dist/spi/config/entity-definition.js

@@ -0,0 +1 @@
+export {};

package/dist/spi/config/plugin-config.d.ts

@@ -0,0 +1,21 @@
+import type { ResourceAction, EntityAction } from '../../api';
+import type { IResourceProvider } from '../providers/i-resource-provider';
+import type { ResourceEndpointDefinition } from './endpoint-definition';
+import type { EntityDefinition } from './entity-definition';
+/**
+ * Plugin configuration
+ * Used when creating the resource plugin
+ */
+export interface ResourcePluginConfig {
+    /** Initial endpoint registrations */
+    endpoints?: ResourceEndpointDefinition[];
+    /** Initial entity registrations */
+    entities?: EntityDefinition[];
+    /** Custom providers to register */
+    providers?: IResourceProvider[];
+    /** Error handler */
+    onError?: (error: any, action: ResourceAction | EntityAction) => void;
+    /** Success handler */
+    onSuccess?: (result: any, action: ResourceAction | EntityAction) => void;
+}
+//# sourceMappingURL=plugin-config.d.ts.map

package/dist/spi/config/plugin-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-config.d.ts","sourceRoot":"","sources":["../../../src/spi/config/plugin-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,SAAS,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAEzC,mCAAmC;IACnC,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE9B,mCAAmC;IACnC,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAEhC,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,GAAG,YAAY,KAAK,IAAI,CAAC;IAEtE,sBAAsB;IACtB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,GAAG,YAAY,KAAK,IAAI,CAAC;CAC1E"}

package/dist/spi/config/plugin-config.js

@@ -0,0 +1 @@
+export {};

package/dist/spi/index.d.ts

@@ -0,0 +1,6 @@
+export * from '../api';
+export * from './providers/i-resource-provider';
+export * from './config/endpoint-definition';
+export * from './config/entity-definition';
+export * from './config/plugin-config';
+//# sourceMappingURL=index.d.ts.map

package/dist/spi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spi/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AAGvB,cAAc,iCAAiC,CAAC;AAGhD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC"}

package/dist/spi/index.js

@@ -0,0 +1,7 @@
+export * from '../api';
+// Providers (for custom implementations)
+export * from './providers/i-resource-provider';
+// Configuration (for plugin setup)
+export * from './config/endpoint-definition';
+export * from './config/entity-definition';
+export * from './config/plugin-config';

package/dist/spi/providers/i-resource-provider.d.ts

@@ -0,0 +1,42 @@
+import type { ResourceOperation } from '../../api';
+/**
+ * Parameters extracted from action and mapped to API call
+ */
+export interface ResourceCallParams {
+    /** Resource-specific parameters (e.g., { id: "123", include: "author" }) */
+    params?: Record<string, any>;
+    /** Request body for create/update operations */
+    body?: any;
+    /** Additional headers */
+    headers?: Record<string, string>;
+    /** Query parameters */
+    query?: Record<string, any>;
+}
+/**
+ * Result from a resource provider call
+ */
+export interface ResourceCallResult<TData = any> {
+    /** Response data */
+    data: TData;
+    /** Response metadata (headers, status, etc.) */
+    metadata?: {
+        status?: number;
+        headers?: Record<string, string>;
+        [key: string]: any;
+    };
+}
+/**
+ * Generic resource provider interface
+ * Implement this to create custom providers (GraphQL, gRPC, etc.)
+ */
+export interface IResourceProvider {
+    /**
+     * Provider type identifier (e.g., "rest", "graphql", "grpc")
+     */
+    readonly type: string;
+    /**
+     * Execute a resource call
+     */
+    call<TData = any>(endpoint: string, params: ResourceCallParams, operation: ResourceOperation): Promise<ResourceCallResult<TData>>;
+}
+//# sourceMappingURL=i-resource-provider.d.ts.map

package/dist/spi/providers/i-resource-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-resource-provider.d.ts","sourceRoot":"","sources":["../../../src/spi/providers/i-resource-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,gDAAgD;IAChD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,GAAG;IAC7C,oBAAoB;IACpB,IAAI,EAAE,KAAK,CAAC;IACZ,gDAAgD;IAChD,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,KAAK,GAAG,GAAG,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;CACvC"}

package/dist/spi/providers/i-resource-provider.js

@@ -0,0 +1 @@
+export {};