@qaecy/cue-sdk 0.0.1

package/README.md

@@ -0,0 +1,152 @@
+# @qaecy/cue-sdk
+
+Headless JavaScript SDK for building apps on the QAECY platform. A framework-agnostic client that handles authentication and API access — the programmatic counterpart to the `@qaecy/cue-widget`.
+
+## Installation
+
+```bash
+npm install @qaecy/cue-sdk firebase
+```
+
+> `firebase` is a peer dependency and must be installed alongside the SDK.
+
+## Quick start
+
+```typescript
+import { Cue } from '@qaecy/cue-sdk';
+
+const cue = new Cue({
+  apiKey: 'YOUR_FIREBASE_API_KEY',
+  appId: 'YOUR_FIREBASE_APP_ID',
+  measurementId: 'YOUR_MEASUREMENT_ID',
+});
+
+// Listen for auth state changes
+cue.auth.onAuthStateChanged((user) => {
+  console.log(user ? `Signed in as ${user.displayName}` : 'Signed out');
+});
+
+// Sign in
+await cue.auth.signIn('google');
+// or
+await cue.auth.signIn('microsoft');
+// or
+await cue.auth.signIn('password', { email: 'user@example.com', password: 'secret' });
+
+// Search documents
+const results = await cue.api.search({
+  term: 'What are the fire safety requirements?',
+  projectId: 'my-project-id',
+});
+
+console.log(results.response);
+console.log(results.sources);
+
+// Sign out
+await cue.auth.signOut();
+```
+
+## Configuration
+
+| Option | Type | Required | Description |
+|---|---|---|---|
+| `apiKey` | `string` | ✅ | Firebase API key |
+| `appId` | `string` | ✅ | Firebase App ID |
+| `measurementId` | `string` | ✅ | Firebase Measurement ID |
+| `gatewayUrl` | `string` | — | Override the default API gateway URL |
+| `useEmulator` | `boolean` | — | Connect to local emulators (default: `false`) |
+
+## Auth
+
+### `cue.auth.signIn(provider)`
+
+Sign in with Google or Microsoft via a browser popup:
+
+```typescript
+const user = await cue.auth.signIn('google');
+const user = await cue.auth.signIn('microsoft');
+```
+
+### `cue.auth.signIn('password', credentials)`
+
+Sign in with email and password:
+
+```typescript
+const user = await cue.auth.signIn('password', {
+  email: 'user@example.com',
+  password: 's3cr3t',
+});
+```
+
+### `cue.auth.signOut()`
+
+```typescript
+await cue.auth.signOut();
+```
+
+### `cue.auth.currentUser`
+
+Returns the currently signed-in Firebase `User`, or `null`.
+
+### `cue.auth.onAuthStateChanged(listener)`
+
+Subscribe to auth state changes. Returns an unsubscribe function.
+
+```typescript
+const unsubscribe = cue.auth.onAuthStateChanged((user) => {
+  if (user) startApp(user);
+});
+
+// Later:
+unsubscribe();
+```
+
+### `cue.auth.getToken(forceRefresh?)`
+
+Get the Firebase ID token for the current user:
+
+```typescript
+const token = await cue.auth.getToken();
+```
+
+## API
+
+All API methods require the user to be authenticated first.
+
+### `cue.api.search(request)`
+
+Search project documents using natural language:
+
+```typescript
+const results = await cue.api.search({
+  term: 'fire resistance requirements',
+  projectId: 'my-project-id',
+  categories: ['buildings', 'regulations'], // optional
+});
+
+// results.response  — AI-generated answer
+// results.sources   — source documents
+```
+
+### `cue.api.sparql(query, projectId)`
+
+Execute a SPARQL query against the project's triplestore:
+
+```typescript
+const data = await cue.api.sparql(
+  `SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10`,
+  'my-project-id',
+);
+```
+
+## Advanced
+
+Access the raw Firebase `Auth` instance for advanced use cases:
+
+```typescript
+const firebaseAuth = cue.auth.firebaseAuth;
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@qaecy/cue-sdk",
+  "version": "0.0.1",
+  "description": "Headless JavaScript SDK for building apps on the QAECY platform",
+  "main": "./src/index.js",
+  "module": "./src/index.js",
+  "typings": "./src/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./src/index.js",
+      "types": "./src/index.d.ts"
+    }
+  },
+  "files": [
+    "src/**/*",
+    "README.md"
+  ],
+  "keywords": [
+    "qaecy",
+    "sdk",
+    "search",
+    "knowledge-graph",
+    "rag",
+    "ai",
+    "document-search"
+  ],
+  "author": "QAECY",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/qaecy/qaecy-monorepo.git",
+    "directory": "libs/js/cue-sdk"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "firebase": "^12.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "types": "./src/index.d.ts"
+}

package/src/index.d.ts

@@ -0,0 +1,6 @@
+export { Cue } from './lib/cue';
+export { CueAuth } from './lib/auth';
+export { CueApi } from './lib/api';
+export type { CueSdkConfig, SsoProvider, PasswordCredentials, SearchRequest, SearchResponse, SearchSource, } from './lib/models';
+export type { AuthStateListener, Unsubscribe } from './lib/auth';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../libs/js/cue-sdk/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,YAAY,EACV,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/src/index.js

@@ -0,0 +1,4 @@
+export { Cue } from './lib/cue';
+export { CueAuth } from './lib/auth';
+export { CueApi } from './lib/api';
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/js/cue-sdk/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC","sourcesContent":["export { Cue } from './lib/cue';\nexport { CueAuth } from './lib/auth';\nexport { CueApi } from './lib/api';\nexport type {\n  CueSdkConfig,\n  SsoProvider,\n  PasswordCredentials,\n  SearchRequest,\n  SearchResponse,\n  SearchSource,\n} from './lib/models';\nexport type { AuthStateListener, Unsubscribe } from './lib/auth';\n"]}

package/src/lib/api.d.ts

@@ -0,0 +1,19 @@
+import type { CueAuth } from './auth';
+import type { SearchRequest, SearchResponse } from './models';
+export declare class CueApi {
+    private readonly _auth;
+    private readonly _gatewayUrl;
+    constructor(_auth: CueAuth, _gatewayUrl: string);
+    private _authHeaders;
+    /**
+     * Search project documents using natural language.
+     * The user must be authenticated before calling this.
+     */
+    search(request: SearchRequest): Promise<SearchResponse>;
+    /**
+     * Execute a SPARQL query against the project's triplestore.
+     * The user must be authenticated before calling this.
+     */
+    sparql(query: string, projectId: string): Promise<unknown>;
+}
+//# sourceMappingURL=api.d.ts.map

package/src/lib/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../../../libs/js/cue-sdk/src/lib/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK9D,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM;YAGxB,YAAY;IAS1B;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAiB7D;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAYjE"}

package/src/lib/api.js

@@ -0,0 +1,56 @@
+const ENDPOINT_SEARCH = '/assistant/search';
+const ENDPOINT_SPARQL = '/triplestore/query';
+export class CueApi {
+    _auth;
+    _gatewayUrl;
+    constructor(_auth, _gatewayUrl) {
+        this._auth = _auth;
+        this._gatewayUrl = _gatewayUrl;
+    }
+    async _authHeaders() {
+        const token = await this._auth.getToken();
+        if (!token)
+            throw new Error('Not authenticated. Call cue.auth.signIn() first.');
+        return {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        };
+    }
+    /**
+     * Search project documents using natural language.
+     * The user must be authenticated before calling this.
+     */
+    async search(request) {
+        const headers = await this._authHeaders();
+        const response = await fetch(`${this._gatewayUrl}${ENDPOINT_SEARCH}`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                term: request.term,
+                projectId: request.projectId,
+                categories: request.categories ?? [],
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Search request failed: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Execute a SPARQL query against the project's triplestore.
+     * The user must be authenticated before calling this.
+     */
+    async sparql(query, projectId) {
+        const headers = await this._authHeaders();
+        const response = await fetch(`${this._gatewayUrl}${ENDPOINT_SPARQL}`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ query, projectId }),
+        });
+        if (!response.ok) {
+            throw new Error(`SPARQL query failed: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=api.js.map

package/src/lib/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../../../libs/js/cue-sdk/src/lib/api.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAC5C,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C,MAAM,OAAO,MAAM;IAEE;IACA;IAFnB,YACmB,KAAc,EACd,WAAmB;QADnB,UAAK,GAAL,KAAK,CAAS;QACd,gBAAW,GAAX,WAAW,CAAQ;IACnC,CAAC;IAEI,KAAK,CAAC,YAAY;QACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAChF,OAAO;YACL,aAAa,EAAE,UAAU,KAAK,EAAE;YAChC,cAAc,EAAE,kBAAkB;SACnC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,OAAsB;QACjC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,GAAG,eAAe,EAAE,EAAE;YACpE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;aACrC,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,SAAiB;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,GAAG,eAAe,EAAE,EAAE;YACpE,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAC3C,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF","sourcesContent":["import type { CueAuth } from './auth';\nimport type { SearchRequest, SearchResponse } from './models';\n\nconst ENDPOINT_SEARCH = '/assistant/search';\nconst ENDPOINT_SPARQL = '/triplestore/query';\n\nexport class CueApi {\n  constructor(\n    private readonly _auth: CueAuth,\n    private readonly _gatewayUrl: string,\n  ) {}\n\n  private async _authHeaders(): Promise<HeadersInit> {\n    const token = await this._auth.getToken();\n    if (!token) throw new Error('Not authenticated. Call cue.auth.signIn() first.');\n    return {\n      Authorization: `Bearer ${token}`,\n      'Content-Type': 'application/json',\n    };\n  }\n\n  /**\n   * Search project documents using natural language.\n   * The user must be authenticated before calling this.\n   */\n  async search(request: SearchRequest): Promise<SearchResponse> {\n    const headers = await this._authHeaders();\n    const response = await fetch(`${this._gatewayUrl}${ENDPOINT_SEARCH}`, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify({\n        term: request.term,\n        projectId: request.projectId,\n        categories: request.categories ?? [],\n      }),\n    });\n    if (!response.ok) {\n      throw new Error(`Search request failed: ${response.status} ${response.statusText}`);\n    }\n    return response.json();\n  }\n\n  /**\n   * Execute a SPARQL query against the project's triplestore.\n   * The user must be authenticated before calling this.\n   */\n  async sparql(query: string, projectId: string): Promise<unknown> {\n    const headers = await this._authHeaders();\n    const response = await fetch(`${this._gatewayUrl}${ENDPOINT_SPARQL}`, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify({ query, projectId }),\n    });\n    if (!response.ok) {\n      throw new Error(`SPARQL query failed: ${response.status} ${response.statusText}`);\n    }\n    return response.json();\n  }\n}\n"]}

package/src/lib/auth.d.ts

@@ -0,0 +1,24 @@
+import { Auth, User } from 'firebase/auth';
+import type { FirebaseApp } from 'firebase/app';
+import type { PasswordCredentials, SsoProvider } from './models';
+export type AuthStateListener = (user: User | null) => void;
+export type Unsubscribe = () => void;
+export declare class CueAuth {
+    private readonly _auth;
+    constructor(app: FirebaseApp, useEmulator?: boolean);
+    /** Sign in with Google or Microsoft via browser popup */
+    signIn(provider: SsoProvider): Promise<User>;
+    /** Sign in with email and password */
+    signIn(provider: 'password', credentials: PasswordCredentials): Promise<User>;
+    /** Sign out the current user */
+    signOut(): Promise<void>;
+    /** Currently signed-in user, or null if not authenticated */
+    get currentUser(): User | null;
+    /** Subscribe to authentication state changes. Returns an unsubscribe function. */
+    onAuthStateChanged(listener: AuthStateListener): Unsubscribe;
+    /** Get the Firebase ID token for the current user, or null if not authenticated */
+    getToken(forceRefresh?: boolean): Promise<string | null>;
+    /** Raw Firebase Auth instance, for advanced use cases */
+    get firebaseAuth(): Auth;
+}
+//# sourceMappingURL=auth.d.ts.map

package/src/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../../../libs/js/cue-sdk/src/lib/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EASJ,IAAI,EACL,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAIjE,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;gBAEjB,GAAG,EAAE,WAAW,EAAE,WAAW,UAAQ;IAOjD,yDAAyD;IACnD,MAAM,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAClD,sCAAsC;IAChC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnF,gCAAgC;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,6DAA6D;IAC7D,IAAI,WAAW,IAAI,IAAI,GAAG,IAAI,CAE7B;IAED,kFAAkF;IAClF,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,WAAW;IAI5D,mFAAmF;IAC7E,QAAQ,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM5D,yDAAyD;IACzD,IAAI,YAAY,IAAI,IAAI,CAEvB;CACF"}

package/src/lib/auth.js

@@ -0,0 +1,48 @@
+import { connectAuthEmulator, getAuth, GoogleAuthProvider, OAuthProvider, onAuthStateChanged as firebaseOnAuthStateChanged, signInWithEmailAndPassword, signInWithPopup, signOut as firebaseSignOut, } from 'firebase/auth';
+const MICROSOFT_PROVIDER_ID = 'microsoft.com';
+export class CueAuth {
+    _auth;
+    constructor(app, useEmulator = false) {
+        this._auth = getAuth(app);
+        if (useEmulator) {
+            connectAuthEmulator(this._auth, 'http://localhost:9099', { disableWarnings: true });
+        }
+    }
+    async signIn(provider, credentials) {
+        if (provider === 'password') {
+            if (!credentials)
+                throw new Error('credentials are required for password sign-in');
+            const result = await signInWithEmailAndPassword(this._auth, credentials.email, credentials.password);
+            return result.user;
+        }
+        const firebaseProvider = provider === 'google'
+            ? new GoogleAuthProvider()
+            : new OAuthProvider(MICROSOFT_PROVIDER_ID);
+        const result = await signInWithPopup(this._auth, firebaseProvider);
+        return result.user;
+    }
+    /** Sign out the current user */
+    async signOut() {
+        await firebaseSignOut(this._auth);
+    }
+    /** Currently signed-in user, or null if not authenticated */
+    get currentUser() {
+        return this._auth.currentUser;
+    }
+    /** Subscribe to authentication state changes. Returns an unsubscribe function. */
+    onAuthStateChanged(listener) {
+        return firebaseOnAuthStateChanged(this._auth, listener);
+    }
+    /** Get the Firebase ID token for the current user, or null if not authenticated */
+    async getToken(forceRefresh = false) {
+        const user = this._auth.currentUser;
+        if (!user)
+            return null;
+        return user.getIdToken(forceRefresh);
+    }
+    /** Raw Firebase Auth instance, for advanced use cases */
+    get firebaseAuth() {
+        return this._auth;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/src/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../../../../libs/js/cue-sdk/src/lib/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EACnB,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,kBAAkB,IAAI,0BAA0B,EAChD,0BAA0B,EAC1B,eAAe,EACf,OAAO,IAAI,eAAe,GAE3B,MAAM,eAAe,CAAC;AAIvB,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAK9C,MAAM,OAAO,OAAO;IACD,KAAK,CAAO;IAE7B,YAAY,GAAgB,EAAE,WAAW,GAAG,KAAK;QAC/C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,WAAW,EAAE,CAAC;YAChB,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,uBAAuB,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAMD,KAAK,CAAC,MAAM,CACV,QAAkC,EAClC,WAAiC;QAEjC,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnF,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAC7C,IAAI,CAAC,KAAK,EACV,WAAW,CAAC,KAAK,EACjB,WAAW,CAAC,QAAQ,CACrB,CAAC;YACF,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,MAAM,gBAAgB,GACpB,QAAQ,KAAK,QAAQ;YACnB,CAAC,CAAC,IAAI,kBAAkB,EAAE;YAC1B,CAAC,CAAC,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,OAAO;QACX,MAAM,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,6DAA6D;IAC7D,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;IAChC,CAAC;IAED,kFAAkF;IAClF,kBAAkB,CAAC,QAA2B;QAC5C,OAAO,0BAA0B,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,QAAQ,CAAC,YAAY,GAAG,KAAK;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED,yDAAyD;IACzD,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF","sourcesContent":["import {\n  Auth,\n  connectAuthEmulator,\n  getAuth,\n  GoogleAuthProvider,\n  OAuthProvider,\n  onAuthStateChanged as firebaseOnAuthStateChanged,\n  signInWithEmailAndPassword,\n  signInWithPopup,\n  signOut as firebaseSignOut,\n  User,\n} from 'firebase/auth';\nimport type { FirebaseApp } from 'firebase/app';\nimport type { PasswordCredentials, SsoProvider } from './models';\n\nconst MICROSOFT_PROVIDER_ID = 'microsoft.com';\n\nexport type AuthStateListener = (user: User | null) => void;\nexport type Unsubscribe = () => void;\n\nexport class CueAuth {\n  private readonly _auth: Auth;\n\n  constructor(app: FirebaseApp, useEmulator = false) {\n    this._auth = getAuth(app);\n    if (useEmulator) {\n      connectAuthEmulator(this._auth, 'http://localhost:9099', { disableWarnings: true });\n    }\n  }\n\n  /** Sign in with Google or Microsoft via browser popup */\n  async signIn(provider: SsoProvider): Promise<User>;\n  /** Sign in with email and password */\n  async signIn(provider: 'password', credentials: PasswordCredentials): Promise<User>;\n  async signIn(\n    provider: SsoProvider | 'password',\n    credentials?: PasswordCredentials,\n  ): Promise<User> {\n    if (provider === 'password') {\n      if (!credentials) throw new Error('credentials are required for password sign-in');\n      const result = await signInWithEmailAndPassword(\n        this._auth,\n        credentials.email,\n        credentials.password,\n      );\n      return result.user;\n    }\n    const firebaseProvider =\n      provider === 'google'\n        ? new GoogleAuthProvider()\n        : new OAuthProvider(MICROSOFT_PROVIDER_ID);\n    const result = await signInWithPopup(this._auth, firebaseProvider);\n    return result.user;\n  }\n\n  /** Sign out the current user */\n  async signOut(): Promise<void> {\n    await firebaseSignOut(this._auth);\n  }\n\n  /** Currently signed-in user, or null if not authenticated */\n  get currentUser(): User | null {\n    return this._auth.currentUser;\n  }\n\n  /** Subscribe to authentication state changes. Returns an unsubscribe function. */\n  onAuthStateChanged(listener: AuthStateListener): Unsubscribe {\n    return firebaseOnAuthStateChanged(this._auth, listener);\n  }\n\n  /** Get the Firebase ID token for the current user, or null if not authenticated */\n  async getToken(forceRefresh = false): Promise<string | null> {\n    const user = this._auth.currentUser;\n    if (!user) return null;\n    return user.getIdToken(forceRefresh);\n  }\n\n  /** Raw Firebase Auth instance, for advanced use cases */\n  get firebaseAuth(): Auth {\n    return this._auth;\n  }\n}\n"]}

package/src/lib/cue.d.ts

@@ -0,0 +1,20 @@
+import { CueAuth } from './auth';
+import { CueApi } from './api';
+import type { CueSdkConfig } from './models';
+/**
+ * Main entry point for the QAECY SDK.
+ *
+ * @example
+ * const cue = new Cue({ apiKey: '...', appId: '...', measurementId: '...' });
+ * await cue.auth.signIn('google');
+ * const results = await cue.api.search({ term: 'my query', projectId: 'project-id' });
+ */
+export declare class Cue {
+    readonly auth: CueAuth;
+    readonly api: CueApi;
+    private readonly _app;
+    constructor(config: CueSdkConfig);
+    /** Convenience: get the current user's Firebase ID token */
+    getToken(forceRefresh?: boolean): Promise<string | null>;
+}
+//# sourceMappingURL=cue.d.ts.map

package/src/lib/cue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cue.d.ts","sourceRoot":"","sources":["../../../../../../libs/js/cue-sdk/src/lib/cue.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAO7C;;;;;;;GAOG;AACH,qBAAa,GAAG;IACd,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;gBAEvB,MAAM,EAAE,YAAY;IAkBhC,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGvD"}

package/src/lib/cue.js

@@ -0,0 +1,39 @@
+import { initializeApp } from 'firebase/app';
+import { CueAuth } from './auth';
+import { CueApi } from './api';
+const FIREBASE_PROJECT_ID = 'qaecy-mvp-406413';
+const FIREBASE_SENDER_ID = '734737865998';
+const GATEWAY_URL_PRODUCTION = 'https://accessors-api-gateway-ueyeemwf2a-oa.a.run.app';
+const GATEWAY_URL_EMULATORS = 'http://localhost:8093';
+/**
+ * Main entry point for the QAECY SDK.
+ *
+ * @example
+ * const cue = new Cue({ apiKey: '...', appId: '...', measurementId: '...' });
+ * await cue.auth.signIn('google');
+ * const results = await cue.api.search({ term: 'my query', projectId: 'project-id' });
+ */
+export class Cue {
+    auth;
+    api;
+    _app;
+    constructor(config) {
+        this._app = initializeApp({
+            apiKey: config.apiKey,
+            appId: config.appId,
+            measurementId: config.measurementId,
+            authDomain: `${FIREBASE_PROJECT_ID}.firebaseapp.com`,
+            projectId: FIREBASE_PROJECT_ID,
+            messagingSenderId: FIREBASE_SENDER_ID,
+        });
+        const gatewayUrl = config.gatewayUrl ??
+            (config.useEmulator ? GATEWAY_URL_EMULATORS : GATEWAY_URL_PRODUCTION);
+        this.auth = new CueAuth(this._app, config.useEmulator ?? false);
+        this.api = new CueApi(this.auth, gatewayUrl);
+    }
+    /** Convenience: get the current user's Firebase ID token */
+    getToken(forceRefresh = false) {
+        return this.auth.getToken(forceRefresh);
+    }
+}
+//# sourceMappingURL=cue.js.map

package/src/lib/cue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cue.js","sourceRoot":"","sources":["../../../../../../libs/js/cue-sdk/src/lib/cue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAG/B,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAC/C,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAC1C,MAAM,sBAAsB,GAAG,uDAAuD,CAAC;AACvF,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,OAAO,GAAG;IACL,IAAI,CAAU;IACd,GAAG,CAAS;IAEJ,IAAI,CAAc;IAEnC,YAAY,MAAoB;QAC9B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;YACxB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,UAAU,EAAE,GAAG,mBAAmB,kBAAkB;YACpD,SAAS,EAAE,mBAAmB;YAC9B,iBAAiB,EAAE,kBAAkB;SACtC,CAAC,CAAC;QAEH,MAAM,UAAU,GACd,MAAM,CAAC,UAAU;YACjB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;QAExE,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,GAAG,KAAK;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["import { initializeApp } from 'firebase/app';\nimport type { FirebaseApp } from 'firebase/app';\nimport { CueAuth } from './auth';\nimport { CueApi } from './api';\nimport type { CueSdkConfig } from './models';\n\nconst FIREBASE_PROJECT_ID = 'qaecy-mvp-406413';\nconst FIREBASE_SENDER_ID = '734737865998';\nconst GATEWAY_URL_PRODUCTION = 'https://accessors-api-gateway-ueyeemwf2a-oa.a.run.app';\nconst GATEWAY_URL_EMULATORS = 'http://localhost:8093';\n\n/**\n * Main entry point for the QAECY SDK.\n *\n * @example\n * const cue = new Cue({ apiKey: '...', appId: '...', measurementId: '...' });\n * await cue.auth.signIn('google');\n * const results = await cue.api.search({ term: 'my query', projectId: 'project-id' });\n */\nexport class Cue {\n  readonly auth: CueAuth;\n  readonly api: CueApi;\n\n  private readonly _app: FirebaseApp;\n\n  constructor(config: CueSdkConfig) {\n    this._app = initializeApp({\n      apiKey: config.apiKey,\n      appId: config.appId,\n      measurementId: config.measurementId,\n      authDomain: `${FIREBASE_PROJECT_ID}.firebaseapp.com`,\n      projectId: FIREBASE_PROJECT_ID,\n      messagingSenderId: FIREBASE_SENDER_ID,\n    });\n\n    const gatewayUrl =\n      config.gatewayUrl ??\n      (config.useEmulator ? GATEWAY_URL_EMULATORS : GATEWAY_URL_PRODUCTION);\n\n    this.auth = new CueAuth(this._app, config.useEmulator ?? false);\n    this.api = new CueApi(this.auth, gatewayUrl);\n  }\n\n  /** Convenience: get the current user's Firebase ID token */\n  getToken(forceRefresh = false): Promise<string | null> {\n    return this.auth.getToken(forceRefresh);\n  }\n}\n"]}

package/src/lib/models.d.ts

@@ -0,0 +1,39 @@
+export interface CueSdkConfig {
+    /** Firebase API key for this project */
+    apiKey: string;
+    /** Firebase App ID */
+    appId: string;
+    /** Firebase Measurement ID */
+    measurementId: string;
+    /** Override the API gateway URL. Defaults to production. */
+    gatewayUrl?: string;
+    /** Connect to local emulators instead of production services */
+    useEmulator?: boolean;
+}
+export type SsoProvider = 'google' | 'microsoft';
+export interface PasswordCredentials {
+    email: string;
+    password: string;
+}
+export interface SearchRequest {
+    /** Natural language query or search term */
+    term: string;
+    /** Project ID to search within */
+    projectId: string;
+    /** Optional category filters */
+    categories?: string[];
+}
+export interface SearchSource {
+    item: string;
+    parent: string;
+    content: string;
+}
+export interface SearchResponse {
+    id: string;
+    question: string;
+    questionHTML: string;
+    response: string;
+    sources: SearchSource[];
+    rankedSources: SearchSource[];
+}
+//# sourceMappingURL=models.d.ts.map

package/src/lib/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../../../../libs/js/cue-sdk/src/lib/models.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B"}

package/src/lib/models.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=models.js.map

package/src/lib/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../../../libs/js/cue-sdk/src/lib/models.ts"],"names":[],"mappings":"","sourcesContent":["export interface CueSdkConfig {\n  /** Firebase API key for this project */\n  apiKey: string;\n  /** Firebase App ID */\n  appId: string;\n  /** Firebase Measurement ID */\n  measurementId: string;\n  /** Override the API gateway URL. Defaults to production. */\n  gatewayUrl?: string;\n  /** Connect to local emulators instead of production services */\n  useEmulator?: boolean;\n}\n\nexport type SsoProvider = 'google' | 'microsoft';\n\nexport interface PasswordCredentials {\n  email: string;\n  password: string;\n}\n\nexport interface SearchRequest {\n  /** Natural language query or search term */\n  term: string;\n  /** Project ID to search within */\n  projectId: string;\n  /** Optional category filters */\n  categories?: string[];\n}\n\nexport interface SearchSource {\n  item: string;\n  parent: string;\n  content: string;\n}\n\nexport interface SearchResponse {\n  id: string;\n  question: string;\n  questionHTML: string;\n  response: string;\n  sources: SearchSource[];\n  rankedSources: SearchSource[];\n}\n"]}