mftsccs-node 0.0.76 → 0.0.78-dev

package/dist/types/Api/MakeTheTypeConceptApi.d.ts

@@ -8,35 +8,6 @@
 import { Concept } from "../DataStructures/Concept";
 /**
  * Retrieves or creates a type concept based on a string identifier.
- * Type concepts are special concepts that define categories for other concepts in the system.
- *
- * This function first attempts to find an existing type concept locally, then queries the backend
- * if not found. If the concept doesn't exist in the backend, it creates a new type concept.
- * The function uses caching to prevent duplicate requests for the same type.
- *
- * @param type - The string identifier for the type concept (e.g., "the_person", "the_location")
- * @param userId - The user ID associated with the request
- * @returns A promise that resolves to the Concept object representing the type
- *
- * @example
- * ```typescript
- * // Get or create a "person" type concept
- * const personType = await MakeTheTypeConceptApi('the_person', 123);
- * console.log('Person type ID:', personType.id);
- *
- * // Use the type concept when creating new concepts
- * const newPerson = await CreateConcept('John Doe', personType.id);
- * ```
- *
- * @remarks
- * - Uses local caching to prevent duplicate simultaneous requests
- * - First searches for existing concept via GetConceptByCharacterAndCategory
- * - Creates new type concept in backend if not found or if typeId is 4 (unknown type)
- * - Automatically adds the retrieved concept to ConceptsData for local access
- * - Cache entries are cleaned up after the fetch completes
- * - Returns a default concept with id=0 if errors occur
- *
- * @see GetConceptByCharacterAndCategory for local concept searching
- * @see MakeTheNameInBackend for creating named concepts
+ * Type concepts define categories and classifications used in the Concept Connection System.
  */
 export declare function MakeTheTypeConceptApi(type: string, userId: number): Promise<Concept>;

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

@@ -26,6 +26,12 @@
 export declare class BaseUrl {
     /** Base URL for the main CCS backend API server */
     static BASE_URL: string;
+    /** Current cache server URL used for read-heavy concept and connection endpoints */
+    static NODE_CACHE_URL: string;
+    /** Ordered cache servers, nearest first. Falls back to BASE_URL when exhausted. */
+    static CACHE_SERVERS: string[];
+    /** Indicates whether the current cache server is still the nearest configured server */
+    static isNearestCache: boolean;
     /** URL for AI service endpoints */
     static AI_URL: string;
     /** MQTT broker URL for real-time messaging */
@@ -34,6 +40,10 @@ export declare class BaseUrl {
     static NODE_URL: string;
     /** Active MQTT connection instance */
     static MQTT_CONNECTION: any;
+    static setNodeCacheUrl(cacheServerUrl?: string): void;
+    static setCacheServers(cacheServers?: string[]): void;
+    static GetReadBaseUrl(): string;
+    static GetReadBaseUrlCandidates(): string[];
     /**
      * Returns the URL for retrieving a single concept by ID.
      * @returns {string} The concept retrieval API endpoint
@@ -244,6 +254,7 @@ export declare class BaseUrl {
      * @returns {string} The type concept creation API endpoint
      */
     static MakeTheTypeConceptUrl(): string;
+    static CreateTypeConceptUrl(): string;
     /**
      * Returns the URL for deleting a single connection.
      * @returns {string} The connection deletion API endpoint

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

@@ -40,9 +40,19 @@
  * await init("https://api.example.com", "", "MyApp", config);
  * ```
  */
+type CCSConfigOptions = Partial<Omit<CCSConfig, "cacheServers">> & {
+    cacheServers?: string[] | string;
+    cacheServerUrl?: string;
+    cacheServer?: string;
+    cache_servers?: string[] | string;
+};
 export declare class CCSConfig {
     /** URL for the AI service. Defaults to "https://ai.freeschema.com" */
     aiUrl: string;
+    /** Single cache server URL for read-heavy concept and connection endpoints */
+    cacheServerUrl: string;
+    /** Ordered cache server URLs, nearest first */
+    cacheServers: string[];
     /** JWT bearer token for authentication. Can be set later via updateAccessToken() */
     accessToken: string;
     /** Whether to enable AI features. Defaults to true */
@@ -58,7 +68,7 @@ export declare class CCSConfig {
     flags?: Record<string, boolean>;
     /**
      * Dictionary of additional parameters.
-     * Example: { logserver: "https://logs.example.com" }
+     * Example: { logserver: "https://logs.example.com", cacheServers: "https://cache-1.example.com,https://cache-2.example.com" }
      */
     parameters?: Record<string, string>;
     /** Path for storing local data (ID counters, cached data, etc.) */
@@ -95,7 +105,7 @@ export declare class CCSConfig {
      * });
      * ```
      */
-    constructor(options?: Partial<CCSConfig>);
+    constructor(options?: CCSConfigOptions);
     /**
      * Returns true if OAuth credentials are configured.
      * @returns {boolean} Whether both clientId and clientSecret are set
@@ -167,3 +177,4 @@ export declare class CCSConfig {
      */
     setParameter(paramName: string, value: string): void;
 }
+export {};

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

@@ -214,6 +214,8 @@ export declare class Transaction {
    * ```
    */
     MakeTheInstanceConcept(type: string, referent: string, composition: boolean | undefined, userId: number, accessId: number, sessionInformationId?: number, referentId?: number): Promise<Concept>;
+    CreateReferentConcept(type: string, referentConcept: Concept | number, characterValue?: string, userId?: number, accessId?: number, sessionInformationId?: number): Promise<Concept>;
+    CreateTypeConcept(typeConcept: Concept | number, characterValue: string, userId?: number, accessId?: number, sessionInformationId?: number): Promise<Concept>;
     /**
    * Creates a connection between two concepts within the transaction.
    * Establishes a typed relationship between source and target concepts.

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

@@ -0,0 +1,3 @@
+import { Concept } from "../DataStructures/Concept";
+import { InnerActions } from "../DataStructures/Transaction/Transaction";
+export declare function CreateReferentConcept(type: string, referentConcept: Concept | number, characterValue?: string, userId?: number, accessId?: number, sessionInformationId?: number, actions?: InnerActions): Promise<Concept>;

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

@@ -0,0 +1,3 @@
+import { Concept } from "../DataStructures/Concept";
+import { InnerActions } from "../DataStructures/Transaction/Transaction";
+export declare function CreateTypeConcept(typeConcept: Concept | number, characterValue: string, userId?: number, accessId?: number, sessionInformationId?: number, actions?: InnerActions): Promise<Concept>;

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

@@ -0,0 +1,6 @@
+import { HttpResponse } from "./Http/HttpClient.service";
+/**
+ * Fetch from the nearest configured cache server first, then rotate through the
+ * remaining cache servers and finally the main backend when a cache server is down.
+ */
+export declare function fetchWithCacheServerFallback(path: string, init?: RequestInit, maxRetries?: number): Promise<HttpResponse>;

package/dist/types/app.d.ts

@@ -8,6 +8,7 @@
  */
 export { init, updateAccessToken };
 export { getOAuthToken, refreshOAuthToken } from './Services/oauth/CallOauth.service';
+export { fetchWithCacheServerFallback } from './Services/cacheService';
 export type { OAuthResponse } from './Services/oauth/CallOauth.service';
 export { requestWithRetry, postWithRetry, getWithRetry, putWithRetry, deleteWithRetry, patchWithRetry, fetchWithRetry, HttpResponse, TokenRefreshError } from './Services/Http/HttpClient.service';
 export { SplitStrings } from './Services/SplitStrings';
@@ -19,6 +20,8 @@ export { default as CreateComposition } from './Services/CreateTheComposition';
 export { CreateConnectionBetweenTwoConcepts, CreateConnectionBetweenTwoConceptsGeneral } from './Services/CreateConnectionBetweenTwoConcepts';
 export { default as GetTheConcept } from './Services/GetTheConcept';
 export { default as MakeTheInstanceConcept } from './Services/MakeTheInstanceConcept';
+export { CreateReferentConcept } from './Services/CreateReferentConcept';
+export { CreateTypeConcept } from './Services/CreateTypeConcept';
 export { storeToDatabase, getFromDatabaseWithType, getFromDatabaseWithTypeOld } from './Database/NoIndexDb';
 export { default as GetConceptByCharacter } from './Services/GetConceptByCharacter';
 export { GetLink, GetLinkRaw } from './Services/GetLink';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mftsccs-node",
-  "version": "0.0.76",
+  "version": "0.0.78-dev",
   "environment": "production",
   "description": "Full Pack of concept and connection system",
   "main": "dist/bundle.js",