@storecraft/sdk 1.0.9 → 1.0.10

package/README.md

@@ -10,9 +10,34 @@ which means you can you it both at browser and at backend runtimes such (`node`
 
 It will allow you to fetch / mutate all of the resources at the `backend` in a 
 convenient manner with `javascript`, such as:
-`products`, `collections`, `authentication`, `customers`, `orders`, `discounts`,
-`storage`, `storefronts`, `shipping`, `statistics`, `tags`, `posts`, `notifications`,
-`templates`, `extensions` and more :)
+
+#### collections
+`products`, `collections`, `auth_users`, `customers`, `orders`, `discounts`,
+`storefronts`, `shipping`, `tags`, `posts`, `notifications`,
+`templates`, `extensions`, `images`
+
+#### Auth
+Perform authentication such as `signin` / `signup` / `api-key`
+
+#### Checkout
+Perform checkout `create` / `complete`
+
+#### Storage
+Perform storage operations such as `put` / `get` / `delete`
+
+#### Payments
+Perform payments `status-check` / `invoke-action`
+
+#### Statistics
+- Query some basic statistics about `orders` in a time span
+- Query count of items in collections
+
+#### AI
+Speak with a `storecraft` agent (Supports streaming :))
+
+<hr/>
+
+Start by installing, 
 
 Plus, everything is typed so you dont have to guess any parameter or queryable key
 

package/index.js

@@ -16,6 +16,7 @@ import Payments from './src/payments.js'
 import Settings from './src/settings.js'
 import Notifications from './src/notifications.js'
 import Storage from './src/storage.js'
+import AI from './src/ai.js'
 
 
 /**
@@ -49,6 +50,7 @@ export class StorecraftSDK {
   constructor(config) {
     this.#_config = config;
 
+    this.ai = new AI(this);
     this.auth = new Auth(this);
     this.storage = new Storage(this);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storecraft/sdk",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Official storecraft Universal Javascript SDK",
   "license": "MIT",
   "author": "Tomer Shalev (https://github.com/store-craft)",

package/src/ai.js

@@ -0,0 +1,171 @@
+/**
+ * @import { 
+ *  AgentRunParameters, AgentRunResponse 
+ * } from '@storecraft/core/ai/agents/types.js'
+ * @import { content } from '@storecraft/core/ai/types.public.js'
+ */
+
+import { HEADER_STORECRAFT_THREAD_ID } from '../../core/rest/con.ai.routes.js';
+import { StorecraftSDK } from '../index.js'
+import { url } from './utils.api.fetch.js';
+
+/**
+ * @description **AI**
+ * 
+ */
+export default class AI {
+
+  /**
+   * 
+   * @param {StorecraftSDK} sdk 
+   */
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * @description Speak with the main `storecraft` agent sync. It is
+   * recommended to use the streamed version {@link streamSpeak}
+   * @param {AgentRunParameters} params 
+   * @returns {Promise<AgentRunResponse>}
+   */
+  speak = async (params) => {
+    const response = await fetch(
+      url(this.sdk.config, 'ai/agent/run'),
+      {
+        method: 'post',
+        body: JSON.stringify(params),
+        headers: {
+          'Content-Type': 'application/json'
+        }
+      }
+    );
+
+    return response.json();
+  }
+
+  /**
+   * @description Stream Speak with the main `storecraft` agent via Server-Sent Events
+   * @param {AgentRunParameters} params 
+   */
+  streamSpeak = async function(params) {
+    const response = await fetch(
+      url(this.sdk.config, 'ai/agent/stream'),
+      {
+        method: 'post',
+        body: JSON.stringify(params),
+        headers: {
+          'Content-Type': 'application/json'
+        }
+      }
+    );
+
+    const threadId = response.headers.get(HEADER_STORECRAFT_THREAD_ID ?? 'X-Storecraft-Thread-Id');
+
+    if(!threadId) {
+      throw new Error(
+        `X-Storecraft-Thread-Id is missing, please tell the backend admin to 
+        change the cors' Access-Control-Expose-Headers to accept the header`
+      )
+    }
+    
+    return {
+      threadId,
+      generator: () => StreamSpeakGenerator(response.body)
+    }
+  }
+
+}
+
+const sleep = (ms=100) => {
+  return new Promise(
+    (resolve, reject) => {
+      setTimeout(
+        resolve, ms
+      )
+    }
+  )
+}
+
+/**
+ * @description Server Sent Events async generator
+ * @param {ReadableStream} stream web stream
+ */
+const StreamSpeakGenerator = async function *(stream) {
+  for await (const sse of SSEGenerator(stream)) {
+    await sleep(50);
+    yield ( /** @type {content} */ (JSON.parse(sse.data)));
+  }
+}
+
+/**
+ * @description Server Sent Events async generator
+ * @param {ReadableStream} stream web stream
+ */
+export const SSEGenerator = async function *(stream) {
+
+  let active_frame = [];
+  let residual_line = '';
+
+  const reader = stream.getReader();
+  let current = await reader.read();
+
+  while(!current.done) {
+    
+    let text = (new TextDecoder()).decode(current.value); 
+    // console.log('text \n\n', text)
+  
+    if(residual_line) {
+      text = residual_line + text;
+      residual_line = '';
+    }
+  
+    const lines = text.split(/\r\n|\n|\r/).map(l => l.trim());
+  
+    for(const line of lines) {
+      if(line==='' && active_frame.length) {
+        // console.log('frame \n\n', active_frame)
+        // empty line means processing and dispatch
+        yield parse_frame(active_frame);
+        active_frame = [];
+      } else {
+        active_frame.push(line);
+      }
+    }
+  
+    // if we got here and we have a line, then it
+    // was not finished (Otherwise, it would have been parsed and dispatched)
+    // I will need to prepend it to the next batch as it is incomplete
+    residual_line = active_frame.pop();
+
+    current = await reader.read();
+  }
+
+}
+
+
+
+/**
+ * @typedef {object} SSEFrame Server Sent Events frame
+ * @prop {string} [data]
+ * @prop {string} [event]
+ */
+
+/**
+ * 
+ * @param {string[]} lines 
+ * @returns {SSEFrame}
+ */
+const parse_frame = (lines) => {
+  return Object.fromEntries(
+    lines.map(
+      (l) => {
+        const delimiter = l.indexOf(':');
+        return [
+          l.slice(0, delimiter).trim(),
+          l.slice(delimiter + 1).trim(),
+        ]
+      }
+    )
+  );
+}

package/src/payments.js

@@ -62,7 +62,8 @@ export default class Payments {
   
   /**
    * 
-   * Invoke a `payment gateway` action on `order`
+   * Invoke a `payment gateway` action on `order`. The list of available actions can be found
+   * using {@link get} or {@link paymentStatusOfOrder}
    * 
    * 
    * @param {string} action_handle The `action` handle at the gateway

package/src/utils.functional.js

@@ -89,7 +89,9 @@ export const text2tokens = (text) => {
   // let tokens = text?.toString().toLowerCase().match(/[^\W_]+/g)
   let tokens = text?.toString().toLowerCase().match(/[\p{L}\d]+/gu)
 
+  // @ts-ignore
   tokens = tokens ?? []
+  // @ts-ignore
   tokens = tokens.filter(
     t => !STOP_WORDS.includes(t)
   )