Advanced Settings
You can pass additional options when initializing the Skapi class (see Setting Up Your Codebase).
new Skapi(...)
ts
class Skapi {
constructor(
project_id: string, // Skapi project ID.
options?: {
autoLogin?: boolean; // Default: true
refetchServiceInfo?: boolean;// Default: false. Bypasses cached project information and fetches fresh information on every load.
requestBatchSize?: number; // Default: 50. Maximum number of requests processed per batch.
encryption?: boolean | { // Default: false. Encrypts private record data in the browser. Can only be set during initialization. HTTPS is required.
iterations?: number; // Default: 600000. PBKDF2 cost. Minimum: 100000.
persistDevice?: boolean; // Default: true. Keeps encryption unlocked across page reloads on that device.
recovery?: 'code' | 'none'; // Default: 'code'. Issues an encryption recovery code, shown once in getConnectionInfo().
trustPolicy?: 'tofu' | 'strict'; // Default: 'tofu'. Controls how a recipient's public key is trusted when sharing.
withheld?: 'null' | 'sentinel'; // Default: 'null'. Specifies what `data` contains when a record cannot be decrypted.
table?: string; // Default: '__skapi__keyring'. Reserved table for the user's keyring.
};
eventListener?: {
onLogin?: (user: UserProfile | null) => void; // Fires on initial page load (after Skapi initializes), on login/logout, and when a session expires. The callback receives a UserProfile object if the user is logged in; otherwise, it receives null.
onUserUpdate?: (user: UserProfile | null) => void; // Fires on initial page load (after Skapi initializes), on login/logout, when a session expires, and when the user's profile is updated. The callback receives a UserProfile object if the user is logged in; otherwise, it receives null.
onBatchProcess?: (process: {
batchToProcess: number; // Number of batches remaining
itemsToProcess: number; // Number of items remaining
completed: any[]; // Results completed in this batch
}) => void;
}
}) {
...
}
...
}Options overview:
autoLogin(boolean, default: true)- Automatically restores the user's session when the page loads.
- See: Auto Login
requestBatchSize(number, default: 50)- Maximum number of requests processed in each batch.
encryption(boolean | object, default: false)- Encrypts the
dataof records saved withaccess_group: 'private'in the browser before the data reaches the database. The contents of files attached to those records are encrypted as well. - Encryption is only as strong as the user's password, so when it is on, encourage your users to use longer passwords.
- This option takes effect only when it is set during
Skapiinitialization. There is no method for enabling encryption later. If this option is omitted, the instance saves every record'sdataas plain text for its entire lifetime. - Enabling encryption later does not encrypt records that were already saved as plain text.
- Setting it to
trueuses the default settings. Pass an object to customize them:iterations(number, default: 600000): PBKDF2 cost for deriving the key from the user's password. Minimum: 100000.persistDevice(boolean, default: true): keeps encryption unlocked across page reloads on that device.recovery('code' | 'none', default: 'code'): issues an encryption recovery code when encryption is first set up for a user. It is shown once, ingetConnectionInfo()asencryption_recovery.code, andregenerateEncryptionRecoveryCode()issues a new one. When a user forgets their password and resets it, this code is the only way to read their encrypted private records again. See Encryption recovery codes.trustPolicy('tofu' | 'strict', default: 'tofu'): controls how a recipient's public key is trusted when a record is shared.'strict'requires the key to be pinned before the first share.withheld('null' | 'sentinel', default: 'null'): specifies whatdatacontains when a record cannot be decrypted.'sentinel'returns a placeholder object with the reason instead ofnull.table(string, default: '__skapi__keyring'): the reserved table for the user's keyring.
- See: Encrypting Private Record Data
- Encrypts the
eventListener(callbacks for key events)onLogin(user: UserProfile | null)- Fires after Skapi initializes on the initial page load, after login or logout, and when a session expires. The callback receives a
UserProfileobject when the user is logged in; otherwise, it receivesnull. - See: Listening to Login/Logout Status
- Fires after Skapi initializes on the initial page load, after login or logout, and when a session expires. The callback receives a
onUserUpdate(user: UserProfile | null)- Fires after login, before logout, when a session expires, and when the user's profile is updated. The callback receives a
UserProfileobject when the user is logged in; otherwise, it receivesnull. - See: Listening to User Profile Updates
- Fires after login, before logout, when a session expires, and when the user's profile is updated. The callback receives a
onBatchProcess(process)- Fires each time Skapi finishes processing a request batch.
Type reference: See UserProfile.
