@layla-network/sdk 0.1.2 → 0.1.3

package/dist/index.cjs

@@ -27,7 +27,9 @@ __export(index_exports, {
   LaylaBridgeUnavailableError: () => LaylaBridgeUnavailableError,
   LaylaError: () => LaylaError,
   LaylaSDK: () => LaylaSDK,
-  default: () => client_default
+  default: () => client_default,
+  installLaylaMock: () => installLaylaMock,
+  makeMockCharacter: () => makeMockCharacter
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -578,6 +580,207 @@ var LaylaSDK = class {
   }
 };
 var client_default = LaylaSDK;
+
+// src/mock.ts
+var delay = (ms) => new Promise((r) => setTimeout(r, ms));
+function makeMockCharacter(name, overrides = {}) {
+  return {
+    id: `mock-${name.toLowerCase()}`,
+    data: {
+      spec: "chara_card_v2",
+      spec_version: "2.0",
+      data: {
+        name,
+        description: `${name} is a mock character for local testing.`,
+        personality: "friendly, helpful",
+        scenario: "",
+        first_mes: `Hi, I'm ${name}.`,
+        mes_example: "",
+        creator_notes: "Generated by layla mock.",
+        system_prompt: "",
+        post_history_instructions: "",
+        alternate_greetings: [],
+        tags: ["mock"],
+        creator: "layla-mock",
+        character_version: "1.0",
+        extensions: {},
+        ...overrides
+      }
+    }
+  };
+}
+function installLaylaMock(options = {}) {
+  if (typeof window === "undefined") {
+    throw new Error(
+      "installLaylaMock needs a browser-like environment (window). In Node, run your test under jsdom or happy-dom."
+    );
+  }
+  const latencyMs = options.latencyMs ?? 150;
+  const tokenDelayMs = options.tokenDelayMs ?? 40;
+  const errorRate = options.errorRate ?? 0;
+  const characters = options.characters ?? [makeMockCharacter("Aria"), makeMockCharacter("Kai")];
+  let current = null;
+  const log = (...a) => {
+    if (options.debug) console.log("[layla-mock]", ...a);
+  };
+  const emit = (event) => {
+    log("RN->web", event);
+    window.dispatchEvent(new MessageEvent("message", { data: JSON.stringify(event) }));
+  };
+  const emitError = (message) => emit({ event: "on_error", data: { message } });
+  const shouldError = () => errorRate > 0 && Math.random() < errorRate;
+  const tokenize = (text) => text.match(/\S+\s*/g) ?? (text ? [text] : []);
+  const defaultReply = (messages) => {
+    const lastUser = [...messages].reverse().find((m) => m.role === "user");
+    const said = lastUser?.content ?? "(nothing)";
+    return `This is a mock Layla response. You said: "${said}". Tokens stream one at a time so you can exercise your streaming UI, cancellation, and the final-content promise.`;
+  };
+  async function* tokenSource(messages) {
+    const produced = options.respond ? await options.respond(messages) : defaultReply(messages);
+    if (typeof produced === "string") {
+      yield* tokenize(produced);
+      return;
+    }
+    if (Array.isArray(produced)) {
+      yield* produced;
+      return;
+    }
+    if (produced && typeof produced === "object") {
+      if (Symbol.asyncIterator in produced) {
+        yield* produced;
+        return;
+      }
+      if (Symbol.iterator in produced) {
+        yield* produced;
+      }
+    }
+  }
+  async function handleSend(messages) {
+    const gen = { cancelled: false };
+    current = gen;
+    try {
+      await delay(latencyMs);
+      if (gen.cancelled) return;
+      if (shouldError()) {
+        emitError("Simulated model error");
+        return;
+      }
+      let snapshot = "";
+      for await (const delta of tokenSource(messages)) {
+        if (gen.cancelled) return;
+        snapshot += delta;
+        emit({ event: "on_message", data: { msg: snapshot, delta } });
+        await delay(tokenDelayMs);
+        if (gen.cancelled) return;
+      }
+      emit({ event: "on_message_end" });
+    } finally {
+      if (current === gen) current = null;
+    }
+  }
+  function handleCancel() {
+    if (current && !current.cancelled) {
+      current.cancelled = true;
+      queueMicrotask(() => emit({ event: "on_message_end" }));
+    }
+  }
+  async function handleGetCharacters() {
+    await delay(latencyMs);
+    if (shouldError()) {
+      emitError("Simulated characters error");
+      return;
+    }
+    emit({ event: "on_get_characters_response", data: characters });
+  }
+  async function handleGetCharacterImage(data) {
+    await delay(latencyMs);
+    if (shouldError()) {
+      emitError("Simulated character image error");
+      return;
+    }
+    emit({
+      event: "on_get_character_image_response",
+      data: {
+        character_id: data.character_id,
+        image_data_base64: "https://picsum.photos/id/237/200/300"
+        // we return a url for mock, since we usually use this as the "src" of an <img> tag, it should work fine as a mock
+      }
+    });
+  }
+  async function handleGenerateImage(_) {
+    await delay(latencyMs);
+    if (shouldError()) {
+      emitError("Simulated image generation error");
+      return;
+    }
+    const totalSteps = 5;
+    for (let step = 1; step <= totalSteps; step++) {
+      await delay(latencyMs);
+      emit({
+        event: "on_generate_image_progress",
+        data: {
+          status: `Generating image... (${step}/${totalSteps})`,
+          steps: step,
+          total_steps: totalSteps
+        }
+      });
+    }
+    emit({
+      event: "on_generate_image_response",
+      data: {
+        image_data_base64: "https://picsum.photos/200/300"
+        // Placeholder image URL for the mock
+      }
+    });
+  }
+  const fakeBridge = {
+    postMessage(raw) {
+      let msg;
+      try {
+        msg = JSON.parse(raw);
+      } catch {
+        return;
+      }
+      log("web->RN", msg);
+      switch (msg.cmd) {
+        case "send_message":
+          void handleSend(msg.data);
+          break;
+        case "cancel":
+          handleCancel();
+          break;
+        case "get_characters":
+          void handleGetCharacters();
+          break;
+        case "get_character_image":
+          void handleGetCharacterImage(msg.data);
+          break;
+        case "generate_image":
+          void handleGenerateImage(msg.data);
+          break;
+        default:
+          break;
+      }
+    }
+  };
+  const previous = window.ReactNativeWebView;
+  if (previous) {
+    log("warning: replacing an existing window.ReactNativeWebView");
+  }
+  window.ReactNativeWebView = fakeBridge;
+  log("installed");
+  let installed = true;
+  return {
+    uninstall() {
+      if (!installed) return;
+      installed = false;
+      if (current) current.cancelled = true;
+      if (previous) window.ReactNativeWebView = previous;
+      else delete window.ReactNativeWebView;
+      log("uninstalled");
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ChatCompletionStream,
@@ -586,5 +789,7 @@ var client_default = LaylaSDK;
   LaylaAbortError,
   LaylaBridgeUnavailableError,
   LaylaError,
-  LaylaSDK
+  LaylaSDK,
+  installLaylaMock,
+  makeMockCharacter
 });

package/dist/index.d.cts

@@ -435,4 +435,53 @@ declare class LaylaSDK {
     constructor(_options?: LaylaSDKOptions);
 }
 
-export { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionCreateParamsBase, type ChatCompletionCreateParamsNonStreaming, type ChatCompletionCreateParamsStreaming, ChatCompletionStream, Images, LaylaSDK as Layla, LaylaAbortError, type LaylaApiCancel, type LaylaApiEvent, type LaylaApiEvent_onError, type LaylaApiEvent_onGenerateImageResponse, type LaylaApiEvent_onGetCharacterImageResponse, type LaylaApiEvent_onGetCharactersResponse, type LaylaApiEvent_onMsg, type LaylaApiEvent_onMsgEnd, type LaylaApiGenerateImage, type LaylaApiGetCharacterImage, type LaylaApiGetCharacters, type LaylaApiRequest, type LaylaApiSendMessage, LaylaBridgeUnavailableError, type LaylaCharacter, type LaylaChatMessage, type LaylaChatRole, LaylaError, LaylaSDK, type LaylaSDKOptions, type RequestOptions, type TavernCardV2, type TavernCharacterBook, LaylaSDK as default };
+/**
+ * mock.ts
+ * -------
+ * A fake Layla native host for running the SDK OUTSIDE the app (Vite dev server,
+ * Storybook, a browser test, etc.). It installs a stand-in
+ * `window.ReactNativeWebView` and answers the web->RN commands by dispatching the
+ * same `MessageEvent`s the real host would, so the SDK's bridge, queue,
+ * streaming, and cancel paths all run for real against it.
+ *
+ * Usage (Vite — install in dev before you use the SDK):
+ *
+ *   // main.ts
+ *   if (import.meta.env.DEV) {
+ *     const { installLaylaMock } = await import('layla-sdk/mock');
+ *     installLaylaMock({ debug: true });
+ *   }
+ *
+ * Install BEFORE the SDK posts its first message; otherwise the bridge sees no
+ * host and rejects with LaylaBridgeUnavailableError.
+ */
+
+type MockReply = string | string[] | Iterable<string> | AsyncIterable<string>;
+interface LaylaMockOptions {
+    /**
+     * Produce the assistant reply for a `send_message`. Return a string (which the
+     * mock tokenises and streams), an array of pre-split tokens, or an
+     * (async) iterable of tokens for full control over timing/content. May be
+     * async. Defaults to a canned reply that echoes the last user message.
+     */
+    respond?: (messages: LaylaChatMessage[]) => MockReply | Promise<MockReply>;
+    /** Cards returned by `get_characters`. Defaults to two sample cards. */
+    characters?: LaylaCharacter[];
+    /** Delay before the first event of a response (simulated latency). Default 150ms. */
+    latencyMs?: number;
+    /** Delay between streamed tokens. Default 40ms. */
+    tokenDelayMs?: number;
+    /** 0..1 probability that a request fails with on_error, for testing error paths. Default 0. */
+    errorRate?: number;
+    /** Log every web->RN command and RN->web event to the console. */
+    debug?: boolean;
+}
+interface LaylaMockHandle {
+    /** Remove the fake bridge and restore whatever was there before. */
+    uninstall(): void;
+}
+/** Build a valid Character Card V2 with sensible mock defaults. */
+declare function makeMockCharacter(name: string, overrides?: Partial<TavernCardV2['data']>): LaylaCharacter;
+declare function installLaylaMock(options?: LaylaMockOptions): LaylaMockHandle;
+
+export { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionCreateParamsBase, type ChatCompletionCreateParamsNonStreaming, type ChatCompletionCreateParamsStreaming, ChatCompletionStream, Images, LaylaSDK as Layla, LaylaAbortError, type LaylaApiCancel, type LaylaApiEvent, type LaylaApiEvent_onError, type LaylaApiEvent_onGenerateImageResponse, type LaylaApiEvent_onGetCharacterImageResponse, type LaylaApiEvent_onGetCharactersResponse, type LaylaApiEvent_onMsg, type LaylaApiEvent_onMsgEnd, type LaylaApiGenerateImage, type LaylaApiGetCharacterImage, type LaylaApiGetCharacters, type LaylaApiRequest, type LaylaApiSendMessage, LaylaBridgeUnavailableError, type LaylaCharacter, type LaylaChatMessage, type LaylaChatRole, LaylaError, LaylaSDK, type LaylaSDKOptions, type RequestOptions, type TavernCardV2, type TavernCharacterBook, LaylaSDK as default, installLaylaMock, makeMockCharacter };

package/dist/index.d.ts

@@ -435,4 +435,53 @@ declare class LaylaSDK {
     constructor(_options?: LaylaSDKOptions);
 }
 
-export { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionCreateParamsBase, type ChatCompletionCreateParamsNonStreaming, type ChatCompletionCreateParamsStreaming, ChatCompletionStream, Images, LaylaSDK as Layla, LaylaAbortError, type LaylaApiCancel, type LaylaApiEvent, type LaylaApiEvent_onError, type LaylaApiEvent_onGenerateImageResponse, type LaylaApiEvent_onGetCharacterImageResponse, type LaylaApiEvent_onGetCharactersResponse, type LaylaApiEvent_onMsg, type LaylaApiEvent_onMsgEnd, type LaylaApiGenerateImage, type LaylaApiGetCharacterImage, type LaylaApiGetCharacters, type LaylaApiRequest, type LaylaApiSendMessage, LaylaBridgeUnavailableError, type LaylaCharacter, type LaylaChatMessage, type LaylaChatRole, LaylaError, LaylaSDK, type LaylaSDKOptions, type RequestOptions, type TavernCardV2, type TavernCharacterBook, LaylaSDK as default };
+/**
+ * mock.ts
+ * -------
+ * A fake Layla native host for running the SDK OUTSIDE the app (Vite dev server,
+ * Storybook, a browser test, etc.). It installs a stand-in
+ * `window.ReactNativeWebView` and answers the web->RN commands by dispatching the
+ * same `MessageEvent`s the real host would, so the SDK's bridge, queue,
+ * streaming, and cancel paths all run for real against it.
+ *
+ * Usage (Vite — install in dev before you use the SDK):
+ *
+ *   // main.ts
+ *   if (import.meta.env.DEV) {
+ *     const { installLaylaMock } = await import('layla-sdk/mock');
+ *     installLaylaMock({ debug: true });
+ *   }
+ *
+ * Install BEFORE the SDK posts its first message; otherwise the bridge sees no
+ * host and rejects with LaylaBridgeUnavailableError.
+ */
+
+type MockReply = string | string[] | Iterable<string> | AsyncIterable<string>;
+interface LaylaMockOptions {
+    /**
+     * Produce the assistant reply for a `send_message`. Return a string (which the
+     * mock tokenises and streams), an array of pre-split tokens, or an
+     * (async) iterable of tokens for full control over timing/content. May be
+     * async. Defaults to a canned reply that echoes the last user message.
+     */
+    respond?: (messages: LaylaChatMessage[]) => MockReply | Promise<MockReply>;
+    /** Cards returned by `get_characters`. Defaults to two sample cards. */
+    characters?: LaylaCharacter[];
+    /** Delay before the first event of a response (simulated latency). Default 150ms. */
+    latencyMs?: number;
+    /** Delay between streamed tokens. Default 40ms. */
+    tokenDelayMs?: number;
+    /** 0..1 probability that a request fails with on_error, for testing error paths. Default 0. */
+    errorRate?: number;
+    /** Log every web->RN command and RN->web event to the console. */
+    debug?: boolean;
+}
+interface LaylaMockHandle {
+    /** Remove the fake bridge and restore whatever was there before. */
+    uninstall(): void;
+}
+/** Build a valid Character Card V2 with sensible mock defaults. */
+declare function makeMockCharacter(name: string, overrides?: Partial<TavernCardV2['data']>): LaylaCharacter;
+declare function installLaylaMock(options?: LaylaMockOptions): LaylaMockHandle;
+
+export { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionCreateParamsBase, type ChatCompletionCreateParamsNonStreaming, type ChatCompletionCreateParamsStreaming, ChatCompletionStream, Images, LaylaSDK as Layla, LaylaAbortError, type LaylaApiCancel, type LaylaApiEvent, type LaylaApiEvent_onError, type LaylaApiEvent_onGenerateImageResponse, type LaylaApiEvent_onGetCharacterImageResponse, type LaylaApiEvent_onGetCharactersResponse, type LaylaApiEvent_onMsg, type LaylaApiEvent_onMsgEnd, type LaylaApiGenerateImage, type LaylaApiGetCharacterImage, type LaylaApiGetCharacters, type LaylaApiRequest, type LaylaApiSendMessage, LaylaBridgeUnavailableError, type LaylaCharacter, type LaylaChatMessage, type LaylaChatRole, LaylaError, LaylaSDK, type LaylaSDKOptions, type RequestOptions, type TavernCardV2, type TavernCharacterBook, LaylaSDK as default, installLaylaMock, makeMockCharacter };

package/dist/index.js

@@ -545,6 +545,207 @@ var LaylaSDK = class {
   }
 };
 var client_default = LaylaSDK;
+
+// src/mock.ts
+var delay = (ms) => new Promise((r) => setTimeout(r, ms));
+function makeMockCharacter(name, overrides = {}) {
+  return {
+    id: `mock-${name.toLowerCase()}`,
+    data: {
+      spec: "chara_card_v2",
+      spec_version: "2.0",
+      data: {
+        name,
+        description: `${name} is a mock character for local testing.`,
+        personality: "friendly, helpful",
+        scenario: "",
+        first_mes: `Hi, I'm ${name}.`,
+        mes_example: "",
+        creator_notes: "Generated by layla mock.",
+        system_prompt: "",
+        post_history_instructions: "",
+        alternate_greetings: [],
+        tags: ["mock"],
+        creator: "layla-mock",
+        character_version: "1.0",
+        extensions: {},
+        ...overrides
+      }
+    }
+  };
+}
+function installLaylaMock(options = {}) {
+  if (typeof window === "undefined") {
+    throw new Error(
+      "installLaylaMock needs a browser-like environment (window). In Node, run your test under jsdom or happy-dom."
+    );
+  }
+  const latencyMs = options.latencyMs ?? 150;
+  const tokenDelayMs = options.tokenDelayMs ?? 40;
+  const errorRate = options.errorRate ?? 0;
+  const characters = options.characters ?? [makeMockCharacter("Aria"), makeMockCharacter("Kai")];
+  let current = null;
+  const log = (...a) => {
+    if (options.debug) console.log("[layla-mock]", ...a);
+  };
+  const emit = (event) => {
+    log("RN->web", event);
+    window.dispatchEvent(new MessageEvent("message", { data: JSON.stringify(event) }));
+  };
+  const emitError = (message) => emit({ event: "on_error", data: { message } });
+  const shouldError = () => errorRate > 0 && Math.random() < errorRate;
+  const tokenize = (text) => text.match(/\S+\s*/g) ?? (text ? [text] : []);
+  const defaultReply = (messages) => {
+    const lastUser = [...messages].reverse().find((m) => m.role === "user");
+    const said = lastUser?.content ?? "(nothing)";
+    return `This is a mock Layla response. You said: "${said}". Tokens stream one at a time so you can exercise your streaming UI, cancellation, and the final-content promise.`;
+  };
+  async function* tokenSource(messages) {
+    const produced = options.respond ? await options.respond(messages) : defaultReply(messages);
+    if (typeof produced === "string") {
+      yield* tokenize(produced);
+      return;
+    }
+    if (Array.isArray(produced)) {
+      yield* produced;
+      return;
+    }
+    if (produced && typeof produced === "object") {
+      if (Symbol.asyncIterator in produced) {
+        yield* produced;
+        return;
+      }
+      if (Symbol.iterator in produced) {
+        yield* produced;
+      }
+    }
+  }
+  async function handleSend(messages) {
+    const gen = { cancelled: false };
+    current = gen;
+    try {
+      await delay(latencyMs);
+      if (gen.cancelled) return;
+      if (shouldError()) {
+        emitError("Simulated model error");
+        return;
+      }
+      let snapshot = "";
+      for await (const delta of tokenSource(messages)) {
+        if (gen.cancelled) return;
+        snapshot += delta;
+        emit({ event: "on_message", data: { msg: snapshot, delta } });
+        await delay(tokenDelayMs);
+        if (gen.cancelled) return;
+      }
+      emit({ event: "on_message_end" });
+    } finally {
+      if (current === gen) current = null;
+    }
+  }
+  function handleCancel() {
+    if (current && !current.cancelled) {
+      current.cancelled = true;
+      queueMicrotask(() => emit({ event: "on_message_end" }));
+    }
+  }
+  async function handleGetCharacters() {
+    await delay(latencyMs);
+    if (shouldError()) {
+      emitError("Simulated characters error");
+      return;
+    }
+    emit({ event: "on_get_characters_response", data: characters });
+  }
+  async function handleGetCharacterImage(data) {
+    await delay(latencyMs);
+    if (shouldError()) {
+      emitError("Simulated character image error");
+      return;
+    }
+    emit({
+      event: "on_get_character_image_response",
+      data: {
+        character_id: data.character_id,
+        image_data_base64: "https://picsum.photos/id/237/200/300"
+        // we return a url for mock, since we usually use this as the "src" of an <img> tag, it should work fine as a mock
+      }
+    });
+  }
+  async function handleGenerateImage(_) {
+    await delay(latencyMs);
+    if (shouldError()) {
+      emitError("Simulated image generation error");
+      return;
+    }
+    const totalSteps = 5;
+    for (let step = 1; step <= totalSteps; step++) {
+      await delay(latencyMs);
+      emit({
+        event: "on_generate_image_progress",
+        data: {
+          status: `Generating image... (${step}/${totalSteps})`,
+          steps: step,
+          total_steps: totalSteps
+        }
+      });
+    }
+    emit({
+      event: "on_generate_image_response",
+      data: {
+        image_data_base64: "https://picsum.photos/200/300"
+        // Placeholder image URL for the mock
+      }
+    });
+  }
+  const fakeBridge = {
+    postMessage(raw) {
+      let msg;
+      try {
+        msg = JSON.parse(raw);
+      } catch {
+        return;
+      }
+      log("web->RN", msg);
+      switch (msg.cmd) {
+        case "send_message":
+          void handleSend(msg.data);
+          break;
+        case "cancel":
+          handleCancel();
+          break;
+        case "get_characters":
+          void handleGetCharacters();
+          break;
+        case "get_character_image":
+          void handleGetCharacterImage(msg.data);
+          break;
+        case "generate_image":
+          void handleGenerateImage(msg.data);
+          break;
+        default:
+          break;
+      }
+    }
+  };
+  const previous = window.ReactNativeWebView;
+  if (previous) {
+    log("warning: replacing an existing window.ReactNativeWebView");
+  }
+  window.ReactNativeWebView = fakeBridge;
+  log("installed");
+  let installed = true;
+  return {
+    uninstall() {
+      if (!installed) return;
+      installed = false;
+      if (current) current.cancelled = true;
+      if (previous) window.ReactNativeWebView = previous;
+      else delete window.ReactNativeWebView;
+      log("uninstalled");
+    }
+  };
+}
 export {
   ChatCompletionStream,
   Images,
@@ -553,5 +754,7 @@ export {
   LaylaBridgeUnavailableError,
   LaylaError,
   LaylaSDK,
-  client_default as default
+  client_default as default,
+  installLaylaMock,
+  makeMockCharacter
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layla-network/sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Layla custom mini-apps SDK",
   "type": "module",
   "main": "./dist/index.cjs",