akanjs 3.0.0-alpha.45 → 3.0.0-alpha.46

package/base/primitiveRegistry.ts

@@ -209,12 +209,12 @@ declare global {
     [DEFAULT_VALUE]: boolean;
     [PURIFIED_VALUE]: boolean;
     [EXAMPLE_VALUE]: boolean;
-    validate(value: boolean | number): boolean;
-    parseValue(input: boolean | number): boolean | number;
-    serializeValue(value: boolean | number): boolean | number;
-    _parse(input: boolean | number): boolean;
-    _serialize(value: boolean | number): boolean;
-    _checkValue(value: boolean | number): void;
+    validate(value: boolean | number | string): boolean;
+    parseValue(input: boolean | number | string): boolean | number | string;
+    serializeValue(value: boolean | number | string): boolean | number | string;
+    _parse(input: boolean | number | string): boolean;
+    _serialize(value: boolean | number | string): boolean;
+    _checkValue(value: boolean | number | string): void;
   }
   interface DateConstructor {
     refName: "Date";
@@ -305,10 +305,14 @@ Object.assign(String, scalarPrimitiveStatics, {
 });
 PrimitiveRegistry.register(String);
 
-const normalizeBooleanPrimitiveValue = (value: boolean | number): boolean | null => {
+const normalizeBooleanPrimitiveValue = (value: boolean | number | string): boolean | null => {
   if (typeof value === "boolean") return value;
   if (value === 1) return true;
   if (value === 0) return false;
+  if (typeof value !== "string") return null;
+  const text = value.trim().toLowerCase();
+  if (text === "true" || text === "1") return true;
+  if (text === "false" || text === "0") return false;
   return null;
 };
 
@@ -317,13 +321,13 @@ Object.assign(Boolean, {
   refName: "Boolean",
   [DEFAULT_VALUE]: false,
   [EXAMPLE_VALUE]: true,
-  validate(value: boolean | number) {
+  validate(value: boolean | number | string) {
     return normalizeBooleanPrimitiveValue(value) !== null;
   },
-  parseValue(input: boolean | number) {
+  parseValue(input: boolean | number | string) {
     return normalizeBooleanPrimitiveValue(input) ?? input;
   },
-  serializeValue(value: boolean | number) {
+  serializeValue(value: boolean | number | string) {
     return normalizeBooleanPrimitiveValue(value) ?? value;
   },
 });

package/common/index.ts

@@ -45,6 +45,7 @@ export { randomPicks } from "./randomPicks";
 export {
   assertUniqueRoutePatterns,
   compareRouteSpecificity,
+  getPageSourceFileViolation,
   getRouteExports,
   isRouteSourceFile,
   isSpecialRouteLeaf,

package/common/routeConvention.ts

@@ -67,27 +67,37 @@ export function isRouteSourceFile(filePath: string): boolean {
   return tryParseRouteModuleKey(key) !== null;
 }
 
-export function validatePageSourceFile(filePath: string, options: ValidatePageSourceFileOptions = {}): boolean {
-  if (!SOURCE_EXT_RE.test(filePath)) return false;
+/**
+ * Why a `page/` file breaks the route convention, or null when it is fine. Null also covers a non-source
+ * asset, which `page/` tolerates. `akan sync <lib>` reports these alongside its other layout violations,
+ * so the rule stays in one place instead of being restated where it cannot afford to throw.
+ */
+export function getPageSourceFileViolation(filePath: string): string | null {
+  if (!SOURCE_EXT_RE.test(filePath)) return null;
 
   const key = filePath.startsWith("./") ? filePath : `./${filePath.split(/[\\/]/).join("/")}`;
   const match = ROUTE_SOURCE_RE.exec(key);
-  const displayPath = options.filePath ?? key;
-  if (!match) throw new Error(`[route-convention] invalid page source file: ${displayPath}`);
+  if (!match) return "invalid page source file";
 
   const file = match[1] as string;
   const ext = match[2] as string;
   const leaf = file.split("/").filter(Boolean).at(-1);
-  if (!leaf) throw new Error(`[route-convention] invalid page source file: ${displayPath}`);
+  if (!leaf) return "invalid page source file";
 
-  if (ext !== "tsx") throw new Error(`[route-convention] route source files under page/ must use .tsx: ${displayPath}`);
+  if (ext !== "tsx") return "route source files under page/ must use .tsx";
   if (leaf.startsWith("_") && !RESERVED_ROUTE_FILES.has(leaf) && leaf !== INTERNAL_ROOT_LAYOUT_LEAF)
-    throw new Error(
-      `[route-convention] only _index.tsx, _layout.tsx and _overrides.tsx are allowed as reserved route files under page/: ${displayPath}`,
-    );
-  if (/^[A-Z]/.test(leaf))
-    throw new Error(`[route-convention] route page filenames must not start with an uppercase letter: ${displayPath}`);
-  return true;
+    return "only _index.tsx, _layout.tsx and _overrides.tsx are allowed as reserved route files under page/";
+  if (/^[A-Z]/.test(leaf)) return "route page filenames must not start with an uppercase letter";
+  return null;
+}
+
+export function validatePageSourceFile(filePath: string, options: ValidatePageSourceFileOptions = {}): boolean {
+  if (!SOURCE_EXT_RE.test(filePath)) return false;
+
+  const violation = getPageSourceFileViolation(filePath);
+  if (!violation) return true;
+  const key = filePath.startsWith("./") ? filePath : `./${filePath.split(/[\\/]/).join("/")}`;
+  throw new Error(`[route-convention] ${violation}: ${options.filePath ?? key}`);
 }
 
 export function validateSubRoutePageKey(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "3.0.0-alpha.45",
+  "version": "3.0.0-alpha.46",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/service/adapt.ts

@@ -4,8 +4,8 @@ import { type ExtractInjectInfoObject, type InjectBuilder, type InjectInfo, inje
 
 export interface Adaptor {
   readonly logger: Logger;
-  onInit(): Promise<void>;
-  onDestroy(): Promise<void>;
+  onInit(): Promise<void> | void;
+  onDestroy(): Promise<void> | void;
 }
 
 export type AdaptorCls<
@@ -30,9 +30,9 @@ export function adapt(name: string, injectBuilder?: InjectBuilder) {
     readonly logger = new Logger(name);
     static readonly [INJECT_META] = injectInfoMap;
     static readonly refName = name;
-    async onInit() {
+    onInit(): Promise<void> | void {
     }
-    async onDestroy() {
+    onDestroy(): Promise<void> | void {
     }
   }
   return Adaptor;

package/service/serve.ts

@@ -43,9 +43,9 @@ const avoidKeys = new Set([
 export interface Service {
   readonly logger: Logger;
   
-  onInit(): Promise<void>;
+  onInit(): Promise<void> | void;
   _libsOnInit(): Promise<void>;
-  onDestroy(): Promise<void>;
+  onDestroy(): Promise<void> | void;
   _libsOnDestroy(): Promise<void>;
 }
 
@@ -121,9 +121,9 @@ export function serve(
     }
     static [INJECT_META] = {};
     readonly logger = new Logger(this.constructor.name);
-    async onInit() {
+    onInit(): Promise<void> | void {
     }
-    async onDestroy() {
+    onDestroy(): Promise<void> | void {
     }
   };
   applyMixins(srvRef, extSrvs, avoidKeys);
@@ -132,10 +132,11 @@ export function serve(
   const onDestroyFns = extSrvs.map((srv) => srv.prototype.onDestroy);
   Object.assign(srvRef.prototype, {
     async _libsOnInit(this: Service) {
-      await Promise.all([...onInitFns.map((onInit) => onInit?.call(this)), this.onInit()]);
+      
+      await Promise.all([...onInitFns, this.onInit].map(async (onInit) => await onInit?.call(this)));
     },
     async _libsOnDestroy(this: Service) {
-      await Promise.all([...onDestroyFns.map((onDestroy) => onDestroy?.call(this)), this.onDestroy()]);
+      await Promise.all([...onDestroyFns, this.onDestroy].map(async (onDestroy) => await onDestroy?.call(this)));
     },
   });
 

package/signal/intercept.ts

@@ -7,8 +7,8 @@ export type InterceptorCls<Methods = {}, InjectMap extends { [key: string]: Inje
   Methods &
     ExtractInjectInfoObject<InjectMap> & {
       readonly logger: Logger;
-      onInit(): Promise<void>;
-      onDestroy(): Promise<void>;
+      onInit(): Promise<void> | void;
+      onDestroy(): Promise<void> | void;
       intercept(context: SignalContext): AsyncGenerator<unknown> | Promise<unknown>;
     },
   { readonly [INJECT_META]: InjectMap; readonly refName: string }
@@ -31,9 +31,9 @@ export function intercept(refName: string, injectBuilder?: InjectBuilder) {
     intercept(context: SignalContext): AsyncGenerator | Promise<(res: Response) => Promise<Response>> {
       return Promise.resolve((res: Response) => Promise.resolve(res));
     }
-    async onInit() {
+    onInit(): Promise<void> | void {
     }
-    async onDestroy() {
+    onDestroy(): Promise<void> | void {
     }
   };
 }

package/types/base/primitiveRegistry.d.ts

@@ -114,12 +114,12 @@ declare global {
         [DEFAULT_VALUE]: boolean;
         [PURIFIED_VALUE]: boolean;
         [EXAMPLE_VALUE]: boolean;
-        validate(value: boolean | number): boolean;
-        parseValue(input: boolean | number): boolean | number;
-        serializeValue(value: boolean | number): boolean | number;
-        _parse(input: boolean | number): boolean;
-        _serialize(value: boolean | number): boolean;
-        _checkValue(value: boolean | number): void;
+        validate(value: boolean | number | string): boolean;
+        parseValue(input: boolean | number | string): boolean | number | string;
+        serializeValue(value: boolean | number | string): boolean | number | string;
+        _parse(input: boolean | number | string): boolean;
+        _serialize(value: boolean | number | string): boolean;
+        _checkValue(value: boolean | number | string): void;
     }
     interface DateConstructor {
         refName: "Date";

package/types/common/index.d.ts

@@ -24,7 +24,7 @@ export { pathGet } from "./pathGet.d.ts";
 export { pathSet } from "./pathSet.d.ts";
 export { randomPick } from "./randomPick.d.ts";
 export { randomPicks } from "./randomPicks.d.ts";
-export { assertUniqueRoutePatterns, compareRouteSpecificity, getRouteExports, isRouteSourceFile, isSpecialRouteLeaf, LAYOUT_ROUTE_EXPORTS, matchRoutePattern, normalizeRoutePattern, PAGE_ROUTE_EXPORTS, type ParsedRouteModuleKey, parseRouteModuleKey, RESERVED_ROUTE_CONFIG_EXPORTS, ROOT_LAYOUT_ROUTE_EXPORTS, type RouteModuleKind, routeSegmentToPatternPart, routeSegmentToTreePath, tryParseRouteModuleKey, type ValidatePageSourceFileOptions, type ValidateSubRoutePageKeyOptions, validatePageSourceFile, validateSubRoutePageKey, } from "./routeConvention.d.ts";
+export { assertUniqueRoutePatterns, compareRouteSpecificity, getPageSourceFileViolation, getRouteExports, isRouteSourceFile, isSpecialRouteLeaf, LAYOUT_ROUTE_EXPORTS, matchRoutePattern, normalizeRoutePattern, PAGE_ROUTE_EXPORTS, type ParsedRouteModuleKey, parseRouteModuleKey, RESERVED_ROUTE_CONFIG_EXPORTS, ROOT_LAYOUT_ROUTE_EXPORTS, type RouteModuleKind, routeSegmentToPatternPart, routeSegmentToTreePath, tryParseRouteModuleKey, type ValidatePageSourceFileOptions, type ValidateSubRoutePageKeyOptions, validatePageSourceFile, validateSubRoutePageKey, } from "./routeConvention.d.ts";
 export { sleep } from "./sleep.d.ts";
 export { splitVersion } from "./splitVersion.d.ts";
 export { getBasePathFromPathname, parseBasePaths, parseSubRouteHosts, resolveSubRouteHosts } from "./subRoute.d.ts";

package/types/common/routeConvention.d.ts

@@ -27,6 +27,12 @@ export interface ValidatePageSourceFileOptions {
     filePath?: string;
 }
 export declare function isRouteSourceFile(filePath: string): boolean;
+/**
+ * Why a `page/` file breaks the route convention, or null when it is fine. Null also covers a non-source
+ * asset, which `page/` tolerates. `akan sync <lib>` reports these alongside its other layout violations,
+ * so the rule stays in one place instead of being restated where it cannot afford to throw.
+ */
+export declare function getPageSourceFileViolation(filePath: string): string | null;
 export declare function validatePageSourceFile(filePath: string, options?: ValidatePageSourceFileOptions): boolean;
 export declare function validateSubRoutePageKey(key: string, basePaths: Iterable<string>, options?: ValidateSubRoutePageKeyOptions): void;
 export declare function parseRouteModuleKey(key: string): ParsedRouteModuleKey;

package/types/service/adapt.d.ts

@@ -3,8 +3,8 @@ import { Logger } from "akanjs/common";
 import { type ExtractInjectInfoObject, type InjectBuilder, type InjectInfo } from "./injectInfo.d.ts";
 export interface Adaptor {
     readonly logger: Logger;
-    onInit(): Promise<void>;
-    onDestroy(): Promise<void>;
+    onInit(): Promise<void> | void;
+    onDestroy(): Promise<void> | void;
 }
 export type AdaptorCls<Methods = any, InjectMap extends Record<string, InjectInfo> = {}> = Cls<Methods & ExtractInjectInfoObject<InjectMap> & Adaptor, {
     readonly [INJECT_META]: InjectMap;

package/types/service/serve.d.ts

@@ -10,9 +10,9 @@ interface ServiceOptions {
 export type ServiceType = "database" | "plain";
 export interface Service {
     readonly logger: Logger;
-    onInit(): Promise<void>;
+    onInit(): Promise<void> | void;
     _libsOnInit(): Promise<void>;
-    onDestroy(): Promise<void>;
+    onDestroy(): Promise<void> | void;
     _libsOnDestroy(): Promise<void>;
 }
 export type ServiceCls<RefName extends string = string, Methods = {}, InjectMap extends {

package/types/signal/intercept.d.ts

@@ -6,8 +6,8 @@ export type InterceptorCls<Methods = {}, InjectMap extends {
     [key: string]: InjectInfo;
 } = {}> = Cls<Methods & ExtractInjectInfoObject<InjectMap> & {
     readonly logger: Logger;
-    onInit(): Promise<void>;
-    onDestroy(): Promise<void>;
+    onInit(): Promise<void> | void;
+    onDestroy(): Promise<void> | void;
     intercept(context: SignalContext): AsyncGenerator<unknown> | Promise<unknown>;
 }, {
     readonly [INJECT_META]: InjectMap;