akanjs 2.3.5-rc.9 → 2.3.6-rc.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # akanjs
 
+## 2.3.5
+
+### Patch Changes
+
+- Fix Akan document and service type regressions for extended constant, document, signal, and store models.
+
 ## 2.3.2
 
 ### Minor Changes

package/README.ko.md

@@ -1,6 +1,6 @@
 # Akan.js
 
-[English](https://unpkg.com/akanjs@latest/README.md) | [Docs](https://akanjs.com/docs) | [npm](https://www.npmjs.com/package/akanjs)
+[English](./README.md) | [Docs](https://akanjs.com/docs) | [npm](https://www.npmjs.com/package/akanjs)
 
 **한 줄의 비즈니스 코드로 웹·iOS·Android·서버·DB를 한 번에.**  
 **One line of business code ships web, iOS, Android, server, and database together.**

package/README.md

@@ -1,6 +1,6 @@
 # Akan.js
 
-[한국어](https://unpkg.com/akanjs@latest/README.ko.md) | [Docs](https://akanjs.com/docs) | [npm](https://www.npmjs.com/package/akanjs)
+[한국어](./README.ko.md) | [Docs](https://akanjs.com/docs) | [npm](https://www.npmjs.com/package/akanjs)
 
 **One line of business code ships web, iOS, Android, server, and database together.**
 

package/base/base.ts

@@ -1,4 +1,4 @@
-import type { Cls } from ".";
+import type { CLIENT_VALUE, Cls, DEFAULT_VALUE, PURIFIED_VALUE, SERVER_VALUE } from ".";
 import { Float, Int } from "./primitiveRegistry";
 
 class EnumPrototype {}
@@ -6,6 +6,10 @@ export type EnumInstance<RefName extends string = string, T = string | number> =
   { refName: RefName; value: T },
   {
     refName: RefName;
+    [SERVER_VALUE]: T;
+    [CLIENT_VALUE]: T;
+    [DEFAULT_VALUE]: T;
+    [PURIFIED_VALUE]: T;
     type: StringConstructor | typeof Int | typeof Float;
     values: readonly T[];
     valueMap: Map<T, number>;
@@ -71,7 +75,7 @@ export const enumOf = <RefName extends string, T = string | number>(
     readonly refName = refName;
     declare readonly value: T;
   }
-  return Enum;
+  return Enum as unknown as EnumInstance<RefName, T>;
 };
 
 /** Id-keyed list helper used for light model collections and immutable-style list updates. */

package/base/primitiveRegistry.ts

@@ -1,5 +1,5 @@
 import dayjsLib, { type Dayjs } from "dayjs";
-
+import { CLIENT_VALUE, DEFAULT_VALUE, EXAMPLE_VALUE, PURIFIED_VALUE, SERVER_VALUE } from "./symbols";
 import type { Cls } from "./types";
 
 export type { Dayjs };
@@ -44,17 +44,14 @@ export class PrimitiveRegistry {
   }
 }
 
-export const PRIMITIVE_SERVER_VALUE = Symbol.for("PRIMITIVE_SERVER_VALUE");
-export const PRIMITIVE_CLIENT_VALUE = Symbol.for("PRIMITIVE_CLIENT_VALUE");
-export const PRIMITIVE_DEFAULT_VALUE = Symbol.for("PRIMITIVE_DEFAULT_VALUE");
-export const PRIMITIVE_EXAMPLE_VALUE = Symbol.for("PRIMITIVE_EXAMPLE_VALUE");
 export type PrimitiveValue = string | number | boolean | Dayjs | Date | null | undefined;
 export class PrimitiveScalar {
   static refName: string;
-  static [PRIMITIVE_SERVER_VALUE]: unknown;
-  static [PRIMITIVE_CLIENT_VALUE]: unknown;
-  static [PRIMITIVE_DEFAULT_VALUE]: unknown = null;
-  static [PRIMITIVE_EXAMPLE_VALUE]: unknown = null;
+  static [SERVER_VALUE]: unknown;
+  static [CLIENT_VALUE]: unknown;
+  static [DEFAULT_VALUE]: unknown = null;
+  static [PURIFIED_VALUE]: unknown = null;
+  static [EXAMPLE_VALUE]: unknown = null;
 
   static validate(value: PrimitiveValue): boolean {
     return true;
@@ -105,10 +102,11 @@ export class PrimitiveScalar {
 /** Integer primitive scalar. Accepts safe integer numbers after parsing. */
 export class Int extends PrimitiveScalar {
   static override refName: "Int" = "Int";
-  static override [PRIMITIVE_SERVER_VALUE]: number;
-  static override [PRIMITIVE_CLIENT_VALUE]: number;
-  static override [PRIMITIVE_DEFAULT_VALUE]: number = 0;
-  static override [PRIMITIVE_EXAMPLE_VALUE]: number = 0;
+  static override [SERVER_VALUE]: number;
+  static override [CLIENT_VALUE]: number;
+  static override [DEFAULT_VALUE]: number = 0;
+  static override [PURIFIED_VALUE]: number = 0;
+  static override [EXAMPLE_VALUE]: number = 0;
 
   static override validate(value: string | number): boolean {
     return typeof value === "number" && Number.isSafeInteger(value);
@@ -125,10 +123,11 @@ PrimitiveRegistry.register(Int);
 /** Floating point primitive scalar. Accepts finite numbers after parsing. */
 export class Float extends PrimitiveScalar {
   static override refName: "Float" = "Float";
-  static override [PRIMITIVE_SERVER_VALUE]: number;
-  static override [PRIMITIVE_CLIENT_VALUE]: number;
-  static override [PRIMITIVE_DEFAULT_VALUE]: number = 0;
-  static override [PRIMITIVE_EXAMPLE_VALUE]: number = 0;
+  static override [SERVER_VALUE]: number;
+  static override [CLIENT_VALUE]: number;
+  static override [DEFAULT_VALUE]: number = 0;
+  static override [PURIFIED_VALUE]: number = 0;
+  static override [EXAMPLE_VALUE]: number = 0;
 
   static override validate(value: string | number): boolean {
     return typeof value === "number" && Number.isFinite(value);
@@ -145,10 +144,11 @@ PrimitiveRegistry.register(Float);
 /** 24-character hexadecimal id primitive used by Akan document and signal models. */
 export class ID extends PrimitiveScalar {
   static override refName: "ID" = "ID";
-  static override [PRIMITIVE_SERVER_VALUE]: string;
-  static override [PRIMITIVE_CLIENT_VALUE]: string;
-  static override [PRIMITIVE_DEFAULT_VALUE]: string = "";
-  static override [PRIMITIVE_EXAMPLE_VALUE]: string = "1234567890abcdef12345678";
+  static override [SERVER_VALUE]: string;
+  static override [CLIENT_VALUE]: string;
+  static override [DEFAULT_VALUE]: string = "";
+  static override [PURIFIED_VALUE]: string = "";
+  static override [EXAMPLE_VALUE]: string = "1234567890abcdef12345678";
 
   static override validate(value: string): boolean {
     if (typeof value !== "string") return false;
@@ -161,7 +161,7 @@ export class ID extends PrimitiveScalar {
     return String(value);
   }
   static override _checkValue(value: PrimitiveValue, options: { optional?: boolean } = {}): void {
-    if (value === ID[PRIMITIVE_DEFAULT_VALUE]) return;
+    if (value === ID[DEFAULT_VALUE]) return;
     
     super._checkValue(value, options);
   }
@@ -171,17 +171,18 @@ PrimitiveRegistry.register(ID);
 /** Open object primitive for intentionally flexible payloads or metadata blobs. */
 export class Any extends PrimitiveScalar {
   static override refName: "Any" = "Any";
-  static override [PRIMITIVE_DEFAULT_VALUE]: object | null = null;
-  static override [PRIMITIVE_EXAMPLE_VALUE]: object = {};
+  static override [DEFAULT_VALUE]: object | null = null;
+  static override [EXAMPLE_VALUE]: object = {};
 }
 PrimitiveRegistry.register(Any);
 
 export class Upload extends PrimitiveScalar {
   static override refName: "Upload" = "Upload";
-  static override [PRIMITIVE_SERVER_VALUE]: File;
-  static override [PRIMITIVE_CLIENT_VALUE]: File;
-  static override [PRIMITIVE_DEFAULT_VALUE]: File | null = null;
-  static override [PRIMITIVE_EXAMPLE_VALUE] = "FileUpload";
+  static override [SERVER_VALUE]: File;
+  static override [CLIENT_VALUE]: File;
+  static override [DEFAULT_VALUE]: File | null = null;
+  static override [PURIFIED_VALUE]: File;
+  static override [EXAMPLE_VALUE] = "FileUpload";
   __TEMP_TYPE__: "Upload" = "Upload";
 }
 PrimitiveRegistry.register(Upload);
@@ -189,10 +190,11 @@ PrimitiveRegistry.register(Upload);
 declare global {
   interface StringConstructor {
     refName: "String";
-    [PRIMITIVE_SERVER_VALUE]: string;
-    [PRIMITIVE_CLIENT_VALUE]: string;
-    [PRIMITIVE_DEFAULT_VALUE]: string;
-    [PRIMITIVE_EXAMPLE_VALUE]: string;
+    [SERVER_VALUE]: string;
+    [CLIENT_VALUE]: string;
+    [DEFAULT_VALUE]: string;
+    [PURIFIED_VALUE]: string;
+    [EXAMPLE_VALUE]: string;
     validate(value: string): boolean;
     parseValue(input: string): string;
     serializeValue(value: string): string;
@@ -202,10 +204,11 @@ declare global {
   }
   interface BooleanConstructor {
     refName: "Boolean";
-    [PRIMITIVE_SERVER_VALUE]: boolean;
-    [PRIMITIVE_CLIENT_VALUE]: boolean;
-    [PRIMITIVE_DEFAULT_VALUE]: boolean;
-    [PRIMITIVE_EXAMPLE_VALUE]: boolean;
+    [SERVER_VALUE]: boolean;
+    [CLIENT_VALUE]: boolean;
+    [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;
@@ -215,10 +218,11 @@ declare global {
   }
   interface DateConstructor {
     refName: "Date";
-    [PRIMITIVE_SERVER_VALUE]: Dayjs;
-    [PRIMITIVE_CLIENT_VALUE]: Dayjs;
-    [PRIMITIVE_DEFAULT_VALUE]: Dayjs;
-    [PRIMITIVE_EXAMPLE_VALUE]: string;
+    [SERVER_VALUE]: Dayjs;
+    [CLIENT_VALUE]: Dayjs;
+    [DEFAULT_VALUE]: Dayjs;
+    [PURIFIED_VALUE]: Dayjs;
+    [EXAMPLE_VALUE]: string;
     validate(value: Date): boolean;
     parseValue(input: Date): Dayjs;
     serializeValue(value: Dayjs | Date): Date;
@@ -287,8 +291,8 @@ const scalarPrimitiveStatics = {
 
 Object.assign(String, scalarPrimitiveStatics, {
   refName: "String",
-  [PRIMITIVE_DEFAULT_VALUE]: "",
-  [PRIMITIVE_EXAMPLE_VALUE]: "String",
+  [DEFAULT_VALUE]: "",
+  [EXAMPLE_VALUE]: "String",
   validate(value: string) {
     return typeof value === "string";
   },
@@ -311,8 +315,8 @@ const normalizeBooleanPrimitiveValue = (value: boolean | number): boolean | null
 Object.assign(Boolean, {
   ...scalarPrimitiveStatics,
   refName: "Boolean",
-  [PRIMITIVE_DEFAULT_VALUE]: false,
-  [PRIMITIVE_EXAMPLE_VALUE]: true,
+  [DEFAULT_VALUE]: false,
+  [EXAMPLE_VALUE]: true,
   validate(value: boolean | number) {
     return normalizeBooleanPrimitiveValue(value) !== null;
   },
@@ -328,8 +332,8 @@ PrimitiveRegistry.register(Boolean);
 Object.assign(Date, {
   ...scalarPrimitiveStatics,
   refName: "Date",
-  [PRIMITIVE_DEFAULT_VALUE]: dayjs(new Date(-1)),
-  [PRIMITIVE_EXAMPLE_VALUE]: dayjs(new Date().toISOString()),
+  [DEFAULT_VALUE]: dayjs(new Date(-1)),
+  [EXAMPLE_VALUE]: dayjs(new Date().toISOString()),
   validate(value: Date | string | number) {
     const date = new Date(value);
     if (Number.isNaN(date.getTime())) return false;

package/base/symbols.ts

@@ -1,11 +1,16 @@
-export const FIELD_META = Symbol.for("akanjs.field");
-export const SLICE_META = Symbol.for("akanjs.slice");
-export const FILTER_META = Symbol.for("akanjs.filter");
-export const LOADER_META = Symbol.for("akanjs.loader");
-export const INJECT_META = Symbol.for("akanjs.inject");
-export const ENDPOINT_META = Symbol.for("akanjs.endpoint");
-export const INTERNAL_META = Symbol.for("akanjs.internal");
-export const STATE_META = Symbol.for("akanjs.state");
-export const STATE_INIT_META = Symbol.for("akanjs.state.init");
-export const STATE_DERIVED_META = Symbol.for("akanjs.state.derived");
-export const ACTION_META = Symbol.for("akanjs.action");
+export const FIELD_META = Symbol.for("akan.field");
+export const SLICE_META = Symbol.for("akan.slice");
+export const FILTER_META = Symbol.for("akan.filter");
+export const LOADER_META = Symbol.for("akan.loader");
+export const INJECT_META = Symbol.for("akan.inject");
+export const ENDPOINT_META = Symbol.for("akan.endpoint");
+export const INTERNAL_META = Symbol.for("akan.internal");
+export const STATE_META = Symbol.for("akan.state");
+export const STATE_INIT_META = Symbol.for("akan.state.init");
+export const STATE_DERIVED_META = Symbol.for("akan.state.derived");
+export const ACTION_META = Symbol.for("akan.action");
+export const SERVER_VALUE = Symbol.for("akan.value.server");
+export const CLIENT_VALUE = Symbol.for("akan.value.client");
+export const DEFAULT_VALUE = Symbol.for("akan.value.default");
+export const EXAMPLE_VALUE = Symbol.for("akan.value.example");
+export const PURIFIED_VALUE = Symbol.for("akan.value.purified");

package/base/types.ts

@@ -48,6 +48,18 @@ export type ObjectAssign<Objects extends object[], Acc = unknown> = Objects exte
   ? ObjectAssign<Rest, Assign<Acc, First>>
   : Acc;
 
+export type ObjectAssignKeyOfObjects<
+  T extends object[],
+  Key extends PropertyKey,
+  Acc = Record<never, never>,
+> = T extends [infer First extends object, ...infer Rest extends object[]]
+  ? Key extends keyof First
+    ? First[Key] extends object
+      ? ObjectAssignKeyOfObjects<Rest, Key, Assign<Acc, First[Key]>>
+      : ObjectAssignKeyOfObjects<Rest, Key, Acc>
+    : ObjectAssignKeyOfObjects<Rest, Key, Acc>
+  : Acc;
+
 export type MergeAll<T extends object[], Acc = unknown> = T extends [
   infer First extends object,
   ...infer Rest extends object[],

package/constant/constantRegistry.ts

@@ -1,7 +1,6 @@
 import {
   type Cls,
   type EnumInstance,
-  FIELD_META,
   type GetStateObject,
   isEnum,
   PrimitiveRegistry,
@@ -9,14 +8,16 @@ import {
   type PrimitiveValue,
 } from "akanjs/base";
 import { capitalize, lowerlize } from "akanjs/common";
-import { type ConstantCls, deserialize, type FieldObject, type PurifiedModel, serialize } from ".";
+import {
+  type ConstantCls,
+  type ConstantModelRef,
+  deserialize,
+  type FieldObject,
+  type PurifiedModel,
+  serialize,
+} from ".";
 import type { ConstantType, DefaultOf, DocumentModel, QueryOf } from "./types";
 
-type ConstantModelRef<FieldObj extends FieldObject = FieldObject> = Cls<
-  unknown,
-  { [FIELD_META]: FieldObj; modelType: ConstantType }
->;
-
 /** Runtime registry for Akan constant model metadata, refs, enums, and generated model contracts. */
 export class ConstantRegistry {
   static database = new Map<string, ConstantModel>();
@@ -107,7 +108,7 @@ export class ConstantRegistry {
     InputRef extends ConstantModelRef,
     ObjectRef extends ConstantModelRef,
     FullFieldObj extends FieldObject,
-    FullRef extends ConstantModelRef<FullFieldObj>,
+    FullRef extends ConstantModelRef<any, FullFieldObj>,
     LightRef extends ConstantModelRef,
     InsightRef extends ConstantModelRef,
     Input = InstanceType<InputRef>,
@@ -200,7 +201,7 @@ export class ConstantRegistry {
       _StateLight: null as unknown as GetStateObject<Light>,
       _StateInsight: null as unknown as GetStateObject<Insight>,
     };
-    ConstantRegistry.setDatabase(refName, cnst as ConstantModel);
+    ConstantRegistry.setDatabase(refName, cnst as unknown as ConstantModel);
     Object.entries(constExports).forEach(([key, value]) => {
       if ((modelRefSet as Set<unknown>).has(value)) return;
       else if (typeof value === "function" && isEnum(value as Cls))

package/constant/deserialize.ts

@@ -1,8 +1,8 @@
-import { applyFnToArrayObjects, type Cls, FIELD_META, PrimitiveRegistry, type PrimitiveScalar } from "akanjs/base";
+import { Any, applyFnToArrayObjects, type Cls, FIELD_META, PrimitiveRegistry, type PrimitiveScalar } from "akanjs/base";
 
-import { type ConstantCls, ConstantRegistry, type FieldProps } from ".";
+import { type ConstantCls, type ConstantModelRef, ConstantRegistry, type FieldProps } from ".";
 
-const getDeserializeFn = (inputRef: ConstantCls | PrimitiveScalar) => {
+const getDeserializeFn = (inputRef: ConstantModelRef | PrimitiveScalar) => {
   const deserializeFn = PrimitiveRegistry.has(inputRef as Cls)
     ? (value: unknown) => (inputRef as unknown as typeof PrimitiveScalar)._parse(value as never)
     : (value: unknown) => value as object;
@@ -13,14 +13,14 @@ const deserializeMap = (value: unknown, field: Pick<FieldProps, "of">) => {
   return Object.fromEntries(
     Object.entries(value as Record<string, unknown>).map(([key, val]) => [
       key,
-      applyFnToArrayObjects(val, (v: never) => deserializeInput(v, field.of as ConstantCls, 0)),
+      applyFnToArrayObjects(val, (v: never) => deserializeInput(v, field.of as ConstantModelRef, 0)),
     ]),
   );
 };
 
 const deserializeInput = <Input = unknown>(
   value: Input | Input[],
-  inputRef: ConstantCls<Input> | PrimitiveScalar,
+  inputRef: ConstantModelRef<Input> | PrimitiveScalar,
   arrDepth: number,
   convertFn: (value: unknown) => unknown = (value: unknown) => value,
 ): Input | Input[] => {
@@ -58,13 +58,13 @@ const deserializeInput = <Input = unknown>(
 };
 
 export const deserialize = (
-  argRef: ConstantCls | PrimitiveScalar,
+  argRef: ConstantModelRef | PrimitiveScalar,
   arrDepth: number,
   value: unknown,
   { key, nullable = false, convertFn }: { key?: string; nullable?: boolean; convertFn?: (value: unknown) => unknown },
 ) => {
   if (nullable && (value === null || value === undefined)) return null;
-  else if (!nullable && (value === null || value === undefined))
+  else if (!nullable && (value === null || value === undefined) && argRef !== Any)
     throw new Error(`Invalid Value (Nullable) in ${key} ${argRef} for value ${value}`);
   return deserializeInput(value, argRef, arrDepth, convertFn) as object[];
 };