akanjs 2.4.1 → 2.4.2-rc.1

package/types/common/websocketAuth.d.ts

@@ -0,0 +1,19 @@
+export interface WebsocketAuthRequest {
+    key: string;
+    data: [string | null];
+}
+export interface WebsocketAuthAckData {
+    type: "auth";
+    revokedRooms: string[];
+}
+/**
+ * Framework-owned websocket auth contract shared by the client and the server dispatcher.
+ * The credential frame carries the raw bearer token; verifying it stays in userland middleware,
+ * so the server only swaps the credential snapshot held on the socket.
+ */
+export declare const websocketAuthContract: {
+    readonly key: "__auth";
+    readonly makeRequest: (jwt: string | null) => WebsocketAuthRequest;
+    readonly makeAck: (revokedRooms: string[]) => WebsocketAuthAckData;
+    readonly readJwt: (data: unknown) => string | null;
+};

package/types/constant/fieldInfo.d.ts

@@ -1,4 +1,5 @@
 import { type Any, CLIENT_VALUE, type Cls, type Dayjs, type EnumInstance, type Float, Int, type PrimitiveScalar, SERVER_VALUE, type SingleValue, type UnCls } from "akanjs/base";
+import type { TextFieldRole } from "./textFieldPaths.d.ts";
 import type { BaseObject } from "./types.d.ts";
 import type { ConstantModelRef } from "./via.d.ts";
 export type ParamFieldType = (typeof PrimitiveScalar & {
@@ -43,7 +44,7 @@ export interface ConstantFieldProps<FieldType extends ConstantFieldKind = Consta
     example?: FieldValue;
     of?: MapValue;
     validate?: (value: FieldValue, model: any) => boolean;
-    text?: "search" | "filter";
+    text?: TextFieldRole;
     meta?: Metadata;
 }
 export declare const fieldPresets: readonly ["email", "password", "url"];
@@ -89,7 +90,7 @@ interface ConstantFieldBuildProps<FieldType extends ConstantFieldKind = any, Fie
     example?: FieldValue;
     of?: MapValue;
     validate?: (value: FieldValue, model: any) => boolean;
-    text?: "search" | "filter";
+    text?: TextFieldRole;
     modelRef: ConstantModelRef;
     arrDepth: number;
     optArrDepth: number;
@@ -132,7 +133,7 @@ export declare class ConstantField<FieldType extends ConstantFieldKind = Constan
     readonly example?: FieldValue;
     readonly of?: MapValue;
     readonly validate?: (value: FieldValue, model: any) => boolean;
-    readonly text?: "search" | "filter";
+    readonly text?: TextFieldRole;
     readonly modelRef: ConstantModelRef;
     readonly arrDepth: number;
     readonly optArrDepth: number;

package/types/constant/index.d.ts

@@ -6,5 +6,7 @@ export * from "./getDefault.d.ts";
 export * from "./immerify.d.ts";
 export * from "./purify.d.ts";
 export * from "./serialize.d.ts";
+export * from "./textFieldPathSet.d.ts";
+export * from "./textFieldPaths.d.ts";
 export * from "./types.d.ts";
 export * from "./via.d.ts";

package/types/constant/textFieldPathSet.d.ts

@@ -0,0 +1,8 @@
+/** The `search_doc` columns a model feeds, each holding the document paths that write it. */
+export declare class TextFieldPathSet {
+    readonly title: Set<string>;
+    readonly desc: Set<string>;
+    readonly tag: Set<string>;
+    readonly thumb: Set<string>;
+    readonly filter: Set<string>;
+}

package/types/constant/textFieldPaths.d.ts

@@ -0,0 +1,10 @@
+import type { FieldObject } from "./fieldInfo.d.ts";
+import { TextFieldPathSet } from "./textFieldPathSet.d.ts";
+/** Column a `text` field feeds in the `search_doc` mirror. */
+export declare const textFieldRoles: readonly ["title", "desc", "tag", "thumb", "filter"];
+export type TextFieldRole = (typeof textFieldRoles)[number];
+export declare class TextFieldPaths extends TextFieldPathSet {
+    #private;
+    readonly children: TextFieldPathSet;
+    collect(fieldMap: FieldObject): this;
+}

package/types/constant/types.d.ts

@@ -67,9 +67,6 @@ export interface ProtoPatch {
     at: Dayjs;
 }
 export declare const DEFAULT_PAGE_SIZE = 20;
-export interface TextDoc {
-    [key: string]: string | TextDoc;
-}
 export type NonFunctionalKeys<T> = {
     [K in keyof T]: T[K] extends (...args: never[]) => unknown ? never : K;
 }[keyof T];

package/types/constant/via.d.ts

@@ -1,6 +1,7 @@
 import { CLIENT_VALUE, type Cls, DEFAULT_VALUE, type EnumInstance, FIELD_META, type ObjectAssign, type ObjectAssignKeyOfObjects, PURIFIED_VALUE, SERVER_VALUE } from "akanjs/base";
 import { type ExtractFieldInfoObject, type FieldBuilder, type FieldInfoObject, type FieldInfoObjectToFieldObject, type FieldObject, type FieldResolver } from "./fieldInfo.d.ts";
 import { type PurifiedModel, type PurifyFunc } from "./purify.d.ts";
+import { TextFieldPaths } from "./textFieldPaths.d.ts";
 import type { BaseInsight, BaseObject, ConstantType, DefaultOf, DefaultOfSchema, NonFunctionalKeys } from "./types.d.ts";
 type BaseFields = "id" | "createdAt" | "updatedAt" | "removedAt";
 type OmitBase<T> = Omit<T, BaseFields>;
@@ -32,14 +33,7 @@ export interface ConstantStatics<Schema = any, OwnSchema = Schema, OwnFieldObj e
     children: Set<ConstantModelRef>;
     relations: Set<ConstantModelRef>;
     enums: Set<EnumInstance>;
-    text: {
-        search: Set<string>;
-        filter: Set<string>;
-        children: {
-            search: Set<string>;
-            filter: Set<string>;
-        };
-    };
+    text: TextFieldPaths;
     _OptionalKey: OptionalKey;
     _RelationKey: RelationKey;
     _PrimitiveKey: PrimitiveKey;
@@ -65,14 +59,7 @@ export interface DatabaseConstantStatics<Schema = any, FieldObj extends FieldObj
     children: Set<ConstantModelRef>;
     relations: Set<ConstantModelRef>;
     enums: Set<EnumInstance>;
-    text: {
-        search: Set<string>;
-        filter: Set<string>;
-        children: {
-            search: Set<string>;
-            filter: Set<string>;
-        };
-    };
+    text: TextFieldPaths;
     _DatabaseSchema: {
         [K in keyof Schema]: K extends keyof FieldObj ? FieldObj[K]["fieldType"] extends "hidden" ? NonNullable<Schema[K]> : Schema[K] : Schema[K];
     };
@@ -83,14 +70,7 @@ export type ConstantModelRef<Schema = any, FieldObj extends FieldObject = FieldO
     children: Set<ConstantModelRef>;
     relations: Set<ConstantModelRef>;
     enums: Set<EnumInstance>;
-    text: {
-        search: Set<string>;
-        filter: Set<string>;
-        children: {
-            search: Set<string>;
-            filter: Set<string>;
-        };
-    };
+    text: TextFieldPaths;
 }>;
 export type DocumentConstantModelRef<Schema = any, FieldObj extends FieldObject = FieldObject, ModelType extends ConstantType = ConstantType, DatabaseSchema = DatabaseSchemaOf<Schema, never>> = Cls<Schema, {
     [FIELD_META]: FieldObj;

package/types/dictionary/base.dictionary.d.ts

@@ -1 +1 @@
-export declare const baseDictionary: import("./dictInfo.d.ts").ServiceDictInfo<[string, string], "ping" | "pingBody" | "pingParam" | "pingQuery" | "wsPing" | "pubsubPing", never, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new" | "edit" | "view">;
+export declare const baseDictionary: import("./dictInfo.d.ts").ServiceDictInfo<[string, string], "ping" | "pingBody" | "pingParam" | "pingQuery" | "wsPing" | "pubsubPing", never, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "new" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "edit" | "view">;

package/types/dictionary/dictionary.d.ts

@@ -1,11 +1,11 @@
 import type { BaseEndpoint } from "akanjs/signal";
 export declare const dictionary: {
-    base: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new" | "edit" | "view">, never>;
+    base: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "new" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "edit" | "view">, never>;
 };
-export declare const Err: import("./trans.d.ts").ErrConstructor<never>, translate: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja", key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new" | "edit" | "view">, data?: import("./trans.d.ts").TranslationData) => string, msg: {
-    info: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new" | "edit" | "view">, option?: import("./trans.d.ts").TransMessageOption) => void;
-    success: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new" | "edit" | "view">, option?: import("./trans.d.ts").TransMessageOption) => void;
-    error: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new" | "edit" | "view">, option?: import("./trans.d.ts").TransMessageOption) => void;
-    warning: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new" | "edit" | "view">, option?: import("./trans.d.ts").TransMessageOption) => void;
-    loading: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new" | "edit" | "view">, option?: import("./trans.d.ts").TransMessageOption) => void;
-}, getDictionary: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja") => object, getAllDictionary: () => import("./trans.d.ts").RootDictionary, __Dict_Key__: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "new" | "edit" | "view">, __Error_Key__: never;
+export declare const Err: import("./trans.d.ts").ErrConstructor<never>, translate: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja", key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "new" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "edit" | "view">, data?: import("./trans.d.ts").TranslationData) => string, msg: {
+    info: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "new" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "edit" | "view">, option?: import("./trans.d.ts").TransMessageOption) => void;
+    success: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "new" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "edit" | "view">, option?: import("./trans.d.ts").TransMessageOption) => void;
+    error: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "new" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "edit" | "view">, option?: import("./trans.d.ts").TransMessageOption) => void;
+    warning: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "new" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "edit" | "view">, option?: import("./trans.d.ts").TransMessageOption) => void;
+    loading: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "new" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "edit" | "view">, option?: import("./trans.d.ts").TransMessageOption) => void;
+}, getDictionary: (lang: "en" | "ko" | "zhChs" | "zhCht" | "ja") => object, getAllDictionary: () => import("./trans.d.ts").RootDictionary, __Dict_Key__: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "error" | "save" | "password" | "remove" | "ok" | "connecting" | "new" | "failed" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "success" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "unauthorized" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "actions" | "edit" | "view">, __Error_Key__: never;

package/types/document/documentQuery.d.ts

@@ -6,6 +6,13 @@ export declare const createDocumentId: (now?: number) => DocumentId;
 export declare const isDocumentId: (value: unknown) => value is DocumentId;
 export type DocumentPrimitive = string | number | boolean | null | Dayjs | Date;
 export type DocumentPath<T = any> = Extract<keyof T, string> | (string & {});
+export declare const searchColumns: readonly ["title", "desc", "tag", "filter"];
+export type SearchColumn = (typeof searchColumns)[number];
+export interface DocumentSearchOptions {
+    columns?: SearchColumn[];
+    prefix?: boolean;
+    weights?: number[];
+}
 export type DocumentQueryNode = {
     kind: "all";
     queries: DocumentQuery[];
@@ -23,7 +30,10 @@ export type DocumentQueryNode = {
     kind: "raw";
     sql: string;
     params: unknown[];
-};
+} | ({
+    kind: "search";
+    text: string;
+} & DocumentSearchOptions);
 export type DocumentQueryOperator = "eq" | "ne" | "oneOf" | "notOneOf" | "gt" | "gte" | "lt" | "lte" | "between" | "exists" | "missing" | "empty" | "has" | "contains";
 export type DocumentQueryValue = DocumentPrimitive | DocumentPrimitive[] | DocumentQueryNode | undefined | Record<string, unknown>;
 export type DocumentUpdateOperator = "set" | "unset" | "inc" | "mul" | "min" | "max" | "push" | "pull" | "addToSet" | "setOnInsert";
@@ -100,6 +110,7 @@ export declare const createDocumentQueryHelper: () => {
     has: (value: unknown) => DocumentQueryNode;
     contains: (value: unknown) => DocumentQueryNode;
     raw: (sql: string, params?: unknown[]) => DocumentQueryNode;
+    search: (text: string, options?: DocumentSearchOptions) => DocumentQueryNode;
     when: (condition: unknown, query: DocumentQuery) => DocumentQuery;
 };
 export type DocumentQueryHelper = ReturnType<typeof createDocumentQueryHelper>;
@@ -128,6 +139,7 @@ export declare const documentQueryHelper: {
     has: (value: unknown) => DocumentQueryNode;
     contains: (value: unknown) => DocumentQueryNode;
     raw: (sql: string, params?: unknown[]) => DocumentQueryNode;
+    search: (text: string, options?: DocumentSearchOptions) => DocumentQueryNode;
     when: (condition: unknown, query: DocumentQuery) => DocumentQuery;
 };
 export declare const encodeDocumentValue: (value: unknown) => unknown;

package/types/document/documentSchema.d.ts

@@ -6,12 +6,10 @@ export interface DocumentIndexDescriptor {
     name?: string;
     fields: Record<string, 1 | -1 | "text" | boolean>;
     unique?: boolean;
-    text?: boolean;
     where?: DocumentQuery;
 }
 export interface DocumentIndexBuilder<Schema> {
     path(path: string, order?: 1 | -1): DocumentIndexBuilder<Schema>;
-    text(path: string): DocumentIndexBuilder<Schema>;
     unique(): DocumentIndexBuilder<Schema>;
     where(where: DocumentQuery | ((q: DocumentQueryHelper) => DocumentQuery)): DocumentIndexBuilder<Schema>;
     done(): Schema;
@@ -25,7 +23,6 @@ export declare class DocumentSchema<Doc = unknown> {
     post<HookDoc = Doc>(type: SaveEventType, hook: DocumentSaveHook<HookDoc>): this;
     hook(type: DocumentHookName, hook: DocumentSaveHook<Doc>): this;
     index(fields: DocumentIndexDescriptor["fields"], options?: Omit<DocumentIndexDescriptor, "fields">): this;
-    text(...fields: string[]): this;
     createIndex(name: string): DocumentIndexBuilder<this>;
 }
 export type SchemaOf<Mdl = unknown, Doc = unknown> = DocumentSchema<Doc> & {

package/types/document/filterMeta.d.ts

@@ -19,7 +19,7 @@ export declare const getFilterInfoByKey: <ArgNames extends string[] = [], Args e
 export declare const setFilterInfoByKey: <ArgNames extends string[] = [], Args extends any[] = any[], Model = any>(modelRef: Cls<Model>, key: string, filterInfo: FilterInfo<ArgNames, Args, Model>) => void;
 export declare const getFilterSortByKey: (modelRef: FilterCls, key: string) => unknown;
 export declare const fillMissingFilterArgs: (filterInfo: FilterInfo, args: unknown[]) => any[];
-export type BaseFilterSortKey = "latest" | "oldest";
+export type BaseFilterSortKey = "latest" | "oldest" | "relevance";
 export type BaseFilterQueryKey = "any";
 export type BaseFilterKey = BaseFilterSortKey | BaseFilterQueryKey;
 export type FilterInstance<Query extends {
@@ -59,6 +59,7 @@ interface BaseSort {
     oldest: {
         createdAt: 1;
     };
+    relevance: Record<string, never>;
 }
 type LibFilterQuery<LibFilters extends FilterCls[]> = MergeAllDoubleKeyOfObjects<LibFilters, typeof FILTER_META, "query">;
 type LibFilterSort<LibFilters extends FilterCls[]> = MergeAllKeyOfTypes<LibFilters, "sort">;

package/types/fetch/client/wsClient.d.ts

@@ -15,6 +15,12 @@ export declare class WsClient {
     connected: boolean;
     constructor(url: string, ErrorCls?: ErrorConstructor | undefined);
     setErrorConstructor(ErrorCls?: ErrorConstructor): void;
+    /**
+     * The handshake only carries a same-origin cookie, so clients that hold the token in memory
+     * (native, cross-origin) authenticate with this frame instead. Signing out sends `null`, which
+     * drops the handshake cookie server-side and revokes the rooms it had authorized.
+     */
+    setJwt(jwt: string | null): void;
     connect(): void;
     destroy(): void;
     on<Data = unknown>(key: string, callback: (data: Data) => void): this;

package/types/index.d.ts

@@ -161,6 +161,12 @@ export interface AppConfigResult {
     docker: DockerConfig;
     defaultDatabaseMode: DatabaseMode;
     routes?: AkanRouteConfig[];
+    /**
+     * Mounts `libs/<lib>/page` into this app under `page/(libs)/(<lib>)` on sync. `true` takes every lib
+     * dependency that ships a `page` folder, an array takes exactly the libs listed, `false` (the default)
+     * syncs nothing and removes what a previous sync created.
+     */
+    syncPageLibs?: string[] | boolean;
     externalLibs: string[];
     barrelImports: string[];
     optimizeImports: string[];

package/types/server/devtools/types.d.ts

@@ -7,7 +7,7 @@
  *   GET /_akan/dictionary  -> DevtoolsEnvelope<"dictionary", DictionaryData>
  *   GET /_akan/deps        -> DevtoolsEnvelope<"deps",       DepsData>
  */
-import type { ConstantType } from "akanjs/constant";
+import type { ConstantType, TextFieldRole } from "akanjs/constant";
 import type { RootDictionary } from "akanjs/dictionary";
 import type { ArgType, SerializedArg, SerializedReturns } from "akanjs/signal";
 export interface DevtoolsIndex {
@@ -82,7 +82,7 @@ export interface ConstantFieldNode {
     maxlength?: number;
     /** `ConstantFieldProps["type"]`: "email" | "password" | "url". */
     preset?: string;
-    text?: "search" | "filter";
+    text?: TextFieldRole;
     accumulate?: unknown;
     example?: unknown;
     meta?: Record<string, unknown>;

package/types/server/resolver/signal.resolver.d.ts

@@ -30,6 +30,12 @@ export declare class SignalResolver {
         live: LiveRegistry;
         middleware: Map<string, MiddlewareCls>;
     }): SignalRoutes;
+    /**
+     * Re-checks the guards of every room this socket is subscribed to and drops the ones that no
+     * longer pass. Called when the socket's credential changes: a pubsub room is authorized once at
+     * subscribe time, so without this a signed-out socket would keep receiving its old rooms.
+     */
+    static revalidateWsRooms(ws: Bun.ServerWebSocket<any>, registry: InjectRegistry): Promise<string[]>;
     static handleWsOpen(ws: Bun.ServerWebSocket<any>, registry: InjectRegistry): Promise<void>;
     static handleWsClose(ws: Bun.ServerWebSocket<any>, registry: InjectRegistry): Promise<void>;
 }

package/types/server/routing/apiRouter.d.ts

@@ -1,8 +1,9 @@
-import type { Logger } from "akanjs/common";
+import { type Logger } from "akanjs/common";
 import type { InjectRegistry } from "akanjs/service";
 import type { HmrWsHub } from "../hmr/wsHub.d.ts";
 import { type WebProxyRunner } from "../proxy.d.ts";
 import type { HttpRoutes, SignalRouteOptions, WebsocketRoutes } from "../types.d.ts";
+import { AppWsData } from "./appWsData.d.ts";
 /**
  * Minimal render-state view the HMR WS hello message needs.
  * `LazyHmrController` exposes this shape via `state.buildId` / `state.cssAssets`,
@@ -27,9 +28,7 @@ export interface ApiRouteInputs {
     routeOptions?: Record<string, SignalRouteOptions>;
     renderEnvRoutes: HttpRoutes;
     /** Upgrades the incoming request into an app-signal WebSocket. */
-    upgradeAppWs: (req: Request, data: {
-        createdAt: number;
-    }) => boolean;
+    upgradeAppWs: (req: Request, data: AppWsData) => boolean;
     webProxyRunner?: WebProxyRunner | null;
 }
 export interface WebsocketHandlersInputs {

package/types/server/routing/appWsData.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Credential snapshot taken at the websocket handshake and carried on `ws.data` for the life of the
+ * socket, so auth middleware and guards can read the caller the same way they read an HTTP request.
+ * Only the credential headers are copied — retaining the whole `Request` would pin it for as long
+ * as the socket stays open.
+ */
+export declare class AppWsData {
+    static fromRequest(req: Request): AppWsData;
+    static of(ws: Bun.ServerWebSocket<unknown>): AppWsData;
+    /**
+     * Swaps the credential the socket authenticates with. Callers must run this synchronously on the
+     * auth frame: frames arrive in order, so a subscribe sent right after the credential must not be
+     * able to observe the previous one.
+     */
+    static applyCredential(data: AppWsData, jwt: string | null): void;
+    createdAt: number;
+    headers: Headers;
+    cookies: Bun.CookieMap;
+    account?: unknown;
+    /** The `authorization` value `account` was resolved from, so each frame need not re-verify it. */
+    resolvedAuthorization?: string;
+    socketId?: string;
+    constructor(headers: Headers);
+}

package/types/server/rscClient.d.ts

@@ -13,6 +13,7 @@ declare global {
         buildId?: number;
     }) => Promise<void>) | undefined;
     var __AKAN_RSC_CLEAR_CACHE__: (() => void) | undefined;
+    var __AKAN_RSC_IS_FROM_CACHE__: (() => boolean) | undefined;
     var __AKAN_DEV_SYNC_NAVIGATION__: ((href: string, kind: "push" | "replace" | "back" | "pop") => void) | undefined;
     var __AKAN_DEV_SYNC_NAVIGATION_APPLYING__: boolean | undefined;
     var __AKAN_GET_SYNC_ROUTE_HREF__: ((href: string) => string) | undefined;

package/types/service/predefinedAdaptor/database.adaptor.d.ts

@@ -4,6 +4,7 @@ import { type BaseEnv, type PromiseOrObject } from "akanjs/base";
 import { type ConstantModel } from "akanjs/constant";
 import { type DatabaseModel, type DocumentQuery, type DocumentSchema, type DocumentUpdate, type DocumentUpdateInput, type DocumentUpdateOperator, type DocumentUpdateOptions, type SchemaOf } from "akanjs/document";
 import type { Sql } from "postgres";
+import { SearchIndex } from "./searchIndex.d.ts";
 export interface SqliteDatabaseConfig {
     filePath?: string;
     journalMode?: "WAL" | "DELETE" | "TRUNCATE" | "PERSIST" | "MEMORY" | "OFF";
@@ -25,11 +26,16 @@ export interface PostgresDatabaseConfig {
     user?: string;
     password?: string;
 }
+export interface SearchConfig {
+    enabled?: boolean;
+    tokenizer?: string;
+}
 export interface DatabaseConfig {
     driver?: "sqlite" | "libsql" | "postgres";
     sqlite?: SqliteDatabaseConfig;
     libsql?: LibsqlDatabaseConfig;
     postgres?: PostgresDatabaseConfig;
+    search?: SearchConfig;
 }
 export interface DocumentStore {
     ensure(): Promise<void>;
@@ -104,6 +110,7 @@ export interface DatabaseAdaptor {
     getConnection(): AkanSqlClient;
     getStore(constant: ConstantModel, database: DatabaseModel, schema: DocumentSchema): DocumentStore;
     transaction<T>(fn: () => PromiseOrObject<T>): Promise<T>;
+    getSearchIndex(): SearchIndex | null;
 }
 interface SqliteEnv extends BaseEnv {
     workspaceRoot?: string;
@@ -135,6 +142,7 @@ type WriteHookOptions = {
 };
 interface DocumentDatabaseOwner {
     getConnection(): AkanSqlClient;
+    getSearchIndex(): SearchIndex | null;
     getMeta(key: string): Promise<string | undefined> | string | undefined;
     setMeta(key: string, value: string): Promise<void>;
     afterCommit(fn: () => PromiseOrObject<void>): Promise<void>;
@@ -164,6 +172,20 @@ interface SqlFrag {
     sql: string;
     params: unknown[];
 }
+interface SearchJoinProps {
+    alias: string;
+    ref: string;
+    match: string;
+    weights: number[];
+}
+interface SearchJoin extends SqlFrag {
+    alias: string;
+}
+interface CompiledQuery {
+    where: string;
+    params: unknown[];
+    joins: SearchJoin[];
+}
 interface SqlDialect {
     readonly name: "sqlite" | "postgres";
     timestampType(): string;
@@ -182,6 +204,7 @@ interface SqlDialect {
     empty(path: string): SqlFrag;
     arrayHas(path: string, value: unknown): SqlFrag;
     contains(path: string, value: unknown): SqlFrag;
+    searchJoin(props: SearchJoinProps): SqlFrag;
     applyUpdate(acc: string, op: DocumentUpdateOperator, path: string, value: unknown): SqlFrag;
     affectedRows(result: unknown): number;
 }
@@ -204,6 +227,7 @@ export declare class SqliteDialect implements SqlDialect {
     empty(path: string): SqlFrag;
     arrayHas(path: string, value: unknown): SqlFrag;
     contains(path: string, value: unknown): SqlFrag;
+    searchJoin({ alias, ref, match, weights }: SearchJoinProps): SqlFrag;
     applyUpdate(acc: string, op: DocumentUpdateOperator, path: string, value: unknown): SqlFrag;
     affectedRows(result: unknown): number;
 }
@@ -226,6 +250,7 @@ export declare class PostgresDialect implements SqlDialect {
     empty(path: string): SqlFrag;
     arrayHas(path: string, value: unknown): SqlFrag;
     contains(path: string, value: unknown): SqlFrag;
+    searchJoin({ ref }: SearchJoinProps): SqlFrag;
     applyUpdate(acc: string, op: DocumentUpdateOperator, path: string, value: unknown): SqlFrag;
     affectedRows(result: unknown): number;
 }
@@ -233,11 +258,10 @@ declare class QueryCompiler {
     #private;
     private readonly fields;
     private readonly dialect;
-    constructor(fields: FieldMap, dialect: SqlDialect);
-    compile(query?: DocumentQuery): {
-        where: string;
-        params: unknown[];
-    };
+    private readonly ref;
+    private readonly searchEnabled;
+    constructor(fields: FieldMap, dialect: SqlDialect, ref: string, searchEnabled: () => boolean);
+    compile(query?: DocumentQuery): CompiledQuery;
     orderBy(sort?: Record<string, 1 | -1>): string;
     fieldExpr(path: string): string;
     private compileNode;
@@ -321,15 +345,11 @@ export declare class SqlDocumentStore {
     exists(query?: DocumentQuery): Promise<string | null>;
     count(query?: DocumentQuery): Promise<number>;
     insight(query?: DocumentQuery): Promise<DocumentRecord>;
-    search(searchText: string | undefined | null, options?: {
-        skip?: number | null;
-        limit?: number | null;
-        sort?: SortOption;
-    }): Promise<{
-        docs: any[];
-        count: number;
-    }>;
     private safeQuery;
+    private writeQuery;
+    private joinSql;
+    private joinParams;
+    private orderBy;
     private prepareDocument;
     private extractInsertBase;
     private applyInsertUpdate;
@@ -359,8 +379,13 @@ export declare class SqlDocumentStore {
     private assertValidRefName;
 }
 declare const SqliteDatabase_base: import("..").AdaptorCls<{}, {
+    scheduler: import("..").InjectInfo<"plug", import("./schedule.adaptor").ScheduleAdaptor, never, never>;
     config: import("..").InjectInfo<"env", {
         filePath: string;
+        search: {
+            enabled: boolean;
+            tokenizer: string;
+        };
         journalMode: "WAL" | "DELETE" | "TRUNCATE" | "PERSIST" | "MEMORY" | "OFF";
         busyTimeoutMs: number;
         synchronous: "OFF" | "NORMAL" | "FULL" | "EXTRA";
@@ -374,6 +399,7 @@ export declare class SqliteDatabase extends SqliteDatabase_base implements Datab
     onInit(): Promise<void>;
     onDestroy(): Promise<void>;
     getConnection(): BunSqliteClient;
+    getSearchIndex(): SearchIndex;
     getStore(constant: ConstantModel, database: DatabaseModel, schema: SchemaOf): SqlDocumentStore;
     getMeta(key: string): string | undefined;
     setMeta(key: string, value: string): Promise<void>;
@@ -383,9 +409,14 @@ export declare class SqliteDatabase extends SqliteDatabase_base implements Datab
     vacuum(): void;
 }
 declare const LibsqlDatabase_base: import("..").AdaptorCls<{}, {
+    scheduler: import("..").InjectInfo<"plug", import("./schedule.adaptor").ScheduleAdaptor, never, never>;
     config: import("..").InjectInfo<"env", {
         url: string;
         authToken: string | undefined;
+        search: {
+            enabled: boolean;
+            tokenizer: string;
+        };
     }, SqliteEnv, never>;
 }>;
 export declare class LibsqlDatabase extends LibsqlDatabase_base implements DatabaseAdaptor {
@@ -393,6 +424,7 @@ export declare class LibsqlDatabase extends LibsqlDatabase_base implements Datab
     onInit(): Promise<void>;
     onDestroy(): Promise<void>;
     getConnection(): LibsqlAkanClient;
+    getSearchIndex(): SearchIndex;
     getStore(constant: ConstantModel, database: DatabaseModel, schema: SchemaOf): SqlDocumentStore;
     getMeta(key: string): Promise<string | undefined>;
     setMeta(key: string, value: string): Promise<void>;
@@ -414,6 +446,7 @@ export declare class PostgresDatabase extends PostgresDatabase_base implements D
     onInit(): Promise<void>;
     onDestroy(): Promise<void>;
     getConnection(): PostgresAkanClient;
+    getSearchIndex(): null;
     getStore(constant: ConstantModel, database: DatabaseModel, schema: SchemaOf): SqlDocumentStore;
     getMeta(key: string): Promise<string | undefined>;
     setMeta(key: string, value: string): Promise<void>;

package/types/service/predefinedAdaptor/index.d.ts

@@ -5,6 +5,7 @@ export * from "./logging.adaptor";
 export * from "./queue.adaptor";
 export * from "./role.adaptor";
 export * from "./schedule.adaptor";
+export * from "./searchIndex.d.ts";
 export * from "./solidCache.adaptor";
 export * from "./solidPubsub.adaptor";
 export * from "./solidQueue.adaptor";