npm - @fencyai/js - Versions diffs - 0.1.2 → 0.1.4 - Mend

@fencyai/js 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/README.md +63 -18
package/dist/availability.d.ts +12 -0
package/dist/availability.d.ts.map +1 -0
package/dist/availability.js +71 -0
package/dist/createChatCompletion.d.ts +16 -0
package/dist/createChatCompletion.d.ts.map +1 -0
package/dist/createChatCompletion.js +43 -0
package/dist/createStream.d.ts +15 -0
package/dist/createStream.d.ts.map +1 -0
package/dist/createStream.js +29 -0
package/dist/index.d.ts +16 -23
package/dist/index.d.ts.map +1 -1
package/dist/index.js +1 -1
package/dist/loadFency.d.ts +19 -0
package/dist/loadFency.d.ts.map +1 -0
package/dist/loadFency.js +42 -0
package/dist/types.d.ts +64 -0
package/dist/types.d.ts.map +1 -0
package/dist/types.js +17 -0
package/package.json +7 -4

package/README.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # @fencyai/js
-A TypeScript ESM module designed for browser use, published as an npm package.
+Core Fency library for browser integration - equivalent to `@stripe/stripe-js`. Load Fency instances with your publishable key.
 ## Installation
@@ -10,27 +10,47 @@ npm install @fencyai/js
 ## Usage
-### ES Modules (Recommended)
+### Basic Usage
 ```javascript
-import { greet, FencyUtils } from '@fencyai/js';
+import { loadFency } from '@fencyai/js';
-// Use the utility function
-console.log(greet('World')); // "Hello from fency-js: World"
+// Make sure to call `loadFency` outside of a component's render to avoid
+// recreating the Fency object on every render.
+const fencyPromise = loadFency('pk_test_your_publishable_key_here');
-// Use the utility class
-const utils = new FencyUtils('2.0.0');
-console.log(utils.getVersion()); // "2.0.0"
-console.log(utils.formatDate(new Date())); // Current date formatted
+// Use the promise
+fencyPromise.then((fency) => {
+  console.log('Fency loaded:', fency.publishableKey);
+  console.log('Version:', fency.version);
+});
 ```
-### Default Import
+### With Configuration Options
 ```javascript
-import fency from '@fencyai/js';
+import { loadFency } from '@fencyai/js';
+const fencyPromise = loadFency('pk_test_your_key', {
+  config: {
+    apiVersion: '2024-01-01',
+    endpoint: 'https://api.fency.ai'
+  }
+});
+```
+### Error Handling
-console.log(fency.greet('Browser')); // "Hello from fency-js: Browser"
-const utils = new fency.FencyUtils();
+```javascript
+import { loadFency } from '@fencyai/js';
+const fencyPromise = loadFency('invalid_key')
+  .then((fency) => {
+    // Success
+  })
+  .catch((error) => {
+    console.error('Failed to load Fency:', error.message);
+  });
 ```
 ### Browser Usage
@@ -43,16 +63,39 @@ const utils = new fency.FencyUtils();
 </head>
 <body>
     <script type="module">
-        import { greet, FencyUtils } from 'https://unpkg.com/@fencyai/js@latest/dist/index.js';
+        import { loadFency } from 'https://unpkg.com/@fencyai/js@latest/dist/index.js';
-        console.log(greet('Browser User'));
-        const utils = new FencyUtils();
-        document.body.innerHTML = `<p>Version: ${utils.getVersion()}</p>`;
+        const fencyPromise = loadFency('pk_test_your_key');
+        fencyPromise.then(fency => {
+          document.body.innerHTML = `<p>Fency loaded: ${fency.version}</p>`;
+        });
     </script>
 </body>
 </html>
 ```
+## API Reference
+### `loadFency(publishableKey, options?)`
+Loads the Fency library with the given publishable key.
+**Parameters:**
+- `publishableKey` (string): Your Fency publishable key (must start with `pk_`)
+- `options` (object, optional): Configuration options
+  - `config.apiVersion` (string, optional): API version to use (default: `'2024-01-01'`)
+  - `config.endpoint` (string, optional): Custom endpoint URL (default: `'https://api.fency.ai'`)
+**Returns:** Promise<FencyInstance>
+**Throws:** Error if publishable key is invalid
+### `isFencyAvailable()`
+Check if Fency is available in the current environment.
+**Returns:** boolean
 ## Development
 ### Prerequisites
@@ -122,7 +165,7 @@ npm run publish:major    # Bump major + publish
 ```
 fency-js/
 ├── src/
-│   └── index.ts          # Main entry point
+│   └── index.ts          # Main entry point with loadFency
 ├── dist/                 # Built files (generated)
 ├── package.json          # Package configuration
 ├── tsconfig.json         # TypeScript configuration
@@ -136,6 +179,8 @@ fency-js/
 - ✅ Tree-shakable exports
 - ✅ Minified production builds
 - ✅ Browser-compatible
+- ✅ Publishable key validation
+- ✅ Promise-based loading
 - ✅ npm package ready
 ## License

package/dist/availability.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import { FencyAvailabilityInfo } from './types.js';
+/**
+ * Check if Fency is available in the current environment
+ * This checks for browser compatibility and required APIs
+ */
+export declare function isFencyAvailable(): boolean;
+/**
+ * Get detailed information about Fency availability
+ * Returns an object with availability status and missing requirements
+ */
+export declare function getFencyAvailabilityInfo(): FencyAvailabilityInfo;
+//# sourceMappingURL=availability.d.ts.map

package/dist/availability.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"availability.d.ts","sourceRoot":"","sources":["../src/availability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAgC1C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAwChE"}

package/dist/availability.js ADDED Viewed

@@ -0,0 +1,71 @@
+/**
+ * Check if Fency is available in the current environment
+ * This checks for browser compatibility and required APIs
+ */
+export function isFencyAvailable() {
+    // Check if we're in a browser environment
+    if (typeof window === 'undefined') {
+        return false;
+    }
+    // Check for required browser APIs
+    const requiredAPIs = [
+        'fetch',
+        'Promise',
+        'JSON'
+    ];
+    for (const api of requiredAPIs) {
+        if (typeof window[api] === 'undefined') {
+            return false;
+        }
+    }
+    // Check for HTTPS in production (recommended for security)
+    if (typeof window.location !== 'undefined') {
+        const isLocalhost = window.location.hostname === 'localhost' ||
+            window.location.hostname === '127.0.0.1';
+        const isSecure = window.location.protocol === 'https:';
+        // Warn in console if not secure (but don't block)
+        if (!isLocalhost && !isSecure) {
+            console.warn('Fency: For security, we recommend using HTTPS in production.');
+        }
+    }
+    return true;
+}
+/**
+ * Get detailed information about Fency availability
+ * Returns an object with availability status and missing requirements
+ */
+export function getFencyAvailabilityInfo() {
+    const result = {
+        available: true,
+        missing: [],
+        warnings: []
+    };
+    // Check if we're in a browser environment
+    if (typeof window === 'undefined') {
+        result.available = false;
+        result.missing.push('Browser environment');
+        return result;
+    }
+    // Check for required browser APIs
+    const requiredAPIs = [
+        'fetch',
+        'Promise',
+        'JSON'
+    ];
+    for (const api of requiredAPIs) {
+        if (typeof window[api] === 'undefined') {
+            result.available = false;
+            result.missing.push(`${api} API`);
+        }
+    }
+    // Check for HTTPS in production
+    if (typeof window.location !== 'undefined') {
+        const isLocalhost = window.location.hostname === 'localhost' ||
+            window.location.hostname === '127.0.0.1';
+        const isSecure = window.location.protocol === 'https:';
+        if (!isLocalhost && !isSecure) {
+            result.warnings.push('HTTPS is recommended for production use');
+        }
+    }
+    return result;
+}

package/dist/createChatCompletion.d.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import { ChatCompletionRequest, ChatCompletionResponse } from './types.js';
+export interface CreateChatCompletionOptions {
+    apiUrl?: string;
+    request?: Partial<ChatCompletionRequest>;
+}
+/**
+ * Creates a chat completion by making a POST request to the Fency API.
+ *
+ * @param pk - The publishable key (used as Bearer token)
+ * @param streamId - The stream ID to associate with the chat completion
+ * @param options - Optional configuration (apiUrl, request overrides)
+ * @returns A promise that resolves to a ChatCompletionResponse
+ * @throws Error if the request fails or the response is invalid
+ */
+export declare function createChatCompletion(pk: string, streamId: string, options?: CreateChatCompletionOptions): Promise<ChatCompletionResponse>;
+//# sourceMappingURL=createChatCompletion.d.ts.map

package/dist/createChatCompletion.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"createChatCompletion.d.ts","sourceRoot":"","sources":["../src/createChatCompletion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAA4B,MAAM,YAAY,CAAC;AAErG,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,sBAAsB,CAAC,CAmCjC"}

package/dist/createChatCompletion.js ADDED Viewed

@@ -0,0 +1,43 @@
+import { isChatCompletionResponse } from './types.js';
+/**
+ * Creates a chat completion by making a POST request to the Fency API.
+ *
+ * @param pk - The publishable key (used as Bearer token)
+ * @param streamId - The stream ID to associate with the chat completion
+ * @param options - Optional configuration (apiUrl, request overrides)
+ * @returns A promise that resolves to a ChatCompletionResponse
+ * @throws Error if the request fails or the response is invalid
+ */
+export async function createChatCompletion(pk, streamId, options = {}) {
+    const apiUrl = options.apiUrl || 'http://localhost:8080/v1/chat-completions';
+    const requestBody = {
+        ...options.request,
+        streamId, // always override with provided streamId
+        openai: {
+            model: 'gpt-4o-mini',
+            messages: [
+                {
+                    role: 'user',
+                    content: 'Hello, how are you?',
+                },
+            ],
+            ...options.request?.openai,
+        },
+    };
+    const response = await fetch(apiUrl, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${pk}`,
+        },
+        body: JSON.stringify(requestBody),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to create chat completion: ${response.status} ${response.statusText}`);
+    }
+    const completion = await response.json();
+    if (!isChatCompletionResponse(completion)) {
+        throw new Error('Invalid chat completion response');
+    }
+    return completion;
+}

package/dist/createStream.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import { Stream } from './types.js';
+export interface CreateStreamOptions {
+    apiUrl?: string;
+    name?: string;
+}
+/**
+ * Creates a new stream by making a POST request to the Fency API.
+ *
+ * @param pk - The publishable key (used as Bearer token and default name)
+ * @param options - Optional configuration (apiUrl, name)
+ * @returns A promise that resolves to a Stream
+ * @throws Error if the request fails or the response is invalid
+ */
+export declare function createStream(pk: string, options?: CreateStreamOptions): Promise<Stream>;
+//# sourceMappingURL=createStream.d.ts.map

package/dist/createStream.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"createStream.d.ts","sourceRoot":"","sources":["../src/createStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAsBjB"}

package/dist/createStream.js ADDED Viewed

@@ -0,0 +1,29 @@
+import { isStream } from './types.js';
+/**
+ * Creates a new stream by making a POST request to the Fency API.
+ *
+ * @param pk - The publishable key (used as Bearer token and default name)
+ * @param options - Optional configuration (apiUrl, name)
+ * @returns A promise that resolves to a Stream
+ * @throws Error if the request fails or the response is invalid
+ */
+export async function createStream(pk, options = {}) {
+    const apiUrl = options.apiUrl || 'http://localhost:8080/v1/streams';
+    const name = options.name || pk;
+    const response = await fetch(apiUrl, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${pk}`,
+        },
+        body: JSON.stringify({ name }),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to create stream: ${response.status} ${response.statusText}`);
+    }
+    const stream = await response.json();
+    if (!isStream(stream)) {
+        throw new Error('Invalid stream response');
+    }
+    return stream;
+}

package/dist/index.d.ts CHANGED Viewed

@@ -1,27 +1,20 @@
-/**
- * A sample utility function that demonstrates the module structure
- * @param message - The message to log
- * @returns A formatted greeting
- */
-export declare function greet(message: string): string;
-/**
- * A sample class that can be used in browser environments
- */
-export declare class FencyUtils {
-    private version;
-    constructor(version?: string);
-    /**
-     * Get the current version
-     */
-    getVersion(): string;
-    /**
-     * Format a date for display
-     */
-    formatDate(date: Date): string;
-}
+import { getFencyAvailabilityInfo, isFencyAvailable } from './availability.js';
+import { loadFency } from './loadFency.js';
+import { createStream } from './createStream.js';
+import { createChatCompletion } from './createChatCompletion.js';
+export type { FencyAvailabilityInfo, FencyInstance, FencyOptions } from './types.js';
+export { getFencyAvailabilityInfo, isFencyAvailable } from './availability.js';
+export { loadFency } from './loadFency.js';
+export { createStream } from './createStream.js';
+export type { CreateStreamOptions } from './createStream.js';
+export { createChatCompletion } from './createChatCompletion.js';
+export type { CreateChatCompletionOptions } from './createChatCompletion.js';
 declare const _default: {
-    greet: typeof greet;
-    FencyUtils: typeof FencyUtils;
+    loadFency: typeof loadFency;
+    isFencyAvailable: typeof isFencyAvailable;
+    getFencyAvailabilityInfo: typeof getFencyAvailabilityInfo;
+    createStream: typeof createStream;
+    createChatCompletion: typeof createChatCompletion;
 };
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"~~AAEA;;;;GAIG~~;~~AACH~~,~~wBAAgB~~,~~KAAK~~,CAAC,OAAO,EAAE,MAAM,~~GAAG~~,MAAM,~~CAE7C~~;~~AAED;;GAEG;AACH~~,~~qBAAa~~,~~UAAU~~;~~IACrB~~,OAAO,CAAC,OAAO,~~CAAS~~;~~gBAEZ~~,OAAO,~~GAAE~~,~~MAAgB~~;~~IAIrC;;OAEG;IACH~~,~~UAAU~~,~~IAAI~~,MAAM~~;IAIpB;;OAEG;IACH~~,~~UAAU~~,CAAC,~~IAAI~~,EAAE,~~IAAI~~,~~GAAG~~,MAAM;~~CAG/B;;;;;AAGD~~,~~wBAGE~~"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE,YAAY,EACV,qBAAqB,EAAE,aAAa,EAAE,YAAY,EACnD,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,wBAAwB,EAAE,gBAAgB,EAC3C,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;;;;;;;;AAG7E,wBAME"}

package/dist/index.js CHANGED Viewed

	@@ -1 +1 @@
1	- function n(e){return~~`Hello~~ ~~from~~ ~~@fencyai/js~~: ~~${e~~}`}~~var~~ t=~~class~~{~~constructor~~(r="1.0.0"){~~this~~.~~version=r~~}~~getVersion~~(){return ~~this~~.version}~~formatDate~~(r){return r.~~toLocaleDateString~~()}},i={~~greet~~:n,~~FencyUtils~~:t};export{t as ~~FencyUtils~~,i as default,n as ~~greet~~};
1	+ function s(){if(typeof window>"u")return!1;let e=["fetch","Promise","JSON"];for(let o of e)if(typeof window[o]>"u")return!1;if(typeof window.location<"u"){let o=window.location.hostname==="localhost"\|\|window.location.hostname==="127.0.0.1",t=window.location.protocol==="https:";!o&&!t&&console.warn("Fency: For security, we recommend using HTTPS in production.")}return!0}function a(){let e={available:!0,missing:[],warnings:[]};if(typeof window>"u")return e.available=!1,e.missing.push("Browser environment"),e;let o=["fetch","Promise","JSON"];for(let t of o)typeof window[t]>"u"&&(e.available=!1,e.missing.push(`${t} API`));if(typeof window.location<"u"){let t=window.location.hostname==="localhost"\|\|window.location.hostname==="127.0.0.1",n=window.location.protocol==="https:";!t&&!n&&e.warnings.push("HTTPS is recommended for production use")}return e}function c(e,o={}){return new Promise((t,n)=>{if(!e\|\|typeof e!="string"){n(new Error("Fency: A valid publishable key is required."));return}if(!e.startsWith("pk_")){n(new Error('Fency: Invalid publishable key format. Keys should start with "pk_".'));return}let i={publishableKey:e,config:{apiVersion:o.config?.apiVersion\|\|"2024-01-01",endpoint:o.config?.endpoint\|\|"https://api.fency.ai"},version:"0.1.3"};setTimeout(()=>{t(i)},0)})}function m(e){return e&&typeof e=="object"&&typeof e.id=="string"&&typeof e.name=="string"}function y(e){return e&&typeof e=="object"&&typeof e.id=="string"&&typeof e.streamId=="string"&&Array.isArray(e.choices)}async function p(e,o={}){let t=o.apiUrl\|\|"http://localhost:8080/v1/streams",n=o.name\|\|e,i=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${e}`},body:JSON.stringify({name:n})});if(!i.ok)throw new Error(`Failed to create stream: ${i.status} ${i.statusText}`);let r=await i.json();if(!m(r))throw new Error("Invalid stream response");return r}async function l(e,o,t={}){let n=t.apiUrl\|\|"http://localhost:8080/v1/chat-completions",i={...t.request,streamId:o,openai:{model:"gpt-4o-mini",messages:[{role:"user",content:"Hello, how are you?"}],...t.request?.openai}},r=await fetch(n,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${e}`},body:JSON.stringify(i)});if(!r.ok)throw new Error(`Failed to create chat completion: ${r.status} ${r.statusText}`);let f=await r.json();if(!y(f))throw new Error("Invalid chat completion response");return f}var P={loadFency:c,isFencyAvailable:s,getFencyAvailabilityInfo:a,createStream:p,createChatCompletion:l};export{l as createChatCompletion,p as createStream,P as default,a as getFencyAvailabilityInfo,s as isFencyAvailable,c as loadFency};

package/dist/loadFency.d.ts ADDED Viewed

@@ -0,0 +1,19 @@
+import { FencyOptions, FencyInstance } from './types.js';
+/**
+ * Loads the Fency library with the given publishable key.
+ * This method should be called outside of a component's render to avoid
+ * recreating the Fency object on every render.
+ *
+ * @param publishableKey - Your Fency publishable key
+ * @param options - Optional configuration options
+ * @returns A promise that resolves to a Fency instance
+ *
+ * @example
+ * ```javascript
+ * import { loadFency } from '@fencyai/js';
+ *
+ * const fencyPromise = loadFency('pk_your_publishable_key');
+ * ```
+ */
+export declare function loadFency(publishableKey: string, options?: Omit<FencyOptions, 'publishableKey'>): Promise<FencyInstance>;
+//# sourceMappingURL=loadFency.d.ts.map

package/dist/loadFency.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"loadFency.d.ts","sourceRoot":"","sources":["../src/loadFency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CACvB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAM,GACjD,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/loadFency.js ADDED Viewed

@@ -0,0 +1,42 @@
+/**
+ * Loads the Fency library with the given publishable key.
+ * This method should be called outside of a component's render to avoid
+ * recreating the Fency object on every render.
+ *
+ * @param publishableKey - Your Fency publishable key
+ * @param options - Optional configuration options
+ * @returns A promise that resolves to a Fency instance
+ *
+ * @example
+ * ```javascript
+ * import { loadFency } from '@fencyai/js';
+ *
+ * const fencyPromise = loadFency('pk_your_publishable_key');
+ * ```
+ */
+export function loadFency(publishableKey, options = {}) {
+    return new Promise((resolve, reject) => {
+        // Validate the publishable key
+        if (!publishableKey || typeof publishableKey !== 'string') {
+            reject(new Error('Fency: A valid publishable key is required.'));
+            return;
+        }
+        if (!publishableKey.startsWith('pk_')) {
+            reject(new Error('Fency: Invalid publishable key format. Keys should start with "pk_".'));
+            return;
+        }
+        // Create the Fency instance
+        const fencyInstance = {
+            publishableKey,
+            config: {
+                apiVersion: options.config?.apiVersion || '2024-01-01',
+                endpoint: options.config?.endpoint || 'https://api.fency.ai',
+            },
+            version: '0.1.3', // This should match your package version
+        };
+        // Simulate async loading (in a real implementation, this might load external scripts)
+        setTimeout(() => {
+            resolve(fencyInstance);
+        }, 0);
+    });
+}

package/dist/types.d.ts ADDED Viewed

@@ -0,0 +1,64 @@
+/**
+ * Configuration options for Fency
+ */
+export interface FencyOptions {
+    /** Your Fency publishable key */
+    publishableKey: string;
+    /** Optional configuration for the Fency instance */
+    config?: {
+        /** API version to use */
+        apiVersion?: string;
+        /** Custom endpoint URL */
+        endpoint?: string;
+    };
+}
+/**
+ * Fency instance interface
+ */
+export interface FencyInstance {
+    /** The publishable key used to initialize this instance */
+    publishableKey: string;
+    /** Configuration options */
+    config: Required<FencyOptions['config']>;
+    /** Version of the Fency library */
+    version: string;
+}
+/**
+ * Availability information interface
+ */
+export interface FencyAvailabilityInfo {
+    /** Whether Fency is available in the current environment */
+    available: boolean;
+    /** List of missing requirements */
+    missing: string[];
+    /** List of warnings */
+    warnings: string[];
+}
+export interface Stream {
+    id: string;
+    name: string;
+}
+export declare function isStream(obj: any): obj is Stream;
+export interface ChatCompletionRequest {
+    streamId: string;
+    openai: {
+        model: string;
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+    };
+}
+export interface ChatCompletionResponse {
+    id: string;
+    streamId: string;
+    choices: Array<{
+        message: {
+            role: string;
+            content: string;
+        };
+        finish_reason?: string;
+    }>;
+}
+export declare function isChatCompletionResponse(obj: any): obj is ChatCompletionResponse;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,MAAM,CAAC,EAAE;QACP,yBAAyB;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,0BAA0B;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAEd;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,MAAM,CAQhD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC,CAAC;KACJ,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;CAEJ;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,sBAAsB,CAShF"}

package/dist/types.js ADDED Viewed

@@ -0,0 +1,17 @@
+export function isStream(obj) {
+    return (obj &&
+        typeof obj === 'object' &&
+        typeof obj.id === 'string' &&
+        typeof obj.name === 'string'
+    // Add more checks for required fields if needed
+    );
+}
+export function isChatCompletionResponse(obj) {
+    return (obj &&
+        typeof obj === 'object' &&
+        typeof obj.id === 'string' &&
+        typeof obj.streamId === 'string' &&
+        Array.isArray(obj.choices)
+    // Add more checks for required fields if needed
+    );
+}

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@fencyai/js",
-  "version": "0.1.2",
-  "description": "A TypeScript ESM module for browser use",
+  "version": "0.1.4",
+  "description": "Core Fency library for browser integration - load Fency instances with your publishable key",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -33,10 +33,13 @@
     "publish:major": "npm run version:major && npm publish --access public"
   },
   "keywords": [
+    "fency",
+    "fencyai",
+    "browser",
     "typescript",
     "esm",
-    "browser",
-    "module"
+    "loadfency",
+    "publishable-key"
   ],
   "author": "",
   "license": "MIT",