@rlanz/socket 0.0.1-4 → 0.0.1-6

package/build/src/assembler_hook.js

@@ -0,0 +1,261 @@
+// src/assembler_hook.ts
+import fs from "fs";
+import ts from "typescript";
+function quote(value) {
+  return `'${value.replaceAll("\\", "\\\\").replaceAll("'", "\\'")}'`;
+}
+function generatedImportPath(importPath) {
+  return importPath.replace(/\.ts$/, "");
+}
+function appImportAlias(source) {
+  const normalized = source.replace(/^\.\//, "");
+  if (normalized === "app") return "#app";
+  if (normalized.startsWith("app/")) return `#app/${normalized.slice("app/".length)}`;
+  throw new Error("[socket] Channel source must be inside the app directory");
+}
+function fail(filePath, message) {
+  throw new Error(`[socket] Cannot generate client types for ${filePath}: ${message}`);
+}
+function propertyName(node) {
+  if (node && (ts.isIdentifier(node) || ts.isStringLiteral(node))) return node.text;
+}
+function isPublic(method) {
+  return !method.modifiers?.some(
+    (modifier) => modifier.kind === ts.SyntaxKind.PrivateKeyword || modifier.kind === ts.SyntaxKind.ProtectedKeyword
+  );
+}
+function isStatic(member) {
+  return ts.canHaveModifiers(member) && !!ts.getModifiers(member)?.some((modifier) => modifier.kind === ts.SyntaxKind.StaticKeyword);
+}
+function validateHandlerMethod(filePath, method, name) {
+  const parameters = method.parameters.filter(
+    (parameter) => !(ts.isIdentifier(parameter.name) && parameter.name.text === "this")
+  );
+  if (parameters.some((parameter) => parameter.dotDotDotToken)) {
+    fail(filePath, `handler method ${name} must not use rest parameters`);
+  }
+  if (parameters.slice(2).some((parameter) => !parameter.questionToken && !parameter.initializer)) {
+    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,
+    fs.readFileSync(filePath, "utf8"),
+    ts.ScriptTarget.Latest,
+    true,
+    filePath.endsWith(".js") ? ts.ScriptKind.JS : ts.ScriptKind.TS
+  );
+  const decoratorImports = /* @__PURE__ */ new Set();
+  const decoratorNamespaces = /* @__PURE__ */ new Set();
+  const baseChannelImports = /* @__PURE__ */ new Set();
+  const socketNamespaces = /* @__PURE__ */ new Set();
+  for (const statement of source.statements) {
+    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier) || statement.moduleSpecifier.text !== "@rlanz/socket/decorators" && statement.moduleSpecifier.text !== "@rlanz/socket") {
+      continue;
+    }
+    const bindings = statement.importClause?.namedBindings;
+    if (bindings && ts.isNamedImports(bindings)) {
+      for (const binding of bindings.elements) {
+        const importedName = (binding.propertyName ?? binding.name).text;
+        if (statement.moduleSpecifier.text === "@rlanz/socket/decorators" && importedName === "onMessage") {
+          decoratorImports.add(binding.name.text);
+        }
+        if (statement.moduleSpecifier.text === "@rlanz/socket" && importedName === "BaseChannel") {
+          baseChannelImports.add(binding.name.text);
+        }
+      }
+    } else if (bindings && ts.isNamespaceImport(bindings)) {
+      if (statement.moduleSpecifier.text === "@rlanz/socket/decorators") {
+        decoratorNamespaces.add(bindings.name.text);
+      } else {
+        socketNamespaces.add(bindings.name.text);
+      }
+    }
+  }
+  const classes = source.statements.filter(ts.isClassDeclaration);
+  let channelClass = classes.find(
+    (node) => node.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.DefaultKeyword)
+  );
+  if (!channelClass) {
+    const defaultExport = source.statements.find(
+      (node) => ts.isExportAssignment(node) && !node.isExportEquals
+    );
+    if (defaultExport && ts.isIdentifier(defaultExport.expression)) {
+      const defaultClassName = defaultExport.expression.text;
+      channelClass = classes.find((node) => node.name?.text === defaultClassName);
+    }
+  }
+  if (!channelClass) fail(filePath, "a default-exported channel class was not found");
+  if (channelClass.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.AbstractKeyword)) {
+    fail(filePath, "the default-exported channel class must not be abstract");
+  }
+  const extendsType = channelClass.heritageClauses?.find((clause) => clause.token === ts.SyntaxKind.ExtendsKeyword)?.types.at(0);
+  const extendsExpression = extendsType?.expression;
+  const directlyExtendsBaseChannel = extendsExpression && ts.isIdentifier(extendsExpression) && baseChannelImports.has(extendsExpression.text) || extendsExpression && ts.isPropertyAccessExpression(extendsExpression) && ts.isIdentifier(extendsExpression.expression) && socketNamespaces.has(extendsExpression.expression.text) && extendsExpression.name.text === "BaseChannel";
+  if (!directlyExtendsBaseChannel) {
+    return `Omitted ${importPath}: generated contracts do not support channel inheritance; the default export must directly extend BaseChannel imported from @rlanz/socket.`;
+  }
+  const patternMember = channelClass.members.find(
+    (member) => ts.isPropertyDeclaration(member) && propertyName(member.name) === "pattern" && !!member.modifiers?.some((modifier) => modifier.kind === ts.SyntaxKind.StaticKeyword)
+  );
+  if (!patternMember || !patternMember.initializer || !ts.isStringLiteral(patternMember.initializer)) {
+    return `Omitted ${importPath}: static pattern must be a direct string literal.`;
+  }
+  if (!isSupportedPattern(patternMember.initializer.text)) {
+    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;
+      const isImportedDecorator = ts.isCallExpression(expression) && (ts.isIdentifier(expression.expression) && decoratorImports.has(expression.expression.text) || ts.isPropertyAccessExpression(expression.expression) && ts.isIdentifier(expression.expression.expression) && decoratorNamespaces.has(expression.expression.expression.text) && expression.expression.name.text === "onMessage");
+      if (!isImportedDecorator || !ts.isCallExpression(expression)) {
+        continue;
+      }
+      if (isStatic(method)) {
+        fail(filePath, "@onMessage cannot generate a contract for a static method");
+      }
+      if (expression.arguments.length !== 1 || !ts.isStringLiteral(expression.arguments[0])) {
+        fail(
+          filePath,
+          `@onMessage on ${propertyName(method.name) ?? "<computed>"} needs a literal event`
+        );
+      }
+      const event = expression.arguments[0].text;
+      const name = propertyName(method.name);
+      if (!name || !ts.isIdentifier(method.name)) fail(filePath, "@onMessage methods must be named");
+      if (!isPublic(method)) fail(filePath, `decorated handler method ${name} must be public`);
+      validateHandlerMethod(filePath, method, name);
+      if (handlers.some((handler) => handler.event === event)) {
+        fail(filePath, `event "${event}" is mapped more than once`);
+      }
+      handlers.push({ event, method: name });
+    }
+  }
+  return { pattern: patternMember.initializer.text, importPath, handlers };
+}
+function generateSocketRegistry(options = {}) {
+  return {
+    run(_parent, hooks, indexGenerator) {
+      const source = options.source ?? "./app/channels";
+      const glob = options.glob ?? ["**/*_channel.{ts,js}"];
+      const importAlias = appImportAlias(source);
+      indexGenerator.add("socketChannels", {
+        source,
+        glob,
+        importAlias,
+        output: options.output ?? "./.adonisjs/client/socket.ts",
+        as(vfs, buffer, _config, helpers) {
+          const channels = [];
+          const diagnostics = [];
+          for (const filePath of Object.values(vfs.asList())) {
+            const importPath = generatedImportPath(helpers.toImportPath(filePath));
+            const inspected = inspectChannel(filePath, importPath);
+            if (typeof inspected === "string") diagnostics.push(inspected);
+            else channels.push(inspected);
+          }
+          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();
+          for (const channel of channels) {
+            buffer.writeLine("{").indent();
+            buffer.writeLine(`readonly pattern: ${quote(channel.pattern)}`);
+            buffer.writeLine(
+              `readonly channel: typeof import(${quote(channel.importPath)}).default`
+            );
+            buffer.writeLine("readonly handlers: {").indent();
+            for (const handler of channel.handlers) {
+              buffer.writeLine(`readonly ${quote(handler.event)}: ${quote(handler.method)}`);
+            }
+            buffer.dedent().writeLine("}");
+            buffer.dedent().writeLine("},");
+          }
+          buffer.dedent().writeLine("]");
+          buffer.dedent().writeLine("}");
+        }
+      });
+      indexGenerator.add("socketServerChannels", {
+        source,
+        glob,
+        importAlias,
+        output: "./.adonisjs/server/socket_channels.ts",
+        as(vfs, buffer, _config, helpers) {
+          const filePaths = Object.values(vfs.asList());
+          filePaths.forEach((filePath, index) => {
+            const importPath = generatedImportPath(helpers.toImportPath(filePath));
+            buffer.writeLine(`import Channel${index} from ${quote(importPath)}`);
+          });
+          if (filePaths.length) buffer.writeLine("");
+          buffer.writeLine(
+            `export const socketChannels = [${filePaths.map((_filePath, index) => `Channel${index}`).join(", ")}] as const`
+          );
+        }
+      });
+      hooks.add("fileChanged", (_relativePath, absolutePath) => {
+        return indexGenerator.addFile(absolutePath);
+      });
+    }
+  };
+}
+var socketRegistryHook = generateSocketRegistry();
+var lazySocketRegistryHook = socketRegistryHook.run;
+var assembler_hook_default = lazySocketRegistryHook;
+export {
+  assembler_hook_default as default,
+  generateSocketRegistry
+};
+//# sourceMappingURL=assembler_hook.js.map

package/build/src/assembler_hook.js.map

@@ -0,0 +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":[]}

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

@@ -1,6 +1,11 @@
-import { SocketClientTransport, PresenceUser, EventHandler, SubscribeOptions, UnsubscribeOptions, SocketOptions, ConnectionState } from './types.js';
+import { ChannelContract, SocketClientTransport, PresenceUser, EventHandler, SubscribeOptions, UnsubscribeOptions, SocketOptions, ConnectionState, ChannelContractFor } from './types.js';
 export { PresenceData, SubscribeAckData, SubscribeResult } from './types.js';
-export { C as ChannelAck, a as ChannelMessage } from '../../shared_types-Dw9AphfO.js';
+export { b as ChannelAck, c as ChannelMessage } from '../../types-DiYaFvgi.js';
+import 'ws';
+import 'node:http';
+import '@adonisjs/core/types/http';
+import '@adonisjs/core/http';
+import '@boringnode/bus/types/main';
 
 /**
  * Represents a subscribed channel.
@@ -16,7 +21,13 @@ export { C as ChannelAck, a as ChannelMessage } from '../../shared_types-Dw9Aphf
  *   .subscribe()
  * ```
  */
-declare class Channel {
+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.
@@ -27,6 +38,8 @@ declare class Channel {
      * 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.
      */
@@ -55,11 +68,17 @@ declare class Channel {
     /**
      * Listens for an event on this channel.
      */
-    listen<T = unknown>(event: string, handler: EventHandler<T>): this;
+    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(event: string, handler?: EventHandler): this;
+    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.
      */
@@ -67,7 +86,7 @@ declare class Channel {
     /**
      * Removes a whispered client event listener.
      */
-    stopListeningForWhisper(event: string, handler?: EventHandler): this;
+    stopListeningForWhisper<T = unknown>(event: string, handler?: EventHandler<T>): this;
     /**
      * Subscribes to the channel.
      *
@@ -77,6 +96,13 @@ declare class Channel {
      *     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.
      */
@@ -84,7 +110,10 @@ declare class Channel {
     /**
      * Sends an event to the server.
      */
-    send<T = unknown>(event: string, data?: T): this;
+    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.
      */
@@ -92,25 +121,30 @@ declare class Channel {
     /**
      * Sends an event and waits for a response.
      */
-    sendWithAck<T = unknown, R = unknown>(event: string, data?: T): Promise<R>;
+    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.
  */
-declare class Socket implements SocketClientTransport {
+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;
-    get id(): string | undefined;
     connect(): Promise<void>;
     disconnect(): void;
-    channel(name: string): Channel;
+    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(event: string, handler: EventHandler): 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>;
 }