aifastdb 0.2.1

package/dist/family-types.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Family Tree (Genealogy) Types for AiFastDb
+ *
+ * Provides TypeScript interfaces for family tree operations:
+ * - Family member management with gender tracking
+ * - Parent-child, spouse, and sibling relationships
+ * - Ancestor and descendant traversal
+ * - Relationship calculation and Chinese kinship titles
+ * - Family tree construction and statistics
+ */
+import type { Entity, Relation } from './social-types';
+/** Gender enumeration */
+export type Gender = 'male' | 'female' | 'unknown';
+/** Gender constants */
+export declare const GENDER: {
+    readonly MALE: Gender;
+    readonly FEMALE: Gender;
+    readonly UNKNOWN: Gender;
+};
+/** Family relationship type enumeration */
+export type FamilyRelationType = 'father' | 'mother' | 'son' | 'daughter' | 'parent' | 'child' | 'spouse' | 'husband' | 'wife' | 'ex_spouse' | 'sibling' | 'brother' | 'sister' | 'half_sibling' | 'grandfather' | 'grandmother' | 'grandparent' | 'grandson' | 'granddaughter' | 'grandchild' | 'uncle' | 'aunt' | 'nephew' | 'niece' | 'cousin' | 'father_in_law' | 'mother_in_law' | 'son_in_law' | 'daughter_in_law' | 'brother_in_law' | 'sister_in_law';
+/** Relation type constants for storage */
+export declare const FAMILY_RELATION_TYPES: {
+    readonly PARENT_OF: "parent_of";
+    readonly CHILD_OF: "child_of";
+    readonly FATHER_OF: "father_of";
+    readonly MOTHER_OF: "mother_of";
+    readonly SPOUSE_OF: "spouse_of";
+    readonly HUSBAND_OF: "husband_of";
+    readonly WIFE_OF: "wife_of";
+    readonly EX_SPOUSE_OF: "ex_spouse_of";
+    readonly SIBLING_OF: "sibling_of";
+    readonly BROTHER_OF: "brother_of";
+    readonly SISTER_OF: "sister_of";
+    readonly HALF_SIBLING_OF: "half_sibling_of";
+    readonly GRANDPARENT_OF: "grandparent_of";
+    readonly GRANDCHILD_OF: "grandchild_of";
+    readonly STEP_PARENT_OF: "step_parent_of";
+    readonly STEP_FATHER_OF: "step_father_of";
+    readonly STEP_MOTHER_OF: "step_mother_of";
+    readonly STEP_CHILD_OF: "step_child_of";
+    readonly ADOPTIVE_PARENT_OF: "adoptive_parent_of";
+    readonly ADOPTIVE_FATHER_OF: "adoptive_father_of";
+    readonly ADOPTIVE_MOTHER_OF: "adoptive_mother_of";
+    readonly ADOPTED_CHILD_OF: "adopted_child_of";
+};
+/** Parent type for getAllParentsWithType */
+export type ParentType = 'biological' | 'step' | 'adoptive';
+/** Child type for getAllChildrenWithType */
+export type ChildType = 'biological' | 'step' | 'adopted';
+/** Parent info with type */
+export interface ParentInfo {
+    person: import('./social-types').Entity;
+    type: ParentType;
+}
+/** Child info with type */
+export interface ChildInfo {
+    person: import('./social-types').Entity;
+    type: ChildType;
+}
+/** Input for creating a family member */
+export interface FamilyMemberInput {
+    /** Optional ID (auto-generated if not provided) */
+    id?: string;
+    /** Person's name */
+    name: string;
+    /** Gender */
+    gender: Gender;
+    /** Birth date in YYYY-MM-DD format */
+    birthDate?: string;
+    /** Death date in YYYY-MM-DD format (optional) */
+    deathDate?: string;
+    /** Birth order among siblings */
+    birthOrder?: number;
+    /** Generation number (0 = self, 1 = parent, -1 = child) */
+    generation?: number;
+    /** Additional properties */
+    properties?: Record<string, unknown>;
+}
+/** Spouse information with ex status */
+export interface SpouseInfo {
+    /** The spouse entity */
+    person: Entity;
+    /** Whether this is an ex-spouse */
+    isEx: boolean;
+}
+/** Direction in path traversal */
+export type PathDirection = 'up' | 'down' | 'same';
+/** A step in the family path */
+export interface FamilyPathStep {
+    /** The person at this step */
+    person: Entity;
+    /** The relation type to reach this person */
+    relation_type: string;
+    /** The direction of traversal */
+    direction: PathDirection;
+}
+/** Family relationship path between two people */
+export interface FamilyPath {
+    /** Starting person */
+    from: Entity;
+    /** Ending person */
+    to: Entity;
+    /** Path steps from 'from' to 'to' */
+    path: FamilyPathStep[];
+    /** Calculated relationship title (Chinese) */
+    relationship: string;
+    /** Generation difference (positive = elder, negative = younger) */
+    generation_diff: number;
+    /** Blood relationship distance */
+    blood_distance: number;
+}
+/** Family tree structure */
+export interface FamilyTree {
+    /** Root person of the tree */
+    root: Entity;
+    /** All members in the tree */
+    members: Entity[];
+    /** Members grouped by generation (generation number -> members) */
+    generations: Record<number, Entity[]>;
+    /** Total number of generations */
+    total_generations: number;
+    /** All family relations in the tree */
+    relations: Relation[];
+}
+/** Family statistics */
+export interface FamilyStats {
+    /** Total number of family members */
+    total_members: number;
+    /** Total number of generations */
+    total_generations: number;
+    /** Number of male members */
+    male_count: number;
+    /** Number of female members */
+    female_count: number;
+    /** Number of members with unknown gender */
+    unknown_gender_count: number;
+    /** Number of living members */
+    living_members: number;
+    /** Number of deceased members */
+    deceased_members: number;
+    /** Average number of children per parent */
+    average_children: number;
+    /** Earliest birth date in the family */
+    earliest_birth?: string;
+    /** Latest birth date in the family */
+    latest_birth?: string;
+}
+/** Common Chinese kinship titles */
+export declare const CHINESE_KINSHIP_TITLES: {
+    readonly FATHER: "父亲";
+    readonly MOTHER: "母亲";
+    readonly PATERNAL_GRANDFATHER: "爷爷";
+    readonly PATERNAL_GRANDMOTHER: "奶奶";
+    readonly MATERNAL_GRANDFATHER: "外公";
+    readonly MATERNAL_GRANDMOTHER: "外婆";
+    readonly GREAT_GRANDFATHER: "曾祖父";
+    readonly GREAT_GRANDMOTHER: "曾祖母";
+    readonly SON: "儿子";
+    readonly DAUGHTER: "女儿";
+    readonly GRANDSON: "孙子";
+    readonly GRANDDAUGHTER: "孙女";
+    readonly GREAT_GRANDSON: "曾孙";
+    readonly GREAT_GRANDDAUGHTER: "曾孙女";
+    readonly HUSBAND: "丈夫";
+    readonly WIFE: "妻子";
+    readonly SPOUSE: "配偶";
+    readonly OLDER_BROTHER: "哥哥";
+    readonly YOUNGER_BROTHER: "弟弟";
+    readonly OLDER_SISTER: "姐姐";
+    readonly YOUNGER_SISTER: "妹妹";
+    readonly BROTHER: "兄弟";
+    readonly SISTER: "姐妹";
+    readonly PATERNAL_UNCLE_OLDER: "伯伯";
+    readonly PATERNAL_UNCLE_YOUNGER: "叔叔";
+    readonly PATERNAL_AUNT: "姑姑";
+    readonly MATERNAL_UNCLE: "舅舅";
+    readonly MATERNAL_AUNT: "姨妈";
+    readonly NEPHEW_PATERNAL: "侄子";
+    readonly NIECE_PATERNAL: "侄女";
+    readonly NEPHEW_MATERNAL: "外甥";
+    readonly NIECE_MATERNAL: "外甥女";
+    readonly PATERNAL_COUSIN_MALE: "堂兄弟";
+    readonly PATERNAL_COUSIN_FEMALE: "堂姐妹";
+    readonly MATERNAL_COUSIN_MALE: "表兄弟";
+    readonly MATERNAL_COUSIN_FEMALE: "表姐妹";
+    readonly FATHER_IN_LAW_HUSBAND: "公公";
+    readonly MOTHER_IN_LAW_HUSBAND: "婆婆";
+    readonly FATHER_IN_LAW_WIFE: "岳父";
+    readonly MOTHER_IN_LAW_WIFE: "岳母";
+    readonly SON_IN_LAW: "女婿";
+    readonly DAUGHTER_IN_LAW: "儿媳";
+};
+/** Options for building a family tree */
+export interface BuildFamilyTreeOptions {
+    /** Number of generations to traverse upward (default: 3) */
+    generationsUp?: number;
+    /** Number of generations to traverse downward (default: 3) */
+    generationsDown?: number;
+}
+/** Options for ancestor/descendant queries */
+export interface TraversalOptions {
+    /** Maximum number of generations to traverse (default: 10) */
+    maxGenerations?: number;
+}
+/** Result of checking if two people are related */
+export interface RelationshipCheckResult {
+    /** Whether the two people are related */
+    isRelated: boolean;
+    /** The relationship path if related */
+    path?: FamilyPath;
+    /** The relationship title if related */
+    title?: string;
+}
+/** Family member with computed relationships */
+export interface FamilyMemberWithRelations extends Entity {
+    /** Parents of this member */
+    parents?: Entity[];
+    /** Spouse of this member */
+    spouse?: Entity;
+    /** Children of this member */
+    children?: Entity[];
+    /** Siblings of this member */
+    siblings?: Entity[];
+    /** Generation number relative to root */
+    generation?: number;
+}
+//# sourceMappingURL=family-types.d.ts.map

package/dist/family-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-types.d.ts","sourceRoot":"","sources":["../ts/family-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAMvD,yBAAyB;AACzB,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnD,uBAAuB;AACvB,eAAO,MAAM,MAAM;mBACD,MAAM;qBACF,MAAM;sBACJ,MAAM;CACpB,CAAC;AAMX,2CAA2C;AAC3C,MAAM,MAAM,kBAAkB,GAE1B,QAAQ,GACR,QAAQ,GACR,KAAK,GACL,UAAU,GACV,QAAQ,GACR,OAAO,GAEP,QAAQ,GACR,SAAS,GACT,MAAM,GACN,WAAW,GAEX,SAAS,GACT,SAAS,GACT,QAAQ,GACR,cAAc,GAEd,aAAa,GACb,aAAa,GACb,aAAa,GACb,UAAU,GACV,eAAe,GACf,YAAY,GAEZ,OAAO,GACP,MAAM,GACN,QAAQ,GACR,OAAO,GACP,QAAQ,GAER,eAAe,GACf,eAAe,GACf,YAAY,GACZ,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,CAAC;AAEpB,0CAA0C;AAC1C,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;CA6BxB,CAAC;AAEX,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5D,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1D,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,gBAAgB,EAAE,MAAM,CAAC;IACxC,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,gBAAgB,EAAE,MAAM,CAAC;IACxC,IAAI,EAAE,SAAS,CAAC;CACjB;AAMD,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;CACf;AAMD,kCAAkC;AAClC,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,wBAAwB;AACxB,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,oCAAoC;AACpC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DzB,CAAC;AAMX,yCAAyC;AACzC,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,mDAAmD;AACnD,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gDAAgD;AAChD,MAAM,WAAW,yBAA0B,SAAQ,MAAM;IACvD,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/family-types.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Family Tree (Genealogy) Types for AiFastDb
+ *
+ * Provides TypeScript interfaces for family tree operations:
+ * - Family member management with gender tracking
+ * - Parent-child, spouse, and sibling relationships
+ * - Ancestor and descendant traversal
+ * - Relationship calculation and Chinese kinship titles
+ * - Family tree construction and statistics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHINESE_KINSHIP_TITLES = exports.FAMILY_RELATION_TYPES = exports.GENDER = void 0;
+/** Gender constants */
+exports.GENDER = {
+    MALE: 'male',
+    FEMALE: 'female',
+    UNKNOWN: 'unknown',
+};
+/** Relation type constants for storage */
+exports.FAMILY_RELATION_TYPES = {
+    // Direct blood relatives
+    PARENT_OF: 'parent_of',
+    CHILD_OF: 'child_of',
+    FATHER_OF: 'father_of',
+    MOTHER_OF: 'mother_of',
+    // Spouse
+    SPOUSE_OF: 'spouse_of',
+    HUSBAND_OF: 'husband_of',
+    WIFE_OF: 'wife_of',
+    EX_SPOUSE_OF: 'ex_spouse_of',
+    // Siblings
+    SIBLING_OF: 'sibling_of',
+    BROTHER_OF: 'brother_of',
+    SISTER_OF: 'sister_of',
+    HALF_SIBLING_OF: 'half_sibling_of',
+    // Grandparents/Grandchildren
+    GRANDPARENT_OF: 'grandparent_of',
+    GRANDCHILD_OF: 'grandchild_of',
+    // Step family (继父母/继子女)
+    STEP_PARENT_OF: 'step_parent_of',
+    STEP_FATHER_OF: 'step_father_of',
+    STEP_MOTHER_OF: 'step_mother_of',
+    STEP_CHILD_OF: 'step_child_of',
+    // Adoptive family (养父母/养子女)
+    ADOPTIVE_PARENT_OF: 'adoptive_parent_of',
+    ADOPTIVE_FATHER_OF: 'adoptive_father_of',
+    ADOPTIVE_MOTHER_OF: 'adoptive_mother_of',
+    ADOPTED_CHILD_OF: 'adopted_child_of',
+};
+// ============================================================================
+// Chinese Kinship Titles
+// ============================================================================
+/** Common Chinese kinship titles */
+exports.CHINESE_KINSHIP_TITLES = {
+    // Direct ancestors
+    FATHER: '父亲',
+    MOTHER: '母亲',
+    PATERNAL_GRANDFATHER: '爷爷',
+    PATERNAL_GRANDMOTHER: '奶奶',
+    MATERNAL_GRANDFATHER: '外公',
+    MATERNAL_GRANDMOTHER: '外婆',
+    GREAT_GRANDFATHER: '曾祖父',
+    GREAT_GRANDMOTHER: '曾祖母',
+    // Direct descendants
+    SON: '儿子',
+    DAUGHTER: '女儿',
+    GRANDSON: '孙子',
+    GRANDDAUGHTER: '孙女',
+    GREAT_GRANDSON: '曾孙',
+    GREAT_GRANDDAUGHTER: '曾孙女',
+    // Spouse
+    HUSBAND: '丈夫',
+    WIFE: '妻子',
+    SPOUSE: '配偶',
+    // Siblings
+    OLDER_BROTHER: '哥哥',
+    YOUNGER_BROTHER: '弟弟',
+    OLDER_SISTER: '姐姐',
+    YOUNGER_SISTER: '妹妹',
+    BROTHER: '兄弟',
+    SISTER: '姐妹',
+    // Paternal uncles and aunts
+    PATERNAL_UNCLE_OLDER: '伯伯',
+    PATERNAL_UNCLE_YOUNGER: '叔叔',
+    PATERNAL_AUNT: '姑姑',
+    // Maternal uncles and aunts
+    MATERNAL_UNCLE: '舅舅',
+    MATERNAL_AUNT: '姨妈',
+    // Nephews and nieces
+    NEPHEW_PATERNAL: '侄子',
+    NIECE_PATERNAL: '侄女',
+    NEPHEW_MATERNAL: '外甥',
+    NIECE_MATERNAL: '外甥女',
+    // Cousins
+    PATERNAL_COUSIN_MALE: '堂兄弟',
+    PATERNAL_COUSIN_FEMALE: '堂姐妹',
+    MATERNAL_COUSIN_MALE: '表兄弟',
+    MATERNAL_COUSIN_FEMALE: '表姐妹',
+    // In-laws
+    FATHER_IN_LAW_HUSBAND: '公公',
+    MOTHER_IN_LAW_HUSBAND: '婆婆',
+    FATHER_IN_LAW_WIFE: '岳父',
+    MOTHER_IN_LAW_WIFE: '岳母',
+    SON_IN_LAW: '女婿',
+    DAUGHTER_IN_LAW: '儿媳',
+};
+//# sourceMappingURL=family-types.js.map

package/dist/family-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-types.js","sourceRoot":"","sources":["../ts/family-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAWH,uBAAuB;AACV,QAAA,MAAM,GAAG;IACpB,IAAI,EAAE,MAAgB;IACtB,MAAM,EAAE,QAAkB;IAC1B,OAAO,EAAE,SAAmB;CACpB,CAAC;AA8CX,0CAA0C;AAC7B,QAAA,qBAAqB,GAAG;IACnC,yBAAyB;IACzB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,SAAS;IACT,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,cAAc;IAC5B,WAAW;IACX,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,eAAe,EAAE,iBAAiB;IAClC,6BAA6B;IAC7B,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,wBAAwB;IACxB,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,4BAA4B;IAC5B,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,kBAAkB;CAC5B,CAAC;AA+HX,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,oCAAoC;AACvB,QAAA,sBAAsB,GAAG;IACpC,mBAAmB;IACnB,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,oBAAoB,EAAE,IAAI;IAC1B,oBAAoB,EAAE,IAAI;IAC1B,oBAAoB,EAAE,IAAI;IAC1B,oBAAoB,EAAE,IAAI;IAC1B,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IAExB,qBAAqB;IACrB,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,KAAK;IAE1B,SAAS;IACT,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;IAEZ,WAAW;IACX,aAAa,EAAE,IAAI;IACnB,eAAe,EAAE,IAAI;IACrB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;IACpB,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,IAAI;IAEZ,4BAA4B;IAC5B,oBAAoB,EAAE,IAAI;IAC1B,sBAAsB,EAAE,IAAI;IAC5B,aAAa,EAAE,IAAI;IAEnB,4BAA4B;IAC5B,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;IAEnB,qBAAqB;IACrB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,KAAK;IAErB,UAAU;IACV,oBAAoB,EAAE,KAAK;IAC3B,sBAAsB,EAAE,KAAK;IAC7B,oBAAoB,EAAE,KAAK;IAC3B,sBAAsB,EAAE,KAAK;IAE7B,UAAU;IACV,qBAAqB,EAAE,IAAI;IAC3B,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,IAAI;IACxB,kBAAkB,EAAE,IAAI;IACxB,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE,IAAI;CACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * AiFastDb - AI-friendly Database
+ *
+ * A high-performance database designed for AI applications with:
+ * - Vector similarity search (HNSW)
+ * - Semantic indexing
+ * - Agent memory with time decay
+ * - Knowledge graph support
+ * - Social graph analysis
+ * - Hybrid search (vector + text + metadata)
+ * - Built-in multimodal perception (Candle)
+ * - External LLM reasoning (Ollama/OpenAI)
+ */
+export { AiFastDb, version, type AiFastDbConfig, type IAiFastDb, type HNSWConfig, type StorageConfig, type MemoryInput, type MemoryNode, type SearchResult, type QueryOptions, type FilterCondition, type ContextOptions, type PreparedContext, type Collection, type CollectionStats, ContentType, } from './native';
+export { AiFastDbClient, createAiFastDb } from './client';
+export { QueryBuilder } from './query-builder';
+export { MemoryManager } from './memory-manager';
+export { VibeSynapse, createVibeSynapse, createVibeSynapseWithMiniLM, createVibeSynapseWithOllama, } from './vibe-synapse';
+export { SocialGraph } from './social-graph';
+export { ConnectMeAdapter } from './connectme-adapter';
+export { FamilyTreeManager } from './family-tree';
+export * from './family-types';
+export { CollectionConfig, OnDeleteAction, ForeignKeyConfig, ForeignKeyValidationResult, CascadeDeleteResult, PopulateConfig, populate, foreignKey, MultiCollectionQueryOptions, EmbeddingFunction, BatchEmbeddingFunction, EmbeddingProvider, OpenAIEmbeddingConfig, EnrichedMemory, EnrichedSearchResult, ChunkingOptions, Document, IngestionResult, GraphTraversalResult, Filters, RelationTypes, EntityTypes, Modality, PerceptionConfig, ReasoningConfig, VibeSynapseConfig, MultimodalInput, PerceptionResult, ReasoningResult, LogicCheckResult, CrossModalSearchOptions, PerceptionPresets, ReasoningPresets, } from './types';
+export * from './social-types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,QAAQ,EACR,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,WAAW,GACZ,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,UAAU,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,QAAQ,EACR,eAAe,EACf,oBAAoB,EACpB,OAAO,EACP,aAAa,EACb,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * AiFastDb - AI-friendly Database
+ *
+ * A high-performance database designed for AI applications with:
+ * - Vector similarity search (HNSW)
+ * - Semantic indexing
+ * - Agent memory with time decay
+ * - Knowledge graph support
+ * - Social graph analysis
+ * - Hybrid search (vector + text + metadata)
+ * - Built-in multimodal perception (Candle)
+ * - External LLM reasoning (Ollama/OpenAI)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReasoningPresets = exports.PerceptionPresets = exports.EntityTypes = exports.RelationTypes = exports.Filters = exports.foreignKey = exports.populate = exports.FamilyTreeManager = exports.ConnectMeAdapter = exports.SocialGraph = exports.createVibeSynapseWithOllama = exports.createVibeSynapseWithMiniLM = exports.createVibeSynapse = exports.VibeSynapse = exports.MemoryManager = exports.QueryBuilder = exports.createAiFastDb = exports.AiFastDbClient = exports.ContentType = exports.version = exports.AiFastDb = void 0;
+// Re-export native bindings
+var native_1 = require("./native");
+Object.defineProperty(exports, "AiFastDb", { enumerable: true, get: function () { return native_1.AiFastDb; } });
+Object.defineProperty(exports, "version", { enumerable: true, get: function () { return native_1.version; } });
+Object.defineProperty(exports, "ContentType", { enumerable: true, get: function () { return native_1.ContentType; } });
+// Export high-level API
+var client_1 = require("./client");
+Object.defineProperty(exports, "AiFastDbClient", { enumerable: true, get: function () { return client_1.AiFastDbClient; } });
+Object.defineProperty(exports, "createAiFastDb", { enumerable: true, get: function () { return client_1.createAiFastDb; } });
+var query_builder_1 = require("./query-builder");
+Object.defineProperty(exports, "QueryBuilder", { enumerable: true, get: function () { return query_builder_1.QueryBuilder; } });
+var memory_manager_1 = require("./memory-manager");
+Object.defineProperty(exports, "MemoryManager", { enumerable: true, get: function () { return memory_manager_1.MemoryManager; } });
+// Export VibeSynapse (multimodal perception API)
+var vibe_synapse_1 = require("./vibe-synapse");
+Object.defineProperty(exports, "VibeSynapse", { enumerable: true, get: function () { return vibe_synapse_1.VibeSynapse; } });
+Object.defineProperty(exports, "createVibeSynapse", { enumerable: true, get: function () { return vibe_synapse_1.createVibeSynapse; } });
+Object.defineProperty(exports, "createVibeSynapseWithMiniLM", { enumerable: true, get: function () { return vibe_synapse_1.createVibeSynapseWithMiniLM; } });
+Object.defineProperty(exports, "createVibeSynapseWithOllama", { enumerable: true, get: function () { return vibe_synapse_1.createVibeSynapseWithOllama; } });
+// Export Social Graph API
+var social_graph_1 = require("./social-graph");
+Object.defineProperty(exports, "SocialGraph", { enumerable: true, get: function () { return social_graph_1.SocialGraph; } });
+var connectme_adapter_1 = require("./connectme-adapter");
+Object.defineProperty(exports, "ConnectMeAdapter", { enumerable: true, get: function () { return connectme_adapter_1.ConnectMeAdapter; } });
+// Export Family Tree API
+var family_tree_1 = require("./family-tree");
+Object.defineProperty(exports, "FamilyTreeManager", { enumerable: true, get: function () { return family_tree_1.FamilyTreeManager; } });
+__exportStar(require("./family-types"), exports);
+// Export types (excluding Entity and Relation from types to avoid conflict with social-types)
+var types_1 = require("./types");
+Object.defineProperty(exports, "populate", { enumerable: true, get: function () { return types_1.populate; } });
+Object.defineProperty(exports, "foreignKey", { enumerable: true, get: function () { return types_1.foreignKey; } });
+Object.defineProperty(exports, "Filters", { enumerable: true, get: function () { return types_1.Filters; } });
+Object.defineProperty(exports, "RelationTypes", { enumerable: true, get: function () { return types_1.RelationTypes; } });
+Object.defineProperty(exports, "EntityTypes", { enumerable: true, get: function () { return types_1.EntityTypes; } });
+Object.defineProperty(exports, "PerceptionPresets", { enumerable: true, get: function () { return types_1.PerceptionPresets; } });
+Object.defineProperty(exports, "ReasoningPresets", { enumerable: true, get: function () { return types_1.ReasoningPresets; } });
+// Export social types (including Entity and Relation which are consistent with Rust core)
+__exportStar(require("./social-types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;;AAEH,4BAA4B;AAC5B,mCAiBkB;AAhBhB,kGAAA,QAAQ,OAAA;AACR,iGAAA,OAAO,OAAA;AAcP,qGAAA,WAAW,OAAA;AAGb,wBAAwB;AACxB,mCAA0D;AAAjD,wGAAA,cAAc,OAAA;AAAE,wGAAA,cAAc,OAAA;AACvC,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAEtB,iDAAiD;AACjD,+CAKwB;AAJtB,2GAAA,WAAW,OAAA;AACX,iHAAA,iBAAiB,OAAA;AACjB,2HAAA,2BAA2B,OAAA;AAC3B,2HAAA,2BAA2B,OAAA;AAG7B,0BAA0B;AAC1B,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AAEzB,yBAAyB;AACzB,6CAAkD;AAAzC,gHAAA,iBAAiB,OAAA;AAC1B,iDAA+B;AAE/B,8FAA8F;AAC9F,iCAkCiB;AA3Bf,iGAAA,QAAQ,OAAA;AACR,mGAAA,UAAU,OAAA;AAYV,gGAAA,OAAO,OAAA;AACP,sGAAA,aAAa,OAAA;AACb,oGAAA,WAAW,OAAA;AAUX,0GAAA,iBAAiB,OAAA;AACjB,yGAAA,gBAAgB,OAAA;AAGlB,0FAA0F;AAC1F,iDAA+B"}

package/dist/memory-manager.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Memory Manager for AI Agent long-term memory
+ *
+ * Provides higher-level memory management including:
+ * - Automatic importance decay
+ * - Memory consolidation
+ * - Context preparation for LLMs
+ */
+import type { IAiFastDb, MemoryNode, MemoryInput, PreparedContext } from './native';
+import type { EmbeddingProvider, ChunkingOptions, Document, IngestionResult } from './types';
+/**
+ * Memory manager configuration
+ */
+export interface MemoryManagerConfig {
+    /** Default decay rate for memories */
+    defaultDecayRate?: number;
+    /** Default importance for new memories */
+    defaultImportance?: number;
+    /** Maximum memories to keep (for pruning) */
+    maxMemories?: number;
+    /** Importance threshold below which memories can be pruned */
+    pruneThreshold?: number;
+    /** Embedding provider for automatic embedding generation */
+    embeddingProvider?: EmbeddingProvider;
+}
+/**
+ * Memory Manager for AI Agent applications
+ */
+export declare class MemoryManager {
+    private db;
+    private config;
+    constructor(db: IAiFastDb, config?: MemoryManagerConfig);
+    /**
+     * Set embedding provider
+     */
+    setEmbeddingProvider(provider: EmbeddingProvider): void;
+    /**
+     * Store a memory with automatic embedding
+     */
+    remember(content: string, options?: Partial<MemoryInput>): Promise<MemoryNode>;
+    /**
+     * Store multiple memories with automatic embedding
+     */
+    rememberMany(items: Array<{
+        content: string;
+        options?: Partial<MemoryInput>;
+    }>): Promise<MemoryNode[]>;
+    /**
+     * Ingest a document with chunking
+     */
+    ingestDocument(doc: Document, options?: ChunkingOptions): Promise<IngestionResult>;
+    /**
+     * Chunk text into smaller pieces
+     */
+    private chunkText;
+    /**
+     * Recall memories with automatic query embedding
+     */
+    recall(query: string, limit?: number): Promise<MemoryNode[]>;
+    /**
+     * Get context for LLM with automatic embedding
+     */
+    getContext(query: string, maxTokens?: number): Promise<PreparedContext>;
+    /**
+     * Prune old/unimportant memories
+     */
+    prune(): number;
+    /**
+     * Consolidate similar memories
+     */
+    consolidate(): Promise<number>;
+    /**
+     * Get memory statistics
+     */
+    stats(): {
+        totalMemories: number;
+        avgImportance: number;
+        oldestMemory: number;
+        newestMemory: number;
+    };
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../ts/memory-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,WAAW,EAEX,eAAe,EAEhB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,MAAM,CAEZ;gBAEU,EAAE,EAAE,SAAS,EAAE,MAAM,GAAE,mBAAwB;IAW3D;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIvD;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAexF;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA2C5G;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IA2C5F;;OAEG;IACH,OAAO,CAAC,SAAS;IA2DjB;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAoBtE;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAQnF;;OAEG;IACH,KAAK,IAAI,MAAM;IAsCf;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAMpC;;OAEG;IACH,KAAK,IAAI;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB;CAsBF"}