@joeybuilt/plexo-sdk 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/connect/index.d.ts +52 -2
- package/dist/connect/index.js +69 -3
- package/dist/connect/index.js.map +1 -1
- package/package.json +1 -1
package/dist/connect/index.d.ts
CHANGED
|
@@ -42,6 +42,8 @@ interface PlexoClientOptions {
|
|
|
42
42
|
plexoUrl: string;
|
|
43
43
|
/** Shared service key — must match PLEXO_SERVICE_KEY on Plexo Core. */
|
|
44
44
|
serviceKey: string;
|
|
45
|
+
/** Service key version sent as X-Service-Key-Version. Default: 'v1'. */
|
|
46
|
+
serviceKeyVersion?: string;
|
|
45
47
|
/** Human-readable app name shown in Plexo UI. Defaults to appId. */
|
|
46
48
|
displayName?: string;
|
|
47
49
|
/** Tools, channels, and connectors this app exposes to Plexo agents. */
|
|
@@ -68,6 +70,24 @@ interface PlexoToken {
|
|
|
68
70
|
email: string | null;
|
|
69
71
|
scope: string | null;
|
|
70
72
|
}
|
|
73
|
+
interface PlexoTask {
|
|
74
|
+
id: string;
|
|
75
|
+
type: string;
|
|
76
|
+
status: string;
|
|
77
|
+
priority: number | null;
|
|
78
|
+
context: Record<string, unknown>;
|
|
79
|
+
createdAt: string;
|
|
80
|
+
updatedAt: string;
|
|
81
|
+
}
|
|
82
|
+
interface PlexoTokenWithConnection extends PlexoToken {
|
|
83
|
+
connectionId: string;
|
|
84
|
+
}
|
|
85
|
+
interface InstallConnectionOptions {
|
|
86
|
+
workspaceId: string;
|
|
87
|
+
registryId: string;
|
|
88
|
+
name: string;
|
|
89
|
+
credentials?: Record<string, unknown>;
|
|
90
|
+
}
|
|
71
91
|
interface AiMessage {
|
|
72
92
|
role: 'system' | 'user' | 'assistant';
|
|
73
93
|
content: string;
|
|
@@ -106,6 +126,14 @@ interface DispatchOptions {
|
|
|
106
126
|
metadata?: Record<string, unknown>;
|
|
107
127
|
};
|
|
108
128
|
idempotencyKey: string;
|
|
129
|
+
scopeOverrides?: Record<string, unknown>;
|
|
130
|
+
}
|
|
131
|
+
/** Optional dispatch context — adds tenancy/trace headers when provided. */
|
|
132
|
+
interface DispatchContext {
|
|
133
|
+
tenantId?: string;
|
|
134
|
+
workspaceId?: string;
|
|
135
|
+
userId?: string;
|
|
136
|
+
traceId?: string;
|
|
109
137
|
}
|
|
110
138
|
interface DispatchResult {
|
|
111
139
|
messageId?: string;
|
|
@@ -160,13 +188,35 @@ declare class PlexoClient {
|
|
|
160
188
|
get isConfigured(): boolean;
|
|
161
189
|
register(): Promise<void>;
|
|
162
190
|
ensureWorkspace(userId: string, email?: string): Promise<string>;
|
|
191
|
+
/**
|
|
192
|
+
* Idempotent get-or-create + auto-install of this app's connection.
|
|
193
|
+
* Used when an app needs Plexo to know about a user without going
|
|
194
|
+
* through the workspace-ensure → install dance separately.
|
|
195
|
+
*/
|
|
196
|
+
autoAttachUser(userId: string, email?: string): Promise<{
|
|
197
|
+
workspaceId: string;
|
|
198
|
+
}>;
|
|
163
199
|
getInstalledConnections(workspaceId: string): Promise<PlexoConnection[]>;
|
|
164
200
|
getToken(workspaceId: string, registryId: string): Promise<PlexoToken | null>;
|
|
165
201
|
disconnect(workspaceId: string, connectionId: string): Promise<void>;
|
|
202
|
+
/**
|
|
203
|
+
* Idempotent install. Returns true if already present or newly installed,
|
|
204
|
+
* false on error. Empty `credentials` are valid for app-owned bridges.
|
|
205
|
+
*/
|
|
206
|
+
installConnection(opts: InstallConnectionOptions): Promise<boolean>;
|
|
207
|
+
/**
|
|
208
|
+
* Multi-token fetch for a registry (e.g. multi-account Google Workspace).
|
|
209
|
+
* Falls back to per-connection getToken() if the bulk endpoint 404s.
|
|
210
|
+
*/
|
|
211
|
+
getTokens(workspaceId: string, registryId: string): Promise<PlexoTokenWithConnection[]>;
|
|
212
|
+
getTasks(workspaceId: string, opts?: {
|
|
213
|
+
status?: string;
|
|
214
|
+
limit?: number;
|
|
215
|
+
}): Promise<PlexoTask[]>;
|
|
166
216
|
oauthPopupUrl(provider: string, workspaceId: string): string;
|
|
167
217
|
aiComplete(workspaceId: string, opts: AiCompleteOptions): Promise<string>;
|
|
168
218
|
chatMessage(workspaceId: string, userId: string, opts: ChatOptions): Promise<ChatReply>;
|
|
169
|
-
dispatch(opts: DispatchOptions): Promise<DispatchResult>;
|
|
219
|
+
dispatch(opts: DispatchOptions, ctx?: DispatchContext): Promise<DispatchResult>;
|
|
170
220
|
/** Returns a framework-agnostic handler for Plexo → app push requests. */
|
|
171
221
|
inbound(handlers: InboundHandlers): {
|
|
172
222
|
handle(req: Request): Promise<Response>;
|
|
@@ -243,4 +293,4 @@ declare function verifyInboundSignature(body: string, signature: string | null,
|
|
|
243
293
|
*/
|
|
244
294
|
declare function createPlexoClient(opts: PlexoClientOptions): PlexoClient;
|
|
245
295
|
|
|
246
|
-
export { type AiCompleteOptions, type AiMessage, type AppChannelConfig, type AppConnectorConfig, type AppExtension, type AppProfile, type AppToolConfig, type ChatOptions, type ChatReply, type DataQuery, type DataResponse, type DispatchOptions, type DispatchResult, type InboundEvent, type InboundEventType, type InboundHandlers, type InboundVerifyResult, PlexoApiError, PlexoAuthError, PlexoClient, type PlexoClientOptions, type PlexoConnection, PlexoNotConfiguredError, PlexoRateLimitedError, type PlexoToken, PlexoUnreachableError, type ResilienceOptions, type TestConnectionResult, createPlexoClient, verifyInboundSignature };
|
|
296
|
+
export { type AiCompleteOptions, type AiMessage, type AppChannelConfig, type AppConnectorConfig, type AppExtension, type AppProfile, type AppToolConfig, type ChatOptions, type ChatReply, type DataQuery, type DataResponse, type DispatchContext, type DispatchOptions, type DispatchResult, type InboundEvent, type InboundEventType, type InboundHandlers, type InboundVerifyResult, type InstallConnectionOptions, PlexoApiError, PlexoAuthError, PlexoClient, type PlexoClientOptions, type PlexoConnection, PlexoNotConfiguredError, PlexoRateLimitedError, type PlexoTask, type PlexoToken, type PlexoTokenWithConnection, PlexoUnreachableError, type ResilienceOptions, type TestConnectionResult, createPlexoClient, verifyInboundSignature };
|
package/dist/connect/index.js
CHANGED
|
@@ -203,6 +203,18 @@ var PlexoClient = class {
|
|
|
203
203
|
);
|
|
204
204
|
return data.workspaceId;
|
|
205
205
|
}
|
|
206
|
+
/**
|
|
207
|
+
* Idempotent get-or-create + auto-install of this app's connection.
|
|
208
|
+
* Used when an app needs Plexo to know about a user without going
|
|
209
|
+
* through the workspace-ensure → install dance separately.
|
|
210
|
+
*/
|
|
211
|
+
async autoAttachUser(userId, email) {
|
|
212
|
+
return await this.#post(
|
|
213
|
+
"/api/v1/auth/profiles/auto-attach-user",
|
|
214
|
+
{ userId, email, name: this.#opts.displayName ?? this.#opts.appId },
|
|
215
|
+
{ userId }
|
|
216
|
+
);
|
|
217
|
+
}
|
|
206
218
|
// -----------------------------------------------------------------------
|
|
207
219
|
// Connections
|
|
208
220
|
// -----------------------------------------------------------------------
|
|
@@ -231,6 +243,55 @@ var PlexoClient = class {
|
|
|
231
243
|
`/api/v1/connections/installed/${encodeURIComponent(connectionId)}?workspaceId=${encodeURIComponent(workspaceId)}`
|
|
232
244
|
);
|
|
233
245
|
}
|
|
246
|
+
/**
|
|
247
|
+
* Idempotent install. Returns true if already present or newly installed,
|
|
248
|
+
* false on error. Empty `credentials` are valid for app-owned bridges.
|
|
249
|
+
*/
|
|
250
|
+
async installConnection(opts) {
|
|
251
|
+
try {
|
|
252
|
+
const existing = await this.getInstalledConnections(opts.workspaceId);
|
|
253
|
+
if (existing.some((c) => c.registryId === opts.registryId)) return true;
|
|
254
|
+
await this.#post("/api/v1/connections/install", opts);
|
|
255
|
+
return true;
|
|
256
|
+
} catch {
|
|
257
|
+
return false;
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
/**
|
|
261
|
+
* Multi-token fetch for a registry (e.g. multi-account Google Workspace).
|
|
262
|
+
* Falls back to per-connection getToken() if the bulk endpoint 404s.
|
|
263
|
+
*/
|
|
264
|
+
async getTokens(workspaceId, registryId) {
|
|
265
|
+
try {
|
|
266
|
+
const data = await this.#get(
|
|
267
|
+
`/api/v1/connections/tokens?workspaceId=${encodeURIComponent(workspaceId)}®istryId=${encodeURIComponent(registryId)}`
|
|
268
|
+
);
|
|
269
|
+
return data;
|
|
270
|
+
} catch (err) {
|
|
271
|
+
if (!(err instanceof PlexoApiError) || err.status !== 404) throw err;
|
|
272
|
+
}
|
|
273
|
+
const conns = await this.getInstalledConnections(workspaceId);
|
|
274
|
+
const matches = conns.filter((c) => c.registryId === registryId && c.status === "active");
|
|
275
|
+
const out = [];
|
|
276
|
+
for (const c of matches) {
|
|
277
|
+
const t = await this.getToken(workspaceId, c.registryId);
|
|
278
|
+
if (t?.access_token) out.push({ ...t, connectionId: c.id });
|
|
279
|
+
}
|
|
280
|
+
return out;
|
|
281
|
+
}
|
|
282
|
+
async getTasks(workspaceId, opts = {}) {
|
|
283
|
+
const params = new URLSearchParams({
|
|
284
|
+
workspaceId,
|
|
285
|
+
limit: String(opts.limit ?? 10)
|
|
286
|
+
});
|
|
287
|
+
if (opts.status) params.set("status", opts.status);
|
|
288
|
+
try {
|
|
289
|
+
const data = await this.#get(`/api/v1/tasks?${params}`);
|
|
290
|
+
return data.items ?? [];
|
|
291
|
+
} catch {
|
|
292
|
+
return [];
|
|
293
|
+
}
|
|
294
|
+
}
|
|
234
295
|
oauthPopupUrl(provider, workspaceId) {
|
|
235
296
|
return `${this.#base}/api/oauth/${encodeURIComponent(provider)}/start?workspaceId=${encodeURIComponent(workspaceId)}`;
|
|
236
297
|
}
|
|
@@ -263,10 +324,11 @@ var PlexoClient = class {
|
|
|
263
324
|
// -----------------------------------------------------------------------
|
|
264
325
|
// Channel dispatch
|
|
265
326
|
// -----------------------------------------------------------------------
|
|
266
|
-
async dispatch(opts) {
|
|
327
|
+
async dispatch(opts, ctx = {}) {
|
|
267
328
|
const data = await this.#post(
|
|
268
329
|
"/api/v1/channel/dispatch",
|
|
269
|
-
opts
|
|
330
|
+
opts,
|
|
331
|
+
ctx
|
|
270
332
|
);
|
|
271
333
|
return { messageId: data.messageId, deliveryStatus: data.deliveryStatus };
|
|
272
334
|
}
|
|
@@ -308,9 +370,13 @@ var PlexoClient = class {
|
|
|
308
370
|
const h = {
|
|
309
371
|
"Content-Type": "application/json",
|
|
310
372
|
Authorization: `Bearer ${this.#opts.serviceKey}`,
|
|
311
|
-
"X-App-Id": this.#opts.appId
|
|
373
|
+
"X-App-Id": this.#opts.appId,
|
|
374
|
+
"X-Service-Key-Version": this.#opts.serviceKeyVersion ?? "v1"
|
|
312
375
|
};
|
|
313
376
|
if (extra.userId) h["X-User-Id"] = extra.userId;
|
|
377
|
+
if (extra.tenantId) h["X-Tenant-Id"] = extra.tenantId;
|
|
378
|
+
if (extra.workspaceId) h["X-Workspace-Id"] = extra.workspaceId;
|
|
379
|
+
if (extra.traceId) h["X-Trace-Id"] = extra.traceId;
|
|
314
380
|
return h;
|
|
315
381
|
}
|
|
316
382
|
async #get(path) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/connect/errors.ts","../../src/connect/inbound.ts","../../src/connect/registration.ts","../../src/connect/client.ts","../../src/connect/index.ts"],"sourcesContent":["// SPDX-License-Identifier: AGPL-3.0-only\n// Copyright (C) 2026 Joeybuilt LLC\n\nexport class PlexoNotConfiguredError extends Error {\n override readonly name = 'PlexoNotConfiguredError'\n constructor(missing: string) {\n super(`PlexoClient not configured: ${missing} is required`)\n }\n}\n\nexport class PlexoUnreachableError extends Error {\n override readonly name = 'PlexoUnreachableError'\n readonly url: string\n constructor(url: string, cause?: unknown) {\n super(`Plexo Core unreachable at ${url}`)\n this.url = url\n if (cause) this.cause = cause\n }\n}\n\nexport class PlexoApiError extends Error {\n override readonly name: string = 'PlexoApiError'\n readonly status: number\n readonly path: string\n constructor(status: number, path: string, detail?: string) {\n super(`Plexo API error ${status} on ${path}${detail ? `: ${detail}` : ''}`)\n this.status = status\n this.path = path\n }\n}\n\nexport class PlexoAuthError extends PlexoApiError {\n readonly name = 'PlexoAuthError' as const\n constructor(path: string) {\n super(401, path, 'invalid or missing service key')\n }\n}\n\nexport class PlexoRateLimitedError extends PlexoApiError {\n readonly name = 'PlexoRateLimitedError' as const\n readonly retryAfterMs: number\n constructor(path: string, retryAfterSec?: number) {\n super(429, path, 'rate limited')\n this.retryAfterMs = (retryAfterSec ?? 60) * 1000\n }\n}\n","// SPDX-License-Identifier: AGPL-3.0-only\n// Copyright (C) 2026 Joeybuilt LLC\n\n/**\n * Inbound request handling — verifies and dispatches requests Plexo Core\n * sends back to the app (events push + data/tool queries).\n *\n * Framework-agnostic: `handleInbound` receives a plain Request and returns\n * a plain Response so it can be wrapped in any framework's route handler.\n *\n * Next.js:\n * export const POST = (req: Request) => plexo.inbound.handle(req)\n *\n * Express:\n * app.post('/api/plexo/events', async (req, res) => {\n * const raw = JSON.stringify(req.body)\n * const r = new Request(req.url, { method:'POST', body: raw, headers: req.headers })\n * const resp = await plexo.inbound.handle(r)\n * res.status(resp.status).json(await resp.json())\n * })\n */\n\nimport { createHmac, timingSafeEqual } from 'node:crypto'\nimport type {\n DataQuery,\n DataResponse,\n InboundEvent,\n InboundHandlers,\n InboundVerifyResult,\n} from './types.js'\n\nconst SKEW_MS = 5 * 60 * 1000\n\nexport function verifyInboundSignature(\n body: string,\n signature: string | null,\n timestamp: string | null,\n serviceKey: string,\n): InboundVerifyResult {\n if (!signature || !timestamp) {\n return { ok: false, error: 'missing X-Plexo-Signature or X-Plexo-Timestamp' }\n }\n const ts = Date.parse(timestamp)\n if (Number.isNaN(ts) || Math.abs(Date.now() - ts) > SKEW_MS) {\n return { ok: false, error: 'timestamp skew exceeds 5 minutes' }\n }\n const expected = 'sha256=' + createHmac('sha256', serviceKey).update(body).digest('hex')\n const sigBuf = Buffer.from(signature)\n const expBuf = Buffer.from(expected)\n if (sigBuf.length !== expBuf.length || !timingSafeEqual(sigBuf, expBuf)) {\n return { ok: false, error: 'signature mismatch' }\n }\n return { ok: true }\n}\n\nexport function createInboundRouter(serviceKey: string, handlers: InboundHandlers) {\n return {\n async handle(req: Request): Promise<Response> {\n const body = await req.text()\n const sig = req.headers.get('x-plexo-signature')\n const ts = req.headers.get('x-plexo-timestamp')\n\n const check = verifyInboundSignature(body, sig, ts, serviceKey)\n if (!check.ok) {\n return new Response(\n JSON.stringify({ error: check.error }),\n { status: 401, headers: { 'Content-Type': 'application/json' } },\n )\n }\n\n let parsed: unknown\n try {\n parsed = JSON.parse(body)\n } catch {\n return new Response(\n JSON.stringify({ error: 'invalid JSON' }),\n { status: 400, headers: { 'Content-Type': 'application/json' } },\n )\n }\n\n const msg = parsed as Record<string, unknown>\n const kind = msg['kind'] as string | undefined\n\n try {\n if (kind === 'event' && handlers.onEvent) {\n await handlers.onEvent(msg['event'] as InboundEvent)\n return new Response(null, { status: 204 })\n }\n\n if (kind === 'data_query' && handlers.onDataQuery) {\n const query = msg['query'] as DataQuery\n const result = await handlers.onDataQuery(query)\n const response: DataResponse = { requestId: query.requestId, result }\n return new Response(\n JSON.stringify(response),\n { status: 200, headers: { 'Content-Type': 'application/json' } },\n )\n }\n\n return new Response(null, { status: 204 })\n } catch (err) {\n const response: DataResponse = {\n requestId: (msg['query'] as DataQuery | undefined)?.requestId ?? '',\n error: err instanceof Error ? err.message : String(err),\n }\n return new Response(\n JSON.stringify(response),\n { status: 500, headers: { 'Content-Type': 'application/json' } },\n )\n }\n },\n }\n}\n","// SPDX-License-Identifier: AGPL-3.0-only\n// Copyright (C) 2026 Joeybuilt LLC\n\nimport type { AppProfile, PlexoClientOptions } from './types.js'\n\nfunction buildHeaders(opts: PlexoClientOptions): Record<string, string> {\n return {\n 'Content-Type': 'application/json',\n Authorization: `Bearer ${opts.serviceKey}`,\n 'X-App-Id': opts.appId,\n }\n}\n\nasync function post(\n opts: PlexoClientOptions,\n path: string,\n body: unknown,\n): Promise<boolean> {\n const fetchImpl = opts.fetchImpl ?? fetch\n try {\n const res = await fetchImpl(\n `${opts.plexoUrl.replace(/\\/$/, '')}${path}`,\n {\n method: 'POST',\n headers: buildHeaders(opts),\n body: JSON.stringify(body),\n signal: AbortSignal.timeout(8_000),\n },\n )\n if (!res.ok) {\n const detail = await res.text().catch(() => `HTTP ${res.status}`)\n console.error(`[plexo/connect] registration rejected (${res.status}): ${detail}`)\n return false\n }\n return true\n } catch (err) {\n console.warn(`[plexo/connect] registration attempt failed: ${(err as Error).message}`)\n return false\n }\n}\n\nexport async function register(\n opts: PlexoClientOptions,\n profile: AppProfile,\n): Promise<void> {\n const backoff = opts.resilience?.registrationBackoffMs ?? [5_000, 15_000, 45_000]\n\n if (await post(opts, '/api/v1/profiles/register', profile)) {\n console.info(`[plexo/connect] registered appId=${opts.appId}`)\n return\n }\n\n for (const delay of backoff) {\n console.info(`[plexo/connect] retrying registration in ${delay / 1000}s`)\n await new Promise<void>((r) => setTimeout(r, delay))\n if (await post(opts, '/api/v1/profiles/register', profile)) {\n console.info(`[plexo/connect] registered appId=${opts.appId}`)\n return\n }\n }\n\n console.warn('[plexo/connect] registration retries exhausted — running in standalone mode')\n}\n","// SPDX-License-Identifier: AGPL-3.0-only\n// Copyright (C) 2026 Joeybuilt LLC\n\nimport { PlexoApiError, PlexoAuthError, PlexoRateLimitedError, PlexoUnreachableError } from './errors.js'\nimport { createInboundRouter } from './inbound.js'\nimport { register } from './registration.js'\nimport type {\n AiCompleteOptions,\n AppProfile,\n ChatOptions,\n ChatReply,\n DispatchOptions,\n DispatchResult,\n InboundHandlers,\n PlexoClientOptions,\n PlexoConnection,\n PlexoToken,\n TestConnectionResult,\n} from './types.js'\n\nexport class PlexoClient {\n readonly #opts: PlexoClientOptions\n readonly #base: string\n\n constructor(opts: PlexoClientOptions) {\n this.#opts = opts\n this.#base = opts.plexoUrl.replace(/\\/$/, '')\n }\n\n get appId(): string { return this.#opts.appId }\n\n get isConfigured(): boolean {\n return !!(this.#opts.plexoUrl && this.#opts.serviceKey)\n }\n\n // -----------------------------------------------------------------------\n // Registration\n // -----------------------------------------------------------------------\n\n async register(): Promise<void> {\n if (!this.isConfigured) return\n\n let domain = ''\n try { domain = new URL(this.#opts.plexoUrl).host } catch {}\n\n const profile: AppProfile = {\n appId: this.#opts.appId,\n displayName: this.#opts.displayName ?? this.#opts.appId,\n domain,\n extensions: this.#opts.extensions ?? [],\n eventContracts: this.#opts.eventContracts ?? [],\n }\n await register(this.#opts, profile)\n }\n\n // -----------------------------------------------------------------------\n // Workspace\n // -----------------------------------------------------------------------\n\n async ensureWorkspace(userId: string, email?: string): Promise<string> {\n const data = await this.#post<{ workspaceId: string }>(\n '/api/v1/auth/workspace/ensure',\n { userId, email, name: this.#opts.displayName ?? this.#opts.appId },\n { userId },\n )\n return data.workspaceId\n }\n\n // -----------------------------------------------------------------------\n // Connections\n // -----------------------------------------------------------------------\n\n async getInstalledConnections(workspaceId: string): Promise<PlexoConnection[]> {\n try {\n const data = await this.#get<{ items?: PlexoConnection[] }>(\n `/api/v1/connections/installed?workspaceId=${encodeURIComponent(workspaceId)}`,\n )\n return data.items ?? []\n } catch {\n return []\n }\n }\n\n async getToken(workspaceId: string, registryId: string): Promise<PlexoToken | null> {\n try {\n return await this.#get<PlexoToken>(\n `/api/v1/connections/token?workspaceId=${encodeURIComponent(workspaceId)}®istryId=${encodeURIComponent(registryId)}`,\n )\n } catch (err) {\n if (err instanceof PlexoApiError && err.status === 404) return null\n throw err\n }\n }\n\n async disconnect(workspaceId: string, connectionId: string): Promise<void> {\n await this.#delete(\n `/api/v1/connections/installed/${encodeURIComponent(connectionId)}?workspaceId=${encodeURIComponent(workspaceId)}`,\n )\n }\n\n oauthPopupUrl(provider: string, workspaceId: string): string {\n return `${this.#base}/api/oauth/${encodeURIComponent(provider)}/start?workspaceId=${encodeURIComponent(workspaceId)}`\n }\n\n // -----------------------------------------------------------------------\n // AI\n // -----------------------------------------------------------------------\n\n async aiComplete(workspaceId: string, opts: AiCompleteOptions): Promise<string> {\n const data = await this.#post<{ text?: string }>(\n '/api/v1/ai/complete',\n { workspaceId, ...opts },\n {},\n 30_000,\n )\n return data.text ?? ''\n }\n\n async chatMessage(\n workspaceId: string,\n userId: string,\n opts: ChatOptions,\n ): Promise<ChatReply> {\n const data = await this.#post<Partial<ChatReply>>(\n '/api/v1/chat/message',\n { workspaceId, forceConversation: true, ...opts },\n { userId },\n 30_000,\n )\n return {\n reply: data.reply ?? '',\n conversationId: data.conversationId,\n sessionId: data.sessionId,\n taskId: data.taskId,\n }\n }\n\n // -----------------------------------------------------------------------\n // Channel dispatch\n // -----------------------------------------------------------------------\n\n async dispatch(opts: DispatchOptions): Promise<DispatchResult> {\n const data = await this.#post<DispatchResult>(\n '/api/v1/channel/dispatch',\n opts,\n )\n return { messageId: data.messageId, deliveryStatus: data.deliveryStatus }\n }\n\n // -----------------------------------------------------------------------\n // Inbound\n // -----------------------------------------------------------------------\n\n /** Returns a framework-agnostic handler for Plexo → app push requests. */\n inbound(handlers: InboundHandlers) {\n return createInboundRouter(this.#opts.serviceKey, handlers)\n }\n\n // -----------------------------------------------------------------------\n // Utilities\n // -----------------------------------------------------------------------\n\n async testConnection(): Promise<TestConnectionResult> {\n const start = Date.now()\n try {\n const fetchImpl = this.#opts.fetchImpl ?? fetch\n const res = await fetchImpl(`${this.#base}/api/health`, {\n signal: AbortSignal.timeout(5_000),\n })\n const latencyMs = Date.now() - start\n if (!res.ok) {\n return { ok: false, latencyMs, error: `HTTP ${res.status}` }\n }\n const body = await res.json().catch(() => ({})) as Record<string, unknown>\n return { ok: true, latencyMs, plexoVersion: body['version'] as string | undefined }\n } catch (err) {\n return {\n ok: false,\n latencyMs: Date.now() - start,\n error: err instanceof Error ? err.message : String(err),\n }\n }\n }\n\n // -----------------------------------------------------------------------\n // HTTP helpers\n // -----------------------------------------------------------------------\n\n #headers(extra: { userId?: string } = {}): Record<string, string> {\n const h: Record<string, string> = {\n 'Content-Type': 'application/json',\n Authorization: `Bearer ${this.#opts.serviceKey}`,\n 'X-App-Id': this.#opts.appId,\n }\n if (extra.userId) h['X-User-Id'] = extra.userId\n return h\n }\n\n async #get<T>(path: string): Promise<T> {\n const fetchImpl = this.#opts.fetchImpl ?? fetch\n const timeout = this.#opts.resilience?.timeoutMs ?? 15_000\n let res: Response\n try {\n res = await fetchImpl(`${this.#base}${path}`, {\n headers: this.#headers(),\n signal: AbortSignal.timeout(timeout),\n })\n } catch (err) {\n throw new PlexoUnreachableError(this.#base, err)\n }\n return this.#parse<T>(res, path)\n }\n\n async #post<T>(\n path: string,\n body: unknown,\n extra: { userId?: string } = {},\n timeoutMs?: number,\n ): Promise<T> {\n const fetchImpl = this.#opts.fetchImpl ?? fetch\n const timeout = timeoutMs ?? this.#opts.resilience?.timeoutMs ?? 15_000\n let res: Response\n try {\n res = await fetchImpl(`${this.#base}${path}`, {\n method: 'POST',\n headers: this.#headers(extra),\n body: JSON.stringify(body),\n signal: AbortSignal.timeout(timeout),\n })\n } catch (err) {\n throw new PlexoUnreachableError(this.#base, err)\n }\n return this.#parse<T>(res, path)\n }\n\n async #delete(path: string): Promise<void> {\n const fetchImpl = this.#opts.fetchImpl ?? fetch\n const timeout = this.#opts.resilience?.timeoutMs ?? 15_000\n let res: Response\n try {\n res = await fetchImpl(`${this.#base}${path}`, {\n method: 'DELETE',\n headers: this.#headers(),\n signal: AbortSignal.timeout(timeout),\n })\n } catch (err) {\n throw new PlexoUnreachableError(this.#base, err)\n }\n if (!res.ok && res.status !== 404) {\n await this.#parse<void>(res, path)\n }\n }\n\n async #parse<T>(res: Response, path: string): Promise<T> {\n if (res.status === 401) throw new PlexoAuthError(path)\n if (res.status === 429) {\n const retry = Number(res.headers.get('retry-after'))\n throw new PlexoRateLimitedError(path, Number.isNaN(retry) ? undefined : retry)\n }\n if (!res.ok) {\n const detail = await res.text().catch(() => '')\n throw new PlexoApiError(res.status, path, detail.slice(0, 300))\n }\n if (res.status === 204) return undefined as T\n return res.json() as Promise<T>\n }\n}\n","// SPDX-License-Identifier: AGPL-3.0-only\n// Copyright (C) 2026 Joeybuilt LLC\n\n/**\n * @plexo/sdk — connect module\n *\n * Universal client for connecting any app to Plexo Core.\n *\n * Quick start:\n *\n * import { createPlexoClient } from '@joeybuilt/plexo-sdk/connect'\n *\n * export const plexo = createPlexoClient({\n * appId: process.env.APP_ID ?? 'my-app',\n * plexoUrl: process.env.PLEXO_URL ?? '',\n * serviceKey: process.env.SERVICE_KEY ?? '',\n * extensions: [\n * { id: 'my-app.todos.list', type: 'tool', name: 'List Todos',\n * config: { description: 'List todos for the current user' } },\n * ],\n * eventContracts: ['my-app.todo.created'],\n * })\n *\n * Register at boot (Next.js instrumentation.ts, Express server start, etc.):\n * await plexo.register()\n *\n * Per-user workspace (call once on first login):\n * const workspaceId = await plexo.ensureWorkspace(userId, email)\n *\n * AI / chat:\n * const text = await plexo.aiComplete(workspaceId, { messages: [...] })\n * const reply = await plexo.chatMessage(workspaceId, userId, { message })\n *\n * Inbound events + data queries (mount at POST /api/plexo/events):\n * export const POST = (req: Request) =>\n * plexo.inbound({ onEvent, onDataQuery }).handle(req)\n */\n\nexport { PlexoClient } from './client.js'\nexport {\n PlexoApiError,\n PlexoAuthError,\n PlexoNotConfiguredError,\n PlexoRateLimitedError,\n PlexoUnreachableError,\n} from './errors.js'\nexport { verifyInboundSignature } from './inbound.js'\nexport type {\n AiCompleteOptions,\n AiMessage,\n AppChannelConfig,\n AppConnectorConfig,\n AppExtension,\n AppProfile,\n AppToolConfig,\n ChatOptions,\n ChatReply,\n DataQuery,\n DataResponse,\n DispatchOptions,\n DispatchResult,\n InboundEvent,\n InboundEventType,\n InboundHandlers,\n InboundVerifyResult,\n PlexoClientOptions,\n PlexoConnection,\n PlexoToken,\n ResilienceOptions,\n TestConnectionResult,\n} from './types.js'\n\nimport { PlexoClient } from './client.js'\nimport type { PlexoClientOptions } from './types.js'\n\n/**\n * Create a configured Plexo client.\n * Call `await client.register()` once at app boot to announce this app to\n * Plexo Core and make its extensions discoverable.\n */\nexport function createPlexoClient(opts: PlexoClientOptions): PlexoClient {\n return new PlexoClient(opts)\n}\n"],"mappings":";AAGO,IAAM,0BAAN,cAAsC,MAAM;AAAA,EAC7B,OAAO;AAAA,EACzB,YAAY,SAAiB;AACzB,UAAM,+BAA+B,OAAO,cAAc;AAAA,EAC9D;AACJ;AAEO,IAAM,wBAAN,cAAoC,MAAM;AAAA,EAC3B,OAAO;AAAA,EAChB;AAAA,EACT,YAAY,KAAa,OAAiB;AACtC,UAAM,6BAA6B,GAAG,EAAE;AACxC,SAAK,MAAM;AACX,QAAI,MAAO,MAAK,QAAQ;AAAA,EAC5B;AACJ;AAEO,IAAM,gBAAN,cAA4B,MAAM;AAAA,EACnB,OAAe;AAAA,EACxB;AAAA,EACA;AAAA,EACT,YAAY,QAAgB,MAAc,QAAiB;AACvD,UAAM,mBAAmB,MAAM,OAAO,IAAI,GAAG,SAAS,KAAK,MAAM,KAAK,EAAE,EAAE;AAC1E,SAAK,SAAS;AACd,SAAK,OAAO;AAAA,EAChB;AACJ;AAEO,IAAM,iBAAN,cAA6B,cAAc;AAAA,EACrC,OAAO;AAAA,EAChB,YAAY,MAAc;AACtB,UAAM,KAAK,MAAM,gCAAgC;AAAA,EACrD;AACJ;AAEO,IAAM,wBAAN,cAAoC,cAAc;AAAA,EAC5C,OAAO;AAAA,EACP;AAAA,EACT,YAAY,MAAc,eAAwB;AAC9C,UAAM,KAAK,MAAM,cAAc;AAC/B,SAAK,gBAAgB,iBAAiB,MAAM;AAAA,EAChD;AACJ;;;ACvBA,SAAS,YAAY,uBAAuB;AAS5C,IAAM,UAAU,IAAI,KAAK;AAElB,SAAS,uBACZ,MACA,WACA,WACA,YACmB;AACnB,MAAI,CAAC,aAAa,CAAC,WAAW;AAC1B,WAAO,EAAE,IAAI,OAAO,OAAO,iDAAiD;AAAA,EAChF;AACA,QAAM,KAAK,KAAK,MAAM,SAAS;AAC/B,MAAI,OAAO,MAAM,EAAE,KAAK,KAAK,IAAI,KAAK,IAAI,IAAI,EAAE,IAAI,SAAS;AACzD,WAAO,EAAE,IAAI,OAAO,OAAO,mCAAmC;AAAA,EAClE;AACA,QAAM,WAAW,YAAY,WAAW,UAAU,UAAU,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK;AACvF,QAAM,SAAS,OAAO,KAAK,SAAS;AACpC,QAAM,SAAS,OAAO,KAAK,QAAQ;AACnC,MAAI,OAAO,WAAW,OAAO,UAAU,CAAC,gBAAgB,QAAQ,MAAM,GAAG;AACrE,WAAO,EAAE,IAAI,OAAO,OAAO,qBAAqB;AAAA,EACpD;AACA,SAAO,EAAE,IAAI,KAAK;AACtB;AAEO,SAAS,oBAAoB,YAAoB,UAA2B;AAC/E,SAAO;AAAA,IACH,MAAM,OAAO,KAAiC;AAC1C,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,YAAM,MAAM,IAAI,QAAQ,IAAI,mBAAmB;AAC/C,YAAM,KAAK,IAAI,QAAQ,IAAI,mBAAmB;AAE9C,YAAM,QAAQ,uBAAuB,MAAM,KAAK,IAAI,UAAU;AAC9D,UAAI,CAAC,MAAM,IAAI;AACX,eAAO,IAAI;AAAA,UACP,KAAK,UAAU,EAAE,OAAO,MAAM,MAAM,CAAC;AAAA,UACrC,EAAE,QAAQ,KAAK,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,QACnE;AAAA,MACJ;AAEA,UAAI;AACJ,UAAI;AACA,iBAAS,KAAK,MAAM,IAAI;AAAA,MAC5B,QAAQ;AACJ,eAAO,IAAI;AAAA,UACP,KAAK,UAAU,EAAE,OAAO,eAAe,CAAC;AAAA,UACxC,EAAE,QAAQ,KAAK,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,QACnE;AAAA,MACJ;AAEA,YAAM,MAAM;AACZ,YAAM,OAAO,IAAI,MAAM;AAEvB,UAAI;AACA,YAAI,SAAS,WAAW,SAAS,SAAS;AACtC,gBAAM,SAAS,QAAQ,IAAI,OAAO,CAAiB;AACnD,iBAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;AAAA,QAC7C;AAEA,YAAI,SAAS,gBAAgB,SAAS,aAAa;AAC/C,gBAAM,QAAQ,IAAI,OAAO;AACzB,gBAAM,SAAS,MAAM,SAAS,YAAY,KAAK;AAC/C,gBAAM,WAAyB,EAAE,WAAW,MAAM,WAAW,OAAO;AACpE,iBAAO,IAAI;AAAA,YACP,KAAK,UAAU,QAAQ;AAAA,YACvB,EAAE,QAAQ,KAAK,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,UACnE;AAAA,QACJ;AAEA,eAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;AAAA,MAC7C,SAAS,KAAK;AACV,cAAM,WAAyB;AAAA,UAC3B,WAAY,IAAI,OAAO,GAA6B,aAAa;AAAA,UACjE,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,QAC1D;AACA,eAAO,IAAI;AAAA,UACP,KAAK,UAAU,QAAQ;AAAA,UACvB,EAAE,QAAQ,KAAK,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,QACnE;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AACJ;;;AC3GA,SAAS,aAAa,MAAkD;AACpE,SAAO;AAAA,IACH,gBAAgB;AAAA,IAChB,eAAe,UAAU,KAAK,UAAU;AAAA,IACxC,YAAY,KAAK;AAAA,EACrB;AACJ;AAEA,eAAe,KACX,MACA,MACA,MACgB;AAChB,QAAM,YAAY,KAAK,aAAa;AACpC,MAAI;AACA,UAAM,MAAM,MAAM;AAAA,MACd,GAAG,KAAK,SAAS,QAAQ,OAAO,EAAE,CAAC,GAAG,IAAI;AAAA,MAC1C;AAAA,QACI,QAAQ;AAAA,QACR,SAAS,aAAa,IAAI;AAAA,QAC1B,MAAM,KAAK,UAAU,IAAI;AAAA,QACzB,QAAQ,YAAY,QAAQ,GAAK;AAAA,MACrC;AAAA,IACJ;AACA,QAAI,CAAC,IAAI,IAAI;AACT,YAAM,SAAS,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,QAAQ,IAAI,MAAM,EAAE;AAChE,cAAQ,MAAM,0CAA0C,IAAI,MAAM,MAAM,MAAM,EAAE;AAChF,aAAO;AAAA,IACX;AACA,WAAO;AAAA,EACX,SAAS,KAAK;AACV,YAAQ,KAAK,gDAAiD,IAAc,OAAO,EAAE;AACrF,WAAO;AAAA,EACX;AACJ;AAEA,eAAsB,SAClB,MACA,SACa;AACb,QAAM,UAAU,KAAK,YAAY,yBAAyB,CAAC,KAAO,MAAQ,IAAM;AAEhF,MAAI,MAAM,KAAK,MAAM,6BAA6B,OAAO,GAAG;AACxD,YAAQ,KAAK,oCAAoC,KAAK,KAAK,EAAE;AAC7D;AAAA,EACJ;AAEA,aAAW,SAAS,SAAS;AACzB,YAAQ,KAAK,4CAA4C,QAAQ,GAAI,GAAG;AACxE,UAAM,IAAI,QAAc,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AACnD,QAAI,MAAM,KAAK,MAAM,6BAA6B,OAAO,GAAG;AACxD,cAAQ,KAAK,oCAAoC,KAAK,KAAK,EAAE;AAC7D;AAAA,IACJ;AAAA,EACJ;AAEA,UAAQ,KAAK,kFAA6E;AAC9F;;;AC1CO,IAAM,cAAN,MAAkB;AAAA,EACZ;AAAA,EACA;AAAA,EAET,YAAY,MAA0B;AAClC,SAAK,QAAQ;AACb,SAAK,QAAQ,KAAK,SAAS,QAAQ,OAAO,EAAE;AAAA,EAChD;AAAA,EAEA,IAAI,QAAgB;AAAE,WAAO,KAAK,MAAM;AAAA,EAAM;AAAA,EAE9C,IAAI,eAAwB;AACxB,WAAO,CAAC,EAAE,KAAK,MAAM,YAAY,KAAK,MAAM;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,WAA0B;AAC5B,QAAI,CAAC,KAAK,aAAc;AAExB,QAAI,SAAS;AACb,QAAI;AAAE,eAAS,IAAI,IAAI,KAAK,MAAM,QAAQ,EAAE;AAAA,IAAK,QAAQ;AAAA,IAAC;AAE1D,UAAM,UAAsB;AAAA,MACxB,OAAO,KAAK,MAAM;AAAA,MAClB,aAAa,KAAK,MAAM,eAAe,KAAK,MAAM;AAAA,MAClD;AAAA,MACA,YAAY,KAAK,MAAM,cAAc,CAAC;AAAA,MACtC,gBAAgB,KAAK,MAAM,kBAAkB,CAAC;AAAA,IAClD;AACA,UAAM,SAAS,KAAK,OAAO,OAAO;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,gBAAgB,QAAgB,OAAiC;AACnE,UAAM,OAAO,MAAM,KAAK;AAAA,MACpB;AAAA,MACA,EAAE,QAAQ,OAAO,MAAM,KAAK,MAAM,eAAe,KAAK,MAAM,MAAM;AAAA,MAClE,EAAE,OAAO;AAAA,IACb;AACA,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,wBAAwB,aAAiD;AAC3E,QAAI;AACA,YAAM,OAAO,MAAM,KAAK;AAAA,QACpB,6CAA6C,mBAAmB,WAAW,CAAC;AAAA,MAChF;AACA,aAAO,KAAK,SAAS,CAAC;AAAA,IAC1B,QAAQ;AACJ,aAAO,CAAC;AAAA,IACZ;AAAA,EACJ;AAAA,EAEA,MAAM,SAAS,aAAqB,YAAgD;AAChF,QAAI;AACA,aAAO,MAAM,KAAK;AAAA,QACd,yCAAyC,mBAAmB,WAAW,CAAC,eAAe,mBAAmB,UAAU,CAAC;AAAA,MACzH;AAAA,IACJ,SAAS,KAAK;AACV,UAAI,eAAe,iBAAiB,IAAI,WAAW,IAAK,QAAO;AAC/D,YAAM;AAAA,IACV;AAAA,EACJ;AAAA,EAEA,MAAM,WAAW,aAAqB,cAAqC;AACvE,UAAM,KAAK;AAAA,MACP,iCAAiC,mBAAmB,YAAY,CAAC,gBAAgB,mBAAmB,WAAW,CAAC;AAAA,IACpH;AAAA,EACJ;AAAA,EAEA,cAAc,UAAkB,aAA6B;AACzD,WAAO,GAAG,KAAK,KAAK,cAAc,mBAAmB,QAAQ,CAAC,sBAAsB,mBAAmB,WAAW,CAAC;AAAA,EACvH;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,WAAW,aAAqB,MAA0C;AAC5E,UAAM,OAAO,MAAM,KAAK;AAAA,MACpB;AAAA,MACA,EAAE,aAAa,GAAG,KAAK;AAAA,MACvB,CAAC;AAAA,MACD;AAAA,IACJ;AACA,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,MAAM,YACF,aACA,QACA,MACkB;AAClB,UAAM,OAAO,MAAM,KAAK;AAAA,MACpB;AAAA,MACA,EAAE,aAAa,mBAAmB,MAAM,GAAG,KAAK;AAAA,MAChD,EAAE,OAAO;AAAA,MACT;AAAA,IACJ;AACA,WAAO;AAAA,MACH,OAAO,KAAK,SAAS;AAAA,MACrB,gBAAgB,KAAK;AAAA,MACrB,WAAW,KAAK;AAAA,MAChB,QAAQ,KAAK;AAAA,IACjB;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,SAAS,MAAgD;AAC3D,UAAM,OAAO,MAAM,KAAK;AAAA,MACpB;AAAA,MACA;AAAA,IACJ;AACA,WAAO,EAAE,WAAW,KAAK,WAAW,gBAAgB,KAAK,eAAe;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAQ,UAA2B;AAC/B,WAAO,oBAAoB,KAAK,MAAM,YAAY,QAAQ;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,iBAAgD;AAClD,UAAM,QAAQ,KAAK,IAAI;AACvB,QAAI;AACA,YAAM,YAAY,KAAK,MAAM,aAAa;AAC1C,YAAM,MAAM,MAAM,UAAU,GAAG,KAAK,KAAK,eAAe;AAAA,QACpD,QAAQ,YAAY,QAAQ,GAAK;AAAA,MACrC,CAAC;AACD,YAAM,YAAY,KAAK,IAAI,IAAI;AAC/B,UAAI,CAAC,IAAI,IAAI;AACT,eAAO,EAAE,IAAI,OAAO,WAAW,OAAO,QAAQ,IAAI,MAAM,GAAG;AAAA,MAC/D;AACA,YAAM,OAAO,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAC9C,aAAO,EAAE,IAAI,MAAM,WAAW,cAAc,KAAK,SAAS,EAAwB;AAAA,IACtF,SAAS,KAAK;AACV,aAAO;AAAA,QACH,IAAI;AAAA,QACJ,WAAW,KAAK,IAAI,IAAI;AAAA,QACxB,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,MAC1D;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAMA,SAAS,QAA6B,CAAC,GAA2B;AAC9D,UAAM,IAA4B;AAAA,MAC9B,gBAAgB;AAAA,MAChB,eAAe,UAAU,KAAK,MAAM,UAAU;AAAA,MAC9C,YAAY,KAAK,MAAM;AAAA,IAC3B;AACA,QAAI,MAAM,OAAQ,GAAE,WAAW,IAAI,MAAM;AACzC,WAAO;AAAA,EACX;AAAA,EAEA,MAAM,KAAQ,MAA0B;AACpC,UAAM,YAAY,KAAK,MAAM,aAAa;AAC1C,UAAM,UAAU,KAAK,MAAM,YAAY,aAAa;AACpD,QAAI;AACJ,QAAI;AACA,YAAM,MAAM,UAAU,GAAG,KAAK,KAAK,GAAG,IAAI,IAAI;AAAA,QAC1C,SAAS,KAAK,SAAS;AAAA,QACvB,QAAQ,YAAY,QAAQ,OAAO;AAAA,MACvC,CAAC;AAAA,IACL,SAAS,KAAK;AACV,YAAM,IAAI,sBAAsB,KAAK,OAAO,GAAG;AAAA,IACnD;AACA,WAAO,KAAK,OAAU,KAAK,IAAI;AAAA,EACnC;AAAA,EAEA,MAAM,MACF,MACA,MACA,QAA6B,CAAC,GAC9B,WACU;AACV,UAAM,YAAY,KAAK,MAAM,aAAa;AAC1C,UAAM,UAAU,aAAa,KAAK,MAAM,YAAY,aAAa;AACjE,QAAI;AACJ,QAAI;AACA,YAAM,MAAM,UAAU,GAAG,KAAK,KAAK,GAAG,IAAI,IAAI;AAAA,QAC1C,QAAQ;AAAA,QACR,SAAS,KAAK,SAAS,KAAK;AAAA,QAC5B,MAAM,KAAK,UAAU,IAAI;AAAA,QACzB,QAAQ,YAAY,QAAQ,OAAO;AAAA,MACvC,CAAC;AAAA,IACL,SAAS,KAAK;AACV,YAAM,IAAI,sBAAsB,KAAK,OAAO,GAAG;AAAA,IACnD;AACA,WAAO,KAAK,OAAU,KAAK,IAAI;AAAA,EACnC;AAAA,EAEA,MAAM,QAAQ,MAA6B;AACvC,UAAM,YAAY,KAAK,MAAM,aAAa;AAC1C,UAAM,UAAU,KAAK,MAAM,YAAY,aAAa;AACpD,QAAI;AACJ,QAAI;AACA,YAAM,MAAM,UAAU,GAAG,KAAK,KAAK,GAAG,IAAI,IAAI;AAAA,QAC1C,QAAQ;AAAA,QACR,SAAS,KAAK,SAAS;AAAA,QACvB,QAAQ,YAAY,QAAQ,OAAO;AAAA,MACvC,CAAC;AAAA,IACL,SAAS,KAAK;AACV,YAAM,IAAI,sBAAsB,KAAK,OAAO,GAAG;AAAA,IACnD;AACA,QAAI,CAAC,IAAI,MAAM,IAAI,WAAW,KAAK;AAC/B,YAAM,KAAK,OAAa,KAAK,IAAI;AAAA,IACrC;AAAA,EACJ;AAAA,EAEA,MAAM,OAAU,KAAe,MAA0B;AACrD,QAAI,IAAI,WAAW,IAAK,OAAM,IAAI,eAAe,IAAI;AACrD,QAAI,IAAI,WAAW,KAAK;AACpB,YAAM,QAAQ,OAAO,IAAI,QAAQ,IAAI,aAAa,CAAC;AACnD,YAAM,IAAI,sBAAsB,MAAM,OAAO,MAAM,KAAK,IAAI,SAAY,KAAK;AAAA,IACjF;AACA,QAAI,CAAC,IAAI,IAAI;AACT,YAAM,SAAS,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,EAAE;AAC9C,YAAM,IAAI,cAAc,IAAI,QAAQ,MAAM,OAAO,MAAM,GAAG,GAAG,CAAC;AAAA,IAClE;AACA,QAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,WAAO,IAAI,KAAK;AAAA,EACpB;AACJ;;;AC1LO,SAAS,kBAAkB,MAAuC;AACrE,SAAO,IAAI,YAAY,IAAI;AAC/B;","names":[]}
|
|
1
|
+
{"version":3,"sources":["../../src/connect/errors.ts","../../src/connect/inbound.ts","../../src/connect/registration.ts","../../src/connect/client.ts","../../src/connect/index.ts"],"sourcesContent":["// SPDX-License-Identifier: AGPL-3.0-only\n// Copyright (C) 2026 Joeybuilt LLC\n\nexport class PlexoNotConfiguredError extends Error {\n override readonly name = 'PlexoNotConfiguredError'\n constructor(missing: string) {\n super(`PlexoClient not configured: ${missing} is required`)\n }\n}\n\nexport class PlexoUnreachableError extends Error {\n override readonly name = 'PlexoUnreachableError'\n readonly url: string\n constructor(url: string, cause?: unknown) {\n super(`Plexo Core unreachable at ${url}`)\n this.url = url\n if (cause) this.cause = cause\n }\n}\n\nexport class PlexoApiError extends Error {\n override readonly name: string = 'PlexoApiError'\n readonly status: number\n readonly path: string\n constructor(status: number, path: string, detail?: string) {\n super(`Plexo API error ${status} on ${path}${detail ? `: ${detail}` : ''}`)\n this.status = status\n this.path = path\n }\n}\n\nexport class PlexoAuthError extends PlexoApiError {\n readonly name = 'PlexoAuthError' as const\n constructor(path: string) {\n super(401, path, 'invalid or missing service key')\n }\n}\n\nexport class PlexoRateLimitedError extends PlexoApiError {\n readonly name = 'PlexoRateLimitedError' as const\n readonly retryAfterMs: number\n constructor(path: string, retryAfterSec?: number) {\n super(429, path, 'rate limited')\n this.retryAfterMs = (retryAfterSec ?? 60) * 1000\n }\n}\n","// SPDX-License-Identifier: AGPL-3.0-only\n// Copyright (C) 2026 Joeybuilt LLC\n\n/**\n * Inbound request handling — verifies and dispatches requests Plexo Core\n * sends back to the app (events push + data/tool queries).\n *\n * Framework-agnostic: `handleInbound` receives a plain Request and returns\n * a plain Response so it can be wrapped in any framework's route handler.\n *\n * Next.js:\n * export const POST = (req: Request) => plexo.inbound.handle(req)\n *\n * Express:\n * app.post('/api/plexo/events', async (req, res) => {\n * const raw = JSON.stringify(req.body)\n * const r = new Request(req.url, { method:'POST', body: raw, headers: req.headers })\n * const resp = await plexo.inbound.handle(r)\n * res.status(resp.status).json(await resp.json())\n * })\n */\n\nimport { createHmac, timingSafeEqual } from 'node:crypto'\nimport type {\n DataQuery,\n DataResponse,\n InboundEvent,\n InboundHandlers,\n InboundVerifyResult,\n} from './types.js'\n\nconst SKEW_MS = 5 * 60 * 1000\n\nexport function verifyInboundSignature(\n body: string,\n signature: string | null,\n timestamp: string | null,\n serviceKey: string,\n): InboundVerifyResult {\n if (!signature || !timestamp) {\n return { ok: false, error: 'missing X-Plexo-Signature or X-Plexo-Timestamp' }\n }\n const ts = Date.parse(timestamp)\n if (Number.isNaN(ts) || Math.abs(Date.now() - ts) > SKEW_MS) {\n return { ok: false, error: 'timestamp skew exceeds 5 minutes' }\n }\n const expected = 'sha256=' + createHmac('sha256', serviceKey).update(body).digest('hex')\n const sigBuf = Buffer.from(signature)\n const expBuf = Buffer.from(expected)\n if (sigBuf.length !== expBuf.length || !timingSafeEqual(sigBuf, expBuf)) {\n return { ok: false, error: 'signature mismatch' }\n }\n return { ok: true }\n}\n\nexport function createInboundRouter(serviceKey: string, handlers: InboundHandlers) {\n return {\n async handle(req: Request): Promise<Response> {\n const body = await req.text()\n const sig = req.headers.get('x-plexo-signature')\n const ts = req.headers.get('x-plexo-timestamp')\n\n const check = verifyInboundSignature(body, sig, ts, serviceKey)\n if (!check.ok) {\n return new Response(\n JSON.stringify({ error: check.error }),\n { status: 401, headers: { 'Content-Type': 'application/json' } },\n )\n }\n\n let parsed: unknown\n try {\n parsed = JSON.parse(body)\n } catch {\n return new Response(\n JSON.stringify({ error: 'invalid JSON' }),\n { status: 400, headers: { 'Content-Type': 'application/json' } },\n )\n }\n\n const msg = parsed as Record<string, unknown>\n const kind = msg['kind'] as string | undefined\n\n try {\n if (kind === 'event' && handlers.onEvent) {\n await handlers.onEvent(msg['event'] as InboundEvent)\n return new Response(null, { status: 204 })\n }\n\n if (kind === 'data_query' && handlers.onDataQuery) {\n const query = msg['query'] as DataQuery\n const result = await handlers.onDataQuery(query)\n const response: DataResponse = { requestId: query.requestId, result }\n return new Response(\n JSON.stringify(response),\n { status: 200, headers: { 'Content-Type': 'application/json' } },\n )\n }\n\n return new Response(null, { status: 204 })\n } catch (err) {\n const response: DataResponse = {\n requestId: (msg['query'] as DataQuery | undefined)?.requestId ?? '',\n error: err instanceof Error ? err.message : String(err),\n }\n return new Response(\n JSON.stringify(response),\n { status: 500, headers: { 'Content-Type': 'application/json' } },\n )\n }\n },\n }\n}\n","// SPDX-License-Identifier: AGPL-3.0-only\n// Copyright (C) 2026 Joeybuilt LLC\n\nimport type { AppProfile, PlexoClientOptions } from './types.js'\n\nfunction buildHeaders(opts: PlexoClientOptions): Record<string, string> {\n return {\n 'Content-Type': 'application/json',\n Authorization: `Bearer ${opts.serviceKey}`,\n 'X-App-Id': opts.appId,\n }\n}\n\nasync function post(\n opts: PlexoClientOptions,\n path: string,\n body: unknown,\n): Promise<boolean> {\n const fetchImpl = opts.fetchImpl ?? fetch\n try {\n const res = await fetchImpl(\n `${opts.plexoUrl.replace(/\\/$/, '')}${path}`,\n {\n method: 'POST',\n headers: buildHeaders(opts),\n body: JSON.stringify(body),\n signal: AbortSignal.timeout(8_000),\n },\n )\n if (!res.ok) {\n const detail = await res.text().catch(() => `HTTP ${res.status}`)\n console.error(`[plexo/connect] registration rejected (${res.status}): ${detail}`)\n return false\n }\n return true\n } catch (err) {\n console.warn(`[plexo/connect] registration attempt failed: ${(err as Error).message}`)\n return false\n }\n}\n\nexport async function register(\n opts: PlexoClientOptions,\n profile: AppProfile,\n): Promise<void> {\n const backoff = opts.resilience?.registrationBackoffMs ?? [5_000, 15_000, 45_000]\n\n if (await post(opts, '/api/v1/profiles/register', profile)) {\n console.info(`[plexo/connect] registered appId=${opts.appId}`)\n return\n }\n\n for (const delay of backoff) {\n console.info(`[plexo/connect] retrying registration in ${delay / 1000}s`)\n await new Promise<void>((r) => setTimeout(r, delay))\n if (await post(opts, '/api/v1/profiles/register', profile)) {\n console.info(`[plexo/connect] registered appId=${opts.appId}`)\n return\n }\n }\n\n console.warn('[plexo/connect] registration retries exhausted — running in standalone mode')\n}\n","// SPDX-License-Identifier: AGPL-3.0-only\n// Copyright (C) 2026 Joeybuilt LLC\n\nimport { PlexoApiError, PlexoAuthError, PlexoRateLimitedError, PlexoUnreachableError } from './errors.js'\nimport { createInboundRouter } from './inbound.js'\nimport { register } from './registration.js'\nimport type {\n AiCompleteOptions,\n AppProfile,\n ChatOptions,\n ChatReply,\n DispatchContext,\n DispatchOptions,\n DispatchResult,\n InboundHandlers,\n InstallConnectionOptions,\n PlexoClientOptions,\n PlexoConnection,\n PlexoTask,\n PlexoToken,\n PlexoTokenWithConnection,\n TestConnectionResult,\n} from './types.js'\n\nexport class PlexoClient {\n readonly #opts: PlexoClientOptions\n readonly #base: string\n\n constructor(opts: PlexoClientOptions) {\n this.#opts = opts\n this.#base = opts.plexoUrl.replace(/\\/$/, '')\n }\n\n get appId(): string { return this.#opts.appId }\n\n get isConfigured(): boolean {\n return !!(this.#opts.plexoUrl && this.#opts.serviceKey)\n }\n\n // -----------------------------------------------------------------------\n // Registration\n // -----------------------------------------------------------------------\n\n async register(): Promise<void> {\n if (!this.isConfigured) return\n\n let domain = ''\n try { domain = new URL(this.#opts.plexoUrl).host } catch {}\n\n const profile: AppProfile = {\n appId: this.#opts.appId,\n displayName: this.#opts.displayName ?? this.#opts.appId,\n domain,\n extensions: this.#opts.extensions ?? [],\n eventContracts: this.#opts.eventContracts ?? [],\n }\n await register(this.#opts, profile)\n }\n\n // -----------------------------------------------------------------------\n // Workspace\n // -----------------------------------------------------------------------\n\n async ensureWorkspace(userId: string, email?: string): Promise<string> {\n const data = await this.#post<{ workspaceId: string }>(\n '/api/v1/auth/workspace/ensure',\n { userId, email, name: this.#opts.displayName ?? this.#opts.appId },\n { userId },\n )\n return data.workspaceId\n }\n\n /**\n * Idempotent get-or-create + auto-install of this app's connection.\n * Used when an app needs Plexo to know about a user without going\n * through the workspace-ensure → install dance separately.\n */\n async autoAttachUser(userId: string, email?: string): Promise<{ workspaceId: string }> {\n return await this.#post<{ workspaceId: string }>(\n '/api/v1/auth/profiles/auto-attach-user',\n { userId, email, name: this.#opts.displayName ?? this.#opts.appId },\n { userId },\n )\n }\n\n // -----------------------------------------------------------------------\n // Connections\n // -----------------------------------------------------------------------\n\n async getInstalledConnections(workspaceId: string): Promise<PlexoConnection[]> {\n try {\n const data = await this.#get<{ items?: PlexoConnection[] }>(\n `/api/v1/connections/installed?workspaceId=${encodeURIComponent(workspaceId)}`,\n )\n return data.items ?? []\n } catch {\n return []\n }\n }\n\n async getToken(workspaceId: string, registryId: string): Promise<PlexoToken | null> {\n try {\n return await this.#get<PlexoToken>(\n `/api/v1/connections/token?workspaceId=${encodeURIComponent(workspaceId)}®istryId=${encodeURIComponent(registryId)}`,\n )\n } catch (err) {\n if (err instanceof PlexoApiError && err.status === 404) return null\n throw err\n }\n }\n\n async disconnect(workspaceId: string, connectionId: string): Promise<void> {\n await this.#delete(\n `/api/v1/connections/installed/${encodeURIComponent(connectionId)}?workspaceId=${encodeURIComponent(workspaceId)}`,\n )\n }\n\n /**\n * Idempotent install. Returns true if already present or newly installed,\n * false on error. Empty `credentials` are valid for app-owned bridges.\n */\n async installConnection(opts: InstallConnectionOptions): Promise<boolean> {\n try {\n const existing = await this.getInstalledConnections(opts.workspaceId)\n if (existing.some((c) => c.registryId === opts.registryId)) return true\n await this.#post('/api/v1/connections/install', opts)\n return true\n } catch {\n return false\n }\n }\n\n /**\n * Multi-token fetch for a registry (e.g. multi-account Google Workspace).\n * Falls back to per-connection getToken() if the bulk endpoint 404s.\n */\n async getTokens(workspaceId: string, registryId: string): Promise<PlexoTokenWithConnection[]> {\n try {\n const data = await this.#get<PlexoTokenWithConnection[]>(\n `/api/v1/connections/tokens?workspaceId=${encodeURIComponent(workspaceId)}®istryId=${encodeURIComponent(registryId)}`,\n )\n return data\n } catch (err) {\n if (!(err instanceof PlexoApiError) || err.status !== 404) throw err\n }\n const conns = await this.getInstalledConnections(workspaceId)\n const matches = conns.filter((c) => c.registryId === registryId && c.status === 'active')\n const out: PlexoTokenWithConnection[] = []\n for (const c of matches) {\n const t = await this.getToken(workspaceId, c.registryId)\n if (t?.access_token) out.push({ ...t, connectionId: c.id })\n }\n return out\n }\n\n async getTasks(\n workspaceId: string,\n opts: { status?: string; limit?: number } = {},\n ): Promise<PlexoTask[]> {\n const params = new URLSearchParams({\n workspaceId,\n limit: String(opts.limit ?? 10),\n })\n if (opts.status) params.set('status', opts.status)\n try {\n const data = await this.#get<{ items?: PlexoTask[] }>(`/api/v1/tasks?${params}`)\n return data.items ?? []\n } catch {\n return []\n }\n }\n\n oauthPopupUrl(provider: string, workspaceId: string): string {\n return `${this.#base}/api/oauth/${encodeURIComponent(provider)}/start?workspaceId=${encodeURIComponent(workspaceId)}`\n }\n\n // -----------------------------------------------------------------------\n // AI\n // -----------------------------------------------------------------------\n\n async aiComplete(workspaceId: string, opts: AiCompleteOptions): Promise<string> {\n const data = await this.#post<{ text?: string }>(\n '/api/v1/ai/complete',\n { workspaceId, ...opts },\n {},\n 30_000,\n )\n return data.text ?? ''\n }\n\n async chatMessage(\n workspaceId: string,\n userId: string,\n opts: ChatOptions,\n ): Promise<ChatReply> {\n const data = await this.#post<Partial<ChatReply>>(\n '/api/v1/chat/message',\n { workspaceId, forceConversation: true, ...opts },\n { userId },\n 30_000,\n )\n return {\n reply: data.reply ?? '',\n conversationId: data.conversationId,\n sessionId: data.sessionId,\n taskId: data.taskId,\n }\n }\n\n // -----------------------------------------------------------------------\n // Channel dispatch\n // -----------------------------------------------------------------------\n\n async dispatch(\n opts: DispatchOptions,\n ctx: DispatchContext = {},\n ): Promise<DispatchResult> {\n const data = await this.#post<DispatchResult>(\n '/api/v1/channel/dispatch',\n opts,\n ctx,\n )\n return { messageId: data.messageId, deliveryStatus: data.deliveryStatus }\n }\n\n // -----------------------------------------------------------------------\n // Inbound\n // -----------------------------------------------------------------------\n\n /** Returns a framework-agnostic handler for Plexo → app push requests. */\n inbound(handlers: InboundHandlers) {\n return createInboundRouter(this.#opts.serviceKey, handlers)\n }\n\n // -----------------------------------------------------------------------\n // Utilities\n // -----------------------------------------------------------------------\n\n async testConnection(): Promise<TestConnectionResult> {\n const start = Date.now()\n try {\n const fetchImpl = this.#opts.fetchImpl ?? fetch\n const res = await fetchImpl(`${this.#base}/api/health`, {\n signal: AbortSignal.timeout(5_000),\n })\n const latencyMs = Date.now() - start\n if (!res.ok) {\n return { ok: false, latencyMs, error: `HTTP ${res.status}` }\n }\n const body = await res.json().catch(() => ({})) as Record<string, unknown>\n return { ok: true, latencyMs, plexoVersion: body['version'] as string | undefined }\n } catch (err) {\n return {\n ok: false,\n latencyMs: Date.now() - start,\n error: err instanceof Error ? err.message : String(err),\n }\n }\n }\n\n // -----------------------------------------------------------------------\n // HTTP helpers\n // -----------------------------------------------------------------------\n\n #headers(extra: {\n userId?: string\n tenantId?: string\n workspaceId?: string\n traceId?: string\n } = {}): Record<string, string> {\n const h: Record<string, string> = {\n 'Content-Type': 'application/json',\n Authorization: `Bearer ${this.#opts.serviceKey}`,\n 'X-App-Id': this.#opts.appId,\n 'X-Service-Key-Version': this.#opts.serviceKeyVersion ?? 'v1',\n }\n if (extra.userId) h['X-User-Id'] = extra.userId\n if (extra.tenantId) h['X-Tenant-Id'] = extra.tenantId\n if (extra.workspaceId) h['X-Workspace-Id'] = extra.workspaceId\n if (extra.traceId) h['X-Trace-Id'] = extra.traceId\n return h\n }\n\n async #get<T>(path: string): Promise<T> {\n const fetchImpl = this.#opts.fetchImpl ?? fetch\n const timeout = this.#opts.resilience?.timeoutMs ?? 15_000\n let res: Response\n try {\n res = await fetchImpl(`${this.#base}${path}`, {\n headers: this.#headers(),\n signal: AbortSignal.timeout(timeout),\n })\n } catch (err) {\n throw new PlexoUnreachableError(this.#base, err)\n }\n return this.#parse<T>(res, path)\n }\n\n async #post<T>(\n path: string,\n body: unknown,\n extra: {\n userId?: string\n tenantId?: string\n workspaceId?: string\n traceId?: string\n } = {},\n timeoutMs?: number,\n ): Promise<T> {\n const fetchImpl = this.#opts.fetchImpl ?? fetch\n const timeout = timeoutMs ?? this.#opts.resilience?.timeoutMs ?? 15_000\n let res: Response\n try {\n res = await fetchImpl(`${this.#base}${path}`, {\n method: 'POST',\n headers: this.#headers(extra),\n body: JSON.stringify(body),\n signal: AbortSignal.timeout(timeout),\n })\n } catch (err) {\n throw new PlexoUnreachableError(this.#base, err)\n }\n return this.#parse<T>(res, path)\n }\n\n async #delete(path: string): Promise<void> {\n const fetchImpl = this.#opts.fetchImpl ?? fetch\n const timeout = this.#opts.resilience?.timeoutMs ?? 15_000\n let res: Response\n try {\n res = await fetchImpl(`${this.#base}${path}`, {\n method: 'DELETE',\n headers: this.#headers(),\n signal: AbortSignal.timeout(timeout),\n })\n } catch (err) {\n throw new PlexoUnreachableError(this.#base, err)\n }\n if (!res.ok && res.status !== 404) {\n await this.#parse<void>(res, path)\n }\n }\n\n async #parse<T>(res: Response, path: string): Promise<T> {\n if (res.status === 401) throw new PlexoAuthError(path)\n if (res.status === 429) {\n const retry = Number(res.headers.get('retry-after'))\n throw new PlexoRateLimitedError(path, Number.isNaN(retry) ? undefined : retry)\n }\n if (!res.ok) {\n const detail = await res.text().catch(() => '')\n throw new PlexoApiError(res.status, path, detail.slice(0, 300))\n }\n if (res.status === 204) return undefined as T\n return res.json() as Promise<T>\n }\n}\n","// SPDX-License-Identifier: AGPL-3.0-only\n// Copyright (C) 2026 Joeybuilt LLC\n\n/**\n * @plexo/sdk — connect module\n *\n * Universal client for connecting any app to Plexo Core.\n *\n * Quick start:\n *\n * import { createPlexoClient } from '@joeybuilt/plexo-sdk/connect'\n *\n * export const plexo = createPlexoClient({\n * appId: process.env.APP_ID ?? 'my-app',\n * plexoUrl: process.env.PLEXO_URL ?? '',\n * serviceKey: process.env.SERVICE_KEY ?? '',\n * extensions: [\n * { id: 'my-app.todos.list', type: 'tool', name: 'List Todos',\n * config: { description: 'List todos for the current user' } },\n * ],\n * eventContracts: ['my-app.todo.created'],\n * })\n *\n * Register at boot (Next.js instrumentation.ts, Express server start, etc.):\n * await plexo.register()\n *\n * Per-user workspace (call once on first login):\n * const workspaceId = await plexo.ensureWorkspace(userId, email)\n *\n * AI / chat:\n * const text = await plexo.aiComplete(workspaceId, { messages: [...] })\n * const reply = await plexo.chatMessage(workspaceId, userId, { message })\n *\n * Inbound events + data queries (mount at POST /api/plexo/events):\n * export const POST = (req: Request) =>\n * plexo.inbound({ onEvent, onDataQuery }).handle(req)\n */\n\nexport { PlexoClient } from './client.js'\nexport {\n PlexoApiError,\n PlexoAuthError,\n PlexoNotConfiguredError,\n PlexoRateLimitedError,\n PlexoUnreachableError,\n} from './errors.js'\nexport { verifyInboundSignature } from './inbound.js'\nexport type {\n AiCompleteOptions,\n AiMessage,\n AppChannelConfig,\n AppConnectorConfig,\n AppExtension,\n AppProfile,\n AppToolConfig,\n ChatOptions,\n ChatReply,\n DataQuery,\n DataResponse,\n DispatchContext,\n DispatchOptions,\n DispatchResult,\n InboundEvent,\n InboundEventType,\n InboundHandlers,\n InboundVerifyResult,\n InstallConnectionOptions,\n PlexoClientOptions,\n PlexoConnection,\n PlexoTask,\n PlexoToken,\n PlexoTokenWithConnection,\n ResilienceOptions,\n TestConnectionResult,\n} from './types.js'\n\nimport { PlexoClient } from './client.js'\nimport type { PlexoClientOptions } from './types.js'\n\n/**\n * Create a configured Plexo client.\n * Call `await client.register()` once at app boot to announce this app to\n * Plexo Core and make its extensions discoverable.\n */\nexport function createPlexoClient(opts: PlexoClientOptions): PlexoClient {\n return new PlexoClient(opts)\n}\n"],"mappings":"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","names":[]}
|