@llmnative/react 2.3.0 → 3.0.0

package/dist/types/src/providers/email/gmail/gmailOAuth.d.ts

@@ -0,0 +1,25 @@
+export type GmailOAuthConfig = {
+    clientId: string;
+    clientSecret: string;
+    /** Where Google comes back with the code: a route of the app's server. */
+    redirectUri: string;
+    fetch?: typeof fetch;
+};
+export type GmailOAuth = {
+    /** The consent page of Google, with a refresh token (offline, consent asked again). */
+    authorizationUrl(options: {
+        state: string;
+        scopes: string[];
+        loginHint?: string;
+    }): string;
+    /** The code Google came back with → the address of the mailbox and its refresh token. */
+    exchangeCode(code: string): Promise<{
+        email: string;
+        refreshToken: string;
+    }>;
+};
+/**
+ * Connecting a Gmail mailbox from a server (CR-130): the consent page, then the refresh token the Gmail
+ * adapters take as `auth`. The client secret and the refresh token stay on the server.
+ */
+export declare function createGmailOAuth(config: GmailOAuthConfig): GmailOAuth;

package/dist/types/src/providers/email/imap/ImapEmailReader.d.ts

@@ -0,0 +1,70 @@
+import { type ProviderConfigurationState } from '../../ProviderConfiguration';
+import { type EmailReadAdapter, type EmailReadBatch, type EmailReadOptions, type EmailReadStart } from '../EmailRead';
+export type ImapEmailReaderConfig = {
+    host: string;
+    /** Default 993. */
+    port?: number;
+    /** TLS from the start (default `true`, port 993); `false` for STARTTLS or plain (port 143). */
+    secure?: boolean;
+    user: string;
+    /** The password, or an app password where the provider has them. */
+    password: string;
+    /** Default `INBOX`. */
+    mailbox?: string;
+};
+/** The parts of `imapflow` and `mailparser` the reader uses: injectable for tests. */
+export type ImapModules = {
+    ImapFlow: new (options: Record<string, unknown>) => ImapClient;
+    simpleParser: (source: Buffer) => Promise<ParsedMail>;
+};
+type ImapClient = {
+    connect(): Promise<void>;
+    mailboxOpen(path: string, options?: {
+        readOnly?: boolean;
+    }): Promise<{
+        uidValidity: bigint | number;
+        uidNext: number;
+    }>;
+    fetch(range: string, query: {
+        uid?: boolean;
+        source?: boolean;
+    }, options?: {
+        uid?: boolean;
+    }): AsyncIterable<{
+        uid: number;
+        source?: Buffer;
+    }>;
+    logout(): Promise<void>;
+};
+type ParsedAddress = {
+    text?: string;
+};
+type ParsedMail = {
+    messageId?: string;
+    from?: ParsedAddress;
+    to?: ParsedAddress | ParsedAddress[];
+    subject?: string;
+    date?: Date;
+    text?: string;
+    html?: string | false;
+};
+/**
+ * Reads a mailbox with IMAP (CR-130), for the providers without push: the app calls `read()` every few
+ * minutes. The cursor is the UIDVALIDITY of the mailbox and the last UID read; a new UIDVALIDITY (the
+ * mailbox renumbered) starts again from now. Server only: it opens a TCP connection. Needs the optional
+ * packages `imapflow` and `mailparser`, loaded on the first read.
+ */
+export declare class ImapEmailReader implements EmailReadAdapter {
+    private readonly config;
+    private readonly options;
+    constructor(config: ImapEmailReaderConfig, options?: {
+        modules?: () => Promise<ImapModules>;
+    });
+    getConfigurationState(): ProviderConfigurationState;
+    isConfigured(): boolean;
+    /** Opens the mailbox read-only, runs `work`, logs out whatever happens. */
+    private withMailbox;
+    start(): Promise<EmailReadStart>;
+    read(cursor: string, { limit }?: EmailReadOptions): Promise<EmailReadBatch>;
+}
+export {};

package/dist/types/src/providers/email/resend/ResendEmailSender.d.ts

@@ -0,0 +1,20 @@
+import { type ProviderConfigurationState } from '../../ProviderConfiguration';
+import { type EmailRecipient, type EmailSendAdapter, type EmailSendParams, type EmailSendResult } from '../EmailSend';
+export declare const RESEND_EMAIL_URL = "https://api.resend.com/emails";
+export type ResendEmailSenderConfig = {
+    apiKey: string;
+    /** The default sender, on a domain verified in Resend. */
+    from?: EmailRecipient;
+    /** The `fetch` to use (a proxy, a test). */
+    fetch?: typeof fetch;
+};
+/**
+ * Sends with Resend (CR-130). The key is a secret: use it on a server, not in a browser bundle.
+ */
+export declare class ResendEmailSender implements EmailSendAdapter {
+    private readonly config;
+    constructor(config: ResendEmailSenderConfig);
+    getConfigurationState(): ProviderConfigurationState;
+    isConfigured(): boolean;
+    send(params: EmailSendParams): Promise<EmailSendResult>;
+}

package/dist/types/src/providers/manifest.d.ts

@@ -5,12 +5,13 @@ import type { AIProviderAdapter } from './ai/AIProvider';
 import type { DataProviderAdapter } from './data/DataProvider';
 import type { StorageProviderAdapter } from './storage/StorageProvider';
 import type { AuthProviderAdapter } from './auth/AuthProvider';
-import type { EmailProviderAdapter } from './email/EmailProvider';
+import type { EmailSendAdapter } from './email/EmailSend';
+import type { EmailReadAdapter } from './email/EmailRead';
 import type { AIConfig, DropboxConfig, FirebaseConfig, GitHubAuthConfig, GoogleOAuth2, GoogleServiceAccount, SupabaseConfig } from '../Config';
 import type { ProviderService } from './ProviderRegistryContext';
-/** The 6 built-in categories — alias of ProviderService (ProviderRegistryContext.tsx), derived from ProviderAdapterMap so the two can't drift. */
+/** The 7 built-in categories — alias of ProviderService (ProviderRegistryContext.tsx), derived from ProviderAdapterMap so the two can't drift. */
 export type ServiceCategory = ProviderService;
-type AnyAdapter = DataProviderAdapter | StorageProviderAdapter | AuthProviderAdapter | EmailProviderAdapter | AIProviderAdapter | CredentialsAdapter;
+type AnyAdapter = DataProviderAdapter | StorageProviderAdapter | AuthProviderAdapter | EmailSendAdapter | EmailReadAdapter | AIProviderAdapter | CredentialsAdapter;
 export interface DriverDescriptor<TConfig = unknown> {
     service: ServiceCategory;
     create: (config: TConfig) => AnyAdapter;
@@ -38,14 +39,15 @@ export declare const PROVIDER_MANIFESTS: Record<string, DriverManifest<any>>;
 export type DataDriverName = 'dbRealtime' | 'firestoreDb' | 'supabaseDb' | 'mock';
 export type StorageDriverName = 'firestorage' | 'supabaseStorage';
 export type AuthDriverName = 'googleAuth' | 'firebaseAuth' | 'dropboxAuth' | 'supabaseAuth' | 'githubAuth' | 'mockAuth';
-export type EmailDriverName = 'gmail';
+export type EmailSendDriverName = 'gmail';
 export type AIDriverName = 'openai' | 'openrouter' | 'opencode' | 'opencode-go' | 'openai-compatible' | 'deepseek' | 'gemini' | 'anthropic' | 'mistral' | 'cloudflare' | 'groq';
 export type CredentialsDriverName = 'googleServiceAccount';
 export type ServicesConfig = {
     data?: DataDriverName | string;
     storage?: StorageDriverName | string;
     auth?: AuthDriverName | string;
-    email?: EmailDriverName | string;
+    emailSend?: EmailSendDriverName | string;
+    emailRead?: string;
     ai?: AIDriverName | string;
     credentials?: CredentialsDriverName | string;
 };

package/dist/vite.js

@@ -1,3 +1,3 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./logHeader-CUsdmGAo.js"),t=require("./server-CCbjPJEz.js");let n=require("node:fs/promises"),r=require("node:path");r=e.r(r);var i=`x-llmnative-proxy`,a=`/api/proxy`,o=async e=>{let t=[];for await(let n of e)t.push(Buffer.isBuffer(n)?n:Buffer.from(n));return t.length===0?void 0:Buffer.concat(t)};function s(e){return e.replace(/[^a-zA-Z0-9_-]/g,``).slice(0,128)||`unknown`}function c(e){if(!e.trim())return`(empty body)`;try{return JSON.stringify(JSON.parse(e),null,2)}catch{return e}}async function l(e,t,i,a,o,l){try{await(0,n.mkdir)(e.dir,{recursive:!0});let u=[``,`=`.repeat(80),`Turn @ ${new Date().toISOString()}`,`Target: ${i}`,`--- REQUEST BODY ---`,c(a),`--- RESPONSE BODY (status ${o}) ---`,c(l),`=`.repeat(80),``].join(`
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./logHeader-CUsdmGAo.js"),t=require("./server-CDheNgME.js");let n=require("node:fs/promises"),r=require("node:path");r=e.r(r);var i=`x-llmnative-proxy`,a=`/api/proxy`,o=async e=>{let t=[];for await(let n of e)t.push(Buffer.isBuffer(n)?n:Buffer.from(n));return t.length===0?void 0:Buffer.concat(t)};function s(e){return e.replace(/[^a-zA-Z0-9_-]/g,``).slice(0,128)||`unknown`}function c(e){if(!e.trim())return`(empty body)`;try{return JSON.stringify(JSON.parse(e),null,2)}catch{return e}}async function l(e,t,i,a,o,l){try{await(0,n.mkdir)(e.dir,{recursive:!0});let u=[``,`=`.repeat(80),`Turn @ ${new Date().toISOString()}`,`Target: ${i}`,`--- REQUEST BODY ---`,c(a),`--- RESPONSE BODY (status ${o}) ---`,c(l),`=`.repeat(80),``].join(`
 `);await(0,n.appendFile)(r.default.join(e.dir,`${s(t)}.txt`),u,`utf-8`)}catch(e){console.warn(`[llmnative-dev-proxy] Failed to write LLM log:`,e)}}var u=async(n,r,a,s,c)=>{let u=new URL(n.url||`/`,`http://localhost`).searchParams.get(`url`);if(n.headers[i]!==`1`){r.statusCode=403,r.setHeader(`Content-Type`,`application/json`),r.end(JSON.stringify({error:`Proxy access denied.`}));return}if(!u){r.statusCode=400,r.setHeader(`Content-Type`,`application/json`),r.end(JSON.stringify({error:`Missing "url" query parameter.`}));return}try{let d=new URL(u);if(d.pathname.startsWith(a)&&[`localhost`,`127.0.0.1`].includes(d.hostname)){r.statusCode=508,r.setHeader(`Content-Type`,`application/json`),r.end(JSON.stringify({error:`Recursive proxy target detected.`,target:u}));return}let f=await o(n),p=n.headers[e.t],m=new Headers,h=new Set([i,e.t,`host`,`origin`,`referer`,`content-length`,`transfer-encoding`,`connection`]);Object.entries(n.headers).forEach(([e,t])=>{t&&!h.has(e.toLowerCase())&&m.set(e,Array.isArray(t)?t.join(`, `):t)});let g=await t.t({url:u,headers:Object.fromEntries(m)},c??(()=>void 0));if(!g.ok){r.statusCode=g.status,r.setHeader(`Content-Type`,`application/json`),r.end(JSON.stringify({error:g.error,provider:g.provider}));return}let _=await fetch(g.url,{method:n.method||`GET`,headers:new Headers(g.headers),body:f&&![`GET`,`HEAD`].includes((n.method||`GET`).toUpperCase())?Uint8Array.from(f):void 0,redirect:`follow`}),v=Buffer.from(await _.arrayBuffer());s?.enabled&&typeof p==`string`&&p&&l(s,p,u,f?.toString(`utf-8`)??``,_.status,v.toString(`utf-8`)),r.statusCode=_.status,_.headers.forEach((e,t)=>{t.toLowerCase()!==`content-encoding`&&r.setHeader(t,e)}),r.end(v)}catch(e){r.statusCode=502,r.setHeader(`Content-Type`,`application/json`),r.end(JSON.stringify({error:e instanceof Error?e.message:`Proxy request failed.`}))}},d=(e=a,t,n)=>({name:`llmnative-dev-proxy`,configureServer(r){r.middlewares.use(e,(r,i)=>{u(r,i,e,t,n)})},configurePreviewServer(r){r.middlewares.use(e,(r,i)=>{u(r,i,e,t,n)})}});exports.PROXY_PATH=a,exports.createProxyPlugin=d;
 //# sourceMappingURL=vite.js.map

package/dist/vite.mjs

@@ -1,5 +1,5 @@
 import { t as e } from "./logHeader-Busbc8OO.mjs";
-import { t } from "./server-CiWwr3Zg.mjs";
+import { t } from "./server-B430eH0y.mjs";
 import { appendFile as n, mkdir as r } from "node:fs/promises";
 import i from "node:path";
 //#region src/providers/proxy/vite.ts