@appconda/sdk 1.0.194 → 1.0.410

package/src/client.ts

@@ -0,0 +1,397 @@
+import { fetch, FormData, File } from 'node-fetch-native-with-agent';
+import { createAgent } from 'node-fetch-native-with-agent/agent';
+import { Models } from './models';
+
+type Payload = {
+    [key: string]: any;
+}
+
+type UploadProgress = {
+    $id: string;
+    progress: number;
+    sizeUploaded: number;
+    chunksTotal: number;
+    chunksUploaded: number;
+}
+
+type Headers = {
+    [key: string]: string;
+}
+
+class AppcondaException extends Error {
+    code: number;
+    response: string;
+    type: string;
+    constructor(message: string, code: number = 0, type: string = '', response: string = '') {
+        super(message);
+        this.name = 'AppcondaException';
+        this.message = message;
+        this.code = code;
+        this.type = type;
+        this.response = response;
+    }
+}
+
+function getUserAgent() {
+    let ua = 'AppcondaNodeJSSDK/14.1.0';
+
+    // `process` is a global in Node.js, but not fully available in all runtimes.
+    const platform: string[] = [];
+    if (typeof process !== 'undefined') {
+        if (typeof process.platform === 'string') platform.push(process.platform);
+        if (typeof process.arch === 'string') platform.push(process.arch);
+    }
+    if (platform.length > 0) {
+        ua += ` (${platform.join('; ')})`;
+    }
+
+    // `navigator.userAgent` is available in Node.js 21 and later.
+    // It's also part of the WinterCG spec, so many edge runtimes provide it.
+    // https://common-min-api.proposal.wintercg.org/#requirements-for-navigatoruseragent
+    // @ts-ignore
+    if (typeof navigator !== 'undefined' && typeof navigator.userAgent === 'string') {
+        // @ts-ignore
+        ua += ` ${navigator.userAgent}`;
+
+        // @ts-ignore
+    } else if (typeof globalThis.EdgeRuntime === 'string') {
+        ua += ` EdgeRuntime`;
+
+        // Older Node.js versions don't have `navigator.userAgent`, so we have to use `process.version`.
+    } else if (typeof process !== 'undefined' && typeof process.version === 'string') {
+        ua += ` Node.js/${process.version}`;
+    }
+
+    return ua;
+}
+
+class Client {
+    static CHUNK_SIZE = 1024 * 1024 * 5;
+
+    config = {
+        endpoint: 'https://cloud.appconda.io/v1',
+        selfSigned: false,
+        project: '',
+        mode: '',
+        key: '',
+        jwt: '',
+        locale: '',
+        session: '',
+        forwardeduseragent: '',
+    };
+    headers: Headers = {
+        'x-sdk-name': 'Node.js',
+        'x-sdk-platform': 'server',
+        'x-sdk-language': 'nodejs',
+        'x-sdk-version': '14.1.0',
+        'user-agent': getUserAgent(),
+        'X-Appconda-Response-Format': '1.6.0',
+    };
+
+    /**
+     * Set Endpoint
+     *
+     * Your project endpoint
+     *
+     * @param {string} endpoint
+     *
+     * @returns {this}
+     */
+    setEndpoint(endpoint: string): this {
+        this.config.endpoint = endpoint;
+
+        return this;
+    }
+
+    /**
+     * Set self-signed
+     *
+     * @param {boolean} selfSigned
+     *
+     * @returns {this}
+     */
+    setSelfSigned(selfSigned: boolean): this {
+        // @ts-ignore
+        if (typeof globalThis.EdgeRuntime !== 'undefined') {
+            console.warn('setSelfSigned is not supported in edge runtimes.');
+        }
+
+        this.config.selfSigned = selfSigned;
+
+        return this;
+    }
+
+    /**
+     * Add header
+     *
+     * @param {string} header
+     * @param {string} value
+     *
+     * @returns {this}
+     */
+    addHeader(header: string, value: string): this {
+        this.headers[header.toLowerCase()] = value;
+
+        return this;
+    }
+
+    /**
+     * Set Project
+     *
+     * Your project ID
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setProject(value: string): this {
+        this.headers['X-Appconda-Project'] = value;
+        this.config.project = value;
+        return this;
+    }
+
+      /**
+     * Set Mode
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+      setMode(value: string): this {
+        this.headers['X-Appconda-Mode'] = value;
+        this.config.mode = value;
+        return this;
+    }
+
+    /**
+     * Set Key
+     *
+     * Your secret API key
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setKey(value: string): this {
+        this.headers['X-Appconda-Key'] = value;
+        this.config.key = value;
+        return this;
+    }
+    /**
+     * Set JWT
+     *
+     * Your secret JSON Web Token
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setJWT(value: string): this {
+        this.headers['X-Appconda-JWT'] = value;
+        this.config.jwt = value;
+        return this;
+    }
+    /**
+     * Set Locale
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setLocale(value: string): this {
+        this.headers['X-Appconda-Locale'] = value;
+        this.config.locale = value;
+        return this;
+    }
+    /**
+     * Set Session
+     *
+     * The user session to authenticate with
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setSession(value: string): this {
+        this.headers['X-Appconda-Session'] = value;
+        this.config.session = value;
+        return this;
+    }
+    /**
+     * Set ForwardedUserAgent
+     *
+     * The user agent string of the client that made the request
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setForwardedUserAgent(value: string): this {
+        this.headers['X-Forwarded-User-Agent'] = value;
+        this.config.forwardeduseragent = value;
+        return this;
+    }
+
+    setFallbackCookies(value: string): this {
+        this.headers['X-Fallback-Cookies'] = value;
+        //this.config.forwardeduseragent = value;
+        return this;
+    }
+
+    prepareRequest(method: string, url: URL, headers: Headers = {}, params: Payload = {}): { uri: string, options: RequestInit } {
+        method = method.toUpperCase();
+
+        headers = Object.assign({}, this.headers, headers);
+
+        let options: RequestInit = {
+            method,
+            headers,
+            ...createAgent(this.config.endpoint, { rejectUnauthorized: !this.config.selfSigned }),
+        };
+
+        if (method === 'GET') {
+            for (const [key, value] of Object.entries(Client.flatten(params))) {
+                url.searchParams.append(key, value);
+            }
+        } else {
+            switch (headers['content-type']) {
+                case 'application/json':
+                    options.body = JSON.stringify(params);
+                    break;
+
+                case 'multipart/form-data':
+                    const formData = new FormData();
+
+                    for (const [key, value] of Object.entries(params)) {
+                        if (value instanceof File) {
+                            formData.append(key, value, value.name);
+                        } else if (Array.isArray(value)) {
+                            for (const nestedValue of value) {
+                                formData.append(`${key}[]`, nestedValue);
+                            }
+                        } else {
+                            formData.append(key, value);
+                        }
+                    }
+
+                    options.body = formData;
+                    delete headers['content-type'];
+                    break;
+            }
+        }
+
+        return { uri: url.toString(), options };
+    }
+
+    async chunkedUpload(method: string, url: URL, headers: Headers = {}, originalPayload: Payload = {}, onProgress: (progress: UploadProgress) => void) {
+        const file: any = Object.values(originalPayload).find((value) => value instanceof File);
+
+        if (file.size <= Client.CHUNK_SIZE) {
+            return await this.call(method, url, headers, originalPayload);
+        }
+
+        let start = 0;
+        let response: any = null;
+
+        while (start < file.size) {
+            let end = start + Client.CHUNK_SIZE; // Prepare end for the next chunk
+            if (end >= file.size) {
+                end = file.size; // Adjust for the last chunk to include the last byte
+            }
+
+            headers['content-range'] = `bytes ${start}-${end - 1}/${file.size}`;
+            const chunk = file.slice(start, end);
+
+            let payload = { ...originalPayload, file: new File([chunk], file.name) };
+
+            response = await this.call(method, url, headers, payload);
+
+            if (onProgress && typeof onProgress === 'function') {
+                onProgress({
+                    $id: response.$id,
+                    progress: Math.round((end / file.size) * 100),
+                    sizeUploaded: end,
+                    chunksTotal: Math.ceil(file.size / Client.CHUNK_SIZE),
+                    chunksUploaded: Math.ceil(end / Client.CHUNK_SIZE)
+                });
+            }
+
+            if (response && response.$id) {
+                headers['x-appconda-id'] = response.$id;
+            }
+
+            start = end;
+        }
+
+        return response;
+    }
+
+    async redirect(method: string, url: URL, headers: Headers = {}, params: Payload = {}): Promise<string> {
+        const { uri, options } = this.prepareRequest(method, url, headers, params);
+
+        const response = await fetch(uri, {
+            ...options,
+            redirect: 'manual'
+        });
+
+        if (response.status !== 301 && response.status !== 302) {
+            throw new AppcondaException('Invalid redirect', response.status);
+        }
+
+        return response.headers.get('location') || '';
+    }
+
+    async call(method: string, url: URL, headers: Headers = {}, params: Payload = {}, responseType = 'json'): Promise<any> {
+        const { uri, options } = this.prepareRequest(method, url, headers, params);
+
+        let data: any = null;
+
+        try {
+            const response = await fetch(uri, options);
+
+            const warnings = response.headers.get('x-appconda-warning');
+            if (warnings) {
+                warnings.split(';').forEach((warning: string) => console.warn('Warning: ' + warning));
+            }
+
+            if (response.headers.get('content-type')?.includes('application/json')) {
+                data = await response.json();
+            } else if (responseType === 'arrayBuffer') {
+                data = await response.arrayBuffer();
+            } else {
+                data = {
+                    message: await response.text()
+                };
+            }
+
+            if (400 <= response.status) {
+                throw new AppcondaException(data?.message, response.status, data?.type, data);
+            }
+
+            return data;
+        } catch (e) {
+            console.error(e);
+            throw e;
+        }
+    }
+
+    static flatten(data: Payload, prefix = ''): Payload {
+        let output: Payload = {};
+
+        for (const [key, value] of Object.entries(data)) {
+            let finalKey = prefix ? prefix + '[' + key + ']' : key;
+            if (Array.isArray(value)) {
+                output = { ...output, ...Client.flatten(value, finalKey) };
+            } else {
+                output[finalKey] = value;
+            }
+        }
+
+        return output;
+    }
+}
+
+export { Client, AppcondaException };
+export { Query } from './query';
+export type { Models, Payload, UploadProgress };
+export type { QueryTypes, QueryTypesList } from './query';

package/src/enums/api-service.ts

@@ -0,0 +1,13 @@
+export enum ApiService {
+    Account = 'account',
+    Avatars = 'avatars',
+    Databases = 'databases',
+    Locale = 'locale',
+    Health = 'health',
+    Storage = 'storage',
+    Teams = 'teams',
+    Users = 'users',
+    Functions = 'functions',
+    Graphql = 'graphql',
+    Messaging = 'messaging',
+}

package/src/enums/api.ts

@@ -0,0 +1,5 @@
+export enum Api {
+    Rest = 'rest',
+    Graphql = 'graphql',
+    Realtime = 'realtime',
+}

package/src/enums/auth-method.ts

@@ -0,0 +1,9 @@
+export enum AuthMethod {
+    Emailpassword = 'email-password',
+    Magicurl = 'magic-url',
+    Emailotp = 'email-otp',
+    Anonymous = 'anonymous',
+    Invites = 'invites',
+    Jwt = 'jwt',
+    Phone = 'phone',
+}

package/src/enums/browser.ts

@@ -0,0 +1,16 @@
+export enum Browser {
+    AvantBrowser = 'aa',
+    AndroidWebViewBeta = 'an',
+    GoogleChrome = 'ch',
+    GoogleChromeIOS = 'ci',
+    GoogleChromeMobile = 'cm',
+    Chromium = 'cr',
+    MozillaFirefox = 'ff',
+    Safari = 'sf',
+    MobileSafari = 'mf',
+    MicrosoftEdge = 'ps',
+    MicrosoftEdgeIOS = 'oi',
+    OperaMini = 'om',
+    Opera = 'op',
+    OperaNext = 'on',
+}

package/src/enums/compression.ts

@@ -0,0 +1,5 @@
+export enum Compression {
+    None = 'none',
+    Gzip = 'gzip',
+    Zstd = 'zstd',
+}

package/src/enums/credit-card.ts

@@ -0,0 +1,18 @@
+export enum CreditCard {
+    AmericanExpress = 'amex',
+    Argencard = 'argencard',
+    Cabal = 'cabal',
+    Cencosud = 'cencosud',
+    DinersClub = 'diners',
+    Discover = 'discover',
+    Elo = 'elo',
+    Hipercard = 'hipercard',
+    JCB = 'jcb',
+    Mastercard = 'mastercard',
+    Naranja = 'naranja',
+    TarjetaShopping = 'targeta-shopping',
+    UnionChinaPay = 'union-china-pay',
+    Visa = 'visa',
+    MIR = 'mir',
+    Maestro = 'maestro',
+}

package/src/enums/database-usage-range.ts

@@ -0,0 +1,5 @@
+export enum DatabaseUsageRange {
+    TwentyFourHours = '24h',
+    ThirtyDays = '30d',
+    NinetyDays = '90d',
+}

package/src/enums/email-template-locale.ts

@@ -0,0 +1,133 @@
+export enum EmailTemplateLocale {
+    Af = 'af',
+    Arae = 'ar-ae',
+    Arbh = 'ar-bh',
+    Ardz = 'ar-dz',
+    Areg = 'ar-eg',
+    Ariq = 'ar-iq',
+    Arjo = 'ar-jo',
+    Arkw = 'ar-kw',
+    Arlb = 'ar-lb',
+    Arly = 'ar-ly',
+    Arma = 'ar-ma',
+    Arom = 'ar-om',
+    Arqa = 'ar-qa',
+    Arsa = 'ar-sa',
+    Arsy = 'ar-sy',
+    Artn = 'ar-tn',
+    Arye = 'ar-ye',
+    As = 'as',
+    Az = 'az',
+    Be = 'be',
+    Bg = 'bg',
+    Bh = 'bh',
+    Bn = 'bn',
+    Bs = 'bs',
+    Ca = 'ca',
+    Cs = 'cs',
+    Cy = 'cy',
+    Da = 'da',
+    De = 'de',
+    Deat = 'de-at',
+    Dech = 'de-ch',
+    Deli = 'de-li',
+    Delu = 'de-lu',
+    El = 'el',
+    En = 'en',
+    Enau = 'en-au',
+    Enbz = 'en-bz',
+    Enca = 'en-ca',
+    Engb = 'en-gb',
+    Enie = 'en-ie',
+    Enjm = 'en-jm',
+    Ennz = 'en-nz',
+    Entt = 'en-tt',
+    Enus = 'en-us',
+    Enza = 'en-za',
+    Eo = 'eo',
+    Es = 'es',
+    Esar = 'es-ar',
+    Esbo = 'es-bo',
+    Escl = 'es-cl',
+    Esco = 'es-co',
+    Escr = 'es-cr',
+    Esdo = 'es-do',
+    Esec = 'es-ec',
+    Esgt = 'es-gt',
+    Eshn = 'es-hn',
+    Esmx = 'es-mx',
+    Esni = 'es-ni',
+    Espa = 'es-pa',
+    Espe = 'es-pe',
+    Espr = 'es-pr',
+    Espy = 'es-py',
+    Essv = 'es-sv',
+    Esuy = 'es-uy',
+    Esve = 'es-ve',
+    Et = 'et',
+    Eu = 'eu',
+    Fa = 'fa',
+    Fi = 'fi',
+    Fo = 'fo',
+    Fr = 'fr',
+    Frbe = 'fr-be',
+    Frca = 'fr-ca',
+    Frch = 'fr-ch',
+    Frlu = 'fr-lu',
+    Ga = 'ga',
+    Gd = 'gd',
+    He = 'he',
+    Hi = 'hi',
+    Hr = 'hr',
+    Hu = 'hu',
+    Id = 'id',
+    Is = 'is',
+    It = 'it',
+    Itch = 'it-ch',
+    Ja = 'ja',
+    Ji = 'ji',
+    Ko = 'ko',
+    Ku = 'ku',
+    Lt = 'lt',
+    Lv = 'lv',
+    Mk = 'mk',
+    Ml = 'ml',
+    Ms = 'ms',
+    Mt = 'mt',
+    Nb = 'nb',
+    Ne = 'ne',
+    Nl = 'nl',
+    Nlbe = 'nl-be',
+    Nn = 'nn',
+    No = 'no',
+    Pa = 'pa',
+    Pl = 'pl',
+    Pt = 'pt',
+    Ptbr = 'pt-br',
+    Rm = 'rm',
+    Ro = 'ro',
+    Romd = 'ro-md',
+    Ru = 'ru',
+    Rumd = 'ru-md',
+    Sb = 'sb',
+    Sk = 'sk',
+    Sl = 'sl',
+    Sq = 'sq',
+    Sr = 'sr',
+    Sv = 'sv',
+    Svfi = 'sv-fi',
+    Th = 'th',
+    Tn = 'tn',
+    Tr = 'tr',
+    Ts = 'ts',
+    Ua = 'ua',
+    Ur = 'ur',
+    Ve = 've',
+    Vi = 'vi',
+    Xh = 'xh',
+    Zhcn = 'zh-cn',
+    Zhhk = 'zh-hk',
+    Zhsg = 'zh-sg',
+    Zhtw = 'zh-tw',
+    Zu = 'zu',
+}

package/src/enums/email-template-type.ts

@@ -0,0 +1,9 @@
+export enum EmailTemplateType {
+    Verification = 'verification',
+    Magicsession = 'magicsession',
+    Recovery = 'recovery',
+    Invitation = 'invitation',
+    Mfachallenge = 'mfachallenge',
+    Sessionalert = 'sessionalert',
+    Otpsession = 'otpsession',
+}

package/src/enums/entities/EntityLimitType.ts

@@ -0,0 +1,4 @@
+export enum EntityLimitType {
+  MAX,
+  MONTHLY,
+}

package/src/enums/entities/PropertyAttributeName.ts

@@ -0,0 +1,27 @@
+export enum PropertyAttributeName {
+  HintText = "HintText", // Common
+  HelpText = "HelpText", // Common
+  Icon = "Icon", // Common
+  Pattern = "pattern", // Text
+  Min = "Min",
+  Max = "Max",
+  Step = "Step",
+  Rows = "Rows",
+  DefaultValue = "DefaultValue",
+  Uppercase = "Uppercase",
+  Lowercase = "Lowercase",
+  Placeholder = "Placeholder",
+  AcceptFileTypes = "AcceptFileTypes",
+  MaxSize = "MaxSize",
+  Editor = "editor",
+  EditorLanguage = "EditorLanguage",
+  EditorSize = "EditorSize",
+  Columns = "Columns",
+  Group = "Group",
+  FormatNumber = "FormatNumber",
+  FormatDate = "FormatDate",
+  FormatBoolean = "FormatBoolean",
+  Separator = "Separator",
+  SelectOptions = "SelectOptions",
+  Password = "Password",
+}

package/src/enums/entities/PropertyCondition.ts

@@ -0,0 +1,8 @@
+export enum PropertyCondition {
+  EQUAL, // =
+  GREATER_THAN, // >
+  EQUAL_OR_GREATER_THAN, // >=
+  LESS_THAN, // <
+  EQUAL_OR_LESS_THAN, // <=,
+  // CONTAINS, // (),
+}

package/src/enums/entities/PropertyType.ts

@@ -0,0 +1,16 @@
+export enum PropertyType {
+  NUMBER = 0,
+  TEXT = 1,
+  DATE = 2,
+  // USER = 3,
+  // ROLE = 4,
+  // ENTITY = 5,
+  MEDIA = 6,
+  // ID = 7,
+  SELECT = 8,
+  BOOLEAN = 10,
+  MULTI_SELECT = 11,
+  MULTI_TEXT = 12,
+  RANGE_NUMBER = 13,
+  RANGE_DATE = 14,
+}

package/src/enums/entities/PropertyValueType.ts

@@ -0,0 +1,6 @@
+export enum PropertyValueType {
+  ID,
+  NUMBER,
+  TEXT,
+  DATE,
+}

package/src/enums/entities/RowAccess.ts

@@ -0,0 +1,2 @@
+export const RowAccessTypes = ["none", "view", "comment", "edit", "delete"] as const;
+export type RowAccess = (typeof RowAccessTypes)[number];