@openrouter/sdk 0.0.0-beta.7 → 0.0.0-beta.9

package/src/models/message.ts

@@ -11,6 +11,12 @@ import {
   AssistantMessage$Outbound,
   AssistantMessage$outboundSchema,
 } from "./assistantmessage.js";
+import {
+  ChatMessageContentItemText,
+  ChatMessageContentItemText$inboundSchema,
+  ChatMessageContentItemText$Outbound,
+  ChatMessageContentItemText$outboundSchema,
+} from "./chatmessagecontentitemtext.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 import {
   SystemMessage,
@@ -19,11 +25,11 @@ import {
   SystemMessage$outboundSchema,
 } from "./systemmessage.js";
 import {
-  ToolMessage,
-  ToolMessage$inboundSchema,
-  ToolMessage$Outbound,
-  ToolMessage$outboundSchema,
-} from "./toolmessage.js";
+  ToolResponseMessage,
+  ToolResponseMessage$inboundSchema,
+  ToolResponseMessage$Outbound,
+  ToolResponseMessage$outboundSchema,
+} from "./toolresponsemessage.js";
 import {
   UserMessage,
   UserMessage$inboundSchema,
@@ -31,43 +37,150 @@ import {
   UserMessage$outboundSchema,
 } from "./usermessage.js";
 
+export type MessageContent = string | Array<ChatMessageContentItemText>;
+
+export type MessageDeveloper = {
+  role: "developer";
+  content: string | Array<ChatMessageContentItemText>;
+  name?: string | undefined;
+};
+
 export type Message =
-  | (ToolMessage & { role: "tool" })
-  | (SystemMessage & { role: "system" })
-  | (UserMessage & { role: "user" })
-  | (AssistantMessage & { role: "assistant" });
+  | ToolResponseMessage
+  | SystemMessage
+  | UserMessage
+  | MessageDeveloper
+  | AssistantMessage;
+
+/** @internal */
+export const MessageContent$inboundSchema: z.ZodType<
+  MessageContent,
+  z.ZodTypeDef,
+  unknown
+> = z.union([z.string(), z.array(ChatMessageContentItemText$inboundSchema)]);
+
+/** @internal */
+export type MessageContent$Outbound =
+  | string
+  | Array<ChatMessageContentItemText$Outbound>;
+
+/** @internal */
+export const MessageContent$outboundSchema: z.ZodType<
+  MessageContent$Outbound,
+  z.ZodTypeDef,
+  MessageContent
+> = z.union([z.string(), z.array(ChatMessageContentItemText$outboundSchema)]);
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace MessageContent$ {
+  /** @deprecated use `MessageContent$inboundSchema` instead. */
+  export const inboundSchema = MessageContent$inboundSchema;
+  /** @deprecated use `MessageContent$outboundSchema` instead. */
+  export const outboundSchema = MessageContent$outboundSchema;
+  /** @deprecated use `MessageContent$Outbound` instead. */
+  export type Outbound = MessageContent$Outbound;
+}
+
+export function messageContentToJSON(messageContent: MessageContent): string {
+  return JSON.stringify(MessageContent$outboundSchema.parse(messageContent));
+}
+
+export function messageContentFromJSON(
+  jsonString: string,
+): SafeParseResult<MessageContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => MessageContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'MessageContent' from JSON`,
+  );
+}
+
+/** @internal */
+export const MessageDeveloper$inboundSchema: z.ZodType<
+  MessageDeveloper,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  role: z.literal("developer"),
+  content: z.union([
+    z.string(),
+    z.array(ChatMessageContentItemText$inboundSchema),
+  ]),
+  name: z.string().optional(),
+});
+
+/** @internal */
+export type MessageDeveloper$Outbound = {
+  role: "developer";
+  content: string | Array<ChatMessageContentItemText$Outbound>;
+  name?: string | undefined;
+};
+
+/** @internal */
+export const MessageDeveloper$outboundSchema: z.ZodType<
+  MessageDeveloper$Outbound,
+  z.ZodTypeDef,
+  MessageDeveloper
+> = z.object({
+  role: z.literal("developer"),
+  content: z.union([
+    z.string(),
+    z.array(ChatMessageContentItemText$outboundSchema),
+  ]),
+  name: z.string().optional(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace MessageDeveloper$ {
+  /** @deprecated use `MessageDeveloper$inboundSchema` instead. */
+  export const inboundSchema = MessageDeveloper$inboundSchema;
+  /** @deprecated use `MessageDeveloper$outboundSchema` instead. */
+  export const outboundSchema = MessageDeveloper$outboundSchema;
+  /** @deprecated use `MessageDeveloper$Outbound` instead. */
+  export type Outbound = MessageDeveloper$Outbound;
+}
+
+export function messageDeveloperToJSON(
+  messageDeveloper: MessageDeveloper,
+): string {
+  return JSON.stringify(
+    MessageDeveloper$outboundSchema.parse(messageDeveloper),
+  );
+}
+
+export function messageDeveloperFromJSON(
+  jsonString: string,
+): SafeParseResult<MessageDeveloper, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => MessageDeveloper$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'MessageDeveloper' from JSON`,
+  );
+}
 
 /** @internal */
 export const Message$inboundSchema: z.ZodType<Message, z.ZodTypeDef, unknown> =
   z.union([
-    ToolMessage$inboundSchema.and(
-      z.object({ role: z.literal("tool") }).transform((v) => ({
-        role: v.role,
-      })),
-    ),
-    SystemMessage$inboundSchema.and(
-      z.object({ role: z.literal("system") }).transform((v) => ({
-        role: v.role,
-      })),
-    ),
-    UserMessage$inboundSchema.and(
-      z.object({ role: z.literal("user") }).transform((v) => ({
-        role: v.role,
-      })),
-    ),
-    AssistantMessage$inboundSchema.and(
-      z.object({ role: z.literal("assistant") }).transform((v) => ({
-        role: v.role,
-      })),
-    ),
+    ToolResponseMessage$inboundSchema,
+    SystemMessage$inboundSchema,
+    UserMessage$inboundSchema,
+    z.lazy(() => MessageDeveloper$inboundSchema),
+    AssistantMessage$inboundSchema,
   ]);
 
 /** @internal */
 export type Message$Outbound =
-  | (ToolMessage$Outbound & { role: "tool" })
-  | (SystemMessage$Outbound & { role: "system" })
-  | (UserMessage$Outbound & { role: "user" })
-  | (AssistantMessage$Outbound & { role: "assistant" });
+  | ToolResponseMessage$Outbound
+  | SystemMessage$Outbound
+  | UserMessage$Outbound
+  | MessageDeveloper$Outbound
+  | AssistantMessage$Outbound;
 
 /** @internal */
 export const Message$outboundSchema: z.ZodType<
@@ -75,22 +188,11 @@ export const Message$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   Message
 > = z.union([
-  ToolMessage$outboundSchema.and(
-    z.object({ role: z.literal("tool") }).transform((v) => ({ role: v.role })),
-  ),
-  SystemMessage$outboundSchema.and(
-    z.object({ role: z.literal("system") }).transform((v) => ({
-      role: v.role,
-    })),
-  ),
-  UserMessage$outboundSchema.and(
-    z.object({ role: z.literal("user") }).transform((v) => ({ role: v.role })),
-  ),
-  AssistantMessage$outboundSchema.and(
-    z.object({ role: z.literal("assistant") }).transform((v) => ({
-      role: v.role,
-    })),
-  ),
+  ToolResponseMessage$outboundSchema,
+  SystemMessage$outboundSchema,
+  UserMessage$outboundSchema,
+  z.lazy(() => MessageDeveloper$outboundSchema),
+  AssistantMessage$outboundSchema,
 ]);
 
 /**

package/src/models/operations/deletekeyshash.ts

@@ -6,7 +6,6 @@ import * as z from "zod";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-import * as models from "../index.js";
 
 export type DeleteKeysHashRequest = {
   hash: string;
@@ -15,17 +14,13 @@ export type DeleteKeysHashRequest = {
 /**
  * API key deleted successfully
  */
-export type DeleteKeysHashResponseBody = {
+export type DeleteKeysHashResponse = {
   /**
    * Confirmation that the API key was deleted
    */
   deleted: boolean;
 };
 
-export type DeleteKeysHashResponse =
-  | DeleteKeysHashResponseBody
-  | models.ErrorResponse;
-
 /** @internal */
 export const DeleteKeysHashRequest$inboundSchema: z.ZodType<
   DeleteKeysHashRequest,
@@ -81,8 +76,8 @@ export function deleteKeysHashRequestFromJSON(
 }
 
 /** @internal */
-export const DeleteKeysHashResponseBody$inboundSchema: z.ZodType<
-  DeleteKeysHashResponseBody,
+export const DeleteKeysHashResponse$inboundSchema: z.ZodType<
+  DeleteKeysHashResponse,
   z.ZodTypeDef,
   unknown
 > = z.object({
@@ -90,74 +85,18 @@ export const DeleteKeysHashResponseBody$inboundSchema: z.ZodType<
 });
 
 /** @internal */
-export type DeleteKeysHashResponseBody$Outbound = {
+export type DeleteKeysHashResponse$Outbound = {
   deleted: boolean;
 };
 
-/** @internal */
-export const DeleteKeysHashResponseBody$outboundSchema: z.ZodType<
-  DeleteKeysHashResponseBody$Outbound,
-  z.ZodTypeDef,
-  DeleteKeysHashResponseBody
-> = z.object({
-  deleted: z.boolean(),
-});
-
-/**
- * @internal
- * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
- */
-export namespace DeleteKeysHashResponseBody$ {
-  /** @deprecated use `DeleteKeysHashResponseBody$inboundSchema` instead. */
-  export const inboundSchema = DeleteKeysHashResponseBody$inboundSchema;
-  /** @deprecated use `DeleteKeysHashResponseBody$outboundSchema` instead. */
-  export const outboundSchema = DeleteKeysHashResponseBody$outboundSchema;
-  /** @deprecated use `DeleteKeysHashResponseBody$Outbound` instead. */
-  export type Outbound = DeleteKeysHashResponseBody$Outbound;
-}
-
-export function deleteKeysHashResponseBodyToJSON(
-  deleteKeysHashResponseBody: DeleteKeysHashResponseBody,
-): string {
-  return JSON.stringify(
-    DeleteKeysHashResponseBody$outboundSchema.parse(deleteKeysHashResponseBody),
-  );
-}
-
-export function deleteKeysHashResponseBodyFromJSON(
-  jsonString: string,
-): SafeParseResult<DeleteKeysHashResponseBody, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => DeleteKeysHashResponseBody$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'DeleteKeysHashResponseBody' from JSON`,
-  );
-}
-
-/** @internal */
-export const DeleteKeysHashResponse$inboundSchema: z.ZodType<
-  DeleteKeysHashResponse,
-  z.ZodTypeDef,
-  unknown
-> = z.union([
-  z.lazy(() => DeleteKeysHashResponseBody$inboundSchema),
-  models.ErrorResponse$inboundSchema,
-]);
-
-/** @internal */
-export type DeleteKeysHashResponse$Outbound =
-  | DeleteKeysHashResponseBody$Outbound
-  | models.ErrorResponse$Outbound;
-
 /** @internal */
 export const DeleteKeysHashResponse$outboundSchema: z.ZodType<
   DeleteKeysHashResponse$Outbound,
   z.ZodTypeDef,
   DeleteKeysHashResponse
-> = z.union([
-  z.lazy(() => DeleteKeysHashResponseBody$outboundSchema),
-  models.ErrorResponse$outboundSchema,
-]);
+> = z.object({
+  deleted: z.boolean(),
+});
 
 /**
  * @internal

package/src/models/operations/getactivity.ts

@@ -15,17 +15,13 @@ export type GetActivityRequest = {
 /**
  * Returns user activity data grouped by endpoint
  */
-export type GetActivityResponseBody = {
+export type GetActivityResponse = {
   /**
    * List of activity items
    */
   data: Array<models.ActivityItem>;
 };
 
-export type GetActivityResponse =
-  | GetActivityResponseBody
-  | models.ErrorResponse;
-
 /** @internal */
 export const GetActivityRequest$inboundSchema: z.ZodType<
   GetActivityRequest,
@@ -81,8 +77,8 @@ export function getActivityRequestFromJSON(
 }
 
 /** @internal */
-export const GetActivityResponseBody$inboundSchema: z.ZodType<
-  GetActivityResponseBody,
+export const GetActivityResponse$inboundSchema: z.ZodType<
+  GetActivityResponse,
   z.ZodTypeDef,
   unknown
 > = z.object({
@@ -90,74 +86,18 @@ export const GetActivityResponseBody$inboundSchema: z.ZodType<
 });
 
 /** @internal */
-export type GetActivityResponseBody$Outbound = {
+export type GetActivityResponse$Outbound = {
   data: Array<models.ActivityItem$Outbound>;
 };
 
-/** @internal */
-export const GetActivityResponseBody$outboundSchema: z.ZodType<
-  GetActivityResponseBody$Outbound,
-  z.ZodTypeDef,
-  GetActivityResponseBody
-> = z.object({
-  data: z.array(models.ActivityItem$outboundSchema),
-});
-
-/**
- * @internal
- * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
- */
-export namespace GetActivityResponseBody$ {
-  /** @deprecated use `GetActivityResponseBody$inboundSchema` instead. */
-  export const inboundSchema = GetActivityResponseBody$inboundSchema;
-  /** @deprecated use `GetActivityResponseBody$outboundSchema` instead. */
-  export const outboundSchema = GetActivityResponseBody$outboundSchema;
-  /** @deprecated use `GetActivityResponseBody$Outbound` instead. */
-  export type Outbound = GetActivityResponseBody$Outbound;
-}
-
-export function getActivityResponseBodyToJSON(
-  getActivityResponseBody: GetActivityResponseBody,
-): string {
-  return JSON.stringify(
-    GetActivityResponseBody$outboundSchema.parse(getActivityResponseBody),
-  );
-}
-
-export function getActivityResponseBodyFromJSON(
-  jsonString: string,
-): SafeParseResult<GetActivityResponseBody, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => GetActivityResponseBody$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'GetActivityResponseBody' from JSON`,
-  );
-}
-
-/** @internal */
-export const GetActivityResponse$inboundSchema: z.ZodType<
-  GetActivityResponse,
-  z.ZodTypeDef,
-  unknown
-> = z.union([
-  z.lazy(() => GetActivityResponseBody$inboundSchema),
-  models.ErrorResponse$inboundSchema,
-]);
-
-/** @internal */
-export type GetActivityResponse$Outbound =
-  | GetActivityResponseBody$Outbound
-  | models.ErrorResponse$Outbound;
-
 /** @internal */
 export const GetActivityResponse$outboundSchema: z.ZodType<
   GetActivityResponse$Outbound,
   z.ZodTypeDef,
   GetActivityResponse
-> = z.union([
-  z.lazy(() => GetActivityResponseBody$outboundSchema),
-  models.ErrorResponse$outboundSchema,
-]);
+> = z.object({
+  data: z.array(models.ActivityItem$outboundSchema),
+});
 
 /**
  * @internal

package/src/models/operations/getauthkey.ts

@@ -7,7 +7,6 @@ import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-import * as models from "../index.js";
 
 /**
  * Legacy rate limit information about a key. Will always return -1.
@@ -68,15 +67,13 @@ export type GetAuthKeyData = {
 /**
  * API key details
  */
-export type GetAuthKeyResponseBody = {
+export type GetAuthKeyResponse = {
   /**
    * Current API key information
    */
   data: GetAuthKeyData;
 };
 
-export type GetAuthKeyResponse = GetAuthKeyResponseBody | models.ErrorResponse;
-
 /** @internal */
 export const GetAuthKeyRateLimit$inboundSchema: z.ZodType<
   GetAuthKeyRateLimit,
@@ -220,8 +217,8 @@ export function getAuthKeyDataFromJSON(
 }
 
 /** @internal */
-export const GetAuthKeyResponseBody$inboundSchema: z.ZodType<
-  GetAuthKeyResponseBody,
+export const GetAuthKeyResponse$inboundSchema: z.ZodType<
+  GetAuthKeyResponse,
   z.ZodTypeDef,
   unknown
 > = z.object({
@@ -229,74 +226,18 @@ export const GetAuthKeyResponseBody$inboundSchema: z.ZodType<
 });
 
 /** @internal */
-export type GetAuthKeyResponseBody$Outbound = {
+export type GetAuthKeyResponse$Outbound = {
   data: GetAuthKeyData$Outbound;
 };
 
-/** @internal */
-export const GetAuthKeyResponseBody$outboundSchema: z.ZodType<
-  GetAuthKeyResponseBody$Outbound,
-  z.ZodTypeDef,
-  GetAuthKeyResponseBody
-> = z.object({
-  data: z.lazy(() => GetAuthKeyData$outboundSchema),
-});
-
-/**
- * @internal
- * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
- */
-export namespace GetAuthKeyResponseBody$ {
-  /** @deprecated use `GetAuthKeyResponseBody$inboundSchema` instead. */
-  export const inboundSchema = GetAuthKeyResponseBody$inboundSchema;
-  /** @deprecated use `GetAuthKeyResponseBody$outboundSchema` instead. */
-  export const outboundSchema = GetAuthKeyResponseBody$outboundSchema;
-  /** @deprecated use `GetAuthKeyResponseBody$Outbound` instead. */
-  export type Outbound = GetAuthKeyResponseBody$Outbound;
-}
-
-export function getAuthKeyResponseBodyToJSON(
-  getAuthKeyResponseBody: GetAuthKeyResponseBody,
-): string {
-  return JSON.stringify(
-    GetAuthKeyResponseBody$outboundSchema.parse(getAuthKeyResponseBody),
-  );
-}
-
-export function getAuthKeyResponseBodyFromJSON(
-  jsonString: string,
-): SafeParseResult<GetAuthKeyResponseBody, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => GetAuthKeyResponseBody$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'GetAuthKeyResponseBody' from JSON`,
-  );
-}
-
-/** @internal */
-export const GetAuthKeyResponse$inboundSchema: z.ZodType<
-  GetAuthKeyResponse,
-  z.ZodTypeDef,
-  unknown
-> = z.union([
-  z.lazy(() => GetAuthKeyResponseBody$inboundSchema),
-  models.ErrorResponse$inboundSchema,
-]);
-
-/** @internal */
-export type GetAuthKeyResponse$Outbound =
-  | GetAuthKeyResponseBody$Outbound
-  | models.ErrorResponse$Outbound;
-
 /** @internal */
 export const GetAuthKeyResponse$outboundSchema: z.ZodType<
   GetAuthKeyResponse$Outbound,
   z.ZodTypeDef,
   GetAuthKeyResponse
-> = z.union([
-  z.lazy(() => GetAuthKeyResponseBody$outboundSchema),
-  models.ErrorResponse$outboundSchema,
-]);
+> = z.object({
+  data: z.lazy(() => GetAuthKeyData$outboundSchema),
+});
 
 /**
  * @internal

package/src/models/operations/getcredits.ts

@@ -7,7 +7,6 @@ import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-import * as models from "../index.js";
 
 export type GetCreditsData = {
   totalCredits: number;
@@ -17,12 +16,10 @@ export type GetCreditsData = {
 /**
  * Returns the total credits purchased and used
  */
-export type GetCreditsResponseBody = {
+export type GetCreditsResponse = {
   data: GetCreditsData;
 };
 
-export type GetCreditsResponse = GetCreditsResponseBody | models.ErrorResponse;
-
 /** @internal */
 export const GetCreditsData$inboundSchema: z.ZodType<
   GetCreditsData,
@@ -87,8 +84,8 @@ export function getCreditsDataFromJSON(
 }
 
 /** @internal */
-export const GetCreditsResponseBody$inboundSchema: z.ZodType<
-  GetCreditsResponseBody,
+export const GetCreditsResponse$inboundSchema: z.ZodType<
+  GetCreditsResponse,
   z.ZodTypeDef,
   unknown
 > = z.object({
@@ -96,74 +93,18 @@ export const GetCreditsResponseBody$inboundSchema: z.ZodType<
 });
 
 /** @internal */
-export type GetCreditsResponseBody$Outbound = {
+export type GetCreditsResponse$Outbound = {
   data: GetCreditsData$Outbound;
 };
 
-/** @internal */
-export const GetCreditsResponseBody$outboundSchema: z.ZodType<
-  GetCreditsResponseBody$Outbound,
-  z.ZodTypeDef,
-  GetCreditsResponseBody
-> = z.object({
-  data: z.lazy(() => GetCreditsData$outboundSchema),
-});
-
-/**
- * @internal
- * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
- */
-export namespace GetCreditsResponseBody$ {
-  /** @deprecated use `GetCreditsResponseBody$inboundSchema` instead. */
-  export const inboundSchema = GetCreditsResponseBody$inboundSchema;
-  /** @deprecated use `GetCreditsResponseBody$outboundSchema` instead. */
-  export const outboundSchema = GetCreditsResponseBody$outboundSchema;
-  /** @deprecated use `GetCreditsResponseBody$Outbound` instead. */
-  export type Outbound = GetCreditsResponseBody$Outbound;
-}
-
-export function getCreditsResponseBodyToJSON(
-  getCreditsResponseBody: GetCreditsResponseBody,
-): string {
-  return JSON.stringify(
-    GetCreditsResponseBody$outboundSchema.parse(getCreditsResponseBody),
-  );
-}
-
-export function getCreditsResponseBodyFromJSON(
-  jsonString: string,
-): SafeParseResult<GetCreditsResponseBody, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => GetCreditsResponseBody$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'GetCreditsResponseBody' from JSON`,
-  );
-}
-
-/** @internal */
-export const GetCreditsResponse$inboundSchema: z.ZodType<
-  GetCreditsResponse,
-  z.ZodTypeDef,
-  unknown
-> = z.union([
-  z.lazy(() => GetCreditsResponseBody$inboundSchema),
-  models.ErrorResponse$inboundSchema,
-]);
-
-/** @internal */
-export type GetCreditsResponse$Outbound =
-  | GetCreditsResponseBody$Outbound
-  | models.ErrorResponse$Outbound;
-
 /** @internal */
 export const GetCreditsResponse$outboundSchema: z.ZodType<
   GetCreditsResponse$Outbound,
   z.ZodTypeDef,
   GetCreditsResponse
-> = z.union([
-  z.lazy(() => GetCreditsResponseBody$outboundSchema),
-  models.ErrorResponse$outboundSchema,
-]);
+> = z.object({
+  data: z.lazy(() => GetCreditsData$outboundSchema),
+});
 
 /**
  * @internal