@spectrum-ts/core 5.0.0

package/dist/express.js

@@ -0,0 +1,37 @@
+import express from "express";
+//#region src/express.ts
+/**
+* Mount a Spectrum webhook endpoint on an Express app.
+*
+* @example
+* ```ts
+* import express from "express";
+* import { Spectrum } from "spectrum-ts";
+* import { spectrum } from "spectrum-ts/express";
+*
+* const app = await Spectrum({ ...,  webhookSecret: process.env.SPECTRUM_WEBHOOK_SECRET });
+*
+* const server = express();
+* server.use(spectrum({ // mount before any global express.json()
+*   app,
+*   onMessage: async (space, message) => {
+*     if (message.content.type === "text") await space.send(`echo: ${message.content.text}`);
+*   },
+* }));
+* server.listen(3000);
+* ```
+*/
+function spectrum(options) {
+	const { app, onMessage, path = "/spectrum/webhook" } = options;
+	const router = express.Router();
+	router.post(path, express.raw({ type: "*/*" }), async (req, res) => {
+		const result = await app.webhook({
+			body: req.body,
+			headers: req.headers
+		}, onMessage);
+		res.status(result.status).set(result.headers).send(Buffer.from(result.body));
+	});
+	return router;
+}
+//#endregion
+export { spectrum };

package/dist/hono.d.ts

@@ -0,0 +1,59 @@
+import { T as WebhookHandler, nn as Message, rn as Space } from "./attachment-a_lrhg6w.js";
+
+//#region src/hono.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): 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;
+  /**
+   * Route the webhook is mounted on.
+   *
+   * @default "/spectrum/webhook"
+   */
+  path?: string;
+}
+/**
+ * Mount a Spectrum webhook endpoint on a Hono app.
+ *
+ * @example
+ * ```ts
+ * import { Hono } from "hono";
+ * import { Spectrum } from "spectrum-ts";
+ * import { spectrum } from "spectrum-ts/hono";
+ *
+ * const app = await Spectrum({ ...,  webhookSecret: process.env.SPECTRUM_WEBHOOK_SECRET });
+ *
+ * const server = new Hono().route("/", spectrum({
+ *   app,
+ *   onMessage: async (space, message) => {
+ *     if (message.content.type === "text") await space.send(`echo: ${message.content.text}`);
+ *   },
+ * }));
+ * ```
+ */
+declare function spectrum(options: SpectrumPluginOptions): import("hono/hono-base").HonoBase<import("hono/types").BlankEnv, {
+  [x: string]: {
+    $post: {
+      input: {};
+      output: {};
+      outputFormat: string;
+      status: import("hono/utils/http-status").StatusCode;
+    };
+  };
+}, "/", string>;
+//#endregion
+export { type Message, type Space, SpectrumPluginOptions, type WebhookHandler, spectrum };

package/dist/hono.js

@@ -0,0 +1,27 @@
+import { Hono } from "hono";
+//#region src/hono.ts
+/**
+* Mount a Spectrum webhook endpoint on a Hono app.
+*
+* @example
+* ```ts
+* import { Hono } from "hono";
+* import { Spectrum } from "spectrum-ts";
+* import { spectrum } from "spectrum-ts/hono";
+*
+* const app = await Spectrum({ ...,  webhookSecret: process.env.SPECTRUM_WEBHOOK_SECRET });
+*
+* const server = new Hono().route("/", spectrum({
+*   app,
+*   onMessage: async (space, message) => {
+*     if (message.content.type === "text") await space.send(`echo: ${message.content.text}`);
+*   },
+* }));
+* ```
+*/
+function spectrum(options) {
+	const { app, onMessage, path = "/spectrum/webhook" } = options;
+	return new Hono().post(path, (c) => app.webhook(c.req.raw, onMessage));
+}
+//#endregion
+export { spectrum };

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { $ as FusorTokenData, A as isFusorEvent, An as AppLayout, At as Rename, B as PlatformUser, C as FusorVerify, Cn as Avatar, Ct as text, D as WebhookRawResult, Dt as resolveContents, E as WebhookRawRequest, Et as richlink, F as PlatformInstance, Ft as Poll, G as Broadcaster, Gt as markdown, Ht as poll, I as PlatformMessage, It as PollChoice, J as mergeStreams, Jt as StreamTextSource, K as ManagedStream, Kt as DeltaExtractor, L as PlatformProviderConfig, Lt as PollChoiceInput, M as EventProducer, Mn as app, Mt as Read, N as Platform, Nn as appLayoutSchema, O as FusorEvent, Ot as Reply, P as PlatformDef, Pt as read, Q as DedicatedTokenData, Qt as group, R as PlatformRuntime, Rt as PollOption, S as FusorRespond, Sn as User, T as WebhookHandler, Tn as avatar, U as SchemaMessage, Ut as Markdown, V as ProviderMessage, Vt as option, W as SpaceNamespace, X as Store, Xt as Group, Y as stream, Yt as TextStreamOptions, Z as CloudPlatform, _ as FusorClient, _n as ContactOrg, _t as voice, a as Content, an as ReactionBuilder, at as SharedTokenData, b as FusorMessagesReturn, bn as contact, bt as Typing, c as fromVCard, ct as SpectrumCloudError, d as UnsupportedKind, dn as Contact, dt as TokenData, en as Edit, et as ImessageInfoData, f as Spectrum, fn as ContactAddress, ft as cloud, g as isFusorClient, gn as ContactName, h as fusor, hn as ContactInput, ht as Voice, i as attachment, in as Reaction, it as ProjectProfile, j as AnyPlatformDef, jn as AppUrl, jt as rename, k as fusorEvent, kn as App, kt as reply, l as toVCard, lt as SubscriptionData, m as definePlatform, mn as ContactEmail, mt as EmojiKey, n as AttachmentInput, nn as Message, nt as PlatformsData, o as ContentBuilder, ot as SlackTeamMeta, p as SpectrumInstance, pn as ContactDetails, pt as Emoji, q as broadcast, qt as StreamText, rn as Space, rt as ProjectData, s as ContentInput, sn as reaction, st as SlackTokenData, t as Attachment, tn as edit, tt as PlatformStatus, u as UnsupportedError, un as custom, ut as SubscriptionStatus, v as FusorMessages, vn as ContactPhone, vt as Unsend, w as FusorVerifyRequest, wn as AvatarInput, wt as Richlink, x as FusorReply, xn as AgentSender, xt as typing, y as FusorMessagesCtx, yt as unsend, z as PlatformSpace } from "./attachment-a_lrhg6w.js";
+export { type AgentSender, type AnyPlatformDef, type App, type AppLayout, type AppUrl, type Attachment, type AttachmentInput, type Avatar, type AvatarInput, type Broadcaster, type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, type Content, type ContentBuilder, type ContentInput, type DedicatedTokenData, type DeltaExtractor, type Edit, Emoji, type EmojiKey, type EventProducer, type FusorClient, type FusorEvent, type FusorMessages, type FusorMessagesCtx, type FusorMessagesReturn, type FusorReply, type FusorRespond, type FusorTokenData, type FusorVerify, type FusorVerifyRequest, type Group, type ImessageInfoData, type ManagedStream, type Markdown, type Message, type Platform, type PlatformDef, type PlatformInstance, type PlatformMessage, type PlatformProviderConfig, type PlatformRuntime, type PlatformSpace, type PlatformStatus, type PlatformUser, type PlatformsData, type Poll, type PollChoice, type PollChoiceInput, type PollOption, type ProjectData, type ProjectProfile, type ProviderMessage, type Reaction, type ReactionBuilder, type Read, type Rename, type Reply, type Richlink, type SchemaMessage, type SharedTokenData, type SlackTeamMeta, type SlackTokenData, type Space, type SpaceNamespace, Spectrum, SpectrumCloudError, type SpectrumInstance, type Store, type StreamText, type StreamTextSource, type SubscriptionData, type SubscriptionStatus, type TextStreamOptions, type TokenData, type Typing, type Unsend, UnsupportedError, type UnsupportedKind, type User, type Voice, type WebhookHandler, type WebhookRawRequest, type WebhookRawResult, app, appLayoutSchema, attachment, avatar, broadcast, cloud, contact, custom, definePlatform, edit, fromVCard, fusor, fusorEvent, group, isFusorClient, isFusorEvent, markdown, mergeStreams, option, poll, reaction, read, rename, reply, resolveContents, richlink, stream, text, toVCard, typing, unsend, voice };