ai-publish-sdk 1.0.0

package/README.md

@@ -0,0 +1,74 @@
+# ai-publish-sdk
+
+SDK for embedded apps to communicate with the host environment.
+
+## Installation
+
+```
+npm install ai-publish-sdk
+```
+
+## Core API
+
+### getUserInfo()
+
+Get current user info.
+
+```typescript
+getUserInfo(config?: RpcConfig): Promise<UserInfo | null>
+
+interface UserInfo {
+  userId: string
+  tenantId: string
+  tenantName?: string
+  name?: string
+  givenName?: string
+  familyName?: string
+  displayName?: string
+  email?: string
+  picture?: string
+}
+```
+
+### getToken(appName, options?)
+
+Get OAuth token for an integration.
+
+```typescript
+getToken(appName: IntegrationAppName, options?: GetTokenOptions, config?: RpcConfig): Promise<GetTokenResult | null>
+
+type IntegrationAppName = 'gmail' | 'jira' | 'googledrive' | 'salesforce' | 'googlecalendar'
+
+interface GetTokenOptions {
+  interactive?: boolean // show OAuth flow if not yet authorized
+}
+
+interface GetTokenResult {
+  token: string
+  instanceUrl?: string // e.g. Salesforce instance URL
+}
+```
+
+### generateMessage(prompt, options)
+
+Generate an AI message.
+
+```typescript
+generateMessage(prompt: string, options: GenerateMessageOptions, config?: RpcConfig): Promise<string | null>
+
+interface GenerateMessageOptions {
+  withPageContext?: boolean // include current page content as context
+  systemPrompt?: string    // guide AI behavior
+}
+```
+
+### RpcConfig
+
+Optional config passed to any function call.
+
+```typescript
+interface RpcConfig {
+  timeout?: number      // ms, default 15000
+  targetOrigin?: string // postMessage target origin, default '*'
+}
+```

package/index.d.ts

@@ -0,0 +1,3 @@
+export { generateMessage, getToken, getUserInfo } from './lib/functions';
+export type { RpcConfig } from './lib/rpc-bridge';
+export type { GenerateMessageOptions, GetTokenOptions, GetTokenResult, IntegrationAppName, UserInfo } from './lib/types';

package/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=15e3,n=new Map;let i=!1;function I(){i||(i=!0,window.addEventListener("message",r=>{const e=r.data;if(!(e!=null&&e.messageId)||!("name"in e))return;const t=n.get(e.messageId);t&&(clearTimeout(t.timer),n.delete(e.messageId),e.error?t.reject(new Error(e.error.message??"RPC error")):t.resolve(e.data))}))}function o(r,e,t){I();const u=(t==null?void 0:t.timeout)??c,g=(t==null?void 0:t.targetOrigin)??"*";return new Promise((m,a)=>{const s=crypto.randomUUID(),d=setTimeout(()=>{n.delete(s),a(new Error(`RPC timeout: ${r}`))},u);n.set(s,{resolve:m,reject:a,timer:d});const l={action:r,params:e,messageId:s};window.parent.postMessage(l,g)})}async function T(r,e,t){return o("generateMessage",[r,e],t)}async function w(r,e,t){return o("getToken",[r,e],t)}async function p(r){return o("getUserInfo",[],r)}exports.generateMessage=T;exports.getToken=w;exports.getUserInfo=p;

package/index.mjs

@@ -0,0 +1,40 @@
+const n = /* @__PURE__ */ new Map();
+let i = !1;
+function l() {
+  i || (i = !0, window.addEventListener("message", (r) => {
+    const e = r.data;
+    if (!(e != null && e.messageId) || !("name" in e)) return;
+    const t = n.get(e.messageId);
+    t && (clearTimeout(t.timer), n.delete(e.messageId), e.error ? t.reject(new Error(e.error.message ?? "RPC error")) : t.resolve(e.data));
+  }));
+}
+function a(r, e, t) {
+  l();
+  const u = (t == null ? void 0 : t.timeout) ?? 15e3, m = (t == null ? void 0 : t.targetOrigin) ?? "*";
+  return new Promise((g, o) => {
+    const s = crypto.randomUUID(), d = setTimeout(() => {
+      n.delete(s), o(new Error(`RPC timeout: ${r}`));
+    }, u);
+    n.set(s, {
+      resolve: g,
+      reject: o,
+      timer: d
+    });
+    const c = { action: r, params: e, messageId: s };
+    window.parent.postMessage(c, m);
+  });
+}
+async function T(r, e, t) {
+  return a("generateMessage", [r, e], t);
+}
+async function I(r, e, t) {
+  return a("getToken", [r, e], t);
+}
+async function w(r) {
+  return a("getUserInfo", [], r);
+}
+export {
+  T as generateMessage,
+  I as getToken,
+  w as getUserInfo
+};

package/lib/functions.d.ts

@@ -0,0 +1,5 @@
+import { RpcConfig } from './rpc-bridge';
+import { GenerateMessageOptions, GetTokenOptions, GetTokenResult, IntegrationAppName, UserInfo } from './types';
+export declare function generateMessage(prompt: string, options: GenerateMessageOptions, config?: RpcConfig): Promise<string | null>;
+export declare function getToken(appName: IntegrationAppName, options?: GetTokenOptions, config?: RpcConfig): Promise<GetTokenResult | null>;
+export declare function getUserInfo(config?: RpcConfig): Promise<UserInfo | null>;

package/lib/rpc-bridge.d.ts

@@ -0,0 +1,5 @@
+export interface RpcConfig {
+    timeout?: number;
+    targetOrigin?: string;
+}
+export declare function rpcCall<T = unknown>(action: string, params: unknown[], config?: RpcConfig): Promise<T>;

package/lib/types.d.ts

@@ -0,0 +1,23 @@
+export type IntegrationAppName = 'gmail' | 'jira' | 'googledrive' | 'salesforce' | 'googlecalendar' | 'slack';
+export interface GenerateMessageOptions {
+    withPageContext?: boolean;
+    systemPrompt?: string;
+}
+export interface GetTokenOptions {
+    interactive?: boolean;
+}
+export interface GetTokenResult {
+    token: string;
+    instanceUrl?: string;
+}
+export interface UserInfo {
+    userId: string;
+    tenantId: string;
+    tenantName?: string;
+    name?: string;
+    givenName?: string;
+    familyName?: string;
+    displayName?: string;
+    email?: string;
+    picture?: string;
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "ai-publish-sdk",
+  "version": "1.0.0",
+  "module": "./index.mjs",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "description": "SDK for embedded apps to communicate with the host environment via RPC over postMessage",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.mjs",
+      "require": "./index.js",
+      "default": "./index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "keywords": [
+    "iframe",
+    "rpc",
+    "postmessage",
+    "sdk",
+    "embedded-app"
+  ]
+}