quickbase-js 2.0.0 → 2.2.0

package/bin/quickbase-js.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * QuickBase JS SDK CLI
+ *
+ * Available commands:
+ *   schema   Generate schema from QuickBase application
+ */
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  switch (command) {
+    case 'schema':
+      const { main: schemaMain } = await import(
+        join(__dirname, '..', 'dist', 'cli', 'schema.js')
+      );
+      await schemaMain(args.slice(1));
+      break;
+
+    case '--help':
+    case '-h':
+    case undefined:
+      console.log(`
+quickbase-js - QuickBase SDK CLI
+
+Commands:
+  schema    Generate schema from QuickBase application
+
+Usage:
+  npx quickbase-js <command> [options]
+
+Examples:
+  npx quickbase-js schema --help
+  npx quickbase-js schema -r mycompany -a bqw123abc -t token
+`);
+      break;
+
+    default:
+      console.error(`Unknown command: ${command}`);
+      console.error('Run "npx quickbase-js --help" for available commands');
+      process.exit(1);
+  }
+}
+
+main().catch((error) => {
+  console.error('Error:', error.message);
+  process.exit(1);
+});

package/dist/auth/index.d.ts

@@ -5,6 +5,7 @@ export type { AuthStrategy, AuthContext, CachedToken } from './types.js';
 export { UserTokenStrategy } from './user-token.js';
 export { TempTokenStrategy } from './temp-token.js';
 export { SsoTokenStrategy } from './sso-token.js';
+export { TicketStrategy } from './ticket.js';
 export { TokenCache } from './token-cache.js';
 import type { AuthConfig } from '../core/types.js';
 import type { AuthStrategy, AuthContext } from './types.js';

package/dist/auth/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK5D;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,WAAW,GACnB,YAAY,CAiBd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM5D;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,WAAW,GACnB,YAAY,CA8Bd"}

package/dist/auth/index.js

@@ -4,10 +4,12 @@
 export { UserTokenStrategy } from './user-token.js';
 export { TempTokenStrategy } from './temp-token.js';
 export { SsoTokenStrategy } from './sso-token.js';
+export { TicketStrategy } from './ticket.js'; // XML-API-TICKET: Remove if XML API discontinued
 export { TokenCache } from './token-cache.js';
 import { UserTokenStrategy } from './user-token.js';
 import { TempTokenStrategy } from './temp-token.js';
 import { SsoTokenStrategy } from './sso-token.js';
+import { TicketStrategy } from './ticket.js'; // XML-API-TICKET: Remove if XML API discontinued
 /**
  * Factory function to create the appropriate auth strategy
  */
@@ -22,6 +24,13 @@ export function createAuthStrategy(authConfig, context) {
             });
         case 'sso':
             return new SsoTokenStrategy(authConfig.samlToken, context);
+        // XML-API-TICKET: Remove this case if XML API is discontinued
+        case 'ticket':
+            return new TicketStrategy(authConfig.username, authConfig.password, {
+                hours: authConfig.hours,
+                onExpired: authConfig.onExpired,
+                persist: authConfig.persist,
+            }, context);
         default:
             throw new Error(`Unknown auth type: ${authConfig.type}`);
     }

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAsB,EACtB,OAAoB;IAEpB,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE9D,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE;gBAC1D,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,eAAe,EAAE,UAAU,CAAC,eAAe;aAC5C,CAAC,CAAC;QAEL,KAAK,KAAK;YACR,OAAO,IAAI,gBAAgB,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE7D;YACE,MAAM,IAAI,KAAK,CAAC,sBAAuB,UAA+B,CAAC,IAAI,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC,CAAC,iDAAiD;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC,CAAC,iDAAiD;AAE/F;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAsB,EACtB,OAAoB;IAEpB,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE9D,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE;gBAC1D,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,eAAe,EAAE,UAAU,CAAC,eAAe;aAC5C,CAAC,CAAC;QAEL,KAAK,KAAK;YACR,OAAO,IAAI,gBAAgB,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE7D,8DAA8D;QAC9D,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CACvB,UAAU,CAAC,QAAQ,EACnB,UAAU,CAAC,QAAQ,EACnB;gBACE,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;aAC5B,EACD,OAAO,CACR,CAAC;QAEJ;YACE,MAAM,IAAI,KAAK,CAAC,sBAAuB,UAA+B,CAAC,IAAI,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC"}

package/dist/auth/ticket.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Ticket Authentication Strategy (XML API)
+ *
+ * Authenticates using username/password via the XML API_Authenticate endpoint.
+ * Unlike user tokens, tickets properly attribute record changes (createdBy/modifiedBy)
+ * to the authenticated user.
+ *
+ * NOTE: This uses the legacy QuickBase XML API (API_Authenticate).
+ * If QuickBase discontinues the XML API in the future, this file and related code
+ * can be safely removed.
+ *
+ * To find all related code, search for the marker: XML-API-TICKET
+ *
+ * Files to remove/update:
+ *   - src/auth/ticket.ts (this file)
+ *   - src/auth/index.ts (TicketStrategy export, createAuthStrategy case)
+ *   - src/core/types.ts (TicketAuthConfig)
+ *   - src/index.ts (exports)
+ *   - tests/auth/ticket.test.ts
+ *   - README.md: "Ticket Auth" section
+ */
+import type { AuthStrategy, AuthContext } from './types.js';
+/**
+ * Options for ticket authentication
+ */
+export interface TicketAuthOptions {
+    /** 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';
+}
+/**
+ * Ticket authentication strategy using XML API_Authenticate.
+ *
+ * @example
+ * ```typescript
+ * const client = createClient({
+ *   realm: 'mycompany',
+ *   auth: {
+ *     type: 'ticket',
+ *     username: 'user@example.com',
+ *     password: 'password',
+ *   },
+ * });
+ * ```
+ *
+ * XML-API-TICKET: Remove this class if XML API is discontinued.
+ */
+export declare class TicketStrategy implements AuthStrategy {
+    private readonly username;
+    private password;
+    private readonly hours;
+    private readonly realm;
+    private readonly fetchApi;
+    private readonly logger;
+    private readonly onExpired?;
+    private readonly persist?;
+    private readonly storageKey;
+    private ticket;
+    private userId;
+    private expiresAt;
+    private authenticated;
+    private pendingAuth;
+    constructor(username: string, password: string, options: TicketAuthOptions | undefined, context: AuthContext);
+    getToken(_dbid?: string): Promise<string>;
+    getAuthorizationHeader(token: string): string;
+    handleAuthError(_dbid?: string): Promise<boolean>;
+    invalidate(_dbid?: string): void;
+    private clearTicket;
+    /**
+     * Get the authenticated user's ID (available after first API call)
+     */
+    getUserId(): string | null;
+    private authenticate;
+    private parseXmlResponse;
+    private escapeXml;
+    private getStorage;
+    private saveToStorage;
+    private restoreFromStorage;
+    private clearFromStorage;
+}
+//# sourceMappingURL=ticket.d.ts.map

package/dist/auth/ticket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.d.ts","sourceRoot":"","sources":["../../src/auth/ticket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAW5D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,qEAAqE;IACrE,OAAO,CAAC,EAAE,gBAAgB,GAAG,cAAc,CAAC;CAC7C;AASD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAgC;gBAGjD,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,OAAO,EAAE,WAAW;IAgBhB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiC/C,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIvC,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvD,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI;YAIZ,YAAY;IAuD1B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,gBAAgB;CAWzB"}

package/dist/auth/ticket.js

@@ -0,0 +1,260 @@
+/**
+ * Ticket Authentication Strategy (XML API)
+ *
+ * Authenticates using username/password via the XML API_Authenticate endpoint.
+ * Unlike user tokens, tickets properly attribute record changes (createdBy/modifiedBy)
+ * to the authenticated user.
+ *
+ * NOTE: This uses the legacy QuickBase XML API (API_Authenticate).
+ * If QuickBase discontinues the XML API in the future, this file and related code
+ * can be safely removed.
+ *
+ * To find all related code, search for the marker: XML-API-TICKET
+ *
+ * Files to remove/update:
+ *   - src/auth/ticket.ts (this file)
+ *   - src/auth/index.ts (TicketStrategy export, createAuthStrategy case)
+ *   - src/core/types.ts (TicketAuthConfig)
+ *   - src/index.ts (exports)
+ *   - tests/auth/ticket.test.ts
+ *   - README.md: "Ticket Auth" section
+ */
+/**
+ * Ticket authentication strategy using XML API_Authenticate.
+ *
+ * @example
+ * ```typescript
+ * const client = createClient({
+ *   realm: 'mycompany',
+ *   auth: {
+ *     type: 'ticket',
+ *     username: 'user@example.com',
+ *     password: 'password',
+ *   },
+ * });
+ * ```
+ *
+ * XML-API-TICKET: Remove this class if XML API is discontinued.
+ */
+export class TicketStrategy {
+    username;
+    password; // Cleared after first auth
+    hours;
+    realm;
+    fetchApi;
+    logger;
+    onExpired;
+    persist;
+    storageKey;
+    ticket = null;
+    userId = null;
+    expiresAt = null;
+    authenticated = false;
+    pendingAuth = null;
+    constructor(username, password, options, context) {
+        this.username = username;
+        this.password = password;
+        this.hours = Math.min(Math.max(options?.hours ?? 12, 1), 4380);
+        this.onExpired = options?.onExpired;
+        this.persist = options?.persist;
+        this.realm = context.realm;
+        this.fetchApi = context.fetchApi;
+        this.logger = context.logger;
+        this.storageKey = `qb_ticket_${this.realm}`;
+        // Try to restore ticket from storage
+        this.restoreFromStorage();
+    }
+    async getToken(_dbid) {
+        // Return cached ticket if available and not expired
+        if (this.ticket && this.expiresAt && Date.now() < this.expiresAt) {
+            return this.ticket;
+        }
+        // If ticket existed but expired, clear it
+        if (this.ticket && this.expiresAt && Date.now() >= this.expiresAt) {
+            this.clearTicket();
+            this.onExpired?.();
+            throw new Error('Ticket expired; create a new client with fresh credentials');
+        }
+        // If already authenticated but no ticket, it expired
+        if (this.authenticated) {
+            this.onExpired?.();
+            throw new Error('Ticket expired; create a new client with fresh credentials');
+        }
+        // Dedupe concurrent auth requests
+        if (this.pendingAuth) {
+            return this.pendingAuth;
+        }
+        this.pendingAuth = this.authenticate();
+        try {
+            const ticket = await this.pendingAuth;
+            return ticket;
+        }
+        finally {
+            this.pendingAuth = null;
+        }
+    }
+    getAuthorizationHeader(token) {
+        return `QB-TICKET ${token}`;
+    }
+    async handleAuthError(_dbid) {
+        // Clear expired ticket
+        this.clearTicket();
+        // Can't refresh - password was cleared after initial auth
+        this.logger.debug('Ticket auth error - cannot refresh (password was cleared)');
+        this.onExpired?.();
+        return false;
+    }
+    invalidate(_dbid) {
+        this.clearTicket();
+    }
+    clearTicket() {
+        this.ticket = null;
+        this.expiresAt = null;
+        this.clearFromStorage();
+    }
+    /**
+     * Get the authenticated user's ID (available after first API call)
+     */
+    getUserId() {
+        return this.userId;
+    }
+    async authenticate() {
+        if (!this.password) {
+            this.onExpired?.();
+            throw new Error('Ticket expired; create a new client with fresh credentials');
+        }
+        const url = `https://${this.realm}.quickbase.com/db/main`;
+        // Build XML request body
+        const xmlBody = `<qdbapi>
+    <username>${this.escapeXml(this.username)}</username>
+    <password>${this.escapeXml(this.password)}</password>
+    <hours>${this.hours}</hours>
+</qdbapi>`;
+        this.logger.debug(`Authenticating via API_Authenticate for ${this.username}`);
+        const response = await this.fetchApi(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/xml',
+                'QUICKBASE-ACTION': 'API_Authenticate',
+            },
+            body: xmlBody,
+        });
+        const xmlText = await response.text();
+        const result = this.parseXmlResponse(xmlText);
+        if (result.errcode !== 0) {
+            const errMsg = result.errdetail || result.errtext || 'Unknown error';
+            throw new Error(`Authentication failed: ${errMsg} (code: ${result.errcode})`);
+        }
+        if (!result.ticket) {
+            throw new Error('No ticket returned from API_Authenticate');
+        }
+        // Store ticket and user ID
+        this.ticket = result.ticket;
+        this.userId = result.userid;
+        this.expiresAt = Date.now() + this.hours * 60 * 60 * 1000;
+        this.authenticated = true;
+        // Save to storage if persistence is enabled
+        this.saveToStorage();
+        // Clear password from memory
+        this.password = null;
+        this.logger.debug(`Authenticated successfully, userId: ${this.userId}`);
+        return this.ticket;
+    }
+    parseXmlResponse(xml) {
+        // Simple XML parsing for the specific response format
+        const getTagContent = (tag) => {
+            const match = xml.match(new RegExp(`<${tag}>([^<]*)</${tag}>`));
+            return match?.[1] ?? '';
+        };
+        return {
+            ticket: getTagContent('ticket'),
+            userid: getTagContent('userid'),
+            errcode: parseInt(getTagContent('errcode'), 10) || 0,
+            errtext: getTagContent('errtext'),
+            errdetail: getTagContent('errdetail') || undefined,
+        };
+    }
+    escapeXml(str) {
+        return str
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+    getStorage() {
+        if (!this.persist)
+            return null;
+        try {
+            // Check if we're in a browser environment
+            if (typeof globalThis === 'undefined')
+                return null;
+            const win = globalThis;
+            const storage = this.persist === 'localStorage' ? win.localStorage : win.sessionStorage;
+            return storage ?? null;
+        }
+        catch {
+            // Storage may be disabled (e.g., private browsing)
+            return null;
+        }
+    }
+    saveToStorage() {
+        const storage = this.getStorage();
+        if (!storage || !this.ticket || !this.userId || !this.expiresAt)
+            return;
+        try {
+            const data = {
+                ticket: this.ticket,
+                userId: this.userId,
+                expiresAt: this.expiresAt,
+            };
+            storage.setItem(this.storageKey, JSON.stringify(data));
+            this.logger.debug(`Ticket saved to ${this.persist}`);
+        }
+        catch {
+            // Storage quota exceeded or other error - ignore
+            this.logger.debug(`Failed to save ticket to ${this.persist}`);
+        }
+    }
+    restoreFromStorage() {
+        const storage = this.getStorage();
+        if (!storage)
+            return;
+        try {
+            const json = storage.getItem(this.storageKey);
+            if (!json)
+                return;
+            const data = JSON.parse(json);
+            // Check if ticket is still valid (with 1 minute buffer)
+            if (Date.now() >= data.expiresAt - 60000) {
+                storage.removeItem(this.storageKey);
+                this.logger.debug('Stored ticket expired, removed from storage');
+                return;
+            }
+            this.ticket = data.ticket;
+            this.userId = data.userId;
+            this.expiresAt = data.expiresAt;
+            this.authenticated = true;
+            // Password stays null since we have a valid ticket
+            this.password = null;
+            this.logger.debug(`Ticket restored from ${this.persist}`);
+        }
+        catch {
+            // Invalid JSON or other error - clear storage
+            storage.removeItem(this.storageKey);
+        }
+    }
+    clearFromStorage() {
+        const storage = this.getStorage();
+        if (!storage)
+            return;
+        try {
+            storage.removeItem(this.storageKey);
+            this.logger.debug(`Ticket cleared from ${this.persist}`);
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+}
+//# sourceMappingURL=ticket.js.map

package/dist/auth/ticket.js.map

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

package/dist/cli/schema.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * CLI Schema Generator
+ *
+ * Generates a schema definition from a QuickBase application.
+ *
+ * Usage:
+ *   npx quickbase-js schema --realm <realm> --app <appId> --token <token>
+ *
+ * Options:
+ *   --realm    QuickBase realm (e.g., "mycompany")
+ *   --app      Application ID (e.g., "bqw123abc")
+ *   --token    User token for authentication (or set QB_USER_TOKEN env var)
+ *   --output   Output file path (default: stdout)
+ *   --format   Output format: "ts" or "json" (default: "ts")
+ *   --merge    Merge with existing schema file, preserving custom aliases
+ *   --help     Show help
+ */
+/**
+ * Main CLI entry point
+ */
+export declare function main(args: string[]): Promise<void>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/cli/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/cli/schema.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAkZH;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFxD"}