@plyaz/core 1.1.1 → 1.2.1

package/dist/frontend/providers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Frontend Providers
+ *
+ * @module frontend/providers
+ */
+export * from './ApiProvider';
+export * from './PlyazProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/frontend/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/frontend/providers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/frontend/store/feature-flags.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Feature Flag Store Integration
+ *
+ * Utilities for integrating feature flags with Zustand stores.
+ * Implements the "pull" pattern where stores fetch from services.
+ */
+import type { FeatureFlagValue, FeatureFlagContext } from '@plyaz/types/features';
+export type { CoreFeatureFlagServiceLike, CoreFeatureFlagFetcherOptions, CoreFeatureFlagStoreInitConfig, } from '@plyaz/types/core';
+import type { CoreFeatureFlagFetcherOptions, CoreFeatureFlagStoreInitConfig } from '@plyaz/types/core';
+/**
+ * Create a fetchFn for feature flag store that uses ServiceRegistry.
+ *
+ * This bridges the ServiceRegistry with the store's callback-based pattern.
+ * Use this for polling or manual refresh scenarios.
+ *
+ * @param options - Fetcher options
+ * @returns A function compatible with store initialization
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const fetchFn = createFeatureFlagFetcher();
+ *
+ * // With context
+ * const fetchFn = createFeatureFlagFetcher({
+ *   context: { userId: currentUser.id },
+ * });
+ *
+ * // Use in store initializer
+ * useFeatureFlagInitializer({ fetchFn });
+ * ```
+ */
+export declare function createFeatureFlagFetcher(options?: CoreFeatureFlagFetcherOptions): () => Promise<Record<string, FeatureFlagValue>>;
+/**
+ * Create full store initialization config with ServiceRegistry integration.
+ *
+ * @param options - Configuration options
+ * @returns Config object for store initialization
+ *
+ * @example
+ * ```typescript
+ * const storeConfig = createFeatureFlagStoreConfig({
+ *   context: { userId: user.id },
+ *   defaults: { 'MY_FLAG': false },
+ *   polling: { enabled: true, interval: 30000 },
+ *   onFlagChange: (key, prev, next) => console.log(`${key}: ${prev} → ${next}`),
+ * });
+ *
+ * useFeatureFlagInitializer(storeConfig);
+ * ```
+ */
+export declare function createFeatureFlagStoreConfig(options: {
+    serviceKey?: string;
+    context?: FeatureFlagContext;
+    defaults?: Record<string, FeatureFlagValue>;
+    polling?: {
+        enabled?: boolean;
+        interval?: number;
+    };
+    onFlagChange?: (key: string, prevValue: FeatureFlagValue | undefined, newValue: FeatureFlagValue) => void;
+    onError?: (error: unknown) => void;
+}): CoreFeatureFlagStoreInitConfig;
+//# sourceMappingURL=feature-flags.d.ts.map

package/dist/frontend/store/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/frontend/store/feature-flags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGlF,YAAY,EACV,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAEV,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,mBAAmB,CAAC;AAM3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,6BAAkC,GAC1C,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAmBjD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,YAAY,CAAC,EAAE,CACb,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,QAAQ,EAAE,gBAAgB,KACvB,IAAI,CAAC;IACV,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,GAAG,8BAA8B,CAUjC"}

package/dist/frontend/store/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Frontend Store Integration
+ *
+ * Utilities for integrating ServiceRegistry with @plyaz/store.
+ * These are frontend-only utilities - for backend, use NestJS modules or
+ * direct service instantiation.
+ *
+ * Note: Error store and middleware are in @plyaz/store and @plyaz/errors:
+ * - Error slice: import { useErrorStore } from '@plyaz/store'
+ * - Error middleware: import { createErrorStoreMiddleware } from '@plyaz/errors/middleware'
+ */
+export { createFeatureFlagFetcher, createFeatureFlagStoreConfig, createServiceAccessor, createServiceAccessors, withServices, } from './integrations';
+export type { CoreFeatureFlagFetcherOptions, CoreFeatureFlagServiceLike, CoreFeatureFlagStoreInitConfig, } from './integrations';
+//# sourceMappingURL=index.d.ts.map

package/dist/frontend/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/frontend/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,gBAAgB,CAAC"}

package/dist/frontend/store/integrations.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Store Integration Utilities (Frontend Only)
+ *
+ * Re-exports all store integration utilities:
+ * - Generic service accessors (work with any service)
+ * - Feature flag specific utilities (pull pattern for polling/refresh)
+ *
+ * ## Integration Patterns
+ *
+ * ### Automatic Store Sync (Primary/Read Pattern)
+ * Services automatically sync to their primary store via ServiceRegistry injection.
+ * Stores are injected based on `primaryStoreKey` and `readStoreKeys` properties.
+ *
+ * ```typescript
+ * // Service automatically has stores injected
+ * const service = await ServiceRegistry.getAsync('featureFlags');
+ * await service.fetchAll(); // Automatically syncs to primary store
+ * ```
+ *
+ * ### Pull Pattern (Fetcher for Hooks)
+ * Store hooks can pull data from service via callbacks for polling/manual refresh.
+ * Use `createFeatureFlagFetcher()` for custom fetch logic.
+ *
+ * ```typescript
+ * useFeatureFlagInitializer({
+ *   fetchFn: createFeatureFlagFetcher({ context: { userId } }),
+ *   polling: { enabled: true, interval: 30000 },
+ * });
+ * ```
+ *
+ * See docs/guides/10-STORE-PATTERN.md for complete store pattern guide.
+ */
+export { createServiceAccessor, createServiceAccessors, withServices } from './service-accessors';
+export { createFeatureFlagFetcher, createFeatureFlagStoreConfig } from './feature-flags';
+export type { CoreFeatureFlagFetcherOptions, CoreFeatureFlagServiceLike, CoreFeatureFlagStoreInitConfig, } from './feature-flags';
+//# sourceMappingURL=integrations.d.ts.map

package/dist/frontend/store/integrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../../src/frontend/store/integrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGlG,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAEzF,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC"}

package/dist/frontend/store/service-accessors.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Service Accessors (Generic)
+ *
+ * Generic utilities for accessing services from stores.
+ * These work with any domain service, not just feature flags.
+ */
+import type { CoreDomainServiceInstance } from '@plyaz/types/core';
+/**
+ * Create a service accessor function for use in stores.
+ *
+ * @param serviceKey - Key of the service in the registry
+ * @returns Async function that returns the service instance
+ *
+ * @example
+ * ```typescript
+ * const getExampleService = createServiceAccessor<ExampleDomainService>('example');
+ *
+ * const myStoreSlice = {
+ *   async createEntity(data) {
+ *     const service = await getExampleService();
+ *     return service.create(data);
+ *   },
+ * };
+ * ```
+ */
+export declare function createServiceAccessor<T extends CoreDomainServiceInstance>(serviceKey: string): () => Promise<T>;
+/**
+ * Create multiple service accessors at once.
+ *
+ * @param keys - Object mapping accessor names to service keys
+ * @returns Object with accessor functions
+ *
+ * @example
+ * ```typescript
+ * const services = createServiceAccessors({
+ *   flags: 'featureFlags',
+ *   examples: 'example',
+ *   users: 'users',
+ * });
+ *
+ * const flags = await services.flags();
+ * const example = await services.examples();
+ * ```
+ */
+export declare function createServiceAccessors<T extends Record<string, string>>(keys: T): {
+    [K in keyof T]: () => Promise<CoreDomainServiceInstance>;
+};
+/**
+ * Create a Zustand middleware that injects services into store actions.
+ *
+ * @param serviceKeys - Service keys to inject
+ * @returns Zustand middleware function
+ *
+ * @example
+ * ```typescript
+ * import { create } from 'zustand';
+ * import { withServices } from '@plyaz/core/frontend';
+ *
+ * interface MyStore {
+ *   items: Item[];
+ *   services: { example: ExampleDomainService };
+ *   fetchItems: () => Promise<void>;
+ * }
+ *
+ * const useMyStore = create<MyStore>(
+ *   withServices(['example'], (set, get, services) => ({
+ *     items: [],
+ *     services,
+ *     fetchItems: async () => {
+ *       const items = await services.example.getAll();
+ *       set({ items });
+ *     },
+ *   }))
+ * );
+ * ```
+ */
+export declare function withServices<TServices extends Record<string, CoreDomainServiceInstance>>(serviceKeys: string[], createStore: (set: (partial: unknown) => void, get: () => unknown, services: TServices) => unknown): (set: (partial: unknown) => void, get: () => unknown) => unknown;
+//# sourceMappingURL=service-accessors.d.ts.map

package/dist/frontend/store/service-accessors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-accessors.d.ts","sourceRoot":"","sources":["../../../src/frontend/store/service-accessors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAOnE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,yBAAyB,EACvE,UAAU,EAAE,MAAM,GACjB,MAAM,OAAO,CAAC,CAAC,CAAC,CAElB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACrE,IAAI,EAAE,CAAC,GACN;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,yBAAyB,CAAC;CAAE,CAQ9D;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,EACtF,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,GAAG,EAAE,MAAM,OAAO,EAAE,QAAQ,EAAE,SAAS,KAAK,OAAO,GACjG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,GAAG,EAAE,MAAM,OAAO,KAAK,OAAO,CAclE"}

package/dist/index.d.ts

@@ -1,7 +1,11 @@
+import '@plyaz/types/globals';
 export * from './domain';
 export * from './engine';
 export * from './base';
-export * from './backend';
-export * from './frontend';
 export * from './utils';
+export * from './services';
+export * from './init';
+export * from './version';
+export * as CoreBackend from './backend';
+export * as CoreFrontend from './frontend';
 //# 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,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,sBAAsB,CAAC;AAE9B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAG1B,OAAO,KAAK,WAAW,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,YAAY,MAAM,YAAY,CAAC"}