@quiltt/core 5.0.0 → 5.0.2

package/dist/api/graphql/index.cjs

@@ -0,0 +1,218 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@apollo/client/core');
+var index_cjs = require('../../config/index.cjs');
+var rxjs = require('rxjs');
+var SubscriptionLink12s = require('./SubscriptionLink-12s-wjkChfxO.cjs');
+var batchHttp = require('@apollo/client/link/batch-http');
+var crossfetch = require('cross-fetch');
+var error = require('@apollo/client/link/error');
+var index_cjs$1 = require('../../storage/index.cjs');
+var http = require('@apollo/client/link/http');
+var retry = require('@apollo/client/link/retry');
+var cache = require('@apollo/client/cache');
+var react = require('@apollo/client/react');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var crossfetch__default = /*#__PURE__*/_interopDefault(crossfetch);
+
+/**
+ * Apollo Link that handles authentication and session expiration for GraphQL requests.
+ *
+ * Features:
+ * - Automatically adds Bearer token to request headers
+ * - Detects expired tokens and triggers proper error handling
+ * - Clears expired sessions from storage (triggers React re-renders via observers)
+ * - Emits GraphQL errors for consistent Apollo error handling
+ */ class AuthLink extends core.ApolloLink {
+    request(operation, forward) {
+        const validation = SubscriptionLink12s.validateSessionToken();
+        if (!validation.valid) {
+            return new rxjs.Observable((observer)=>{
+                observer.error(validation.error);
+            });
+        }
+        const { token } = validation;
+        operation.setContext(({ headers = {} })=>({
+                headers: {
+                    ...headers,
+                    authorization: `Bearer ${token}`
+                }
+            }));
+        return forward(operation);
+    }
+}
+
+// Use `cross-fetch` only if `fetch` is not available on the `globalThis` object
+const effectiveFetch$1 = typeof fetch === 'undefined' ? crossfetch__default.default : fetch;
+const BatchHttpLink = new batchHttp.BatchHttpLink({
+    uri: index_cjs.endpointGraphQL,
+    fetch: effectiveFetch$1
+});
+
+const ErrorLink = new error.ErrorLink(({ error, result })=>{
+    // In Apollo Client 4, errors are consolidated to the 'error' and 'result' properties
+    // Handle GraphQL errors from result
+    if (result?.errors) {
+        result.errors.forEach((graphQLError)=>{
+            const { message, path, extensions } = graphQLError;
+            const formattedPath = Array.isArray(path) ? path.join('.') : path ?? 'N/A';
+            const parts = [
+                `[Quiltt][GraphQL Error]: ${message}`,
+                `Path: ${formattedPath}`
+            ];
+            if (extensions) {
+                if (extensions.code) parts.push(`Code: ${extensions.code}`);
+                if (extensions.errorId) parts.push(`Error ID: ${extensions.errorId}`);
+                if (extensions.instruction) parts.push(`Instruction: ${extensions.instruction}`);
+                if (extensions.documentationUrl) {
+                    parts.push(`Docs: ${extensions.documentationUrl}`);
+                }
+            }
+            console.warn(parts.join(' | '));
+        });
+    }
+    // Handle network/server errors
+    if (error) {
+        if ('statusCode' in error && error.statusCode === 401) {
+            console.warn('[Quiltt][Authentication Error]:', error);
+            index_cjs$1.GlobalStorage.set('session', null);
+        } else if ('statusCode' in error) {
+            console.warn('[Quiltt][Server Error]:', error);
+        } else {
+            console.warn('[Quiltt][Network Error]:', error);
+        }
+    }
+});
+
+const ForwardableLink = new core.ApolloLink((operation, forward)=>forward(operation));
+
+// Use `cross-fetch` only if `fetch` is not available on the `globalThis` object
+const effectiveFetch = typeof fetch === 'undefined' ? crossfetch__default.default : fetch;
+const HttpLink = new http.HttpLink({
+    uri: index_cjs.endpointGraphQL,
+    fetch: effectiveFetch
+});
+
+const RetryLink = new retry.RetryLink({
+    attempts: {
+        retryIf: (error, _operation)=>{
+            if (!error) return false;
+            const statusCode = 'statusCode' in error ? error.statusCode : undefined;
+            return !statusCode || statusCode >= 500;
+        }
+    }
+});
+
+const TerminatingLink = new core.ApolloLink(()=>{
+    return new rxjs.Observable((observer)=>{
+        observer.complete();
+    });
+});
+
+/**
+ * Extracts version number from formatted version string
+ * @param formattedVersion - Formatted version like "@quiltt/core: v4.5.1"
+ * @returns Version number like "4.5.1" or "unknown" if not found
+ */ const extractVersionNumber = (formattedVersion)=>{
+    // Find the 'v' prefix and extract version after it
+    const vIndex = formattedVersion.indexOf('v');
+    if (vIndex === -1) return 'unknown';
+    const versionPart = formattedVersion.substring(vIndex + 1);
+    const parts = versionPart.split('.');
+    // Validate we have at least major.minor.patch
+    if (parts.length < 3) return 'unknown';
+    // Extract numeric parts (handles cases like "4.5.1-beta")
+    const major = parts[0].match(/^\d+/)?.[0];
+    const minor = parts[1].match(/^\d+/)?.[0];
+    const patch = parts[2].match(/^\d+/)?.[0];
+    if (!major || !minor || !patch) return 'unknown';
+    return `${major}.${minor}.${patch}`;
+};
+/**
+ * Generates a User-Agent string following standard format
+ * Format: Quiltt/<version> (<platform-info>)
+ */ const getUserAgent = (sdkVersion, platformInfo)=>{
+    return `Quiltt/${sdkVersion} (${platformInfo})`;
+};
+
+const createVersionLink = (platformInfo)=>{
+    const versionNumber = extractVersionNumber(index_cjs.version);
+    const userAgent = getUserAgent(versionNumber, platformInfo);
+    return new core.ApolloLink((operation, forward)=>{
+        operation.setContext(({ headers = {} })=>({
+                headers: {
+                    ...headers,
+                    'Quiltt-Client-Version': index_cjs.version,
+                    'User-Agent': userAgent
+                }
+            }));
+        return forward(operation);
+    });
+};
+
+class QuilttClient extends core.ApolloClient {
+    constructor(options){
+        const finalOptions = {
+            ...options,
+            devtools: {
+                enabled: options.devtools?.enabled ?? index_cjs.debugging
+            }
+        };
+        const initialLinks = options.customLinks ? [
+            ...options.customLinks
+        ] : [];
+        const isOperationDefinition = (def)=>def.kind === 'OperationDefinition';
+        const isSubscriptionOperation = (operation)=>{
+            return operation.query.definitions.some((definition)=>isOperationDefinition(definition) && definition.operation === 'subscription');
+        };
+        const isBatchable = (operation)=>{
+            return operation.getContext().batchable ?? true;
+        };
+        const authLink = new AuthLink();
+        const subscriptionsLink = new SubscriptionLink12s.SubscriptionLink();
+        const quilttLink = core.ApolloLink.from([
+            ...initialLinks,
+            options.versionLink,
+            authLink,
+            ErrorLink,
+            RetryLink
+        ]).split(isSubscriptionOperation, subscriptionsLink, ForwardableLink).split(isBatchable, BatchHttpLink, HttpLink);
+        super({
+            link: quilttLink,
+            ...finalOptions
+        });
+    }
+}
+
+Object.defineProperty(exports, "gql", {
+  enumerable: true,
+  get: function () { return core.gql; }
+});
+exports.SubscriptionLink = SubscriptionLink12s.SubscriptionLink;
+Object.defineProperty(exports, "InMemoryCache", {
+  enumerable: true,
+  get: function () { return cache.InMemoryCache; }
+});
+Object.defineProperty(exports, "useMutation", {
+  enumerable: true,
+  get: function () { return react.useMutation; }
+});
+Object.defineProperty(exports, "useQuery", {
+  enumerable: true,
+  get: function () { return react.useQuery; }
+});
+Object.defineProperty(exports, "useSubscription", {
+  enumerable: true,
+  get: function () { return react.useSubscription; }
+});
+exports.AuthLink = AuthLink;
+exports.BatchHttpLink = BatchHttpLink;
+exports.ErrorLink = ErrorLink;
+exports.ForwardableLink = ForwardableLink;
+exports.HttpLink = HttpLink;
+exports.QuilttClient = QuilttClient;
+exports.RetryLink = RetryLink;
+exports.TerminatingLink = TerminatingLink;
+exports.createVersionLink = createVersionLink;

package/dist/api/graphql/index.d.ts

@@ -0,0 +1,82 @@
+import { ApolloClient, ApolloLink } from '@apollo/client/core';
+export { OperationVariables, gql } from '@apollo/client/core';
+import { Observable } from 'rxjs';
+import { BatchHttpLink as BatchHttpLink$1 } from '@apollo/client/link/batch-http';
+import { ErrorLink as ErrorLink$1 } from '@apollo/client/link/error';
+import { HttpLink as HttpLink$1 } from '@apollo/client/link/http';
+import { RetryLink as RetryLink$1 } from '@apollo/client/link/retry';
+import { Consumer } from '@rails/actioncable';
+export { InMemoryCache, NormalizedCacheObject } from '@apollo/client/cache';
+export { useMutation, useQuery, useSubscription } from '@apollo/client/react';
+
+type QuilttClientOptions = Omit<ApolloClient.Options, 'link'> & {
+    /** An array of initial links to inject before the default Quiltt Links */
+    customLinks?: ApolloLink[];
+    /** Platform-specific version link (required) */
+    versionLink: ApolloLink;
+};
+declare class QuilttClient extends ApolloClient {
+    constructor(options: QuilttClientOptions);
+}
+
+/**
+ * Apollo Link that handles authentication and session expiration for GraphQL requests.
+ *
+ * Features:
+ * - Automatically adds Bearer token to request headers
+ * - Detects expired tokens and triggers proper error handling
+ * - Clears expired sessions from storage (triggers React re-renders via observers)
+ * - Emits GraphQL errors for consistent Apollo error handling
+ */
+declare class AuthLink extends ApolloLink {
+    request(operation: ApolloLink.Operation, forward: ApolloLink.ForwardFunction): Observable<ApolloLink.Result>;
+}
+
+declare const BatchHttpLink: BatchHttpLink$1;
+
+declare const ErrorLink: ErrorLink$1;
+
+declare const ForwardableLink: ApolloLink;
+
+declare const HttpLink: HttpLink$1;
+
+declare const RetryLink: RetryLink$1;
+
+type RequestResult = ApolloLink.Result<{
+    [key: string]: unknown;
+}>;
+type ConnectionParams = object | ((operation: ApolloLink.Operation) => object);
+type SubscriptionCallbacks = {
+    connected?: (args?: {
+        reconnected: boolean;
+    }) => void;
+    disconnected?: () => void;
+    received?: (payload: unknown) => void;
+};
+declare class ActionCableLink extends ApolloLink {
+    cables: {
+        [id: string]: Consumer;
+    };
+    channelName: string;
+    actionName: string;
+    connectionParams: ConnectionParams;
+    callbacks: SubscriptionCallbacks;
+    constructor(options: {
+        channelName?: string;
+        actionName?: string;
+        connectionParams?: ConnectionParams;
+        callbacks?: SubscriptionCallbacks;
+    });
+    request(operation: ApolloLink.Operation, _next: ApolloLink.ForwardFunction): Observable<RequestResult>;
+}
+
+declare class SubscriptionLink extends ActionCableLink {
+    constructor();
+}
+
+declare const TerminatingLink: ApolloLink;
+
+declare const createVersionLink: (platformInfo: string) => ApolloLink;
+
+export { AuthLink, BatchHttpLink, ErrorLink, ForwardableLink, HttpLink, QuilttClient, RetryLink, SubscriptionLink, TerminatingLink, createVersionLink };
+export type { QuilttClientOptions };

package/dist/api/graphql/index.js

@@ -0,0 +1,184 @@
+import { ApolloLink, ApolloClient } from '@apollo/client/core';
+export { gql } from '@apollo/client/core';
+import { endpointGraphQL, version, debugging } from '../../config/index.js';
+import { Observable } from 'rxjs';
+import { v as validateSessionToken, S as SubscriptionLink } from './SubscriptionLink-12s-ufJBKwu1.js';
+import { BatchHttpLink as BatchHttpLink$1 } from '@apollo/client/link/batch-http';
+import crossfetch from 'cross-fetch';
+import { ErrorLink as ErrorLink$1 } from '@apollo/client/link/error';
+import { GlobalStorage } from '../../storage/index.js';
+import { HttpLink as HttpLink$1 } from '@apollo/client/link/http';
+import { RetryLink as RetryLink$1 } from '@apollo/client/link/retry';
+export { InMemoryCache } from '@apollo/client/cache';
+export { useMutation, useQuery, useSubscription } from '@apollo/client/react';
+
+/**
+ * Apollo Link that handles authentication and session expiration for GraphQL requests.
+ *
+ * Features:
+ * - Automatically adds Bearer token to request headers
+ * - Detects expired tokens and triggers proper error handling
+ * - Clears expired sessions from storage (triggers React re-renders via observers)
+ * - Emits GraphQL errors for consistent Apollo error handling
+ */ class AuthLink extends ApolloLink {
+    request(operation, forward) {
+        const validation = validateSessionToken();
+        if (!validation.valid) {
+            return new Observable((observer)=>{
+                observer.error(validation.error);
+            });
+        }
+        const { token } = validation;
+        operation.setContext(({ headers = {} })=>({
+                headers: {
+                    ...headers,
+                    authorization: `Bearer ${token}`
+                }
+            }));
+        return forward(operation);
+    }
+}
+
+// Use `cross-fetch` only if `fetch` is not available on the `globalThis` object
+const effectiveFetch$1 = typeof fetch === 'undefined' ? crossfetch : fetch;
+const BatchHttpLink = new BatchHttpLink$1({
+    uri: endpointGraphQL,
+    fetch: effectiveFetch$1
+});
+
+const ErrorLink = new ErrorLink$1(({ error, result })=>{
+    // In Apollo Client 4, errors are consolidated to the 'error' and 'result' properties
+    // Handle GraphQL errors from result
+    if (result?.errors) {
+        result.errors.forEach((graphQLError)=>{
+            const { message, path, extensions } = graphQLError;
+            const formattedPath = Array.isArray(path) ? path.join('.') : path ?? 'N/A';
+            const parts = [
+                `[Quiltt][GraphQL Error]: ${message}`,
+                `Path: ${formattedPath}`
+            ];
+            if (extensions) {
+                if (extensions.code) parts.push(`Code: ${extensions.code}`);
+                if (extensions.errorId) parts.push(`Error ID: ${extensions.errorId}`);
+                if (extensions.instruction) parts.push(`Instruction: ${extensions.instruction}`);
+                if (extensions.documentationUrl) {
+                    parts.push(`Docs: ${extensions.documentationUrl}`);
+                }
+            }
+            console.warn(parts.join(' | '));
+        });
+    }
+    // Handle network/server errors
+    if (error) {
+        if ('statusCode' in error && error.statusCode === 401) {
+            console.warn('[Quiltt][Authentication Error]:', error);
+            GlobalStorage.set('session', null);
+        } else if ('statusCode' in error) {
+            console.warn('[Quiltt][Server Error]:', error);
+        } else {
+            console.warn('[Quiltt][Network Error]:', error);
+        }
+    }
+});
+
+const ForwardableLink = new ApolloLink((operation, forward)=>forward(operation));
+
+// Use `cross-fetch` only if `fetch` is not available on the `globalThis` object
+const effectiveFetch = typeof fetch === 'undefined' ? crossfetch : fetch;
+const HttpLink = new HttpLink$1({
+    uri: endpointGraphQL,
+    fetch: effectiveFetch
+});
+
+const RetryLink = new RetryLink$1({
+    attempts: {
+        retryIf: (error, _operation)=>{
+            if (!error) return false;
+            const statusCode = 'statusCode' in error ? error.statusCode : undefined;
+            return !statusCode || statusCode >= 500;
+        }
+    }
+});
+
+const TerminatingLink = new ApolloLink(()=>{
+    return new Observable((observer)=>{
+        observer.complete();
+    });
+});
+
+/**
+ * Extracts version number from formatted version string
+ * @param formattedVersion - Formatted version like "@quiltt/core: v4.5.1"
+ * @returns Version number like "4.5.1" or "unknown" if not found
+ */ const extractVersionNumber = (formattedVersion)=>{
+    // Find the 'v' prefix and extract version after it
+    const vIndex = formattedVersion.indexOf('v');
+    if (vIndex === -1) return 'unknown';
+    const versionPart = formattedVersion.substring(vIndex + 1);
+    const parts = versionPart.split('.');
+    // Validate we have at least major.minor.patch
+    if (parts.length < 3) return 'unknown';
+    // Extract numeric parts (handles cases like "4.5.1-beta")
+    const major = parts[0].match(/^\d+/)?.[0];
+    const minor = parts[1].match(/^\d+/)?.[0];
+    const patch = parts[2].match(/^\d+/)?.[0];
+    if (!major || !minor || !patch) return 'unknown';
+    return `${major}.${minor}.${patch}`;
+};
+/**
+ * Generates a User-Agent string following standard format
+ * Format: Quiltt/<version> (<platform-info>)
+ */ const getUserAgent = (sdkVersion, platformInfo)=>{
+    return `Quiltt/${sdkVersion} (${platformInfo})`;
+};
+
+const createVersionLink = (platformInfo)=>{
+    const versionNumber = extractVersionNumber(version);
+    const userAgent = getUserAgent(versionNumber, platformInfo);
+    return new ApolloLink((operation, forward)=>{
+        operation.setContext(({ headers = {} })=>({
+                headers: {
+                    ...headers,
+                    'Quiltt-Client-Version': version,
+                    'User-Agent': userAgent
+                }
+            }));
+        return forward(operation);
+    });
+};
+
+class QuilttClient extends ApolloClient {
+    constructor(options){
+        const finalOptions = {
+            ...options,
+            devtools: {
+                enabled: options.devtools?.enabled ?? debugging
+            }
+        };
+        const initialLinks = options.customLinks ? [
+            ...options.customLinks
+        ] : [];
+        const isOperationDefinition = (def)=>def.kind === 'OperationDefinition';
+        const isSubscriptionOperation = (operation)=>{
+            return operation.query.definitions.some((definition)=>isOperationDefinition(definition) && definition.operation === 'subscription');
+        };
+        const isBatchable = (operation)=>{
+            return operation.getContext().batchable ?? true;
+        };
+        const authLink = new AuthLink();
+        const subscriptionsLink = new SubscriptionLink();
+        const quilttLink = ApolloLink.from([
+            ...initialLinks,
+            options.versionLink,
+            authLink,
+            ErrorLink,
+            RetryLink
+        ]).split(isSubscriptionOperation, subscriptionsLink, ForwardableLink).split(isBatchable, BatchHttpLink, HttpLink);
+        super({
+            link: quilttLink,
+            ...finalOptions
+        });
+    }
+}
+
+export { AuthLink, BatchHttpLink, ErrorLink, ForwardableLink, HttpLink, QuilttClient, RetryLink, SubscriptionLink, TerminatingLink, createVersionLink };

package/dist/api/index.cjs

@@ -0,0 +1,26 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var browser_cjs = require('./browser.cjs');
+var index_cjs = require('./graphql/index.cjs');
+var index_cjs$1 = require('./rest/index.cjs');
+
+
+
+Object.keys(browser_cjs).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return browser_cjs[k]; }
+	});
+});
+Object.keys(index_cjs).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return index_cjs[k]; }
+	});
+});
+Object.keys(index_cjs$1).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return index_cjs$1[k]; }
+	});
+});

package/dist/api/index.d.ts

@@ -0,0 +1,3 @@
+export * from './browser.js';
+export * from './graphql/index.js';
+export * from './rest/index.js';

package/dist/api/index.js

@@ -0,0 +1,3 @@
+export * from './browser.js';
+export * from './graphql/index.js';
+export * from './rest/index.js';