quip-test-utils

library0.1.3jsnpmunverified

Testing utilities for Quip Live Apps development. Version 0.1.3 is the initial release with basic testing helpers. This package provides utilities to mock Quip Live Apps environment and write unit tests for Quip Live Apps. It includes helpers for creating test records, simulating user actions, and validating Quip-specific behaviors. Key differentiators include tight integration with Quip Live Apps API and simplified test setup. Currently in early development with likely breaking changes.

testing

npm install quip-test-utils

github ↗package ↗

INSTALL

IMPORT

SIG · QUIP-TEST-UTILS

quip-test-utils

testingjavascriptv0.1.3

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

createQuipTestRecord

✓ import { createQuipTestRecord } from 'quip-test-utils'

✗ const createQuipTestRecord = require('quip-test-utils')

Package is ESM-only; CommonJS require will not work.

mockQuipApp

✓ import { mockQuipApp } from 'quip-test-utils'

✗ import { MockQuipApp } from 'quip-test-utils'

Function is not a class; wrong casing will cause undefined.

simulateUserAction

✓ import { simulateUserAction } from 'quip-test-utils'

✗ import simulateUserAction from 'quip-test-utils'

Default export is not provided; named import required.

cleanupTestRecords

✓ import { cleanupTestRecords } from 'quip-test-utils'

✗ import { cleanUpTestRecords } from 'quip-test-utils'

Function name uses lowercase 'c' in 'cleanup'; camelCase sensitive.

This shows basic setup: mock app environment, create test record, simulate user interaction, and cleanup.

import { createQuipTestRecord, mockQuipApp, simulateUserAction, cleanupTestRecords } from 'quip-test-utils'; // Mock Quip App environment mockQuipApp(process.env.QUIP_APP_ID ?? 'test-app-id'); // Create a test record const record = createQuipTestRecord('task', { title: 'Test task', status: 'open' }); // Simulate user action simulateUserAction({ type: 'click', element: record.get('title') }); console.log('Record created:', record.getData()); // Clean up after test cleanupTestRecords();

Debug

Known issues

breakingVersion 0.x is unstable; APIs may change without notice.

fix

Lock to exact version and monitor changelog for breaking changes.

affects: >=0.0.0

deprecatedDeprecation warning in future versions expected as package matures.

fix

Stay updated with latest release notes.

affects: >=0.1.0

gotchacreateQuipTestRecord does not persist records; they are in-memory only.

fix

Use with test runner that provides isolation between tests.

affects: >=0.1.0

gotchasimulateUserAction does not trigger real HTTP requests; only local event simulation.

fix

Do not rely on this for network behavior testing.

affects: >=0.1.0

Errors

Common errors & fixes

TypeError: mockQuipApp is not a function

Incorrect import: using default import instead of named.

fix

Use `import { mockQuipApp } from 'quip-test-utils'`.

Module not found: Can't resolve 'quip-test-utils' in ...

Package not installed or not in node_modules.

fix

Run `npm install quip-test-utils --save-dev` or equivalent.

SyntaxError: Cannot use import statement outside a module

Using ESM import in a CommonJS context without type: module.

fix

Add 'type': 'module' to package.json or use .mjs extension.

Upgrade

Version history

0.1.3latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/quip/quip-apps ↗

packagehttps://www.npmjs.com/package/quip-test-utils ↗