quickbase-js 2.1.0 → 2.2.0

package/dist/core/schema.js

@@ -0,0 +1,168 @@
+/**
+ * Schema resolution and lookup utilities
+ */
+/**
+ * Error thrown when an unknown table or field alias is used
+ */
+export class SchemaError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SchemaError';
+    }
+}
+/**
+ * Resolve a schema definition into lookup maps for efficient alias resolution
+ */
+export function resolveSchema(schema) {
+    if (!schema)
+        return undefined;
+    const tableAliasToId = new Map();
+    const tableIdToAlias = new Map();
+    const fieldAliasToId = new Map();
+    const fieldIdToAlias = new Map();
+    for (const [tableAlias, tableSchema] of Object.entries(schema.tables)) {
+        const tableId = tableSchema.id;
+        // Table mappings
+        tableAliasToId.set(tableAlias, tableId);
+        tableIdToAlias.set(tableId, tableAlias);
+        // Field mappings for this table
+        const aliasToId = new Map();
+        const idToAlias = new Map();
+        for (const [fieldAlias, fieldId] of Object.entries(tableSchema.fields)) {
+            aliasToId.set(fieldAlias, fieldId);
+            idToAlias.set(fieldId, fieldAlias);
+        }
+        fieldAliasToId.set(tableId, aliasToId);
+        fieldIdToAlias.set(tableId, idToAlias);
+    }
+    return {
+        original: schema,
+        tableAliasToId,
+        tableIdToAlias,
+        fieldAliasToId,
+        fieldIdToAlias,
+    };
+}
+/**
+ * Resolve a table alias to its ID.
+ * If the input is already a table ID, returns it unchanged.
+ * Throws SchemaError if alias is not found.
+ */
+export function resolveTableAlias(schema, tableRef) {
+    if (!schema)
+        return tableRef;
+    // Check if it's an alias
+    const tableId = schema.tableAliasToId.get(tableRef);
+    if (tableId)
+        return tableId;
+    // Check if it's already a table ID
+    if (schema.tableIdToAlias.has(tableRef))
+        return tableRef;
+    // Unknown alias - throw helpful error
+    const availableAliases = Array.from(schema.tableAliasToId.keys());
+    const suggestion = findSimilar(tableRef, availableAliases);
+    const suggestionText = suggestion ? ` Did you mean '${suggestion}'?` : '';
+    const availableText = availableAliases.length > 0
+        ? ` Available: ${availableAliases.join(', ')}`
+        : '';
+    throw new SchemaError(`Unknown table alias '${tableRef}'.${suggestionText}${availableText}`);
+}
+/**
+ * Resolve a field alias to its ID for a given table.
+ * If the input is already a field ID (number), returns it unchanged.
+ * Throws SchemaError if alias is not found.
+ */
+export function resolveFieldAlias(schema, tableId, fieldRef) {
+    // If it's already a number, return as-is
+    if (typeof fieldRef === 'number')
+        return fieldRef;
+    // If no schema, try to parse as number or return as-is
+    if (!schema) {
+        const num = parseInt(fieldRef, 10);
+        if (!isNaN(num))
+            return num;
+        // Can't resolve without schema - pass through and let API handle it
+        return fieldRef;
+    }
+    // Look up the alias
+    const fieldMap = schema.fieldAliasToId.get(tableId);
+    if (fieldMap) {
+        const fieldId = fieldMap.get(fieldRef);
+        if (fieldId !== undefined)
+            return fieldId;
+    }
+    // Check if it's a numeric string (raw field ID)
+    const num = parseInt(fieldRef, 10);
+    if (!isNaN(num))
+        return num;
+    // Unknown alias - throw helpful error
+    const availableAliases = fieldMap ? Array.from(fieldMap.keys()) : [];
+    const suggestion = findSimilar(fieldRef, availableAliases);
+    const suggestionText = suggestion ? ` Did you mean '${suggestion}'?` : '';
+    // Get table alias for better error message
+    const tableAlias = schema.tableIdToAlias.get(tableId) || tableId;
+    throw new SchemaError(`Unknown field alias '${fieldRef}' in table '${tableAlias}'.${suggestionText}`);
+}
+/**
+ * Get the alias for a field ID, if defined in schema.
+ * Returns undefined if no alias is defined.
+ */
+export function getFieldAlias(schema, tableId, fieldId) {
+    if (!schema)
+        return undefined;
+    const fieldMap = schema.fieldIdToAlias.get(tableId);
+    return fieldMap?.get(fieldId);
+}
+/**
+ * Get the alias for a table ID, if defined in schema.
+ * Returns undefined if no alias is defined.
+ */
+export function getTableAlias(schema, tableId) {
+    if (!schema)
+        return undefined;
+    return schema.tableIdToAlias.get(tableId);
+}
+/**
+ * Find a similar string from a list (for "did you mean" suggestions)
+ * Uses simple Levenshtein distance
+ */
+function findSimilar(input, candidates, maxDistance = 3) {
+    const inputLower = input.toLowerCase();
+    let bestMatch;
+    let bestDistance = maxDistance + 1;
+    for (const candidate of candidates) {
+        const distance = levenshteinDistance(inputLower, candidate.toLowerCase());
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            bestMatch = candidate;
+        }
+    }
+    return bestDistance <= maxDistance ? bestMatch : undefined;
+}
+/**
+ * Calculate Levenshtein distance between two strings
+ */
+function levenshteinDistance(a, b) {
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    // Create matrix with proper initialization
+    const matrix = Array.from({ length: b.length + 1 }, (_, i) => Array.from({ length: a.length + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
+    // Fill in the rest
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"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"}

package/dist/core/transform.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Request and response transformation utilities for schema aliases
+ */
+import type { ResolvedSchema } from './types.js';
+/**
+ * Context for request transformation
+ */
+export interface RequestTransformContext {
+    schema?: ResolvedSchema;
+    /** The resolved table ID (after alias resolution) */
+    tableId?: string;
+}
+/**
+ * Transform a request body, resolving table and field aliases to IDs.
+ * Handles: from, to, select, sortBy, groupBy, where, data
+ */
+export declare function transformRequest<T extends Record<string, unknown>>(body: T, ctx: RequestTransformContext): T;
+/**
+ * Context for response transformation
+ */
+export interface ResponseTransformContext {
+    schema?: ResolvedSchema;
+    /** The table ID for field alias lookups */
+    tableId?: string;
+}
+/**
+ * Transform a response, converting field IDs to aliases and unwrapping values.
+ * Handles nested data arrays (for runQuery, upsert responses).
+ */
+export declare function transformResponse<T>(response: T, ctx: ResponseTransformContext): T;
+/**
+ * Extract the table ID from a request body.
+ * Looks for 'from' or 'to' fields and resolves any aliases.
+ */
+export declare function extractTableIdFromRequest(body: Record<string, unknown> | undefined, schema?: ResolvedSchema): string | undefined;
+//# sourceMappingURL=transform.d.ts.map

package/dist/core/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/core/transform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAWjD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,IAAI,EAAE,CAAC,EACP,GAAG,EAAE,uBAAuB,GAC3B,CAAC,CAyDH;AAqFD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,QAAQ,EAAE,CAAC,EACX,GAAG,EAAE,wBAAwB,GAC5B,CAAC,CAiBH;AAmED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,MAAM,CAAC,EAAE,cAAc,GACtB,MAAM,GAAG,SAAS,CAcpB"}

package/dist/core/transform.js

@@ -0,0 +1,205 @@
+/**
+ * Request and response transformation utilities for schema aliases
+ */
+import { resolveTableAlias, resolveFieldAlias, getFieldAlias, } from './schema.js';
+/**
+ * Transform a request body, resolving table and field aliases to IDs.
+ * Handles: from, to, select, sortBy, groupBy, where, data
+ */
+export function transformRequest(body, ctx) {
+    // Work with a plain object to avoid TypeScript index signature issues
+    const result = { ...body };
+    let tableId = ctx.tableId;
+    // Schema-dependent transforms (alias resolution)
+    if (ctx.schema) {
+        // Resolve table references (from, to)
+        if ('from' in result && typeof result.from === 'string') {
+            tableId = resolveTableAlias(ctx.schema, result.from);
+            result.from = tableId;
+        }
+        if ('to' in result && typeof result.to === 'string') {
+            tableId = resolveTableAlias(ctx.schema, result.to);
+            result.to = tableId;
+        }
+        // Resolve field aliases (requires tableId)
+        if (tableId) {
+            // Resolve select array
+            if ('select' in result && Array.isArray(result.select)) {
+                result.select = result.select.map((field) => resolveFieldAlias(ctx.schema, tableId, field));
+            }
+            // Resolve sortBy array
+            if ('sortBy' in result && Array.isArray(result.sortBy)) {
+                result.sortBy = result.sortBy.map((sort) => ({
+                    ...sort,
+                    fieldId: resolveFieldAlias(ctx.schema, tableId, sort.fieldId),
+                }));
+            }
+            // Resolve groupBy array
+            if ('groupBy' in result && Array.isArray(result.groupBy)) {
+                result.groupBy = result.groupBy.map((group) => ({
+                    ...group,
+                    fieldId: resolveFieldAlias(ctx.schema, tableId, group.fieldId),
+                }));
+            }
+            // Resolve where clause (string replacement)
+            if ('where' in result && typeof result.where === 'string') {
+                result.where = transformWhereClause(result.where, ctx.schema, tableId);
+            }
+        }
+    }
+    // Auto-wrap data values (always runs, no schema required)
+    if ('data' in result && Array.isArray(result.data)) {
+        result.data = result.data.map((record) => wrapRecordValues(record, ctx.schema, tableId));
+    }
+    return result;
+}
+/**
+ * Wrap record values and optionally resolve field aliases.
+ * Always wraps plain values in { value: X } format.
+ * Resolves field aliases to IDs if schema is provided.
+ */
+function wrapRecordValues(record, schema, tableId) {
+    const result = {};
+    for (const [key, value] of Object.entries(record)) {
+        // Resolve field alias if schema is available
+        let outputKey = key;
+        if (schema && tableId) {
+            try {
+                const fieldId = resolveFieldAlias(schema, tableId, key);
+                outputKey = String(fieldId);
+            }
+            catch {
+                // Not an alias, keep original key
+            }
+        }
+        // Always auto-wrap values
+        result[outputKey] = wrapFieldValue(value);
+    }
+    return result;
+}
+/**
+ * Transform a where clause, replacing field aliases with IDs.
+ * QuickBase where syntax: {fieldId.operator.value}
+ * Example: {'status'.EX.'Active'} -> {7.EX.'Active'}
+ */
+function transformWhereClause(where, schema, tableId) {
+    // Match patterns like {'fieldAlias' or {fieldAlias. at the start of conditions
+    // The pattern captures the field reference between { and .
+    return where.replace(/\{['"]?([^.'"\}]+)['"]?\./g, (match, fieldRef) => {
+        try {
+            const fieldId = resolveFieldAlias(schema, tableId, fieldRef);
+            return `{${fieldId}.`;
+        }
+        catch {
+            // If alias not found, keep original (might be a raw ID)
+            return match;
+        }
+    });
+}
+/**
+ * Wrap a value in QuickBase's { value: X } format if not already wrapped.
+ * Handles plain values, arrays, and already-wrapped values.
+ */
+function wrapFieldValue(value) {
+    // Already wrapped - return as-is
+    if (isWrappedValue(value)) {
+        return value;
+    }
+    // Wrap plain value
+    return { value };
+}
+/**
+ * Check if a value is already wrapped in { value: X } format.
+ */
+function isWrappedValue(value) {
+    if (value === null || value === undefined)
+        return false;
+    if (typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const obj = value;
+    return 'value' in obj;
+}
+/**
+ * Transform a response, converting field IDs to aliases and unwrapping values.
+ * Handles nested data arrays (for runQuery, upsert responses).
+ */
+export function transformResponse(response, ctx) {
+    if (!response || typeof response !== 'object')
+        return response;
+    const result = { ...response };
+    // Handle data array (runQuery, upsert responses)
+    if ('data' in result && Array.isArray(result.data) && ctx.tableId) {
+        result.data = result.data.map((record) => transformRecordForResponse(record, ctx.schema, ctx.tableId));
+    }
+    return result;
+}
+/**
+ * Transform a single record from the response.
+ * - Converts field ID keys to aliases (if schema defined)
+ * - Unwraps { value: X } to just X
+ * - Unknown fields keep their numeric key but still get unwrapped
+ */
+function transformRecordForResponse(record, schema, tableId) {
+    const result = {};
+    for (const [key, value] of Object.entries(record)) {
+        // Determine the output key (alias or original)
+        let outputKey = key;
+        const fieldId = parseInt(key, 10);
+        if (!isNaN(fieldId) && schema) {
+            const alias = getFieldAlias(schema, tableId, fieldId);
+            if (alias) {
+                outputKey = alias;
+            }
+        }
+        // Unwrap { value: X } -> X
+        const unwrappedValue = unwrapFieldValue(value);
+        result[outputKey] = unwrappedValue;
+    }
+    return result;
+}
+/**
+ * Unwrap a field value from QuickBase's { value: X } format.
+ * Also handles arrays of values.
+ */
+function unwrapFieldValue(value) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === 'object' && !Array.isArray(value)) {
+        const obj = value;
+        // Check if it's a { value: X } wrapper
+        if ('value' in obj && Object.keys(obj).length === 1) {
+            // Recursively unwrap in case value is an array of wrapped values
+            return unwrapFieldValue(obj.value);
+        }
+        // Check if it's a { value: X, ...metadata } wrapper (preserve just value)
+        if ('value' in obj) {
+            return unwrapFieldValue(obj.value);
+        }
+    }
+    // Handle array of { value: X } objects
+    if (Array.isArray(value)) {
+        return value.map(unwrapFieldValue);
+    }
+    return value;
+}
+// =============================================================================
+// Table ID Extraction
+// =============================================================================
+/**
+ * Extract the table ID from a request body.
+ * Looks for 'from' or 'to' fields and resolves any aliases.
+ */
+export function extractTableIdFromRequest(body, schema) {
+    if (!body)
+        return undefined;
+    // Check 'from' (runQuery, deleteRecords)
+    if ('from' in body && typeof body.from === 'string') {
+        return schema ? resolveTableAlias(schema, body.from) : body.from;
+    }
+    // Check 'to' (upsert)
+    if ('to' in body && typeof body.to === 'string') {
+        return schema ? resolveTableAlias(schema, body.to) : body.to;
+    }
+    return undefined;
+}
+//# sourceMappingURL=transform.js.map

package/dist/core/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/core/transform.ts"],"names":[],"mappings":"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"}

package/dist/core/types.d.ts

@@ -20,6 +20,85 @@ export interface QuickbaseConfig {
     autoPaginate?: boolean;
     /** Convert ISO date strings in responses to JavaScript Date objects (default: true) */
     convertDates?: boolean;
+    /**
+     * Schema aliases for tables and fields.
+     * Allows using readable names instead of QuickBase IDs in queries.
+     *
+     * @example
+     * ```typescript
+     * schema: {
+     *   tables: {
+     *     projects: {
+     *       id: 'bqw3ryzab',
+     *       fields: {
+     *         name: 6,
+     *         status: 7,
+     *         dueDate: 12,
+     *       }
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    schema?: Schema;
+    /**
+     * Read-only mode prevents any write operations.
+     * Uses defense-in-depth with two layers:
+     * 1. Explicit blocklist of known write endpoints
+     * 2. HTTP method check (blocks POST/PUT/DELETE/PATCH unless allowlisted)
+     *
+     * @example
+     * ```typescript
+     * const qb = createClient({
+     *   realm: 'myrealm',
+     *   auth: { type: 'user-token', userToken: '...' },
+     *   readOnly: true,
+     * });
+     * // qb.runQuery() works
+     * // qb.upsert() throws ReadOnlyError
+     * ```
+     */
+    readOnly?: boolean;
+}
+/**
+ * Field alias mapping: alias name -> field ID
+ * @example { name: 6, status: 7, dueDate: 12 }
+ */
+export interface FieldSchema {
+    [alias: string]: number;
+}
+/**
+ * Table schema with ID and field mappings
+ * @example { id: 'bqw3ryzab', fields: { name: 6, status: 7 } }
+ */
+export interface TableSchema {
+    /** QuickBase table ID (dbid) */
+    id: string;
+    /** Field alias mappings */
+    fields: FieldSchema;
+}
+/**
+ * Complete schema definition with table aliases
+ */
+export interface Schema {
+    tables: {
+        [alias: string]: TableSchema;
+    };
+}
+/**
+ * Resolved schema with bidirectional lookup maps for efficient alias resolution
+ */
+export interface ResolvedSchema {
+    /** Original schema definition */
+    original: Schema;
+    /** Table alias -> table ID */
+    tableAliasToId: Map<string, string>;
+    /** Table ID -> table alias */
+    tableIdToAlias: Map<string, string>;
+    /** Table ID -> (field alias -> field ID) */
+    fieldAliasToId: Map<string, Map<string, number>>;
+    /** Table ID -> (field ID -> field alias) */
+    fieldIdToAlias: Map<string, Map<number, string>>;
 }
 export type AuthConfig = UserTokenAuthConfig | TempTokenAuthConfig | SsoTokenAuthConfig | TicketAuthConfig;
 export interface UserTokenAuthConfig {
@@ -59,6 +138,10 @@ export interface TicketAuthConfig {
     password: string;
     /** Ticket validity in hours (default: 12, max: 4380 ~6 months) */
     hours?: number;
+    /** Callback invoked when ticket expires - use to show login UI */
+    onExpired?: () => void;
+    /** Persist ticket to storage for session survival (default: none) */
+    persist?: 'sessionStorage' | 'localStorage';
 }
 export interface RateLimitConfig {
     /**
@@ -147,6 +230,10 @@ export interface ResolvedConfig {
     onRateLimit?: (info: RateLimitInfo) => void;
     autoPaginate: boolean;
     convertDates: boolean;
+    /** Resolved schema with lookup maps (undefined if no schema provided) */
+    schema?: ResolvedSchema;
+    /** Read-only mode - blocks all write operations */
+    readOnly: boolean;
 }
 /** Default configuration values */
 export declare const DEFAULT_CONFIG: {

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IAEd,mCAAmC;IACnC,IAAI,EAAE,UAAU,CAAC;IAEjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;IAExB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kFAAkF;IAClF,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,uFAAuF;IACvF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAClB,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,KAAK,CAAC;IACZ,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,qDAAqD;QACrD,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IAEF,2DAA2D;IAC3D,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,iCAAiC;IACjC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,SAAS,EAAE,IAAI,CAAC;IAChB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,KAAK,CAAC;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7B,iBAAiB,EAAE;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,mCAAmC;AACnC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;CAiBjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiMH,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,8BAA8B;IACvC,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE;QACL,WAAW,EAAE,CAAC;QACd,cAAc,EAAE,IAAI;QACpB,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,CAAC;KACd;IACD,iBAAiB,EAAE;QACjB,OAAO,EAAE,KAAK;QACd,oBAAoB,EAAE,GAAG;KAC1B;IACD,mBAAmB,EAAE,MAAM,EAAE,yCAAyC;IACtE,YAAY,EAAE,KAAK;IACnB,YAAY,EAAE,IAAI;CACV,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsSH,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,8BAA8B;IACvC,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE;QACL,WAAW,EAAE,CAAC;QACd,cAAc,EAAE,IAAI;QACpB,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,CAAC;KACd;IACD,iBAAiB,EAAE;QACjB,OAAO,EAAE,KAAK;QACd,oBAAoB,EAAE,GAAG;KAC1B;IACD,mBAAmB,EAAE,MAAM,EAAE,yCAAyC;IACtE,YAAY,EAAE,KAAK;IACnB,YAAY,EAAE,IAAI;CACV,CAAC"}

package/dist/index.d.ts

@@ -20,11 +20,13 @@
  * ```
  */
 export type { QuickbaseConfig, AuthConfig, UserTokenAuthConfig, TempTokenAuthConfig, SsoTokenAuthConfig, TicketAuthConfig, // XML-API-TICKET: Remove if XML API discontinued
-RateLimitConfig, RetryConfig, RateLimitInfo, PaginationMetadata, PaginatedResponse, FieldInfo, } from './core/index.js';
-export { QuickbaseError, RateLimitError, AuthenticationError, AuthorizationError, NotFoundError, ValidationError, TimeoutError, ServerError, } from './core/index.js';
+RateLimitConfig, RetryConfig, RateLimitInfo, PaginationMetadata, PaginatedResponse, FieldInfo, Schema, TableSchema, FieldSchema, ResolvedSchema, } from './core/index.js';
+export { SchemaError } from './core/schema.js';
+export { QuickbaseError, RateLimitError, AuthenticationError, AuthorizationError, NotFoundError, ValidationError, TimeoutError, ServerError, ReadOnlyError, } from './core/index.js';
 export type { AuthStrategy } from './auth/index.js';
 export { UserTokenStrategy, TempTokenStrategy, SsoTokenStrategy, TicketStrategy, // XML-API-TICKET: Remove if XML API discontinued
 createAuthStrategy, } from './auth/index.js';
+import type { AuthStrategy } from './auth/index.js';
 export type { RequestOptions } from './client/index.js';
 export { SlidingWindowThrottle, NoOpThrottle } from './client/index.js';
 export type { QuickbaseAPI } from './generated/types.js';
@@ -46,6 +48,11 @@ export interface QuickbaseClient extends QuickbaseAPI {
     }) => Promise<T>;
     /** Get the resolved configuration */
     getConfig: () => ResolvedConfig;
+    /**
+     * Get the auth strategy for advanced usage (e.g., XML API client).
+     * XML-API: Used by createXmlClient() to access authentication.
+     */
+    getAuthStrategy: () => AuthStrategy;
 }
 /**
  * Create a QuickBase client
@@ -87,5 +94,7 @@ export interface QuickbaseClient extends QuickbaseAPI {
  * ```
  */
 export declare function createClient(config: QuickbaseConfig): QuickbaseClient;
+export { createXmlClient, XmlClient, XmlError, XmlErrorCode, isUnauthorized as isXmlUnauthorized, isNotFound as isXmlNotFound, isInvalidTicket as isXmlInvalidTicket, isXmlWriteAction, } from './xml/index.js';
+export type { XmlCaller, XmlClientOptions, XmlExecutor, Role, RoleAccess, UserRole, RoleMember, UserWithRoles, Group, GroupUser, GroupManager, Subgroup, UserInfo, SchemaField, SchemaQuery, SchemaVariable, SchemaChildTable, SchemaOriginal, SchemaTable, DatabaseInfo, DBInfo, RecordField, PageType, WebhookTrigger, WebhookOptions, GetRoleInfoResult, UserRolesResult, GetUserRoleResult, GetSchemaResult, GrantedDBsResult, FindDBByNameResult, GetUsersInGroupResult, CreateGroupResult, GetGroupRoleResult, ProvisionUserResult, AddReplaceDBPageResult, FieldAddChoicesResult, FieldRemoveChoicesResult, DoQueryCountResult, GetRecordInfoResult, GrantedGroupsResult, GrantedDBsForGroupResult, GetAppDTMInfoResult, GetAncestorInfoResult, ImportFromCSVResult, CopyMasterDetailResult, WebhookResult, } from './xml/index.js';
 export default createClient;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,YAAY,EACV,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAAE,iDAAiD;AACnE,eAAe,EACf,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EAAE,iDAAiD;AACjE,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGxE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,mDAAmD;IACnD,OAAO,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE;QAC9B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;QACpD,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAEjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,cAAc,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CA6BrE;AAGD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -19,7 +19,9 @@
  * console.log(app.name);
  * ```
  */
-export { QuickbaseError, RateLimitError, AuthenticationError, AuthorizationError, NotFoundError, ValidationError, TimeoutError, ServerError, } from './core/index.js';
+// Schema utilities
+export { SchemaError } from './core/schema.js';
+export { QuickbaseError, RateLimitError, AuthenticationError, AuthorizationError, NotFoundError, ValidationError, TimeoutError, ServerError, ReadOnlyError, } from './core/index.js';
 export { UserTokenStrategy, TempTokenStrategy, SsoTokenStrategy, TicketStrategy, // XML-API-TICKET: Remove if XML API discontinued
 createAuthStrategy, } from './auth/index.js';
 export { SlidingWindowThrottle, NoOpThrottle } from './client/index.js';
@@ -93,8 +95,12 @@ export function createClient(config) {
         ...apiMethods,
         request: executor.execute,
         getConfig: () => resolvedConfig,
+        // XML-API: Expose auth strategy for XML client
+        getAuthStrategy: () => auth,
     };
 }
+// XML-API: XML API exports - remove when QuickBase discontinues XML API
+export { createXmlClient, XmlClient, XmlError, XmlErrorCode, isUnauthorized as isXmlUnauthorized, isNotFound as isXmlNotFound, isInvalidTicket as isXmlInvalidTicket, isXmlWriteAction, } from './xml/index.js';
 // Default export
 export default createClient;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAkBH,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EAAE,iDAAiD;AACjE,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIxE,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAmBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,YAAY,CAAC,MAAuB;IAClD,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,WAAW,GAAG;QAClB,KAAK,EAAE,cAAc,CAAC,KAAK;QAC3B,OAAO,EAAE,cAAc,CAAC,OAAO;QAC/B,QAAQ,EAAE,cAAc,CAAC,QAAQ;QACjC,MAAM;KACP,CAAC;IAEF,MAAM,IAAI,GAAG,kBAAkB,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,cAAc,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAElE,MAAM,QAAQ,GAAG,qBAAqB,CAAC;QACrC,MAAM,EAAE,cAAc;QACtB,IAAI;QACJ,QAAQ;QACR,MAAM;KACP,CAAC,CAAC;IAEH,2BAA2B;IAC3B,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAEnF,OAAO;QACL,GAAG,UAAU;QACb,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,SAAS,EAAE,GAAG,EAAE,CAAC,cAAc;KAChC,CAAC;AACJ,CAAC;AAED,iBAAiB;AACjB,eAAe,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAuBH,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EAAE,iDAAiD;AACjE,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIxE,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAyBzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,YAAY,CAAC,MAAuB;IAClD,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,WAAW,GAAG;QAClB,KAAK,EAAE,cAAc,CAAC,KAAK;QAC3B,OAAO,EAAE,cAAc,CAAC,OAAO;QAC/B,QAAQ,EAAE,cAAc,CAAC,QAAQ;QACjC,MAAM;KACP,CAAC;IAEF,MAAM,IAAI,GAAG,kBAAkB,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,cAAc,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAElE,MAAM,QAAQ,GAAG,qBAAqB,CAAC;QACrC,MAAM,EAAE,cAAc;QACtB,IAAI;QACJ,QAAQ;QACR,MAAM;KACP,CAAC,CAAC;IAEH,2BAA2B;IAC3B,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAEnF,OAAO;QACL,GAAG,UAAU;QACb,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,SAAS,EAAE,GAAG,EAAE,CAAC,cAAc;QAC/B,+CAA+C;QAC/C,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI;KAC5B,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,OAAO,EACL,eAAe,EACf,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,cAAc,IAAI,iBAAiB,EACnC,UAAU,IAAI,aAAa,EAC3B,eAAe,IAAI,kBAAkB,EACrC,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AA4DxB,iBAAiB;AACjB,eAAe,YAAY,CAAC"}