@getzep/zep-cloud 1.0.2 → 1.0.4

package/api/resources/user/client/Client.js

@@ -67,11 +67,12 @@ class User {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ZepEnvironment.Default, "users"),
                 method: "POST",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
                 contentType: "application/json",
                 body: yield serializers.CreateUserRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return yield serializers.User.parseOrThrow(_response.body, {
@@ -148,11 +149,12 @@ class User {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ZepEnvironment.Default, "users-ordered"),
                 method: "GET",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return yield serializers.UserListResponse.parseOrThrow(_response.body, {
@@ -221,10 +223,11 @@ class User {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ZepEnvironment.Default, `users/${encodeURIComponent(userId)}`),
                 method: "GET",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
                 contentType: "application/json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return yield serializers.User.parseOrThrow(_response.body, {
@@ -293,10 +296,11 @@ class User {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ZepEnvironment.Default, `users/${encodeURIComponent(userId)}`),
                 method: "DELETE",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
                 contentType: "application/json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return yield serializers.SuccessResponse.parseOrThrow(_response.body, {
@@ -367,11 +371,12 @@ class User {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ZepEnvironment.Default, `users/${encodeURIComponent(userId)}`),
                 method: "PATCH",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
                 contentType: "application/json",
                 body: yield serializers.UpdateUserRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return yield serializers.User.parseOrThrow(_response.body, {
@@ -447,10 +452,11 @@ class User {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.ZepEnvironment.Default, `users/${encodeURIComponent(userId)}/sessions`),
                 method: "GET",
-                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
+                headers: Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "zep-cloud", "X-Fern-SDK-Version": "1.0.4", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())),
                 contentType: "application/json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
                 return yield serializers.user.getSessions.Response.parseOrThrow(_response.body, {

package/api/{resources/memory/client/requests → types}/ClassifySessionRequest.d.ts

@@ -1,13 +1,6 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-/**
- * @example
- *     {
- *         classes: ["classes"],
- *         name: "name"
- *     }
- */
 export interface ClassifySessionRequest {
     /** The classes to use for classification. */
     classes: string[];

package/api/types/CreateDocumentRequest.d.ts

@@ -2,8 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 export interface CreateDocumentRequest {
-    content?: string;
+    content: string;
     documentId?: string;
-    embedding?: number[];
     metadata?: Record<string, unknown>;
 }

package/api/types/EndSessionResponse.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index";
+export interface EndSessionResponse {
+    classification?: Zep.ClassifySessionResponse;
+    session?: Zep.Session;
+}

package/api/types/EndSessionsResponse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index";
+export interface EndSessionsResponse {
+    sessions?: Zep.Session[];
+}

package/api/types/Memory.d.ts

@@ -9,6 +9,8 @@ export interface Memory {
     messages?: Zep.Message[];
     /** A dictionary containing metadata associated with the memory. */
     metadata?: Record<string, unknown>;
+    /** Summary list result from Summary Retriever Memory Type. */
+    relevantSummaries?: Zep.Summary[];
     /** A Summary object. */
     summary?: Zep.Summary;
 }

package/api/types/MemorySearchResult.d.ts

@@ -3,7 +3,6 @@
  */
 import * as Zep from "../index";
 export interface MemorySearchResult {
-    embedding?: number[];
     message?: Zep.Message;
     metadata?: Record<string, unknown>;
     score?: number;

package/api/types/SessionSearchResponse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index";
+export interface SessionSearchResponse {
+    results?: Zep.SessionSearchResult[];
+}

package/api/types/SessionSearchResult.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Zep from "../index";
+export interface SessionSearchResult {
+    message?: Zep.Message;
+    score?: number;
+    sessionId?: string;
+    summary?: Zep.Summary;
+}

package/api/types/SessionSearchResult.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/types/index.d.ts

@@ -1,10 +1,13 @@
 export * from "./ApiError";
+export * from "./ClassifySessionRequest";
 export * from "./ClassifySessionResponse";
 export * from "./CreateDocumentRequest";
 export * from "./DocumentCollectionResponse";
 export * from "./DocumentResponse";
 export * from "./DocumentSearchResult";
 export * from "./DocumentSearchResultPage";
+export * from "./EndSessionResponse";
+export * from "./EndSessionsResponse";
 export * from "./Memory";
 export * from "./MemorySearchResult";
 export * from "./Message";
@@ -15,10 +18,11 @@ export * from "./SearchScope";
 export * from "./SearchType";
 export * from "./Session";
 export * from "./SessionListResponse";
+export * from "./SessionSearchResponse";
+export * from "./SessionSearchResult";
 export * from "./SuccessResponse";
 export * from "./Summary";
 export * from "./SummaryListResponse";
 export * from "./UpdateDocumentListRequest";
 export * from "./User";
 export * from "./UserListResponse";
-export * from "./ModelsZepDataClass";

package/api/types/index.js

@@ -15,12 +15,15 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ApiError"), exports);
+__exportStar(require("./ClassifySessionRequest"), exports);
 __exportStar(require("./ClassifySessionResponse"), exports);
 __exportStar(require("./CreateDocumentRequest"), exports);
 __exportStar(require("./DocumentCollectionResponse"), exports);
 __exportStar(require("./DocumentResponse"), exports);
 __exportStar(require("./DocumentSearchResult"), exports);
 __exportStar(require("./DocumentSearchResultPage"), exports);
+__exportStar(require("./EndSessionResponse"), exports);
+__exportStar(require("./EndSessionsResponse"), exports);
 __exportStar(require("./Memory"), exports);
 __exportStar(require("./MemorySearchResult"), exports);
 __exportStar(require("./Message"), exports);
@@ -31,10 +34,11 @@ __exportStar(require("./SearchScope"), exports);
 __exportStar(require("./SearchType"), exports);
 __exportStar(require("./Session"), exports);
 __exportStar(require("./SessionListResponse"), exports);
+__exportStar(require("./SessionSearchResponse"), exports);
+__exportStar(require("./SessionSearchResult"), exports);
 __exportStar(require("./SuccessResponse"), exports);
 __exportStar(require("./Summary"), exports);
 __exportStar(require("./SummaryListResponse"), exports);
 __exportStar(require("./UpdateDocumentListRequest"), exports);
 __exportStar(require("./User"), exports);
 __exportStar(require("./UserListResponse"), exports);
-__exportStar(require("./ModelsZepDataClass"), exports);

package/core/fetcher/Fetcher.d.ts

@@ -11,6 +11,7 @@ export declare namespace Fetcher {
         timeoutMs?: number;
         maxRetries?: number;
         withCredentials?: boolean;
+        abortSignal?: AbortSignal;
         responseType?: "json" | "blob" | "streaming" | "text";
     }
     type Error = FailedStatusCodeError | NonJsonError | TimeoutError | UnknownError;

package/core/fetcher/Fetcher.js

@@ -36,7 +36,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetcher = void 0;
-const form_data_1 = __importDefault(require("form-data"));
 const qs_1 = __importDefault(require("qs"));
 const runtime_1 = require("../runtime");
 const INITIAL_RETRY_DELAY = 1;
@@ -60,15 +59,34 @@ function fetcherImpl(args) {
             ? `${args.url}?${qs_1.default.stringify(args.queryParameters, { arrayFormat: "repeat" })}`
             : args.url;
         let body = undefined;
-        if (args.body instanceof form_data_1.default) {
-            // @ts-expect-error
-            body = args.body;
-        }
-        else if (args.body instanceof Uint8Array) {
-            body = args.body;
+        const maybeStringifyBody = (body) => {
+            if (body instanceof Uint8Array) {
+                return body;
+            }
+            else if (args.contentType === "application/x-www-form-urlencoded" && typeof args.body === "string") {
+                return args.body;
+            }
+            else {
+                return JSON.stringify(body);
+            }
+        };
+        if (runtime_1.RUNTIME.type === "node") {
+            if (args.body instanceof (yield Promise.resolve().then(() => __importStar(require("formdata-node")))).FormData) {
+                // @ts-expect-error
+                body = args.body;
+            }
+            else {
+                body = maybeStringifyBody(args.body);
+            }
         }
         else {
-            body = JSON.stringify(args.body);
+            if (args.body instanceof (yield Promise.resolve().then(() => __importStar(require("form-data")))).default) {
+                // @ts-expect-error
+                body = args.body;
+            }
+            else {
+                body = maybeStringifyBody(args.body);
+            }
         }
         // In Node.js environments, the SDK always uses`node-fetch`.
         // If not in Node.js the SDK uses global fetch if available,
@@ -81,20 +99,27 @@ function fetcherImpl(args) {
                 ? fetch
                 : (yield Promise.resolve().then(() => __importStar(require("node-fetch")))).default;
         const makeRequest = () => __awaiter(this, void 0, void 0, function* () {
-            const controller = new AbortController();
-            let abortId = undefined;
+            const signals = [];
+            // Add timeout signal
+            let timeoutAbortId = undefined;
             if (args.timeoutMs != null) {
-                abortId = setTimeout(() => controller.abort(), args.timeoutMs);
+                const { signal, abortId } = getTimeoutSignal(args.timeoutMs);
+                timeoutAbortId = abortId;
+                signals.push(signal);
+            }
+            // Add arbitrary signal
+            if (args.abortSignal != null) {
+                signals.push(args.abortSignal);
             }
             const response = yield fetchFn(url, {
                 method: args.method,
                 headers,
                 body,
-                signal: controller.signal,
+                signal: anySignal(signals),
                 credentials: args.withCredentials ? "include" : undefined,
             });
-            if (abortId != null) {
-                clearTimeout(abortId);
+            if (timeoutAbortId != null) {
+                clearTimeout(timeoutAbortId);
             }
             return response;
         });
@@ -160,7 +185,16 @@ function fetcherImpl(args) {
             }
         }
         catch (error) {
-            if (error instanceof Error && error.name === "AbortError") {
+            if (args.abortSignal != null && args.abortSignal.aborted) {
+                return {
+                    ok: false,
+                    error: {
+                        reason: "unknown",
+                        errorMessage: "The user aborted a request",
+                    },
+                };
+            }
+            else if (error instanceof Error && error.name === "AbortError") {
                 return {
                     ok: false,
                     error: {
@@ -187,4 +221,36 @@ function fetcherImpl(args) {
         }
     });
 }
+const TIMEOUT = "timeout";
+function getTimeoutSignal(timeoutMs) {
+    const controller = new AbortController();
+    const abortId = setTimeout(() => controller.abort(TIMEOUT), timeoutMs);
+    return { signal: controller.signal, abortId };
+}
+/**
+ * Returns an abort signal that is getting aborted when
+ * at least one of the specified abort signals is aborted.
+ *
+ * Requires at least node.js 18.
+ */
+function anySignal(...args) {
+    // Allowing signals to be passed either as array
+    // of signals or as multiple arguments.
+    const signals = (args.length === 1 && Array.isArray(args[0]) ? args[0] : args);
+    const controller = new AbortController();
+    for (const signal of signals) {
+        if (signal.aborted) {
+            // Exiting early if one of the signals
+            // is already aborted.
+            controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason);
+            break;
+        }
+        // Listening for signals and removing the listeners
+        // when at least one symbol is aborted.
+        signal.addEventListener("abort", () => controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason), {
+            signal: controller.signal,
+        });
+    }
+    return controller.signal;
+}
 exports.fetcher = fetcherImpl;

package/dist/Client.d.ts

@@ -15,6 +15,7 @@ export declare namespace ZepClient {
     interface RequestOptions {
         timeoutInSeconds?: number;
         maxRetries?: number;
+        abortSignal?: AbortSignal;
     }
 }
 export declare class ZepClient {

package/dist/api/errors/ConflictError.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as errors from "../../errors/index";
+import * as Zep from "../index";
+export declare class ConflictError extends errors.ZepError {
+    constructor(body: Zep.ApiError);
+}

package/dist/api/errors/ConflictError.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConflictError = void 0;
+const errors = __importStar(require("../../errors/index"));
+class ConflictError extends errors.ZepError {
+    constructor(body) {
+        super({
+            message: "ConflictError",
+            statusCode: 409,
+            body: body,
+        });
+        Object.setPrototypeOf(this, ConflictError.prototype);
+    }
+}
+exports.ConflictError = ConflictError;

package/dist/api/errors/index.d.ts

@@ -2,3 +2,4 @@ export * from "./UnauthorizedError";
 export * from "./InternalServerError";
 export * from "./BadRequestError";
 export * from "./NotFoundError";
+export * from "./ConflictError";

package/dist/api/errors/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./UnauthorizedError"), exports);
 __exportStar(require("./InternalServerError"), exports);
 __exportStar(require("./BadRequestError"), exports);
 __exportStar(require("./NotFoundError"), exports);
+__exportStar(require("./ConflictError"), exports);

package/dist/api/resources/document/client/Client.d.ts

@@ -13,6 +13,7 @@ export declare namespace Document {
     interface RequestOptions {
         timeoutInSeconds?: number;
         maxRetries?: number;
+        abortSignal?: AbortSignal;
     }
 }
 export declare class Document {
@@ -104,7 +105,9 @@ export declare class Document {
      * @throws {@link Zep.InternalServerError}
      *
      * @example
-     *     await zep.document.addDocuments("collectionName", [{}])
+     *     await zep.document.addDocuments("collectionName", [{
+     *             content: "content"
+     *         }])
      */
     addDocuments(collectionName: string, request: Zep.CreateDocumentRequest[], requestOptions?: Document.RequestOptions): Promise<string[]>;
     /**