@alepha/protobuf 0.13.1 → 0.13.2

package/dist/index.d.ts

@@ -7,7 +7,7 @@ import "dayjs";
 
 //#region ../alepha/src/core/constants/KIND.d.ts
 /**
- * Used for identifying descriptors.
+ * Used for identifying primitives.
  *
  * @internal
  */
@@ -60,34 +60,49 @@ interface ServiceSubstitution<T extends object = any> {
  */
 type ServiceEntry<T extends object = any> = Service<T> | ServiceSubstitution<T>;
 //#endregion
-//#region ../alepha/src/core/helpers/descriptor.d.ts
-interface DescriptorArgs<T extends object = {}> {
+//#region ../alepha/src/core/helpers/primitive.d.ts
+interface PrimitiveArgs<T extends object = {}> {
   options: T;
   alepha: Alepha;
   service: InstantiableClass<Service>;
   module?: Service;
 }
-interface DescriptorConfig {
+interface PrimitiveConfig {
   propertyKey: string;
   service: InstantiableClass<Service>;
   module?: Service;
 }
-declare abstract class Descriptor<T extends object = {}> {
+declare abstract class Primitive<T extends object = {}> {
   protected readonly alepha: Alepha;
   readonly options: T;
-  readonly config: DescriptorConfig;
-  constructor(args: DescriptorArgs<T>);
+  readonly config: PrimitiveConfig;
+  constructor(args: PrimitiveArgs<T>);
   /**
-   * Called automatically by Alepha after the descriptor is created.
+   * Called automatically by Alepha after the primitive is created.
    */
   protected onInit(): void;
 }
-type DescriptorFactoryLike<T extends object = any> = {
+type PrimitiveFactoryLike<T extends object = any> = {
   (options: T): any;
   [KIND]: any;
 };
 //#endregion
-//#region ../alepha/src/core/descriptors/$inject.d.ts
+//#region ../alepha/src/core/interfaces/Async.d.ts
+/**
+ * Represents a value that can be either a value or a promise of value.
+ */
+type Async<T> = T | Promise<T>;
+//#endregion
+//#region ../alepha/src/core/interfaces/LoggerInterface.d.ts
+interface LoggerInterface {
+  trace(message: string, data?: unknown): void;
+  debug(message: string, data?: unknown): void;
+  info(message: string, data?: unknown): void;
+  warn(message: string, data?: unknown): void;
+  error(message: string, data?: unknown): void;
+}
+//#endregion
+//#region ../alepha/src/core/primitives/$inject.d.ts
 interface InjectOptions<T extends object = any> {
   /**
    * - 'transient' → Always a new instance on every inject. Zero caching.
@@ -112,8 +127,8 @@ interface InjectOptions<T extends object = any> {
   parent?: Service | null;
 }
 //#endregion
-//#region ../alepha/src/core/descriptors/$module.d.ts
-interface ModuleDescriptorOptions {
+//#region ../alepha/src/core/primitives/$module.d.ts
+interface ModulePrimitiveOptions {
   /**
    * Name of the module.
    *
@@ -128,9 +143,9 @@ interface ModuleDescriptorOptions {
    */
   services?: Array<Service>;
   /**
-   * List of $descriptors to register in the module.
+   * List of $primitives to register in the module.
    */
-  descriptors?: Array<DescriptorFactoryLike>;
+  primitives?: Array<PrimitiveFactoryLike>;
   /**
    * By default, module will register ALL services.
    * You can override this behavior by providing a register function.
@@ -144,7 +159,7 @@ interface ModuleDescriptorOptions {
  * Base class for all modules.
  */
 declare abstract class Module {
-  abstract readonly options: ModuleDescriptorOptions;
+  abstract readonly options: ModulePrimitiveOptions;
   abstract register(alepha: Alepha): void;
   static NAME_REGEX: RegExp;
   /**
@@ -159,21 +174,6 @@ declare abstract class Module {
   static of(ctor: Service): Service<Module> | undefined;
 }
 //#endregion
-//#region ../alepha/src/core/interfaces/Async.d.ts
-/**
- * Represents a value that can be either a value or a promise of value.
- */
-type Async<T> = T | Promise<T>;
-//#endregion
-//#region ../alepha/src/core/interfaces/LoggerInterface.d.ts
-interface LoggerInterface {
-  trace(message: string, data?: unknown): void;
-  debug(message: string, data?: unknown): void;
-  info(message: string, data?: unknown): void;
-  warn(message: string, data?: unknown): void;
-  error(message: string, data?: unknown): void;
-}
-//#endregion
 //#region ../alepha/src/core/providers/AlsProvider.d.ts
 type AsyncLocalStorageData = any;
 declare class AlsProvider {
@@ -379,7 +379,7 @@ declare class EventManager {
   }): Promise<void>;
 }
 //#endregion
-//#region ../alepha/src/core/descriptors/$atom.d.ts
+//#region ../alepha/src/core/primitives/$atom.d.ts
 type AtomOptions<T extends TAtomObject, N extends string> = {
   name: N;
   schema: T;
@@ -508,7 +508,7 @@ type OnlyArray<T extends object> = { [K in keyof T]: NonNullable<T[K]> extends A
  * // You can access the environment variables using alepha.env
  * console.log(alepha.env.MY_VAR); // "value"
  *
- * // But you should use $env() descriptor to get typed values from the environment.
+ * // But you should use $env() primitive to get typed values from the environment.
  * class App {
  *   env = $env(
  *     t.object({
@@ -521,7 +521,7 @@ type OnlyArray<T extends object> = { [K in keyof T]: NonNullable<T[K]> extends A
  * ### Modules
  *
  * Modules are a way to group services together.
- * You can register a module using the `$module` descriptor.
+ * You can register a module using the `$module` primitive.
  *
  * ```ts
  * import { $module } from "alepha";
@@ -539,7 +539,7 @@ type OnlyArray<T extends object> = { [K in keyof T]: NonNullable<T[K]> extends A
  * ### Hooks
  *
  * Hooks are a way to run async functions from all registered providers/services.
- * You can register a hook using the `$hook` descriptor.
+ * You can register a hook using the `$hook` primitive.
  *
  * ```ts
  * import { $hook } from "alepha";
@@ -636,9 +636,9 @@ declare class Alepha {
     use: Service;
   }>;
   /**
-   * Registry of descriptors.
+   * Registry of primitives.
    */
-  protected descriptorRegistry: Map<Service<Descriptor<{}>>, Descriptor<{}>[]>;
+  protected primitiveRegistry: Map<Service<Primitive<{}>>, Primitive<{}>[]>;
   /**
    *  List of all services + how they are provided.
    */
@@ -658,7 +658,7 @@ declare class Alepha {
   /**
    * State manager to store arbitrary values.
    */
-  get state(): StateManager<State>;
+  get store(): StateManager<State>;
   /**
    * Codec manager for encoding and decoding data with different formats.
    *
@@ -731,7 +731,7 @@ declare class Alepha {
    * Starts the App.
    *
    * - Lock any further changes to the container.
-   * - Run "configure" hook for all services. Descriptors will be processed.
+   * - Run "configure" hook for all services. Primitives will be processed.
    * - Run "start" hook for all services. Providers will connect/listen/...
    * - Run "ready" hook for all services. This is the point where the App is ready to serve requests.
    *
@@ -836,13 +836,13 @@ declare class Alepha {
   }>;
   services<T extends object>(base: Service<T>): Array<T>;
   /**
-   * Get all descriptors of the specified type.
+   * Get all primitives of the specified type.
    */
-  descriptors<TDescriptor extends Descriptor>(factory: {
-    [KIND]: InstantiableClass<TDescriptor>;
-  } | string): Array<TDescriptor>;
+  primitives<TPrimitive extends Primitive>(factory: {
+    [KIND]: InstantiableClass<TPrimitive>;
+  } | string): Array<TPrimitive>;
   protected new<T extends object>(service: Service<T>, args?: any[]): T;
-  protected processDescriptor(value: Descriptor, propertyKey?: string): void;
+  protected processPrimitive(value: Primitive, propertyKey?: string): void;
 }
 interface Hook<T extends keyof Hooks = any> {
   caller?: Service;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@alepha/protobuf",
   "description": "Protocol Buffers (Protobuf) codec support for Alepha framework.",
   "author": "Nicolas Foures",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -18,13 +18,13 @@
     "protobufjs": "^7.5.4"
   },
   "devDependencies": {
-    "alepha": "0.13.1",
+    "alepha": "0.13.2",
     "tsdown": "^0.16.7",
     "typescript": "^5.9.3",
     "vitest": "^4.0.14"
   },
   "peerDependencies": {
-    "alepha": "0.13.1"
+    "alepha": "0.13.2"
   },
   "scripts": {
     "lint": "alepha lint",