@pooflabs/core 0.0.26 → 0.0.28

package/dist/client/config.d.ts

@@ -19,7 +19,7 @@ export interface ClientConfig {
     };
     phantomConfig?: {
         appId?: string;
-        providers?: Array<'injected' | 'google' | 'apple' | 'phantom'>;
+        providers?: Array<'injected' | 'google' | 'apple' | 'phantom' | 'deeplink'>;
         redirectUrl?: string;
         autoConnect?: boolean;
         theme?: 'light' | 'dark';

package/dist/client/operations.d.ts

@@ -5,13 +5,24 @@ export type SetOptions = {
         headers?: Record<string, string>;
     };
 };
-export declare function get(path: string, opts?: {
+/**
+ * Options for the get function.
+ */
+export type GetOptions = {
+    /** Natural language prompt for AI-powered queries (collections only) */
     prompt?: string | undefined;
+    /** Bypass the local cache and fetch fresh data */
     bypassCache?: boolean;
+    /** Include documents from sub-paths (nested collections) */
+    includeSubPaths?: boolean;
+    /** Shape object for relationship resolution - specifies which related documents to include */
+    shape?: Record<string, any>;
+    /** Internal overrides for headers */
     _overrides?: {
         headers?: Record<string, string>;
     };
-}): Promise<any>;
+};
+export declare function get(path: string, opts?: GetOptions): Promise<any>;
 export type RunExpressionOptions = {
     returnType?: 'Bool' | 'String' | 'Int' | 'UInt';
     _overrides?: {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { init } from './client/config';
 export { getConfig, ClientConfig } from './client/config';
-export { get, set, setMany, setFile, getFiles, runQuery, runQueryMany, runExpression, runExpressionMany, signMessage, signTransaction, signAndSubmitTransaction, SetOptions, RunExpressionOptions, RunExpressionResult } from './client/operations';
+export { get, set, setMany, setFile, getFiles, runQuery, runQueryMany, runExpression, runExpressionMany, signMessage, signTransaction, signAndSubmitTransaction, SetOptions, GetOptions, RunExpressionOptions, RunExpressionResult } from './client/operations';
 export { subscribe, closeAllSubscriptions, clearCache, getCachedData, reconnectWithNewAuth } from './client/subscription';
 export * from './types';
 export { getIdToken } from './utils/utils';

package/dist/index.js

@@ -3279,8 +3279,10 @@ async function get(path, opts = {}) {
         if (!normalizedPath || normalizedPath.length === 0) {
             return new Error("Invalid path provided.");
         }
-        // Create cache key combining path and prompt
-        const cacheKey = `${normalizedPath}:${opts.prompt || ''}`;
+        // Create cache key combining path, prompt, includeSubPaths, and shape
+        const shapeKey = opts.shape ? JSON.stringify(opts.shape) : '';
+        const includeSubPathsKey = opts.includeSubPaths ? ':subpaths' : '';
+        const cacheKey = `${normalizedPath}:${opts.prompt || ''}${includeSubPathsKey}:${shapeKey}`;
         const now = Date.now();
         // Check for valid cache entry if not bypassing cache
         if (!opts.bypassCache && getCache[cacheKey] && now < getCache[cacheKey].expiresAt) {
@@ -3301,15 +3303,20 @@ async function get(path, opts = {}) {
                 // Cache miss or bypass - proceed with API request
                 const pathIsDocument = normalizedPath.split("/").length % 2 === 0;
                 let response;
+                // Build common query params
+                const includeSubPathsParam = opts.includeSubPaths ? '&includeSubPaths=true' : '';
+                const shapeParam = opts.shape ? `&shape=${encodeURIComponent(JSON.stringify(opts.shape))}` : '';
                 if (pathIsDocument) {
                     const itemId = encodeURIComponent(normalizedPath);
-                    const apiPath = `items/${itemId}`;
+                    // For documents, query params go after the path
+                    const queryParams = [includeSubPathsParam, shapeParam].filter(p => p).join('');
+                    const apiPath = queryParams ? `items/${itemId}?${queryParams.substring(1)}` : `items/${itemId}`;
                     response = await makeApiRequest('GET', apiPath, null, opts._overrides);
                 }
                 else {
                     const path = encodeURIComponent(normalizedPath);
                     const promptQueryParam = (opts === null || opts === void 0 ? void 0 : opts.prompt) ? `&prompt=${btoa(opts.prompt)}` : "";
-                    const apiPath = `items?path=${path}${promptQueryParam}`;
+                    const apiPath = `items?path=${path}${promptQueryParam}${includeSubPathsParam}${shapeParam}`;
                     response = await makeApiRequest('GET', apiPath, null, opts._overrides);
                 }
                 // Cache the response (unless bypassing cache)
@@ -3725,9 +3732,10 @@ const WS_V2_PATH = '/ws/v2';
 function generateSubscriptionId() {
     return `sub_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
 }
-function getCacheKey(path, prompt) {
+function getCacheKey(path, prompt, shape) {
     const normalizedPath = path.startsWith('/') ? path.slice(1) : path;
-    return `${normalizedPath}:${prompt || 'default'}`;
+    const shapeKey = shape && Object.keys(shape).length > 0 ? JSON.stringify(shape) : '';
+    return `${normalizedPath}:${prompt || 'default'}:${shapeKey}`;
 }
 function isTokenExpired(token) {
     try {
@@ -3893,7 +3901,7 @@ function handleServerMessage(connection, message) {
             const subscription = connection.subscriptions.get(message.subscriptionId);
             if (subscription) {
                 // Update cache
-                const cacheKey = getCacheKey(subscription.path, subscription.prompt);
+                const cacheKey = getCacheKey(subscription.path, subscription.prompt, subscription.shape);
                 responseCache.set(cacheKey, { data: message.data, timestamp: Date.now() });
                 // Store last data
                 subscription.lastData = message.data;
@@ -3921,7 +3929,7 @@ function handleServerMessage(connection, message) {
             const subscription = connection.subscriptions.get(message.subscriptionId);
             if (subscription) {
                 // Update cache
-                const cacheKey = getCacheKey(subscription.path, subscription.prompt);
+                const cacheKey = getCacheKey(subscription.path, subscription.prompt, subscription.shape);
                 responseCache.set(cacheKey, { data: message.data, timestamp: Date.now() });
                 // Store last data
                 subscription.lastData = message.data;
@@ -3974,6 +3982,9 @@ function sendSubscribe(connection, subscription) {
         path: subscription.path,
         prompt: subscription.prompt ? btoa(subscription.prompt) : undefined,
         includeSubPaths: subscription.includeSubPaths,
+        shape: subscription.shape && Object.keys(subscription.shape).length > 0
+            ? subscription.shape
+            : undefined,
     };
     try {
         connection.ws.send(JSON.stringify(message));
@@ -4005,7 +4016,7 @@ function sendUnsubscribe(connection, subscriptionId) {
 async function subscribeV2(path, subscriptionOptions) {
     const config = await getConfig();
     const normalizedPath = path.startsWith('/') ? path.slice(1) : path;
-    const cacheKey = getCacheKey(normalizedPath, subscriptionOptions.prompt);
+    const cacheKey = getCacheKey(normalizedPath, subscriptionOptions.prompt, subscriptionOptions.shape);
     // Deliver cached data immediately if available
     const cachedEntry = responseCache.get(cacheKey);
     if (cachedEntry && Date.now() - cachedEntry.timestamp < CACHE_TTL && subscriptionOptions.onData) {
@@ -4016,10 +4027,12 @@ async function subscribeV2(path, subscriptionOptions) {
     }
     // Get or create connection for this appId
     const connection = await getOrCreateConnection(config.appId, config.isServer);
-    // Check if we already have a subscription for this path+prompt
+    // Check if we already have a subscription for this path+prompt+shape
+    const shapeKey = subscriptionOptions.shape ? JSON.stringify(subscriptionOptions.shape) : '';
     let existingSubscription;
     for (const sub of connection.subscriptions.values()) {
-        if (sub.path === normalizedPath && sub.prompt === subscriptionOptions.prompt) {
+        const subShapeKey = sub.shape ? JSON.stringify(sub.shape) : '';
+        if (sub.path === normalizedPath && sub.prompt === subscriptionOptions.prompt && subShapeKey === shapeKey) {
             existingSubscription = sub;
             break;
         }
@@ -4044,6 +4057,7 @@ async function subscribeV2(path, subscriptionOptions) {
         subscriptionId,
         path: normalizedPath,
         prompt: subscriptionOptions.prompt,
+        shape: subscriptionOptions.shape,
         includeSubPaths: false,
         callbacks: [subscriptionOptions],
         lastData: undefined,