@spectrum-ts/elysia 7.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2025 Photon AI
+
+Permission is hereby granted,
+free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# @spectrum-ts/elysia
+
+[ElysiaJS](https://elysiajs.com) webhook adapter for [spectrum-ts](https://github.com/photon-hq/spectrum-ts).
+
+## Install
+
+```sh
+bun add spectrum-ts @spectrum-ts/elysia elysia
+```
+
+## Use
+
+```ts
+import { Spectrum } from "spectrum-ts";
+import { spectrum } from "@spectrum-ts/elysia";
+import { Elysia } from "elysia";
+
+const app = await Spectrum({
+  webhookSecret: process.env.SPECTRUM_WEBHOOK_SECRET,
+});
+
+new Elysia()
+  .use(
+    spectrum({
+      app,
+      onMessage: async (space, message) => {
+        if (message.content.type === "text") {
+          await space.send(`echo: ${message.content.text}`);
+        }
+      },
+    })
+  )
+  .listen(3000);
+```
+
+See the [spectrum-ts documentation](https://photon.codes/spectrum) for the full guide.

package/dist/index.d.ts

@@ -0,0 +1,92 @@
+import { Elysia } from "elysia";
+import { Message, Space, WebhookHandler, WebhookHandler as WebhookHandler$1 } from "@spectrum-ts/core";
+
+//#region src/index.d.ts
+/**
+ * The minimal structural surface of a Spectrum instance the plugin needs. Kept
+ * structural (rather than importing the generic `SpectrumInstance<Providers>`)
+ * so the plugin stays decoupled from provider typing; a real instance is
+ * assignable via its Web `Request` webhook overload.
+ */
+interface WebhookReceiver {
+  webhook(request: Request, handler: WebhookHandler$1): Promise<Response>;
+}
+interface SpectrumPluginOptions {
+  /** The Spectrum instance returned by `await Spectrum({...})`. */
+  app: WebhookReceiver;
+  /**
+   * Invoked once per inbound message, fire-and-forget after the response — the
+   * same `(space, message)` contract as `app.webhook(request, handler)`. Covers
+   * both native Spectrum webhooks and fusor webhooks identically.
+   */
+  onMessage: WebhookHandler$1;
+  /**
+   * Route the webhook is mounted on.
+   *
+   * @default "/spectrum/webhook"
+   */
+  path?: string;
+}
+/**
+ * Mount a Spectrum webhook endpoint on an Elysia app.
+ *
+ * @example
+ * ```ts
+ * import { Elysia } from "elysia";
+ * import { Spectrum } from "spectrum-ts";
+ * import { spectrum } from "@spectrum-ts/elysia";
+ *
+ * const app = await Spectrum({ ...,  webhookSecret: process.env.SPECTRUM_WEBHOOK_SECRET });
+ *
+ * new Elysia()
+ *   .use(spectrum({
+ *     app,
+ *     onMessage: async (space, message) => {
+ *       if (message.content.type === "text") await space.send(`echo: ${message.content.text}`);
+ *     },
+ *   }))
+ *   .listen(3000);
+ * ```
+ */
+declare function spectrum(options: SpectrumPluginOptions): Elysia<"", {
+  decorator: {};
+  store: {};
+  derive: {};
+  resolve: {};
+}, {
+  typebox: {};
+  error: {};
+}, {
+  schema: {};
+  standaloneSchema: {};
+  macro: {};
+  macroFn: {};
+  parser: {};
+  response: {};
+}, {
+  [x: string]: {
+    post: {
+      body: unknown;
+      params: {};
+      query: unknown;
+      headers: unknown;
+      response: {
+        200: Response;
+      };
+    };
+  };
+}, {
+  derive: {};
+  resolve: {};
+  schema: {};
+  standaloneSchema: {};
+  response: {};
+}, {
+  derive: {};
+  resolve: {};
+  schema: {};
+  standaloneSchema: {};
+  response: {};
+}>;
+//#endregion
+export { type Message, type Space, SpectrumPluginOptions, type WebhookHandler, spectrum };

package/dist/index.js

@@ -0,0 +1,32 @@
+import { Elysia } from "elysia";
+//#region src/index.ts
+/**
+* Mount a Spectrum webhook endpoint on an Elysia app.
+*
+* @example
+* ```ts
+* import { Elysia } from "elysia";
+* import { Spectrum } from "spectrum-ts";
+* import { spectrum } from "@spectrum-ts/elysia";
+*
+* const app = await Spectrum({ ...,  webhookSecret: process.env.SPECTRUM_WEBHOOK_SECRET });
+*
+* new Elysia()
+*   .use(spectrum({
+*     app,
+*     onMessage: async (space, message) => {
+*       if (message.content.type === "text") await space.send(`echo: ${message.content.text}`);
+*     },
+*   }))
+*   .listen(3000);
+* ```
+*/
+function spectrum(options) {
+	const { app, onMessage, path = "/spectrum/webhook" } = options;
+	return new Elysia({
+		name: "spectrum-webhook",
+		seed: path
+	}).post(path, ({ request }) => app.webhook(request, onMessage), { parse: "none" });
+}
+//#endregion
+export { spectrum };

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@spectrum-ts/elysia",
+  "version": "7.0.0",
+  "description": "ElysiaJS webhook adapter for spectrum-ts.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/photon-hq/spectrum-ts.git",
+    "directory": "packages/elysia"
+  },
+  "homepage": "https://photon.codes/spectrum",
+  "bugs": {
+    "url": "https://github.com/photon-hq/spectrum-ts/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@spectrum-ts/core": "^7.0.0",
+    "elysia": "^1",
+    "typescript": "^5 || ^6.0.0"
+  },
+  "license": "MIT"
+}