@rlanz/socket 0.0.1-6 → 0.0.1-8

package/build/services/socket.d.ts

@@ -1,9 +1,9 @@
-import { S as SocketService } from '../socket_service-D3jKrleE.js';
+import { S as SocketService } from '../socket_service-BcC9ASCE.js';
 import 'node:http';
 import '@adonisjs/logger';
 import 'emittery';
 import 'ws';
-import '../types-DiYaFvgi.js';
+import '../base_channel-DPOnqned.js';
 import '@adonisjs/core/types/http';
 import '@adonisjs/core/http';
 import '@boringnode/bus/types/main';

package/build/{socket_service-D3jKrleE.d.ts → socket_service-BcC9ASCE.d.ts}

@@ -2,10 +2,13 @@ import { IncomingMessage, Server } from 'node:http';
 import { Logger } from '@adonisjs/logger';
 import Emittery from 'emittery';
 import { WebSocketServer } from 'ws';
-import { e as BaseChannelConstructor, g as ChannelMatch, A as AuthenticatedSocket, B as BaseChannel, u as PresenceData, h as ChannelOptions, o as SocketEvents, P as PresenceManager, S as SocketConfig, s as SocketServiceStatus, p as SocketHealthSnapshot } from './types-DiYaFvgi.js';
+import { v as BaseChannelConstructor, B as BaseChannel, w as ChannelMiddlewareRunnerFactory, x as ChannelMatch, A as AuthenticatedSocket, y as PresenceData, d as ChannelOptions, l as SocketEvents, P as PresenceManager, c as SocketConfig, s as SocketServiceStatus, m as SocketHealthSnapshot } from './base_channel-DPOnqned.js';
 import { HttpContext } from '@adonisjs/core/http';
 import { SocketFake } from './src/testing.js';
 
+type SocketUpgradeContextRunner = <Result>(request: IncomingMessage, handler: (httpContext: HttpContext) => Promise<Result>, shortCircuitBeforeMiddleware?: (httpContext: HttpContext) => Result | undefined | Promise<Result | undefined>) => Promise<Result>;
+
+type ChannelFactory = (channel: BaseChannelConstructor) => BaseChannel<any> | Promise<BaseChannel<any>>;
 /**
  * Matches channel names against registered patterns.
  *
@@ -18,6 +21,9 @@ import { SocketFake } from './src/testing.js';
  */
 declare class ChannelRouter {
     #private;
+    private makeChannel;
+    private createMiddlewareRunner?;
+    constructor(makeChannel?: ChannelFactory, createMiddlewareRunner?: ChannelMiddlewareRunnerFactory | undefined);
     /**
      * Registers a channel.
      */
@@ -47,7 +53,7 @@ declare class ChannelRouter {
         readonly presenceData?: undefined;
     } | {
         readonly success: true;
-        readonly instance: BaseChannel<User, unknown>;
+        readonly instance: BaseChannel<User, Record<never, never>>;
         readonly params: Record<string, string>;
         readonly paramValues: string[];
         readonly presenceData: Record<string, unknown> | PresenceData | null;
@@ -68,8 +74,6 @@ declare class ChannelRouter {
     get size(): number;
 }
 
-type SocketUpgradeContextRunner = <Result>(request: IncomingMessage, handler: (httpContext: HttpContext) => Promise<Result>) => Promise<Result>;
-
 /**
  * Main service for managing WebSocket connections.
  */
@@ -87,9 +91,6 @@ declare class SocketService<User = unknown> extends Emittery<SocketEvents<User>>
             emit: (event: string, data: unknown) => void;
         };
     };
-    toUser(userId: string | number): {
-        emit: (event: string, data: unknown) => void;
-    };
     broadcast(event: string, data: unknown): void;
     getSocket(socketId: string): AuthenticatedSocket<User> | undefined;
     get connectionsCount(): number;

package/build/src/assembler_hook.js

@@ -1,3 +1,8 @@
+import {
+  BindableChannelPattern
+} from "../chunk-6PJ4ALJD.js";
+import "../chunk-E6ILCRL3.js";
+
 // src/assembler_hook.ts
 import fs from "fs";
 import ts from "typescript";
@@ -38,20 +43,6 @@ function validateHandlerMethod(filePath, method, name) {
     fail(filePath, `handler method ${name} must not require parameters after the payload`);
   }
 }
-function isSupportedPattern(pattern) {
-  const normalized = pattern === "/" ? "/" : pattern.replace(/^\//, "").replace(/\/$/, "");
-  if (normalized === "/") {
-    return true;
-  }
-  const segments = normalized.split("/");
-  return segments.every((segment, index) => {
-    const isFinal = index === segments.length - 1;
-    const literal = segment.length > 0 && !/[:*?]/.test(segment);
-    const requiredParam = /^:[^.:?/*]+$/.test(segment);
-    const optionalParam = /^:[^.:?/*]+\?$/.test(segment);
-    return literal || requiredParam || isFinal && (optionalParam || segment === "*");
-  });
-}
 function inspectChannel(filePath, importPath) {
   const source = ts.createSourceFile(
     filePath,
@@ -116,45 +107,11 @@ function inspectChannel(filePath, importPath) {
   if (!patternMember || !patternMember.initializer || !ts.isStringLiteral(patternMember.initializer)) {
     return `Omitted ${importPath}: static pattern must be a direct string literal.`;
   }
-  if (!isSupportedPattern(patternMember.initializer.text)) {
+  const bindablePattern = BindableChannelPattern.parse(patternMember.initializer.text);
+  if (!bindablePattern) {
     return `Omitted ${importPath}: pattern ${quote(patternMember.initializer.text)} is not supported by generated typing; use literals, required params, a final optional param, or a final wildcard.`;
   }
-  const methods = /* @__PURE__ */ new Map();
-  for (const member of channelClass.members) {
-    if (ts.isMethodDeclaration(member) && !isStatic(member)) {
-      const name = propertyName(member.name);
-      if (name) methods.set(name, member);
-    }
-  }
   const handlers = [];
-  const handlerMember = channelClass.members.find(
-    (member) => ts.isPropertyDeclaration(member) && !isStatic(member) && propertyName(member.name) === "handlers"
-  );
-  if (handlerMember) {
-    if (!handlerMember.initializer || !ts.isObjectLiteralExpression(handlerMember.initializer)) {
-      fail(filePath, "handlers must be an object literal");
-    }
-    for (const property of handlerMember.initializer.properties) {
-      if (!ts.isPropertyAssignment(property) || !ts.isStringLiteral(property.name)) {
-        fail(filePath, "handler event keys must be direct string literals");
-      }
-      const event = property.name.text;
-      const value = property.initializer;
-      if (!ts.isPropertyAccessExpression(value) || value.expression.kind !== ts.SyntaxKind.ThisKeyword || !ts.isIdentifier(value.name)) {
-        fail(filePath, `handler "${event}" must reference this.<publicMethod>`);
-      }
-      const method = methods.get(value.name.text);
-      if (!method) fail(filePath, `handler "${event}" references missing method ${value.name.text}`);
-      if (!isPublic(method)) {
-        fail(filePath, `handler method ${value.name.text} must be public`);
-      }
-      validateHandlerMethod(filePath, method, value.name.text);
-      if (handlers.some((handler) => handler.event === event)) {
-        fail(filePath, `event "${event}" is mapped more than once`);
-      }
-      handlers.push({ event, method: value.name.text });
-    }
-  }
   for (const method of channelClass.members.filter(ts.isMethodDeclaration)) {
     for (const decorator of ts.getDecorators(method) ?? []) {
       const expression = decorator.expression;
@@ -182,7 +139,7 @@ function inspectChannel(filePath, importPath) {
       handlers.push({ event, method: name });
     }
   }
-  return { pattern: patternMember.initializer.text, importPath, handlers };
+  return { pattern: patternMember.initializer.text, bindablePattern, importPath, handlers };
 }
 function generateSocketRegistry(options = {}) {
   return {
@@ -204,16 +161,33 @@ function generateSocketRegistry(options = {}) {
             if (typeof inspected === "string") diagnostics.push(inspected);
             else channels.push(inspected);
           }
+          const patterns = /* @__PURE__ */ new Set();
+          for (const channel of channels) {
+            if (patterns.has(channel.bindablePattern.canonicalPattern)) {
+              fail(
+                channel.importPath,
+                `pattern ${quote(channel.pattern)} is declared more than once`
+              );
+            }
+            patterns.add(channel.bindablePattern.canonicalPattern);
+          }
           for (const diagnostic of diagnostics) buffer.writeLine(`// [socket] ${diagnostic}`);
           if (diagnostics.length) buffer.writeLine("");
           buffer.writeLine("export interface AppSocket {").indent();
-          if (diagnostics.length) {
-            buffer.writeLine("readonly uncertain: true");
-          }
-          buffer.writeLine("readonly channels: readonly [").indent();
+          buffer.writeLine("readonly channels: {").indent();
           for (const channel of channels) {
-            buffer.writeLine("{").indent();
-            buffer.writeLine(`readonly pattern: ${quote(channel.pattern)}`);
+            buffer.writeLine(`readonly ${quote(channel.pattern)}: {`).indent();
+            if (channel.bindablePattern.parameters.length === 0) {
+              buffer.writeLine("readonly params: undefined");
+            } else {
+              buffer.writeLine("readonly params: {").indent();
+              for (const parameter of channel.bindablePattern.parameters) {
+                buffer.writeLine(
+                  `readonly ${quote(parameter.name)}${parameter.optional ? "?" : ""}: string | number`
+                );
+              }
+              buffer.dedent().writeLine("}");
+            }
             buffer.writeLine(
               `readonly channel: typeof import(${quote(channel.importPath)}).default`
             );
@@ -222,9 +196,9 @@ function generateSocketRegistry(options = {}) {
               buffer.writeLine(`readonly ${quote(handler.event)}: ${quote(handler.method)}`);
             }
             buffer.dedent().writeLine("}");
-            buffer.dedent().writeLine("},");
+            buffer.dedent().writeLine("}");
           }
-          buffer.dedent().writeLine("]");
+          buffer.dedent().writeLine("}");
           buffer.dedent().writeLine("}");
         }
       });

package/build/src/assembler_hook.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/assembler_hook.ts"],"sourcesContent":["import fs from 'node:fs'\nimport ts from 'typescript'\nimport type { CommonHooks } from '@adonisjs/assembler/types'\nimport type { IndexGeneratorSourceConfig } from '@adonisjs/assembler/types'\n\nexport interface SocketAssemblerHookOptions {\n  source?: string\n  glob?: string[]\n  output?: string\n}\n\ntype Handler = { event: string; method: string }\ntype Channel = { pattern: string; importPath: string; handlers: Handler[] }\ntype SocketAssemblerHook = Extract<CommonHooks['init'][number], { run: (...args: any[]) => any }>\n\nfunction quote(value: string) {\n  return `'${value.replaceAll('\\\\', '\\\\\\\\').replaceAll(\"'\", \"\\\\'\")}'`\n}\n\nfunction generatedImportPath(importPath: string): string {\n  return importPath.replace(/\\.ts$/, '')\n}\n\nfunction appImportAlias(source: string): string {\n  const normalized = source.replace(/^\\.\\//, '')\n  if (normalized === 'app') return '#app'\n  if (normalized.startsWith('app/')) return `#app/${normalized.slice('app/'.length)}`\n  throw new Error('[socket] Channel source must be inside the app directory')\n}\n\nfunction fail(filePath: string, message: string): never {\n  throw new Error(`[socket] Cannot generate client types for ${filePath}: ${message}`)\n}\n\nfunction propertyName(node: ts.PropertyName | undefined): string | undefined {\n  if (node && (ts.isIdentifier(node) || ts.isStringLiteral(node))) return node.text\n}\n\nfunction isPublic(method: ts.MethodDeclaration) {\n  return !method.modifiers?.some(\n    (modifier) =>\n      modifier.kind === ts.SyntaxKind.PrivateKeyword ||\n      modifier.kind === ts.SyntaxKind.ProtectedKeyword\n  )\n}\n\nfunction isStatic(member: ts.ClassElement): boolean {\n  return (\n    ts.canHaveModifiers(member) &&\n    !!ts.getModifiers(member)?.some((modifier) => modifier.kind === ts.SyntaxKind.StaticKeyword)\n  )\n}\n\nfunction validateHandlerMethod(filePath: string, method: ts.MethodDeclaration, name: string): void {\n  const parameters = method.parameters.filter(\n    (parameter) => !(ts.isIdentifier(parameter.name) && parameter.name.text === 'this')\n  )\n  if (parameters.some((parameter) => parameter.dotDotDotToken)) {\n    fail(filePath, `handler method ${name} must not use rest parameters`)\n  }\n  if (parameters.slice(2).some((parameter) => !parameter.questionToken && !parameter.initializer)) {\n    fail(filePath, `handler method ${name} must not require parameters after the payload`)\n  }\n}\n\nfunction isSupportedPattern(pattern: string): boolean {\n  const normalized = pattern === '/' ? '/' : pattern.replace(/^\\//, '').replace(/\\/$/, '')\n  if (normalized === '/') {\n    return true\n  }\n  const segments = normalized.split('/')\n\n  return segments.every((segment, index) => {\n    const isFinal = index === segments.length - 1\n    const literal = segment.length > 0 && !/[:*?]/.test(segment)\n    const requiredParam = /^:[^.:?/*]+$/.test(segment)\n    const optionalParam = /^:[^.:?/*]+\\?$/.test(segment)\n\n    return literal || requiredParam || (isFinal && (optionalParam || segment === '*'))\n  })\n}\n\nfunction inspectChannel(filePath: string, importPath: string): Channel | string {\n  const source = ts.createSourceFile(\n    filePath,\n    fs.readFileSync(filePath, 'utf8'),\n    ts.ScriptTarget.Latest,\n    true,\n    filePath.endsWith('.js') ? ts.ScriptKind.JS : ts.ScriptKind.TS\n  )\n  const decoratorImports = new Set<string>()\n  const decoratorNamespaces = new Set<string>()\n  const baseChannelImports = new Set<string>()\n  const socketNamespaces = new Set<string>()\n\n  for (const statement of source.statements) {\n    if (\n      !ts.isImportDeclaration(statement) ||\n      !ts.isStringLiteral(statement.moduleSpecifier) ||\n      (statement.moduleSpecifier.text !== '@rlanz/socket/decorators' &&\n        statement.moduleSpecifier.text !== '@rlanz/socket')\n    ) {\n      continue\n    }\n\n    const bindings = statement.importClause?.namedBindings\n    if (bindings && ts.isNamedImports(bindings)) {\n      for (const binding of bindings.elements) {\n        const importedName = (binding.propertyName ?? binding.name).text\n        if (\n          statement.moduleSpecifier.text === '@rlanz/socket/decorators' &&\n          importedName === 'onMessage'\n        ) {\n          decoratorImports.add(binding.name.text)\n        }\n        if (statement.moduleSpecifier.text === '@rlanz/socket' && importedName === 'BaseChannel') {\n          baseChannelImports.add(binding.name.text)\n        }\n      }\n    } else if (bindings && ts.isNamespaceImport(bindings)) {\n      if (statement.moduleSpecifier.text === '@rlanz/socket/decorators') {\n        decoratorNamespaces.add(bindings.name.text)\n      } else {\n        socketNamespaces.add(bindings.name.text)\n      }\n    }\n  }\n\n  const classes = source.statements.filter(ts.isClassDeclaration)\n  let channelClass = classes.find((node) =>\n    node.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.DefaultKeyword)\n  )\n\n  if (!channelClass) {\n    const defaultExport = source.statements.find(\n      (node): node is ts.ExportAssignment => ts.isExportAssignment(node) && !node.isExportEquals\n    )\n    if (defaultExport && ts.isIdentifier(defaultExport.expression)) {\n      const defaultClassName = defaultExport.expression.text\n      channelClass = classes.find((node) => node.name?.text === defaultClassName)\n    }\n  }\n  if (!channelClass) fail(filePath, 'a default-exported channel class was not found')\n  if (channelClass.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.AbstractKeyword)) {\n    fail(filePath, 'the default-exported channel class must not be abstract')\n  }\n\n  const extendsType = channelClass.heritageClauses\n    ?.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword)\n    ?.types.at(0)\n  const extendsExpression = extendsType?.expression\n  const directlyExtendsBaseChannel =\n    (extendsExpression &&\n      ts.isIdentifier(extendsExpression) &&\n      baseChannelImports.has(extendsExpression.text)) ||\n    (extendsExpression &&\n      ts.isPropertyAccessExpression(extendsExpression) &&\n      ts.isIdentifier(extendsExpression.expression) &&\n      socketNamespaces.has(extendsExpression.expression.text) &&\n      extendsExpression.name.text === 'BaseChannel')\n\n  if (!directlyExtendsBaseChannel) {\n    return (\n      `Omitted ${importPath}: generated contracts do not support channel inheritance; ` +\n      'the default export must directly extend BaseChannel imported from @rlanz/socket.'\n    )\n  }\n\n  const patternMember = channelClass.members.find(\n    (member): member is ts.PropertyDeclaration =>\n      ts.isPropertyDeclaration(member) &&\n      propertyName(member.name) === 'pattern' &&\n      !!member.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.StaticKeyword)\n  )\n  if (\n    !patternMember ||\n    !patternMember.initializer ||\n    !ts.isStringLiteral(patternMember.initializer)\n  ) {\n    return `Omitted ${importPath}: static pattern must be a direct string literal.`\n  }\n\n  if (!isSupportedPattern(patternMember.initializer.text)) {\n    return (\n      `Omitted ${importPath}: pattern ${quote(patternMember.initializer.text)} is not supported by ` +\n      'generated typing; use literals, required params, a final optional param, or a final wildcard.'\n    )\n  }\n\n  const methods = new Map<string, ts.MethodDeclaration>()\n  for (const member of channelClass.members) {\n    if (ts.isMethodDeclaration(member) && !isStatic(member)) {\n      const name = propertyName(member.name)\n      if (name) methods.set(name, member)\n    }\n  }\n\n  const handlers: Handler[] = []\n  const handlerMember = channelClass.members.find(\n    (member): member is ts.PropertyDeclaration =>\n      ts.isPropertyDeclaration(member) &&\n      !isStatic(member) &&\n      propertyName(member.name) === 'handlers'\n  )\n  if (handlerMember) {\n    if (!handlerMember.initializer || !ts.isObjectLiteralExpression(handlerMember.initializer)) {\n      fail(filePath, 'handlers must be an object literal')\n    }\n    for (const property of handlerMember.initializer.properties) {\n      if (!ts.isPropertyAssignment(property) || !ts.isStringLiteral(property.name)) {\n        fail(filePath, 'handler event keys must be direct string literals')\n      }\n      const event = property.name.text\n      const value = property.initializer\n      if (\n        !ts.isPropertyAccessExpression(value) ||\n        value.expression.kind !== ts.SyntaxKind.ThisKeyword ||\n        !ts.isIdentifier(value.name)\n      ) {\n        fail(filePath, `handler \"${event}\" must reference this.<publicMethod>`)\n      }\n      const method = methods.get(value.name.text)\n      if (!method) fail(filePath, `handler \"${event}\" references missing method ${value.name.text}`)\n      if (!isPublic(method)) {\n        fail(filePath, `handler method ${value.name.text} must be public`)\n      }\n      validateHandlerMethod(filePath, method, value.name.text)\n      if (handlers.some((handler) => handler.event === event)) {\n        fail(filePath, `event \"${event}\" is mapped more than once`)\n      }\n      handlers.push({ event, method: value.name.text })\n    }\n  }\n\n  for (const method of channelClass.members.filter(ts.isMethodDeclaration)) {\n    for (const decorator of ts.getDecorators(method) ?? []) {\n      const expression = decorator.expression\n      const isImportedDecorator =\n        ts.isCallExpression(expression) &&\n        ((ts.isIdentifier(expression.expression) &&\n          decoratorImports.has(expression.expression.text)) ||\n          (ts.isPropertyAccessExpression(expression.expression) &&\n            ts.isIdentifier(expression.expression.expression) &&\n            decoratorNamespaces.has(expression.expression.expression.text) &&\n            expression.expression.name.text === 'onMessage'))\n\n      if (!isImportedDecorator || !ts.isCallExpression(expression)) {\n        continue\n      }\n\n      if (isStatic(method)) {\n        fail(filePath, '@onMessage cannot generate a contract for a static method')\n      }\n\n      if (expression.arguments.length !== 1 || !ts.isStringLiteral(expression.arguments[0])) {\n        fail(\n          filePath,\n          `@onMessage on ${propertyName(method.name) ?? '<computed>'} needs a literal event`\n        )\n      }\n      const event = expression.arguments[0].text\n      const name = propertyName(method.name)\n      if (!name || !ts.isIdentifier(method.name)) fail(filePath, '@onMessage methods must be named')\n      if (!isPublic(method)) fail(filePath, `decorated handler method ${name} must be public`)\n      validateHandlerMethod(filePath, method, name)\n      if (handlers.some((handler) => handler.event === event)) {\n        fail(filePath, `event \"${event}\" is mapped more than once`)\n      }\n      handlers.push({ event, method: name })\n    }\n  }\n\n  return { pattern: patternMember.initializer.text, importPath, handlers }\n}\n\n/** Registers generation of the application socket registry with AdonisJS Assembler. */\nexport function generateSocketRegistry(\n  options: SocketAssemblerHookOptions = {}\n): SocketAssemblerHook {\n  return {\n    run(_parent, hooks, indexGenerator) {\n      const source = options.source ?? './app/channels'\n      const glob = options.glob ?? ['**/*_channel.{ts,js}']\n      const importAlias = appImportAlias(source)\n\n      indexGenerator.add('socketChannels', {\n        source,\n        glob,\n        importAlias,\n        output: options.output ?? './.adonisjs/client/socket.ts',\n        as(vfs, buffer, _config, helpers) {\n          const channels: Channel[] = []\n          const diagnostics: string[] = []\n          for (const filePath of Object.values(vfs.asList())) {\n            const importPath = generatedImportPath(helpers.toImportPath(filePath))\n            const inspected = inspectChannel(filePath, importPath)\n            if (typeof inspected === 'string') diagnostics.push(inspected)\n            else channels.push(inspected)\n          }\n\n          for (const diagnostic of diagnostics) buffer.writeLine(`// [socket] ${diagnostic}`)\n          if (diagnostics.length) buffer.writeLine('')\n          buffer.writeLine('export interface AppSocket {').indent()\n          if (diagnostics.length) {\n            buffer.writeLine('readonly uncertain: true')\n          }\n          buffer.writeLine('readonly channels: readonly [').indent()\n          for (const channel of channels) {\n            buffer.writeLine('{').indent()\n            buffer.writeLine(`readonly pattern: ${quote(channel.pattern)}`)\n            buffer.writeLine(\n              `readonly channel: typeof import(${quote(channel.importPath)}).default`\n            )\n            buffer.writeLine('readonly handlers: {').indent()\n            for (const handler of channel.handlers) {\n              buffer.writeLine(`readonly ${quote(handler.event)}: ${quote(handler.method)}`)\n            }\n            buffer.dedent().writeLine('}')\n            buffer.dedent().writeLine('},')\n          }\n          buffer.dedent().writeLine(']')\n          buffer.dedent().writeLine('}')\n        },\n      } satisfies IndexGeneratorSourceConfig)\n\n      indexGenerator.add('socketServerChannels', {\n        source,\n        glob,\n        importAlias,\n        output: './.adonisjs/server/socket_channels.ts',\n        as(vfs, buffer, _config, helpers) {\n          const filePaths = Object.values(vfs.asList())\n          filePaths.forEach((filePath, index) => {\n            const importPath = generatedImportPath(helpers.toImportPath(filePath))\n            buffer.writeLine(`import Channel${index} from ${quote(importPath)}`)\n          })\n          if (filePaths.length) buffer.writeLine('')\n          buffer.writeLine(\n            `export const socketChannels = [${filePaths.map((_filePath, index) => `Channel${index}`).join(', ')}] as const`\n          )\n        },\n      } satisfies IndexGeneratorSourceConfig)\n\n      hooks.add('fileChanged', (_relativePath, absolutePath) => {\n        return indexGenerator.addFile(absolutePath)\n      })\n    },\n  }\n}\n\nconst socketRegistryHook = generateSocketRegistry()\nconst lazySocketRegistryHook: SocketAssemblerHook['run'] = socketRegistryHook.run\n\nexport default lazySocketRegistryHook\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/assembler_hook.ts"],"sourcesContent":["import fs from 'node:fs'\nimport ts from 'typescript'\nimport type { CommonHooks } from '@adonisjs/assembler/types'\nimport type { IndexGeneratorSourceConfig } from '@adonisjs/assembler/types'\nimport { BindableChannelPattern } from './bindable_channel_pattern.js'\n\nexport interface SocketAssemblerHookOptions {\n  source?: string\n  glob?: string[]\n  output?: string\n}\n\ntype Handler = { event: string; method: string }\ntype Channel = {\n  pattern: string\n  bindablePattern: BindableChannelPattern\n  importPath: string\n  handlers: Handler[]\n}\ntype SocketAssemblerHook = Extract<CommonHooks['init'][number], { run: (...args: any[]) => any }>\n\nfunction quote(value: string) {\n  return `'${value.replaceAll('\\\\', '\\\\\\\\').replaceAll(\"'\", \"\\\\'\")}'`\n}\n\nfunction generatedImportPath(importPath: string): string {\n  return importPath.replace(/\\.ts$/, '')\n}\n\nfunction appImportAlias(source: string): string {\n  const normalized = source.replace(/^\\.\\//, '')\n  if (normalized === 'app') return '#app'\n  if (normalized.startsWith('app/')) return `#app/${normalized.slice('app/'.length)}`\n  throw new Error('[socket] Channel source must be inside the app directory')\n}\n\nfunction fail(filePath: string, message: string): never {\n  throw new Error(`[socket] Cannot generate client types for ${filePath}: ${message}`)\n}\n\nfunction propertyName(node: ts.PropertyName | undefined): string | undefined {\n  if (node && (ts.isIdentifier(node) || ts.isStringLiteral(node))) return node.text\n}\n\nfunction isPublic(method: ts.MethodDeclaration) {\n  return !method.modifiers?.some(\n    (modifier) =>\n      modifier.kind === ts.SyntaxKind.PrivateKeyword ||\n      modifier.kind === ts.SyntaxKind.ProtectedKeyword\n  )\n}\n\nfunction isStatic(member: ts.ClassElement): boolean {\n  return (\n    ts.canHaveModifiers(member) &&\n    !!ts.getModifiers(member)?.some((modifier) => modifier.kind === ts.SyntaxKind.StaticKeyword)\n  )\n}\n\nfunction validateHandlerMethod(filePath: string, method: ts.MethodDeclaration, name: string): void {\n  const parameters = method.parameters.filter(\n    (parameter) => !(ts.isIdentifier(parameter.name) && parameter.name.text === 'this')\n  )\n  if (parameters.some((parameter) => parameter.dotDotDotToken)) {\n    fail(filePath, `handler method ${name} must not use rest parameters`)\n  }\n  if (parameters.slice(2).some((parameter) => !parameter.questionToken && !parameter.initializer)) {\n    fail(filePath, `handler method ${name} must not require parameters after the payload`)\n  }\n}\n\nfunction inspectChannel(filePath: string, importPath: string): Channel | string {\n  const source = ts.createSourceFile(\n    filePath,\n    fs.readFileSync(filePath, 'utf8'),\n    ts.ScriptTarget.Latest,\n    true,\n    filePath.endsWith('.js') ? ts.ScriptKind.JS : ts.ScriptKind.TS\n  )\n  const decoratorImports = new Set<string>()\n  const decoratorNamespaces = new Set<string>()\n  const baseChannelImports = new Set<string>()\n  const socketNamespaces = new Set<string>()\n\n  for (const statement of source.statements) {\n    if (\n      !ts.isImportDeclaration(statement) ||\n      !ts.isStringLiteral(statement.moduleSpecifier) ||\n      (statement.moduleSpecifier.text !== '@rlanz/socket/decorators' &&\n        statement.moduleSpecifier.text !== '@rlanz/socket')\n    ) {\n      continue\n    }\n\n    const bindings = statement.importClause?.namedBindings\n    if (bindings && ts.isNamedImports(bindings)) {\n      for (const binding of bindings.elements) {\n        const importedName = (binding.propertyName ?? binding.name).text\n        if (\n          statement.moduleSpecifier.text === '@rlanz/socket/decorators' &&\n          importedName === 'onMessage'\n        ) {\n          decoratorImports.add(binding.name.text)\n        }\n        if (statement.moduleSpecifier.text === '@rlanz/socket' && importedName === 'BaseChannel') {\n          baseChannelImports.add(binding.name.text)\n        }\n      }\n    } else if (bindings && ts.isNamespaceImport(bindings)) {\n      if (statement.moduleSpecifier.text === '@rlanz/socket/decorators') {\n        decoratorNamespaces.add(bindings.name.text)\n      } else {\n        socketNamespaces.add(bindings.name.text)\n      }\n    }\n  }\n\n  const classes = source.statements.filter(ts.isClassDeclaration)\n  let channelClass = classes.find((node) =>\n    node.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.DefaultKeyword)\n  )\n\n  if (!channelClass) {\n    const defaultExport = source.statements.find(\n      (node): node is ts.ExportAssignment => ts.isExportAssignment(node) && !node.isExportEquals\n    )\n    if (defaultExport && ts.isIdentifier(defaultExport.expression)) {\n      const defaultClassName = defaultExport.expression.text\n      channelClass = classes.find((node) => node.name?.text === defaultClassName)\n    }\n  }\n  if (!channelClass) fail(filePath, 'a default-exported channel class was not found')\n  if (channelClass.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.AbstractKeyword)) {\n    fail(filePath, 'the default-exported channel class must not be abstract')\n  }\n\n  const extendsType = channelClass.heritageClauses\n    ?.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword)\n    ?.types.at(0)\n  const extendsExpression = extendsType?.expression\n  const directlyExtendsBaseChannel =\n    (extendsExpression &&\n      ts.isIdentifier(extendsExpression) &&\n      baseChannelImports.has(extendsExpression.text)) ||\n    (extendsExpression &&\n      ts.isPropertyAccessExpression(extendsExpression) &&\n      ts.isIdentifier(extendsExpression.expression) &&\n      socketNamespaces.has(extendsExpression.expression.text) &&\n      extendsExpression.name.text === 'BaseChannel')\n\n  if (!directlyExtendsBaseChannel) {\n    return (\n      `Omitted ${importPath}: generated contracts do not support channel inheritance; ` +\n      'the default export must directly extend BaseChannel imported from @rlanz/socket.'\n    )\n  }\n\n  const patternMember = channelClass.members.find(\n    (member): member is ts.PropertyDeclaration =>\n      ts.isPropertyDeclaration(member) &&\n      propertyName(member.name) === 'pattern' &&\n      !!member.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.StaticKeyword)\n  )\n  if (\n    !patternMember ||\n    !patternMember.initializer ||\n    !ts.isStringLiteral(patternMember.initializer)\n  ) {\n    return `Omitted ${importPath}: static pattern must be a direct string literal.`\n  }\n\n  const bindablePattern = BindableChannelPattern.parse(patternMember.initializer.text)\n  if (!bindablePattern) {\n    return (\n      `Omitted ${importPath}: pattern ${quote(patternMember.initializer.text)} is not supported by ` +\n      'generated typing; use literals, required params, a final optional param, or a final wildcard.'\n    )\n  }\n\n  const handlers: Handler[] = []\n  for (const method of channelClass.members.filter(ts.isMethodDeclaration)) {\n    for (const decorator of ts.getDecorators(method) ?? []) {\n      const expression = decorator.expression\n      const isImportedDecorator =\n        ts.isCallExpression(expression) &&\n        ((ts.isIdentifier(expression.expression) &&\n          decoratorImports.has(expression.expression.text)) ||\n          (ts.isPropertyAccessExpression(expression.expression) &&\n            ts.isIdentifier(expression.expression.expression) &&\n            decoratorNamespaces.has(expression.expression.expression.text) &&\n            expression.expression.name.text === 'onMessage'))\n\n      if (!isImportedDecorator || !ts.isCallExpression(expression)) {\n        continue\n      }\n\n      if (isStatic(method)) {\n        fail(filePath, '@onMessage cannot generate a contract for a static method')\n      }\n\n      if (expression.arguments.length !== 1 || !ts.isStringLiteral(expression.arguments[0])) {\n        fail(\n          filePath,\n          `@onMessage on ${propertyName(method.name) ?? '<computed>'} needs a literal event`\n        )\n      }\n      const event = expression.arguments[0].text\n      const name = propertyName(method.name)\n      if (!name || !ts.isIdentifier(method.name)) fail(filePath, '@onMessage methods must be named')\n      if (!isPublic(method)) fail(filePath, `decorated handler method ${name} must be public`)\n      validateHandlerMethod(filePath, method, name)\n      if (handlers.some((handler) => handler.event === event)) {\n        fail(filePath, `event \"${event}\" is mapped more than once`)\n      }\n      handlers.push({ event, method: name })\n    }\n  }\n\n  return { pattern: patternMember.initializer.text, bindablePattern, importPath, handlers }\n}\n\n/** Registers generation of the application socket registry with AdonisJS Assembler. */\nexport function generateSocketRegistry(\n  options: SocketAssemblerHookOptions = {}\n): SocketAssemblerHook {\n  return {\n    run(_parent, hooks, indexGenerator) {\n      const source = options.source ?? './app/channels'\n      const glob = options.glob ?? ['**/*_channel.{ts,js}']\n      const importAlias = appImportAlias(source)\n\n      indexGenerator.add('socketChannels', {\n        source,\n        glob,\n        importAlias,\n        output: options.output ?? './.adonisjs/client/socket.ts',\n        as(vfs, buffer, _config, helpers) {\n          const channels: Channel[] = []\n          const diagnostics: string[] = []\n          for (const filePath of Object.values(vfs.asList())) {\n            const importPath = generatedImportPath(helpers.toImportPath(filePath))\n            const inspected = inspectChannel(filePath, importPath)\n            if (typeof inspected === 'string') diagnostics.push(inspected)\n            else channels.push(inspected)\n          }\n\n          const patterns = new Set<string>()\n          for (const channel of channels) {\n            if (patterns.has(channel.bindablePattern.canonicalPattern)) {\n              fail(\n                channel.importPath,\n                `pattern ${quote(channel.pattern)} is declared more than once`\n              )\n            }\n            patterns.add(channel.bindablePattern.canonicalPattern)\n          }\n\n          for (const diagnostic of diagnostics) buffer.writeLine(`// [socket] ${diagnostic}`)\n          if (diagnostics.length) buffer.writeLine('')\n          buffer.writeLine('export interface AppSocket {').indent()\n          buffer.writeLine('readonly channels: {').indent()\n          for (const channel of channels) {\n            buffer.writeLine(`readonly ${quote(channel.pattern)}: {`).indent()\n            if (channel.bindablePattern.parameters.length === 0) {\n              buffer.writeLine('readonly params: undefined')\n            } else {\n              buffer.writeLine('readonly params: {').indent()\n              for (const parameter of channel.bindablePattern.parameters) {\n                buffer.writeLine(\n                  `readonly ${quote(parameter.name)}${parameter.optional ? '?' : ''}: string | number`\n                )\n              }\n              buffer.dedent().writeLine('}')\n            }\n            buffer.writeLine(\n              `readonly channel: typeof import(${quote(channel.importPath)}).default`\n            )\n            buffer.writeLine('readonly handlers: {').indent()\n            for (const handler of channel.handlers) {\n              buffer.writeLine(`readonly ${quote(handler.event)}: ${quote(handler.method)}`)\n            }\n            buffer.dedent().writeLine('}')\n            buffer.dedent().writeLine('}')\n          }\n          buffer.dedent().writeLine('}')\n          buffer.dedent().writeLine('}')\n        },\n      } satisfies IndexGeneratorSourceConfig)\n\n      indexGenerator.add('socketServerChannels', {\n        source,\n        glob,\n        importAlias,\n        output: './.adonisjs/server/socket_channels.ts',\n        as(vfs, buffer, _config, helpers) {\n          const filePaths = Object.values(vfs.asList())\n          filePaths.forEach((filePath, index) => {\n            const importPath = generatedImportPath(helpers.toImportPath(filePath))\n            buffer.writeLine(`import Channel${index} from ${quote(importPath)}`)\n          })\n          if (filePaths.length) buffer.writeLine('')\n          buffer.writeLine(\n            `export const socketChannels = [${filePaths.map((_filePath, index) => `Channel${index}`).join(', ')}] as const`\n          )\n        },\n      } satisfies IndexGeneratorSourceConfig)\n\n      hooks.add('fileChanged', (_relativePath, absolutePath) => {\n        return indexGenerator.addFile(absolutePath)\n      })\n    },\n  }\n}\n\nconst socketRegistryHook = generateSocketRegistry()\nconst lazySocketRegistryHook: SocketAssemblerHook['run'] = socketRegistryHook.run\n\nexport default lazySocketRegistryHook\n"],"mappings":"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","names":[]}

package/build/src/client/index.d.ts

@@ -1,152 +1,8 @@
-import { ChannelContract, SocketClientTransport, PresenceUser, EventHandler, SubscribeOptions, UnsubscribeOptions, SocketOptions, ConnectionState, ChannelContractFor } from './types.js';
-export { PresenceData, SubscribeAckData, SubscribeResult } from './types.js';
-export { b as ChannelAck, c as ChannelMessage } from '../../types-DiYaFvgi.js';
+export { S as Socket } from '../../index-DjBYUhFR.js';
+export { ChannelBroadcastEvent, ChannelBroadcastPayload, ChannelCallArgs, ChannelClientEvent, ChannelClientEventPayload, ChannelParameters, ChannelPattern, ConnectionState, EventHandler, PresenceData, PresenceUser, SocketOptions, SubscribeAckData, SubscribeOptions, SubscribeResult, UnsubscribeOptions } from './types.js';
+export { a as ChannelAck, b as ChannelMessage } from '../../base_channel-DPOnqned.js';
 import 'ws';
 import 'node:http';
 import '@adonisjs/core/types/http';
 import '@adonisjs/core/http';
 import '@boringnode/bus/types/main';
-
-/**
- * Represents a subscribed channel.
- * Chainable API inspired by Laravel Echo.
- *
- * @example
- * ```ts
- * socket.channel('chat/general')
- *   .here((users) => setOnlineUsers(users))
- *   .joining((user) => console.log(`${user.name} joined`))
- *   .leaving((user) => console.log(`${user.name} left`))
- *   .listen('chat:message', (msg) => addMessage(msg))
- *   .subscribe()
- * ```
- */
-type UnknownContract = ChannelContract<unknown, unknown>;
-type ClientMap<C> = C extends ChannelContract<infer E, unknown> ? E : unknown;
-type ServerMap<C> = C extends ChannelContract<unknown, infer E> ? E : unknown;
-type IsUnknown<T> = unknown extends T ? true : false;
-type StringKey<T> = Extract<keyof T, string>;
-type EventDataArgs<Payload> = undefined extends Payload ? [data?: Payload] : [data: Payload];
-declare class Channel<Contract = UnknownContract> {
-    #private;
-    /**
-     * Channel name.
-     */
-    readonly name: string;
-    constructor(name: string, transport: SocketClientTransport);
-    /**
-     * Whether the channel should stay subscribed.
-     */
-    get subscribed(): boolean;
-    /** Whether a framework lifecycle currently owns this channel. @internal */
-    get $managed(): boolean;
-    /**
-     * Whether the channel is active on the server.
-     */
-    get active(): boolean;
-    /**
-     * List of present users.
-     */
-    get users(): PresenceUser[];
-    /**
-     * Number of present users.
-     */
-    get count(): number;
-    /**
-     * Registers a handler called with the present users.
-     * Called immediately on subscribe and after each presence change.
-     */
-    here(handler: EventHandler<PresenceUser[]>): this;
-    /**
-     * Registers a handler called when a user joins.
-     */
-    joining(handler: EventHandler<PresenceUser>): this;
-    /**
-     * Registers a handler called when a user leaves.
-     */
-    leaving(handler: EventHandler<PresenceUser>): this;
-    /**
-     * Listens for an event on this channel.
-     */
-    listen<T = unknown>(this: IsUnknown<ServerMap<Contract>> extends true ? Channel<Contract> : never, event: string, handler: EventHandler<T>): this;
-    listen<Event extends StringKey<ServerMap<Contract>>>(this: Channel<Contract>, event: Event, handler: EventHandler<ServerMap<Contract>[Event]>): this;
-    /**
-     * Removes an event listener.
-     */
-    stopListening<T = unknown>(this: IsUnknown<ServerMap<Contract>> extends true ? Channel<Contract> : never, event: string, handler?: EventHandler<T>): this;
-    stopListening<Event extends StringKey<ServerMap<Contract>>>(this: Channel<Contract>, event: Event, handler?: EventHandler<ServerMap<Contract>[Event]>): this;
-    /** Registers a lifecycle-owned event handler. @internal */
-    $listen(event: string, handler: EventHandler<any>): void;
-    /** Removes a lifecycle-owned event handler. @internal */
-    $stopListening(event: string, handler: EventHandler<any>): void;
-    /**
-     * Listens for a client event whispered by another channel member.
-     */
-    listenForWhisper<T = unknown>(event: string, handler: EventHandler<T>): this;
-    /**
-     * Removes a whispered client event listener.
-     */
-    stopListeningForWhisper<T = unknown>(event: string, handler?: EventHandler<T>): this;
-    /**
-     * Subscribes to the channel.
-     *
-     * client listeners -> subscribe ack -> active channel
-     *        |                 |                 |
-     *        v                 v                 v
-     *     events ready     presence sync      send/listen
-     */
-    subscribe(options?: SubscribeOptions): Promise<this>;
-    /** Acquires subscription intent without overriding a direct consumer. @internal */
-    $acquire(options?: SubscribeOptions): {
-        ready: Promise<Channel<Contract>>;
-        release: () => Promise<void>;
-    };
-    /** Restores desired subscriptions after the transport reconnects. @internal */
-    $resubscribe(options?: SubscribeOptions): Promise<this>;
-    /**
-     * Unsubscribes from the channel.
-     */
-    unsubscribe(options?: UnsubscribeOptions): Promise<void>;
-    /**
-     * Sends an event to the server.
-     */
-    send<T = unknown>(this: IsUnknown<ClientMap<Contract>> extends true ? Channel<Contract> : never, event: string, data?: T): this;
-    send<Event extends StringKey<ClientMap<Contract>>>(this: Channel<Contract>, event: Event, ...[data]: ClientMap<Contract>[Event] extends {
-        payload: infer Payload;
-    } ? EventDataArgs<Payload> : never): this;
-    /**
-     * Relays a client event to other members of this channel.
-     */
-    whisper<T = unknown>(event: string, data?: T): this;
-    /**
-     * Sends an event and waits for a response.
-     */
-    sendWithAck<T = unknown, Result = unknown>(this: IsUnknown<ClientMap<Contract>> extends true ? Channel<Contract> : never, event: string, data?: T): Promise<Result>;
-    sendWithAck<Event extends StringKey<ClientMap<Contract>>>(this: Channel<Contract>, event: Event, ...[data]: ClientMap<Contract>[Event] extends {
-        payload: infer Payload;
-    } ? EventDataArgs<Payload> : never): Promise<ClientMap<Contract>[Event] extends {
-        ack: infer Acknowledgement;
-    } ? Acknowledgement : unknown>;
-}
-
-/**
- * Main Socket client.
- */
-type ChannelResult<Registry, Name extends string> = string extends Name ? Channel<unknown> : [Registry] extends [never] ? Channel : ChannelContractFor<Registry, Name> extends infer Contract ? [Contract] extends [never] ? never : Channel<Contract> : never;
-declare class Socket<Registry = never> implements SocketClientTransport {
-    #private;
-    constructor(options?: SocketOptions);
-    get state(): ConnectionState;
-    get connected(): boolean;
-    connect(): Promise<void>;
-    disconnect(): void;
-    channel<const Name extends string>(name: Name & (ChannelResult<Registry, Name> extends never ? never : unknown)): ChannelResult<Registry, Name>;
-    leave(name: string): Promise<void>;
-    onStateChange(handler: EventHandler<ConnectionState>): () => void;
-    on<T = unknown>(event: string, handler: EventHandler<T>): () => void;
-    off<T = unknown>(event: string, handler: EventHandler<T>): void;
-    send(message: Record<string, unknown>): void;
-    sendRequest<T = unknown>(message: Record<string, unknown>, timeout?: number): Promise<T>;
-}
-
-export { Channel, ConnectionState, EventHandler, PresenceUser, Socket, SocketOptions, SubscribeOptions, UnsubscribeOptions };