@forklaunch/core 1.5.2 → 1.5.4

package/lib/ws/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/ws/asyncApiV3Generator/asyncApiV3Generator.ts","../../src/ws/webSocketLike.ts"],"sourcesContent":["import type {\n  AsyncAPIObject,\n  ChannelObject,\n  ChannelsObject,\n  MessageObject,\n  MessagesObject,\n  OperationObject,\n  OperationsObject,\n  ReferenceObject\n} from '@asyncapi/parser/esm/spec-types/v3';\n\nimport type { AnySchemaValidator } from '@forklaunch/validator';\n\nimport { EventSchema, EventSchemaEntry } from '../types/eventSchema.types';\n\nexport type AsyncApiDocument = AsyncAPIObject;\n\nexport function generateAsyncApi<SV extends AnySchemaValidator>(\n  eventSchemas: EventSchema<SV>,\n  options?: {\n    title?: string;\n    version?: string;\n    description?: string;\n    id?: AsyncApiDocument['id'];\n    defaultContentType?: AsyncApiDocument['defaultContentType'];\n  }\n): AsyncApiDocument {\n  const channels: ChannelsObject = {};\n\n  const appendMessageToChannel = (\n    collection?: Record<string, EventSchemaEntry<SV>>\n  ) => {\n    if (!collection) {\n      return;\n    }\n\n    Object.entries(collection).forEach(([messageKey, candidate]) => {\n      if (\n        !candidate ||\n        typeof candidate !== 'object' ||\n        Array.isArray(candidate) ||\n        !('shape' in candidate)\n      ) {\n        return;\n      }\n\n      const entry = candidate as EventSchemaEntry<SV>;\n      const schema = entry.shape;\n\n      // Determine which channels to use\n      const channelNames: string[] = entry.channel\n        ? [entry.channel]\n        : entry.channels && entry.channels.length > 0\n          ? entry.channels\n          : [messageKey];\n\n      const messageName =\n        entry.operation ?? entry.operations?.[0] ?? messageKey;\n\n      // Add message to all specified channels\n      channelNames.forEach((channelName) => {\n        const existingChannel = channels[channelName];\n        if (!existingChannel || '$ref' in existingChannel) {\n          channels[channelName] = {\n            address: channelName,\n            messages: {}\n          };\n        }\n\n        const channelEntry = channels[channelName] as ChannelObject;\n        channelEntry.messages = (channelEntry.messages ?? {}) as MessagesObject;\n        const messages = channelEntry.messages as MessagesObject;\n\n        const message: MessageObject = {\n          name: messageName,\n          payload: schema\n        };\n\n        messages[messageName] = message;\n      });\n    });\n  };\n\n  appendMessageToChannel(eventSchemas.clientMessages);\n  appendMessageToChannel(eventSchemas.serverMessages);\n  appendMessageToChannel(eventSchemas.errors);\n\n  const operations: OperationsObject = {};\n\n  const addOperationsForCollection = (\n    collection: Record<string, EventSchemaEntry<SV>> | undefined,\n    action: 'send' | 'receive'\n  ) => {\n    if (!collection) {\n      return;\n    }\n\n    Object.entries(collection).forEach(([messageKey, candidate]) => {\n      if (\n        !candidate ||\n        typeof candidate !== 'object' ||\n        Array.isArray(candidate) ||\n        !('shape' in candidate)\n      ) {\n        return;\n      }\n\n      const entry = candidate as EventSchemaEntry<SV>;\n\n      // Determine which channels to use\n      const channelNames: string[] = entry.channel\n        ? [entry.channel]\n        : entry.channels && entry.channels.length > 0\n          ? entry.channels\n          : [messageKey];\n\n      const messageName =\n        entry.operation ?? entry.operations?.[0] ?? messageKey;\n\n      // Create operations for all specified channels\n      channelNames.forEach((channelName) => {\n        const operationKey = `${action}-${channelName}-${messageName}`;\n\n        const operation: OperationObject = {\n          action,\n          channel: {\n            $ref: `#/channels/${channelName}`\n          } as ReferenceObject,\n          messages: [\n            {\n              $ref: `#/channels/${channelName}/messages/${messageName}`\n            } as ReferenceObject\n          ]\n        };\n\n        operations[operationKey] = operation;\n      });\n    });\n  };\n\n  addOperationsForCollection(eventSchemas.clientMessages, 'receive');\n  addOperationsForCollection(eventSchemas.serverMessages, 'send');\n\n  const { title, version, description } = options ?? {};\n\n  const asyncApiDocument: AsyncApiDocument = {\n    asyncapi: '3.0.0',\n    info: {\n      title: title || process.env.API_TITLE || 'Forklaunch WebSocket API',\n      version: version || '1.0.0',\n      ...(description ? { description } : {})\n    },\n    ...(options?.id ? { id: options.id } : {}),\n    ...(options?.defaultContentType\n      ? { defaultContentType: options.defaultContentType }\n      : {}),\n    ...(Object.keys(channels).length > 0 ? { channels } : {}),\n    ...(Object.keys(operations).length > 0 ? { operations } : {})\n  };\n\n  return asyncApiDocument;\n}\n","import {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  prettyPrintParseErrors,\n  SchemaValidator\n} from '@forklaunch/validator';\n\nimport { EventSchema, EventSchemaEntry } from './types/eventSchema.types';\n\ntype SchemaRecord<SV extends AnySchemaValidator> =\n  | Record<string, EventSchemaEntry<SV>>\n  | undefined;\n\nexport function buildUnionSchema<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  record: SchemaRecord<SV>\n): IdiomaticSchema<SV> | undefined {\n  if (!record) {\n    return undefined;\n  }\n\n  const schemas = Object.values(record)\n    .filter((entry): entry is EventSchemaEntry<SV> => Boolean(entry))\n    .map((entry) => entry.shape);\n\n  if (schemas.length === 0) {\n    return undefined;\n  }\n\n  if (schemas.length === 1) {\n    return schemas[0];\n  }\n\n  return schemaValidator.union(schemas) as IdiomaticSchema<SV>;\n}\n\nexport function parseSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  value: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  if (!schema) {\n    return value;\n  }\n\n  const result = schemaValidator.parse(schema, value);\n  if (result.ok) {\n    return result.value;\n  }\n\n  const errors = 'errors' in result ? result.errors || [] : [];\n  throw new Error(prettyPrintParseErrors(errors, context));\n}\n\nexport function encodeSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  value: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  const validated = parseSchemaValue(schemaValidator, value, schema, context);\n\n  if (\n    Buffer.isBuffer(validated) ||\n    validated instanceof ArrayBuffer ||\n    ArrayBuffer.isView(validated)\n  ) {\n    if (Buffer.isBuffer(validated)) {\n      return validated;\n    }\n\n    if (validated instanceof ArrayBuffer) {\n      return Buffer.from(validated);\n    }\n\n    const view = validated as {\n      buffer: ArrayBuffer;\n      byteOffset: number;\n      byteLength: number;\n    };\n    const typed = new Uint8Array(view.buffer, view.byteOffset, view.byteLength);\n    return Buffer.from(typed);\n  }\n\n  if (typeof validated === 'string') {\n    return Buffer.from(validated, 'utf-8');\n  }\n\n  if (validated === null || validated === undefined) {\n    return validated;\n  }\n\n  return Buffer.from(JSON.stringify(validated), 'utf-8');\n}\n\nexport function decodeSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  data: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  let decoded: string;\n  let parsed: unknown;\n\n  if (Buffer.isBuffer(data)) {\n    decoded = data.toString('utf-8');\n  } else if (data instanceof ArrayBuffer) {\n    decoded = Buffer.from(data).toString('utf-8');\n  } else if (ArrayBuffer.isView(data)) {\n    const view = data as {\n      buffer: ArrayBuffer;\n      byteOffset: number;\n      byteLength: number;\n    };\n    decoded = Buffer.from(\n      view.buffer,\n      view.byteOffset,\n      view.byteLength\n    ).toString('utf-8');\n  } else if (typeof data === 'string') {\n    decoded = data;\n  } else {\n    parsed = data;\n    return parseSchemaValue(schemaValidator, parsed, schema, context);\n  }\n\n  try {\n    parsed = JSON.parse(decoded);\n  } catch {\n    parsed = decoded;\n  }\n\n  return parseSchemaValue(schemaValidator, parsed, schema, context);\n}\n\nexport function normalizeEncodedValue(\n  encoded: unknown,\n  context: string,\n  allowUndefined = false\n): Buffer | undefined {\n  if (encoded === null || encoded === undefined) {\n    if (allowUndefined) {\n      return undefined;\n    }\n    throw new Error(`Invalid ${context}`);\n  }\n\n  if (Buffer.isBuffer(encoded)) {\n    return encoded;\n  }\n\n  if (encoded instanceof ArrayBuffer) {\n    return Buffer.from(encoded);\n  }\n\n  if (ArrayBuffer.isView(encoded)) {\n    const view = encoded as ArrayBufferView;\n    return Buffer.from(view.buffer, view.byteOffset, view.byteLength);\n  }\n\n  if (typeof encoded === 'string') {\n    return Buffer.from(encoded, 'utf-8');\n  }\n\n  if (\n    typeof encoded === 'number' ||\n    typeof encoded === 'boolean' ||\n    typeof encoded === 'bigint'\n  ) {\n    return Buffer.from(JSON.stringify(encoded), 'utf-8');\n  }\n\n  if (typeof encoded === 'object') {\n    return Buffer.from(JSON.stringify(encoded), 'utf-8');\n  }\n\n  throw new Error(`Unsupported payload type for ${context}`);\n}\n\nexport function createWebSocketSchemas<\n  SV extends AnySchemaValidator,\n  ES extends EventSchema<SV>\n>(schemaValidator: SchemaValidator, eventSchemas: ES) {\n  const clientMessagesSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.clientMessages\n  );\n  const serverMessagesSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.serverMessages\n  );\n  const errorsSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.errors\n  );\n  const pingSchema = eventSchemas.ping?.shape;\n  const pongSchema = eventSchemas.pong?.shape;\n  const closeReasonSchema = eventSchemas.closeReason\n    ? buildUnionSchema<SV>(schemaValidator, eventSchemas.closeReason)\n    : undefined;\n\n  return {\n    clientMessagesSchema,\n    serverMessagesSchema,\n    errorsSchema,\n    pingSchema,\n    pongSchema,\n    closeReasonSchema\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/ws/asyncApiV3Generator/asyncApiV3Generator.ts","../../src/ws/webSocketLike.ts"],"sourcesContent":["import type {\n  AsyncAPIObject,\n  ChannelObject,\n  ChannelsObject,\n  MessageObject,\n  MessagesObject,\n  OperationObject,\n  OperationsObject,\n  ReferenceObject\n} from '@asyncapi/parser/esm/spec-types/v3';\n\nimport type { AnySchemaValidator } from '@forklaunch/validator';\n\nimport { EventSchema, EventSchemaEntry } from '../types/eventSchema.types';\n\nexport type AsyncApiDocument = AsyncAPIObject;\n\nexport function generateAsyncApi<SV extends AnySchemaValidator>(\n  eventSchemas: EventSchema<SV>,\n  options?: {\n    title?: string;\n    version?: string;\n    description?: string;\n    id?: AsyncApiDocument['id'];\n    defaultContentType?: AsyncApiDocument['defaultContentType'];\n  }\n): AsyncApiDocument {\n  const channels: ChannelsObject = {};\n\n  const appendMessageToChannel = (\n    collection?: Record<string, EventSchemaEntry<SV>>\n  ) => {\n    if (!collection) {\n      return;\n    }\n\n    Object.entries(collection).forEach(([messageKey, candidate]) => {\n      if (\n        !candidate ||\n        typeof candidate !== 'object' ||\n        Array.isArray(candidate) ||\n        !('shape' in candidate)\n      ) {\n        return;\n      }\n\n      const entry = candidate as EventSchemaEntry<SV>;\n      const schema = entry.shape;\n\n      // Determine which channels to use\n      const channelNames: string[] = entry.channel\n        ? [entry.channel]\n        : entry.channels && entry.channels.length > 0\n          ? entry.channels\n          : [messageKey];\n\n      const messageName =\n        entry.operation ?? entry.operations?.[0] ?? messageKey;\n\n      // Add message to all specified channels\n      channelNames.forEach((channelName) => {\n        const existingChannel = channels[channelName];\n        if (!existingChannel || '$ref' in existingChannel) {\n          channels[channelName] = {\n            address: channelName,\n            messages: {}\n          };\n        }\n\n        const channelEntry = channels[channelName] as ChannelObject;\n        channelEntry.messages = (channelEntry.messages ?? {}) as MessagesObject;\n        const messages = channelEntry.messages as MessagesObject;\n\n        const message: MessageObject = {\n          name: messageName,\n          payload: schema\n        };\n\n        messages[messageName] = message;\n      });\n    });\n  };\n\n  appendMessageToChannel(eventSchemas.clientMessages);\n  appendMessageToChannel(eventSchemas.serverMessages);\n  appendMessageToChannel(eventSchemas.errors);\n\n  const operations: OperationsObject = {};\n\n  const addOperationsForCollection = (\n    collection: Record<string, EventSchemaEntry<SV>> | undefined,\n    action: 'send' | 'receive'\n  ) => {\n    if (!collection) {\n      return;\n    }\n\n    Object.entries(collection).forEach(([messageKey, candidate]) => {\n      if (\n        !candidate ||\n        typeof candidate !== 'object' ||\n        Array.isArray(candidate) ||\n        !('shape' in candidate)\n      ) {\n        return;\n      }\n\n      const entry = candidate as EventSchemaEntry<SV>;\n\n      // Determine which channels to use\n      const channelNames: string[] = entry.channel\n        ? [entry.channel]\n        : entry.channels && entry.channels.length > 0\n          ? entry.channels\n          : [messageKey];\n\n      const messageName =\n        entry.operation ?? entry.operations?.[0] ?? messageKey;\n\n      // Create operations for all specified channels\n      channelNames.forEach((channelName) => {\n        const operationKey = `${action}-${channelName}-${messageName}`;\n\n        const operation: OperationObject = {\n          action,\n          channel: {\n            $ref: `#/channels/${channelName}`\n          } as ReferenceObject,\n          messages: [\n            {\n              $ref: `#/channels/${channelName}/messages/${messageName}`\n            } as ReferenceObject\n          ]\n        };\n\n        operations[operationKey] = operation;\n      });\n    });\n  };\n\n  addOperationsForCollection(eventSchemas.clientMessages, 'receive');\n  addOperationsForCollection(eventSchemas.serverMessages, 'send');\n\n  const { title, version, description } = options ?? {};\n\n  const asyncApiDocument: AsyncApiDocument = {\n    asyncapi: '3.0.0',\n    info: {\n      title: title || process.env.API_TITLE || 'Forklaunch WebSocket API',\n      version: version || '1.0.0',\n      ...(description ? { description } : {})\n    },\n    ...(options?.id ? { id: options.id } : {}),\n    ...(options?.defaultContentType\n      ? { defaultContentType: options.defaultContentType }\n      : {}),\n    ...(Object.keys(channels).length > 0 ? { channels } : {}),\n    ...(Object.keys(operations).length > 0 ? { operations } : {})\n  };\n\n  return asyncApiDocument;\n}\n","import {\n  AnySchemaValidator,\n  IdiomaticSchema,\n  prettyPrintParseErrors,\n  SchemaValidator\n} from '@forklaunch/validator';\n\nimport { EventSchema, EventSchemaEntry } from './types/eventSchema.types';\n\ntype SchemaRecord<SV extends AnySchemaValidator> =\n  Record<string, EventSchemaEntry<SV>> | undefined;\n\nexport function buildUnionSchema<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  record: SchemaRecord<SV>\n): IdiomaticSchema<SV> | undefined {\n  if (!record) {\n    return undefined;\n  }\n\n  const schemas = Object.values(record)\n    .filter((entry): entry is EventSchemaEntry<SV> => Boolean(entry))\n    .map((entry) => entry.shape);\n\n  if (schemas.length === 0) {\n    return undefined;\n  }\n\n  if (schemas.length === 1) {\n    return schemas[0];\n  }\n\n  return schemaValidator.union(schemas) as IdiomaticSchema<SV>;\n}\n\nexport function parseSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  value: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  if (!schema) {\n    return value;\n  }\n\n  const result = schemaValidator.parse(schema, value);\n  if (result.ok) {\n    return result.value;\n  }\n\n  const errors = 'errors' in result ? result.errors || [] : [];\n  throw new Error(prettyPrintParseErrors(errors, context));\n}\n\nexport function encodeSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  value: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  const validated = parseSchemaValue(schemaValidator, value, schema, context);\n\n  if (\n    Buffer.isBuffer(validated) ||\n    validated instanceof ArrayBuffer ||\n    ArrayBuffer.isView(validated)\n  ) {\n    if (Buffer.isBuffer(validated)) {\n      return validated;\n    }\n\n    if (validated instanceof ArrayBuffer) {\n      return Buffer.from(validated);\n    }\n\n    const view = validated as {\n      buffer: ArrayBuffer;\n      byteOffset: number;\n      byteLength: number;\n    };\n    const typed = new Uint8Array(view.buffer, view.byteOffset, view.byteLength);\n    return Buffer.from(typed);\n  }\n\n  if (typeof validated === 'string') {\n    return Buffer.from(validated, 'utf-8');\n  }\n\n  if (validated === null || validated === undefined) {\n    return validated;\n  }\n\n  return Buffer.from(JSON.stringify(validated), 'utf-8');\n}\n\nexport function decodeSchemaValue<SV extends AnySchemaValidator>(\n  schemaValidator: SchemaValidator,\n  data: unknown,\n  schema: IdiomaticSchema<SV> | undefined,\n  context: string\n): unknown {\n  let decoded: string;\n  let parsed: unknown;\n\n  if (Buffer.isBuffer(data)) {\n    decoded = data.toString('utf-8');\n  } else if (data instanceof ArrayBuffer) {\n    decoded = Buffer.from(data).toString('utf-8');\n  } else if (ArrayBuffer.isView(data)) {\n    const view = data as {\n      buffer: ArrayBuffer;\n      byteOffset: number;\n      byteLength: number;\n    };\n    decoded = Buffer.from(\n      view.buffer,\n      view.byteOffset,\n      view.byteLength\n    ).toString('utf-8');\n  } else if (typeof data === 'string') {\n    decoded = data;\n  } else {\n    parsed = data;\n    return parseSchemaValue(schemaValidator, parsed, schema, context);\n  }\n\n  try {\n    parsed = JSON.parse(decoded);\n  } catch {\n    parsed = decoded;\n  }\n\n  return parseSchemaValue(schemaValidator, parsed, schema, context);\n}\n\nexport function normalizeEncodedValue(\n  encoded: unknown,\n  context: string,\n  allowUndefined = false\n): Buffer | undefined {\n  if (encoded === null || encoded === undefined) {\n    if (allowUndefined) {\n      return undefined;\n    }\n    throw new Error(`Invalid ${context}`);\n  }\n\n  if (Buffer.isBuffer(encoded)) {\n    return encoded;\n  }\n\n  if (encoded instanceof ArrayBuffer) {\n    return Buffer.from(encoded);\n  }\n\n  if (ArrayBuffer.isView(encoded)) {\n    const view = encoded as ArrayBufferView;\n    return Buffer.from(view.buffer, view.byteOffset, view.byteLength);\n  }\n\n  if (typeof encoded === 'string') {\n    return Buffer.from(encoded, 'utf-8');\n  }\n\n  if (\n    typeof encoded === 'number' ||\n    typeof encoded === 'boolean' ||\n    typeof encoded === 'bigint'\n  ) {\n    return Buffer.from(JSON.stringify(encoded), 'utf-8');\n  }\n\n  if (typeof encoded === 'object') {\n    return Buffer.from(JSON.stringify(encoded), 'utf-8');\n  }\n\n  throw new Error(`Unsupported payload type for ${context}`);\n}\n\nexport function createWebSocketSchemas<\n  SV extends AnySchemaValidator,\n  ES extends EventSchema<SV>\n>(schemaValidator: SchemaValidator, eventSchemas: ES) {\n  const clientMessagesSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.clientMessages\n  );\n  const serverMessagesSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.serverMessages\n  );\n  const errorsSchema = buildUnionSchema<SV>(\n    schemaValidator,\n    eventSchemas.errors\n  );\n  const pingSchema = eventSchemas.ping?.shape;\n  const pongSchema = eventSchemas.pong?.shape;\n  const closeReasonSchema = eventSchemas.closeReason\n    ? buildUnionSchema<SV>(schemaValidator, eventSchemas.closeReason)\n    : undefined;\n\n  return {\n    clientMessagesSchema,\n    serverMessagesSchema,\n    errorsSchema,\n    pingSchema,\n    pongSchema,\n    closeReasonSchema\n  };\n}\n"],"mappings":"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","names":[]}

package/lib/ws/types/eventSchema.types.d.ts

@@ -0,0 +1,28 @@
+import { AnySchemaValidator, IdiomaticSchema } from '@forklaunch/validator';
+import { StringOnlyObject } from '../../http/types/contractDetails.types';
+export type AsyncApiEnrichment = {
+    channel?: string;
+    channels?: string[];
+    operation?: string;
+    operations?: string[];
+};
+export type EventSchemaEntry<SV extends AnySchemaValidator> = {
+    shape: IdiomaticSchema<SV>;
+} & AsyncApiEnrichment;
+export type EventSchema<SV extends AnySchemaValidator> = {
+    ping?: EventSchemaEntry<SV>;
+    pong?: EventSchemaEntry<SV>;
+    clientMessages: Record<string, EventSchemaEntry<SV>>;
+    serverMessages: Record<string, EventSchemaEntry<SV>>;
+    errors?: Record<string, EventSchemaEntry<SV>>;
+    closeReason?: Record<string, EventSchemaEntry<SV>>;
+    context?: StringOnlyObject<SV>;
+    userData?: StringOnlyObject<SV>;
+};
+export type ServerEventSchema<SV extends AnySchemaValidator, ES extends EventSchema<SV>> = Omit<ES, 'serverMessages' | 'clientMessages'> & {
+    serverMessages: ES['clientMessages'];
+    clientMessages: ES['serverMessages'];
+};
+export type ExtractSchemaFromEntry<SV extends AnySchemaValidator, Entry extends EventSchemaEntry<SV> | undefined> = Entry extends EventSchemaEntry<SV> ? Entry['shape'] : never;
+export type ExtractSchemaFromRecord<SV extends AnySchemaValidator, RecordType extends Record<string, EventSchemaEntry<SV>> | undefined> = RecordType extends Record<string, EventSchemaEntry<SV>> ? RecordType[keyof RecordType]['shape'] : never;
+//# sourceMappingURL=eventSchema.types.d.ts.map

package/lib/ws/types/eventSchema.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventSchema.types.d.ts","sourceRoot":"","sources":["../../../src/ws/types/eventSchema.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,IAAI;IAC5D,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;CAC5B,GAAG,kBAAkB,CAAC;AAEvB,MAAM,MAAM,WAAW,CAAC,EAAE,SAAS,kBAAkB,IAAI;IACvD,IAAI,CAAC,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAC3B,EAAE,SAAS,kBAAkB,EAC7B,EAAE,SAAS,WAAW,CAAC,EAAE,CAAC,IACxB,IAAI,CAAC,EAAE,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,GAAG;IAClD,cAAc,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC;IACrC,cAAc,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAChC,EAAE,SAAS,kBAAkB,EAC7B,KAAK,SAAS,gBAAgB,CAAC,EAAE,CAAC,GAAG,SAAS,IAC5C,KAAK,SAAS,gBAAgB,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;AAEhE,MAAM,MAAM,uBAAuB,CACjC,EAAE,SAAS,kBAAkB,EAC7B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,IAEnE,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,GACnD,UAAU,CAAC,MAAM,UAAU,CAAC,CAAC,OAAO,CAAC,GACrC,KAAK,CAAC"}

package/lib/ws/webSocketLike.d.ts

@@ -0,0 +1,18 @@
+import { AnySchemaValidator, IdiomaticSchema, SchemaValidator } from '@forklaunch/validator';
+import { EventSchema, EventSchemaEntry } from './types/eventSchema.types';
+type SchemaRecord<SV extends AnySchemaValidator> = Record<string, EventSchemaEntry<SV>> | undefined;
+export declare function buildUnionSchema<SV extends AnySchemaValidator>(schemaValidator: SchemaValidator, record: SchemaRecord<SV>): IdiomaticSchema<SV> | undefined;
+export declare function parseSchemaValue<SV extends AnySchemaValidator>(schemaValidator: SchemaValidator, value: unknown, schema: IdiomaticSchema<SV> | undefined, context: string): unknown;
+export declare function encodeSchemaValue<SV extends AnySchemaValidator>(schemaValidator: SchemaValidator, value: unknown, schema: IdiomaticSchema<SV> | undefined, context: string): unknown;
+export declare function decodeSchemaValue<SV extends AnySchemaValidator>(schemaValidator: SchemaValidator, data: unknown, schema: IdiomaticSchema<SV> | undefined, context: string): unknown;
+export declare function normalizeEncodedValue(encoded: unknown, context: string, allowUndefined?: boolean): Buffer | undefined;
+export declare function createWebSocketSchemas<SV extends AnySchemaValidator, ES extends EventSchema<SV>>(schemaValidator: SchemaValidator, eventSchemas: ES): {
+    clientMessagesSchema: IdiomaticSchema<SV> | undefined;
+    serverMessagesSchema: IdiomaticSchema<SV> | undefined;
+    errorsSchema: IdiomaticSchema<SV> | undefined;
+    pingSchema: IdiomaticSchema<SV> | undefined;
+    pongSchema: IdiomaticSchema<SV> | undefined;
+    closeReasonSchema: IdiomaticSchema<SV> | undefined;
+};
+export {};
+//# sourceMappingURL=webSocketLike.d.ts.map

package/lib/ws/webSocketLike.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSocketLike.d.ts","sourceRoot":"","sources":["../../src/ws/webSocketLike.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,eAAe,EAEf,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE1E,KAAK,YAAY,CAAC,EAAE,SAAS,kBAAkB,IAC7C,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;AAEnD,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,EAC5D,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GACvB,eAAe,CAAC,EAAE,CAAC,GAAG,SAAS,CAkBjC;AAED,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,EAC5D,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,eAAe,CAAC,EAAE,CAAC,GAAG,SAAS,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAYT;AAED,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,kBAAkB,EAC7D,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,eAAe,CAAC,EAAE,CAAC,GAAG,SAAS,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAkCT;AAED,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,kBAAkB,EAC7D,eAAe,EAAE,eAAe,EAChC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,eAAe,CAAC,EAAE,CAAC,GAAG,SAAS,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAiCT;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,cAAc,UAAQ,GACrB,MAAM,GAAG,SAAS,CAsCpB;AAED,wBAAgB,sBAAsB,CACpC,EAAE,SAAS,kBAAkB,EAC7B,EAAE,SAAS,WAAW,CAAC,EAAE,CAAC,EAC1B,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,EAAE;;;;;;;EA2BnD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/core",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "forklaunch-js core package. Contains useful building blocks.",
   "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
   "bugs": {
@@ -78,58 +78,58 @@
   "dependencies": {
     "@asyncapi/parser": "^3.6.0",
     "@forklaunch/opentelemetry-instrumentation-hyper-express": "0.0.5",
-    "@mikro-orm/core": "7.0.15",
-    "@mikro-orm/mongodb": "7.0.15",
+    "@mikro-orm/core": "7.1.8",
+    "@mikro-orm/mongodb": "7.1.8",
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/api-logs": "^0.217.0",
-    "@opentelemetry/exporter-logs-otlp-http": "^0.217.0",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.217.0",
-    "@opentelemetry/exporter-prometheus": "^0.217.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.217.0",
-    "@opentelemetry/instrumentation-express": "^0.65.0",
-    "@opentelemetry/instrumentation-http": "^0.217.0",
-    "@opentelemetry/resources": "^2.7.1",
-    "@opentelemetry/sdk-logs": "^0.217.0",
-    "@opentelemetry/sdk-metrics": "^2.7.1",
-    "@opentelemetry/sdk-node": "^0.217.0",
-    "@opentelemetry/sdk-trace-node": "^2.7.1",
-    "@opentelemetry/semantic-conventions": "^1.40.0",
+    "@opentelemetry/api-logs": "^0.221.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.221.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.221.0",
+    "@opentelemetry/exporter-prometheus": "^0.221.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.221.0",
+    "@opentelemetry/instrumentation-express": "^0.69.0",
+    "@opentelemetry/instrumentation-http": "^0.221.0",
+    "@opentelemetry/resources": "^2.10.0",
+    "@opentelemetry/sdk-logs": "^0.221.0",
+    "@opentelemetry/sdk-metrics": "^2.10.0",
+    "@opentelemetry/sdk-node": "^0.221.0",
+    "@opentelemetry/sdk-trace-node": "^2.10.0",
+    "@opentelemetry/semantic-conventions": "^1.43.0",
     "cors": "^2.8.6",
     "dotenv": "^17.4.2",
-    "fastmcp": "^4.0.1",
-    "jose": "6.2.3",
-    "openapi3-ts": "^4.5.0",
+    "fastmcp": "^4.12.1",
+    "jose": "6.2.4",
+    "openapi3-ts": "^4.6.1",
     "pino": "^10.3.1",
     "pino-http": "^11.0.0",
     "pino-pretty": "^13.1.3",
-    "redis": "^5.12.1",
-    "uuid": "^14.0.0",
+    "redis": "^6.1.0",
+    "uuid": "^14.0.1",
     "zod": "^4.4.3",
-    "@forklaunch/validator": "1.2.18",
-    "@forklaunch/common": "1.2.18"
+    "@forklaunch/validator": "1.2.20",
+    "@forklaunch/common": "1.2.20"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@scalar/express-api-reference": "^0.9.14",
+    "@scalar/express-api-reference": "^0.10.11",
     "@types/cors": "^2.8.19",
     "@types/jest": "^30.0.0",
     "@types/qs": "^6.15.1",
     "@types/uuid": "^11.0.0",
-    "@typescript/native-preview": "7.0.0-dev.20260511.1",
-    "globals": "^17.6.0",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "globals": "^17.8.0",
     "jest": "^30.4.2",
     "jose": "6.1.3",
-    "prettier": "^3.8.3",
-    "testcontainers": "^11.14.0",
-    "ts-jest": "^29.4.9",
+    "prettier": "^3.9.6",
+    "testcontainers": "^12.0.4",
+    "ts-jest": "^29.4.12",
     "ts-node": "^10.9.2",
     "tsup": "^8.5.1",
-    "typedoc": "^0.28.19",
-    "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.3"
+    "typedoc": "^0.28.20",
+    "typescript": "npm:@typescript/typescript6@^6.0.2",
+    "typescript-eslint": "^8.65.0"
   },
   "scripts": {
-    "build": "tsgo --noEmit && tsup ./src/cache/index.ts ./src/controllers/index.ts ./src/mappers/index.ts ./src/objectstore/index.ts ./src/persistence/index.ts ./src/http/index.ts ./src/services/index.ts ./src/environment/index.ts ./src/ws/index.ts --format cjs,esm --no-splitting --dts --tsconfig tsconfig.json --out-dir lib --clean --sourcemap",
+    "build": "tsgo --noEmit && tsup ./src/cache/index.ts ./src/controllers/index.ts ./src/mappers/index.ts ./src/objectstore/index.ts ./src/persistence/index.ts ./src/http/index.ts ./src/services/index.ts ./src/environment/index.ts ./src/ws/index.ts --format cjs,esm --no-splitting --tsconfig tsconfig.json --out-dir lib --clean --sourcemap && tsgo -p tsconfig.build.json --emitDeclarationOnly",
     "clean": "rm -rf lib pnpm.lock.yaml node_modules",
     "docs": "typedoc --out docs *",
     "format": "prettier --ignore-path=.prettierignore --config .prettierrc '**/*.{ts,tsx,json}' --write",