@nodefony/orm-core 10.0.0-alpha.1

package/dist/types/nodefony/src/readOptions.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Vérifie que l'option de lecture `order` respecte le contrat portable
+ * `Array<[string, "ASC" | "DESC"]>`, ou lève {@link InvalidOrderOption}.
+ *
+ * Source de vérité **unique** partagée par tous les adapters : chacun l'appelle une
+ * fois, en amont de la construction de sa requête, plutôt que de retester la forme à
+ * chaque endroit qui pose un tri. Sans elle, un `order` mal formé était sauté en
+ * silence (le test historique `options?.order?.length` est faux pour un objet) et la
+ * requête partait sans `ORDER BY`.
+ *
+ * Absence de tri — `undefined`, `null`, ou tableau vide — est acceptée : rien n'y est
+ * exprimé qui puisse être trahi. Seule une TENTATIVE de tri mal formée est refusée.
+ *
+ * Coût : sortie immédiate dans le cas dominant (`undefined`), aucune allocation sur le
+ * chemin nominal — la description n'est construite qu'au moment de lever.
+ *
+ * @param order - valeur de `options.order` telle que reçue de l'appelant.
+ * @param entity - nom logique de l'entité ciblée (diagnostic).
+ * @throws InvalidOrderOption si `order` est présent et n'est pas un tableau de couples valides.
+ */
+export declare function assertOrderOption(order: unknown, entity: string): void;

package/dist/types/nodefony/src/serviceWiring.d.ts

@@ -0,0 +1,24 @@
+import type { Container, Event, DefaultOptionsService } from "nodefony";
+/**
+ * Câblage d'un {@link Service} (DI / bus d'événements / options) sous forme de
+ * **tuple** — évite de redéclarer `container` / `notificationsCenter` / `options`
+ * dans le constructeur de chaque service juste pour les tunneler jusqu'à `super`.
+ *
+ * À capter en rest-param et forwarder par spread :
+ *
+ * ```ts
+ * constructor(repository: R, ...wiring: ServiceWiring) {
+ *   super("name", repository, ...wiring);
+ * }
+ * ```
+ *
+ * Reflète l'ordre positionnel du constructeur de `Service` :
+ * `(name, container?, notificationsCenter?, options?)`. Ces trois arguments sont
+ * quasi toujours **omis** (le container DI les fournit à l'instanciation) ; le
+ * tuple sert surtout à ne plus les recopier à la main dans chaque sous-classe.
+ */
+export type ServiceWiring = [
+    container?: Container,
+    notificationsCenter?: Event | false | null,
+    options?: DefaultOptionsService
+];