mftsccs-node 0.2.24 → 0.2.25

package/dist/types/Api/Search/SearchInternalApi.d.ts

@@ -7,7 +7,7 @@
  * @module Api/Search/SearchInternalApi
  * @see https://documentation.freeschema.com for internal composition structure and search patterns
  */
-import { SearchStructure } from "../../app";
+import { SearchStructure } from "../../DataStructures/Search/SearchStructure";
 /**
  * Searches for concepts within internal (nested) compositions with authentication.
  * This function enables searching for concepts that are part of internal compositions,
@@ -16,7 +16,8 @@ import { SearchStructure } from "../../app";
  *
  * @param search - SearchStructure object containing all search parameters including composition, internal composition, type, search text, and pagination
  * @param token - Optional authentication token for authorized access (defaults to empty string for public queries)
- * @returns Promise resolving to an array of matching concepts from the internal composition, or empty array on error
+ * @returns Promise resolving to an array of matching concepts from the internal composition. A valid empty result is returned as an empty array.
+ * @throws Will throw if the request fails or the backend returns a non-OK response.
  *
  * @example
  * ```typescript
@@ -56,9 +57,9 @@ import { SearchStructure } from "../../app";
  * - Filtering results within specific composition contexts
  *
  * Error handling:
- * - HTTP errors are logged with status and handled via HandleHttpError
+ * - HTTP errors are handled via HandleHttpError and thrown
  * - Network errors are caught, logged, and re-thrown
- * - Returns empty array on HTTP errors to prevent null reference issues
+ * - Empty arrays represent valid empty results, not failed requests
  *
  * Query construction:
  * - All parameters are URL-encoded as query strings

package/dist/types/Api/Search/SearchLinkMultipleApi.d.ts

@@ -17,7 +17,8 @@ import { SearchQuery } from '../../DataStructures/SearchQuery';
  *
  * @param searchQuery - Array of SearchQuery objects, each containing search parameters for a specific query
  * @param token - Optional authentication token for authorized access (defaults to empty string for public queries)
- * @returns Promise resolving to an array of search results (one result set per query), or empty array on error
+ * @returns Promise resolving to an array of search results, one result set per query. A valid empty result is returned as an empty array.
+ * @throws Will throw if the request fails or the backend returns a non-OK response.
  *
  * @example
  * ```typescript
@@ -74,10 +75,9 @@ import { SearchQuery } from '../../DataStructures/SearchQuery';
  * - Atomic execution of all queries
  *
  * Error handling:
- * - HTTP errors are logged with status and handled via HandleHttpError
+ * - HTTP errors are handled via HandleHttpError and thrown
  * - Network errors are caught, logged, and re-thrown
- * - Returns empty array on HTTP errors to prevent null reference issues
- * - If any query fails, the entire operation returns an empty array
+ * - Empty arrays represent valid empty results, not failed requests
  *
  * Query execution:
  * - All queries are executed server-side

package/dist/types/Api/Search/SearchWithLinker.d.ts

@@ -17,7 +17,8 @@ import { SearchQuery } from '../../DataStructures/SearchQuery';
  *
  * @param searchQuery - Array of SearchQuery objects defining search criteria and relationship paths to follow
  * @param token - Optional authentication token for authorized access (defaults to empty string for public queries)
- * @returns Promise resolving to an array of search results with linked concepts resolved, or empty array on error
+ * @returns Promise resolving to an array of search results with linked concepts resolved. A valid empty result is returned as an empty array.
+ * @throws Will throw if the request fails or the backend returns a non-OK response.
  *
  * @example
  * ```typescript
@@ -81,10 +82,10 @@ import { SearchQuery } from '../../DataStructures/SearchQuery';
  * - Ideal for reducing client-side data fetching complexity
  *
  * Error handling:
- * - HTTP errors are logged with status and handled via HandleHttpError
+ * - HTTP errors are handled via HandleHttpError and thrown
  * - Network errors are caught, logged, and re-thrown
- * - Returns empty array on HTTP errors to maintain consistent error handling
- * - Link resolution errors are handled gracefully server-side
+ * - Empty arrays represent valid empty results, not failed requests
+ * - Link resolution errors are handled by the backend response contract
  *
  * Use cases:
  * - Building detailed profile views with all related data

package/dist/types/Api/SearchConcept/GetConceptByCharacterAndCategoryApi.d.ts

@@ -16,6 +16,7 @@ import { Concept } from "../../DataStructures/Concept";
  *
  * @param characterValue - The character string identifying the concept (e.g., "the_person", "john_doe")
  * @returns A promise that resolves to the matching Concept object, or a default concept if not found
+ * @throws Will throw if the request fails or the backend returns a non-OK response.
  *
  * @example
  * ```typescript
@@ -29,9 +30,9 @@ import { Concept } from "../../DataStructures/Concept";
  * ```
  *
  * @remarks
- * - Returns a default concept (id=0) if the concept is not found or an error occurs
+ * - Returns a default concept (id=0) if the concept is not found
  * - Automatically caches the retrieved concept in ConceptsData
- * - HTTP errors are handled through HandleHttpError but do not throw
+ * - HTTP errors are handled through HandleHttpError and thrown
  * - Errors are logged to console and re-thrown for caller handling
  *
  * @see GetConceptByCharacterAndCategoryDirectApi for searching with explicit category

package/dist/types/Api/SearchConcept/GetConceptByCharacterAndCategoryDirect.d.ts

@@ -18,6 +18,7 @@ import { Concept } from "./../../DataStructures/Concept";
  * @param characterValue - The character string identifying the concept (e.g., "john_doe", "building_a")
  * @param category_id - The specific category ID to search within
  * @returns A promise that resolves to the matching Concept object, or a default concept if not found
+ * @throws Will throw if the request fails or the backend returns a non-OK response.
  *
  * @example
  * ```typescript
@@ -36,10 +37,10 @@ import { Concept } from "./../../DataStructures/Concept";
  * @remarks
  * - Uses local caching (conceptCache) to prevent duplicate simultaneous requests
  * - Cache key is the concatenation of characterValue and category_id
- * - Returns a default concept (id=0) if the concept is not found or an error occurs
+ * - Returns a default concept (id=0) if the concept is not found
  * - Automatically caches the retrieved concept in ConceptsData for subsequent use
  * - Cache entries are cleaned up in the finally block after fetch completes
- * - HTTP errors are handled through HandleHttpError but do not throw
+ * - HTTP errors are handled through HandleHttpError and thrown
  * - Errors are logged with full diagnostic information including the endpoint URL
  *
  * @see GetConceptByCharacterAndCategoryApi for searching without explicit category

package/dist/types/Api/View/ViewInternalDataApi.d.ts

@@ -16,8 +16,8 @@
  * internal connection lists.
  *
  * @param ids - Array of concept IDs to retrieve internal data for
- * @returns A promise that resolves to a dictionary mapping concept IDs to their internal connections,
- *          or an empty connection list if the request fails
+ * @returns A promise that resolves to a dictionary mapping concept IDs to their internal connections.
+ * @throws Will throw if the request fails or the backend returns a non-OK response.
  *
  * @example
  * ```typescript
@@ -40,8 +40,7 @@
  * @remarks
  * - Returns an object where keys are concept IDs and values are arrays of Connection objects
  * - Automatically fetches and caches all sub-concepts via GetConceptBulk
- * - Returns an empty connection list on error
- * - HTTP errors are handled through HandleHttpError but do not throw
+ * - HTTP errors are handled through HandleHttpError and thrown
  * - Requires authentication via GetRequestHeader
  * - Errors are logged to console and re-thrown for caller handling
  *

package/dist/types/DataStructures/ConceptData.d.ts

@@ -38,10 +38,19 @@ export declare class ConceptsData {
     /** Legacy array storage for concepts (deprecated in favor of tree structures) */
     static conceptsArray: Concept[];
     /**
-     * NPC (Non-Persistent Concepts) cache for temporarily tracking accessed concept IDs.
-     * Limited to 10 entries for memory management.
+     * NPC (Non-Persistent Concepts) cache for concept IDs that are currently in cooldown.
      */
     static NPC: number[];
+    /**
+     * Per-NPC cooldown state. Each failed backend lookup increases the cooldown by
+     * 30 seconds: first miss = 30s, second miss = 60s, third miss = 90s, etc.
+     */
+    static NPCMeta: Map<number, {
+        attempts: number;
+        expiresAt: number;
+    }>;
+    static NPC_BACKOFF_SECONDS: number;
+    static RemoveExpiredNpc(now?: number): void;
     /** Dictionary-style storage for quick concept lookups by ID */
     static conceptDictionary: Concept[];
     /**
@@ -61,7 +70,7 @@ export declare class ConceptsData {
     static CheckContains(concept: Concept): boolean;
     /**
      * Adds a concept ID to the Non-Persistent Concepts (NPC) cache.
-     * Used for tracking recently accessed concepts. Automatically clears when exceeding 10 entries.
+     * Used for tracking recently missed concepts with a growing retry cooldown.
      *
      * @param {number} id - The concept ID to add to NPC cache
      *
@@ -72,10 +81,10 @@ export declare class ConceptsData {
      */
     static AddNpc(id: number): void;
     /**
-     * Checks if a concept ID exists in the NPC cache.
+     * Checks if a concept ID exists in the NPC cache and is still inside its cooldown.
      *
      * @param {number} id - The concept ID to check
-     * @returns {boolean} True if the ID is in the NPC cache, false otherwise
+     * @returns {boolean} True if the ID is currently in NPC cooldown, false otherwise
      *
      * @example
      * ```typescript

package/dist/types/DataStructures/ReservedIds.d.ts

@@ -24,6 +24,7 @@
 export declare class ReservedIds {
     /** Pool of reserved concept IDs */
     static ids: number[];
+    private static pendingFetch;
     /**
     * Gets the next available reserved ID from the pool.
     * Automatically refills the pool if it has fewer than 10 IDs.

package/dist/types/DataStructures/Search/FreeschemaQuery.d.ts

@@ -184,4 +184,5 @@ export declare class FreeschemaQuery {
      * @default false
      */
     isOldConnectionType: boolean;
+    usePipelineQuery: boolean;
 }

package/dist/types/Database/NoIndexDb.d.ts

@@ -1,20 +1,18 @@
 /**
- * No-operation IndexedDB interface module for environments without IndexedDB support.
+ * In-memory database compatibility module for the Node package.
  *
- * This module provides stub implementations of database operations that are used when
- * IndexedDB is not available or when database functionality needs to be disabled.
- * All functions are no-ops or return default values, allowing the application to
- * run without actual database persistence.
+ * The original frontend package used IndexedDB. The Node package keeps the same
+ * small storage API so existing data structures can run unchanged, but values are
+ * stored only in process memory and are lost when the process exits.
  *
  * @module Database/NoIndexDb
  * @see https://documentation.freeschema.com for reference
  */
 import { SettingData } from "../DataStructures/SettingData";
 /**
- * Opens or returns a reference to the IndexedDB database.
+ * Opens or returns a reference to the legacy IndexedDB database handle.
  *
- * In this no-op implementation, it simply returns the static database reference
- * from IndexDb without performing any actual initialization.
+ * This Node compatibility implementation does not initialize a real database.
  *
  * @param databaseName - The name of the database to open
  * @returns The static IDBDatabase reference from IndexDb.db
@@ -32,10 +30,10 @@ import { SettingData } from "../DataStructures/SettingData";
  */
 export declare function openDatabase(databaseName: string): IDBDatabase;
 /**
- * Stores an object to the database (no-op implementation).
+ * Stores an object in the in-memory compatibility store.
  *
- * This function provides a stub for storing data to IndexedDB. In this no-op
- * implementation, it does not perform any actual storage operations.
+ * Values are not persisted to disk. Use this only as a runtime cache for the
+ * current Node process.
  *
  * @param databaseName - The name of the database or object store
  * @param object - The object to store (can be any type)
@@ -48,15 +46,15 @@ export declare function openDatabase(databaseName: string): IDBDatabase;
  * ```
  *
  * @remarks
- * This is a placeholder implementation. Use the full database module for actual persistence.
+ * This is not durable storage.
  */
 export declare function storeToDatabase(databaseName: string, object: any): void;
 /**
- * Retrieves statistics and settings from the database.
+ * Retrieves statistics and settings from the in-memory store.
  *
  * Returns a new SettingData instance initialized with default values.
  * This provides a consistent interface for accessing settings even when
- * database functionality is disabled.
+ * durable database functionality is disabled.
  *
  * @returns A new SettingData instance with AI features enabled (true)
  *
@@ -73,10 +71,9 @@ export declare function storeToDatabase(databaseName: string, object: any): void
  */
 export declare function GetStatsFromDatabase(): SettingData;
 /**
- * Updates the AI flag in settings (no-op implementation).
+ * Updates the AI flag in the in-memory settings store.
  *
- * This function provides a stub for updating AI-related settings in the database.
- * In this no-op implementation, it does not perform any actual updates.
+ * The update is process-local and is not persisted to disk.
  *
  * @param object - The SettingData object containing the new AI flag value
  *
@@ -88,16 +85,16 @@ export declare function GetStatsFromDatabase(): SettingData;
  * ```
  *
  * @remarks
- * This is a placeholder implementation. Changes are not persisted.
+ * Changes are not persisted across process restarts.
  *
  * @see SettingData for the settings data structure
  */
 export declare function AiUpdateFlag(object: SettingData): void;
 /**
- * Retrieves an object from the database by type and ID (no-op implementation).
+ * Retrieves objects from the in-memory store by property and value.
  *
- * This async function provides a stub for fetching data from IndexedDB based on
- * type and ID. In this no-op implementation, it returns undefined.
+ * This async function mirrors the old IndexedDB API shape while using the
+ * process-local compatibility store.
  *
  * @param databaseName - The name of the database or object store
  * @param type - The type of object to retrieve (e.g., 'concept', 'setting')
@@ -111,14 +108,14 @@ export declare function AiUpdateFlag(object: SettingData): void;
  * ```
  *
  * @remarks
- * This is a placeholder implementation. Use the full database module for actual retrieval.
+ * This is not durable storage.
  */
-export declare function getFromDatabaseWithType(databaseName: string, type: string, id: number): Promise<void>;
+export declare function getFromDatabaseWithType(databaseName: string, type: string, id: number): Promise<any[]>;
 /**
- * Retrieves objects from the database using legacy method (no-op implementation).
+ * Retrieves all objects from a named in-memory store.
  *
- * This async function provides a stub for the older method of fetching data from
- * IndexedDB. In this no-op implementation, it returns undefined.
+ * This async function preserves the older IndexedDB-oriented method name while
+ * returning data from the process-local compatibility store.
  *
  * @param databaseName - The name of the database or object store
  * @returns Promise resolving to undefined
@@ -135,12 +132,11 @@ export declare function getFromDatabaseWithType(databaseName: string, type: stri
  *
  * @see getFromDatabaseWithType for the current retrieval method
  */
-export declare function getFromDatabaseWithTypeOld(databaseName: string): Promise<void>;
+export declare function getFromDatabaseWithTypeOld(databaseName: string): Promise<any[]>;
 /**
- * Removes an object from the database by ID (no-op implementation).
+ * Removes an object from the in-memory store by ID.
  *
- * This function provides a stub for deleting data from IndexedDB. In this no-op
- * implementation, it does not perform any actual deletion.
+ * The deletion is process-local and is not persisted to disk.
  *
  * @param databaseName - The name of the database or object store
  * @param id - The numeric ID of the object to remove
@@ -152,14 +148,14 @@ export declare function getFromDatabaseWithTypeOld(databaseName: string): Promis
  * ```
  *
  * @remarks
- * This is a placeholder implementation. Use the full database module for actual deletion.
+ * This is not durable storage.
  */
 export declare function removeFromDatabase(databaseName: string, id: number): void;
 /**
- * Retrieves all objects from the local database (no-op implementation).
+ * Retrieves all objects from a local in-memory store.
  *
- * This async function provides a stub for fetching all data from a local IndexedDB
- * object store. In this no-op implementation, it returns undefined.
+ * This async function preserves the local IndexedDB API shape while returning
+ * process-local data.
  *
  * @param databaseName - The name of the database or object store
  * @returns Promise resolving to undefined
@@ -171,8 +167,8 @@ export declare function removeFromDatabase(databaseName: string, id: number): vo
  * ```
  *
  * @remarks
- * This is a placeholder implementation. Use the full database module for actual bulk retrieval.
+ * This is not durable storage.
  *
  * @see LocalIndexDb for local database operations
  */
-export declare function getAllFromLocalDb(databaseName: string): Promise<void>;
+export declare function getAllFromLocalDb(databaseName: string): Promise<any[]>;

package/dist/types/Services/Common/DecodeCountInfo.d.ts

@@ -33,7 +33,7 @@ export declare function DecodeCountInfo(countStrings?: string[]): CountInfo[];
  *
  * @async
  * @param {CountInfo[]} countInfos - Array of CountInfo objects to process
- * @returns {Promise<any>} A promise that resolves to a dictionary mapping concept IDs to enriched CountInfo objects
+ * @returns {Promise<any>} A promise that resolves to a dictionary mapping concept IDs to arrays of enriched CountInfo objects
  *
  * @example
  * ```typescript
@@ -43,8 +43,8 @@ export declare function DecodeCountInfo(countStrings?: string[]): CountInfo[];
  * ];
  * const dictionary = await GetConnectionTypeForCount(countInfos);
  * // dictionary = {
- * //   123: { conceptId: 123, connectionTypeId: 456, count: 42, connectionType: "follows" },
- * //   789: { conceptId: 789, connectionTypeId: 456, count: 15, connectionType: "follows" }
+ * //   123: [{ conceptId: 123, connectionTypeId: 456, count: 42, connectionType: "follows" }],
+ * //   789: [{ conceptId: 789, connectionTypeId: 456, count: 15, connectionType: "follows" }]
  * // }
  * ```
  *
@@ -52,6 +52,7 @@ export declare function DecodeCountInfo(countStrings?: string[]): CountInfo[];
  * - Fetches concept objects for each connectionTypeId
  * - Adds connectionType (character value) to each CountInfo
  * - Returns dictionary indexed by conceptId for fast lookup
+ * - Preserves multiple counts for the same concept across different connection types
  * - Used by formatting functions to add count information
  */
 export declare function GetConnectionTypeForCount(countInfos: CountInfo[]): Promise<any>;

package/dist/types/Services/Common/ErrorPosting.d.ts

@@ -5,25 +5,23 @@
 import { HttpResponse } from "../Http/HttpClient.service";
 /**
  * Handles HTTP errors by creating and throwing structured error responses.
- * Specifically handles 401 Unauthorized errors.
  *
- * @param {Response} response - The HTTP Response object to process
- * @throws {FreeSchemaResponse} Throws a structured error response for unauthorized requests
+ * @param {Response | HttpResponse} response - The HTTP response object to process
+ * @throws {FreeSchemaResponse} Throws a structured error response for any non-OK response
  *
  * @example
  * ```typescript
  * const response = await fetch("https://api.example.com/data");
  * HandleHttpError(response);
- * // Throws FreeSchemaResponse if status is 401
+ * // Throws FreeSchemaResponse if response.ok is false
  * ```
  *
  * @remarks
- * - Currently only handles 401 status codes
+ * - Handles any non-2xx status code
  * - Creates FreeSchemaResponse with status text, success=false, status code, and URL
- * - Other status codes are not handled (function returns normally)
  * - Useful for API call error handling
  */
-export declare function HandleHttpError(response: Response): void;
+export declare function HandleHttpError(response: Response | HttpResponse): void;
 export declare function HandleHttpErrorHttp(response: HttpResponse): void;
 /**
  * Handles internal application errors by creating and throwing structured error responses.

package/dist/types/Services/CreateConnectionBetweenTwoConcepts.d.ts

@@ -32,7 +32,7 @@ import { Connection } from "../DataStructures/Connection";
  * @param both - If true, creates connections in both directions (default: false)
  * @param count - If true, maintains a count of relationships for this linker type (default: false)
  *
- * @returns A promise that resolves to the created forward Connection object
+ * @returns A promise that resolves to the created forward Connection object with a reserved ID
  *
  * @example
  * ```typescript
@@ -71,6 +71,7 @@ import { Connection } from "../DataStructures/Connection";
  * - Forward connection type pattern: `{sourceType}_s_{linker}_s`
  * - Backward connection type pattern: `{targetType}_s_{linker}_by`
  * - Count concept pattern: `{type}_s_{linker}_count`
+ * - Uses reserved connection IDs for forward and backward connections
  * - Uses session information ID 999 and access level 4 as defaults
  * - Counting creates/updates a separate count concept for relationship analytics
  * - The backward connection is created first if both=true
@@ -199,12 +200,12 @@ export declare function CountRelationship(linker: string, concept: Concept, pass
  * - Uses CreateTheConnectionGeneral for proper ID reservation and persistence
  * - Forward connection type pattern: `{sourceType}_s_{linker}_s`
  * - Backward connection type pattern: `{targetType}_s_{linker}_by`
- * - Backward connections still use basic Connection creation (not CreateTheConnectionGeneral)
+ * - Forward and backward connections both use CreateTheConnectionGeneral
  * - Uses session information ID 999, order 1000, and access level 4
  * - Connection is marked for update (toUpdate = true) via CreateTheConnectionGeneral
  * - Recommended for production use over CreateConnectionBetweenTwoConcepts
  *
- * @see {@link CreateConnectionBetweenTwoConcepts} for the temporary version
+ * @see {@link CreateConnectionBetweenTwoConcepts} for the compatibility export
  * @see {@link CreateTheConnectionGeneral} for the underlying connection creation
  * @see {@link CountRelationship} for relationship counting implementation
  */

package/dist/types/Services/CreateTheComposition.d.ts

@@ -90,7 +90,7 @@ import { Concept } from "../DataStructures/Concept";
  * - Primitive values (strings, numbers) are stored as characterValue in leaf concepts
  * - Nested objects and arrays are recursively converted into sub-compositions
  * - All concepts are connected using the mainKey (root concept ID) as the connection type
- * - Uses temporary connections (via createTheConnection) with random IDs
+ * - Uses reserved connection IDs for persistence
  * - Default values: userId=999, accessId=4, sessionInformationId=999
  * - The function modifies SyncData by adding all created concepts and connections
  * - Complex objects become type concepts with isComposition=true
@@ -98,6 +98,6 @@ import { Concept } from "../DataStructures/Concept";
  *
  * @see {@link GetComposition} for reconstructing compositions back to JSON
  * @see {@link MakeTheInstanceConcept} for individual concept creation
- * @see {@link createTheConnection} for connection creation logic
+ * @see {@link CreateTheConnectionGeneral} for connection creation logic
  */
 export default function CreateTheComposition(json: any, ofTheConceptId?: number | null, ofTheConceptUserId?: number | null, mainKey?: number | null, userId?: number | null, accessId?: number | null, sessionInformationId?: number | null): Promise<Concept>;

package/dist/types/Services/CreateTheConnection.d.ts

@@ -8,13 +8,18 @@
  * @module CreateTheConnection
  */
 import { Connection } from "../DataStructures/Connection";
+type ConnectionConceptIds = {
+    ofTheConceptId: number;
+    toTheConceptId: number;
+};
+export declare function validateConnectionConceptIds(ofTheConceptId: number | string, toTheConceptId: number | string): ConnectionConceptIds;
 /**
  * Creates a temporary connection between two concepts with default settings.
  *
  * This function establishes a basic connection relationship between a source concept
  * (ofTheConcept) and a target concept (toTheConcept). The created connection is marked
  * as temporary (isTemp = true) and assigned a random ID. It automatically handles the
- * special case where a concept connects to itself by setting predefined IDs.
+ * Self-referencing connections are rejected before they can enter the sync queue.
  *
  * The function uses default values for security (0), access level (4), and order (1),
  * making it suitable for quick connection creation during prototyping or when advanced
@@ -48,8 +53,7 @@ import { Connection } from "../DataStructures/Connection";
  *
  * @remarks
  * - The connection is marked as temporary (isTemp = true) and assigned a random ID
- * - Self-referencing connections (where ofTheConceptId equals toTheConceptId) are handled
- *   specially by setting ofTheConceptId to 0 and toTheConceptId to 1
+ * - Self-referencing connections are rejected
  * - Default security level is set to 0 and access level to 4
  * - The connection is automatically added to SyncData for later synchronization
  * - For production use with reserved IDs and more control, consider using CreateTheConnectionGeneral
@@ -58,4 +62,5 @@ import { Connection } from "../DataStructures/Connection";
  * @see {@link Connection} for the connection data structure
  * @see {@link SyncData.AddConnection} for how connections are queued for sync
  */
-export declare function createTheConnection(ofTheConceptId: number, ofTheConceptUserId: number, toTheConceptId: number, toTheConceptUserId: number, typeId: number, sessionInformationId: number, sessionInformationUserId: number): Connection;
+export declare function createTheConnection(ofTheConceptId: number | string, ofTheConceptUserId: number, toTheConceptId: number | string, toTheConceptUserId: number, typeId: number, sessionInformationId: number, sessionInformationUserId: number): Connection;
+export {};

package/dist/types/Services/CreateTheConnectionGeneral.d.ts

@@ -7,9 +7,9 @@
  *
  * @module CreateTheConnectionGeneral
  */
-import { Concept } from "../app";
+import type { Concept } from "../DataStructures/Concept";
 import { Connection } from "../DataStructures/Connection";
-import { InnerActions } from "../DataStructures/Transaction/Transaction";
+import type { InnerActions } from "../DataStructures/Transaction/Transaction";
 /**
  * Creates a permanent connection between two concepts with reserved ID and full configuration.
  *
@@ -61,7 +61,7 @@ import { InnerActions } from "../DataStructures/Transaction/Transaction";
  * - Uses reserved IDs from ReservedConnectionIds for guaranteed uniqueness
  * - Connection is marked as non-temporary (isTemp = false) for persistence
  * - Sets toUpdate = true to ensure database synchronization
- * - Self-referencing connections are handled by setting ofTheConceptId to 0 and toTheConceptId to 1
+ * - Self-referencing connections are rejected before they can enter the sync queue
  * - The connection is added to both SyncData and the provided actions object
  * - If passedUserId is 999, the function defaults to using ofTheConceptUserId
  *
@@ -69,7 +69,7 @@ import { InnerActions } from "../DataStructures/Transaction/Transaction";
  * @see {@link CreateConnection} for a simplified high-level connection API
  * @see {@link ReservedConnectionIds.getId} for ID reservation mechanism
  */
-export declare function CreateTheConnectionGeneral(ofTheConceptId: number, ofTheConceptUserId: number, toTheConceptId: number, toTheConceptUserId: number, typeId: number, sessionInformationId: number, sessionInformationUserId: number, orderId?: number, accessId?: number, passedUserId?: number, actions?: InnerActions): Promise<Connection>;
+export declare function CreateTheConnectionGeneral(ofTheConceptId: number | string, ofTheConceptUserId: number, toTheConceptId: number | string, toTheConceptUserId: number, typeId: number, sessionInformationId: number, sessionInformationUserId: number, orderId?: number, accessId?: number, passedUserId?: number, actions?: InnerActions): Promise<Connection>;
 /**
  * Creates a connection between two concepts using a type string identifier.
  *

package/dist/types/Services/GetDataFromIndexDb.d.ts

@@ -1,21 +1,21 @@
 /**
- * IndexedDB Data Retrieval Service
+ * Runtime Cache Hydration Service
  *
- * This module provides comprehensive functionality for loading data from IndexedDB into
- * in-memory data structures. It handles both regular and local database data, loading
- * connections and concepts into their respective memory structures for efficient access.
+ * This module loads data from the Node package's process-local compatibility store
+ * into in-memory data structures. It keeps the original IndexedDB-oriented function
+ * names used by the frontend package, but it does not provide durable storage.
  *
  * The service supports two data contexts:
- * - Global/synced data: Loaded from standard IndexedDB stores
- * - Local data: Loaded from local-only IndexedDB stores for offline or user-specific data
+ * - Global/synced data: Loaded from the process-local compatibility store
+ * - Local data: Loaded from local process memory for API compatibility
  *
  * @module GetDataFromIndexDb
  */
 /**
- * Loads data from the standard IndexedDB stores into memory.
+ * Loads data from the standard process-local stores into memory.
  *
  * This is the main entry point for initializing the application's in-memory data structures
- * from persisted database records. Currently focuses on loading connections, with concept
+ * from runtime cache records. Currently focuses on loading connections, with concept
  * loading functionality commented out for optimization or architectural reasons.
  *
  * The function delegates to specialized helpers to load different data types, ensuring

package/dist/types/Services/Http/HttpClient.service.d.ts

@@ -100,6 +100,13 @@ export declare class HttpResponse {
  * ```
  */
 export declare function requestWithRetry(method: string, url: string, headers?: Record<string, string>, body?: any, maxRetries?: number): Promise<HttpResponse>;
+/**
+ * Fetch-compatible wrapper backed by requestWithRetry.
+ *
+ * Use this when migrating existing fetch call sites that expect `ok`, `json()`,
+ * and `text()` while still needing automatic token refresh on 401.
+ */
+export declare function fetchWithRetry(url: string, init?: RequestInit, maxRetries?: number): Promise<HttpResponse>;
 /**
  * Convenience method for POST requests with automatic retry on 401.
  *

package/dist/types/Services/MakeTheTimestamp.d.ts

@@ -30,8 +30,8 @@ import { Concept } from "../DataStructures/Concept";
  * - Category ID is fixed at 4 for timestamp concepts
  * - Referent ID is set to 0 (no referent concept)
  * - Security ID is fixed at 999
- * - Session information ID is overridden to 999 regardless of parameter
- * - Access ID is overridden to 4 regardless of parameter
+ * - Uses the provided sessionInformationId, defaulting to 999
+ * - Uses the provided accessId
  * - All user IDs are derived from the userId parameter
  * - Type concept is created before the timestamp concept
  *