@partium/cordova-sdk 14.0.0

package/LICENSE.txt

@@ -0,0 +1,100 @@
+Copyright © 2022-2025 Partium, Inc. DBA Partium
+
+Partium Source Code License, by Partium, Inc. DBA Partium ("Licensor")
+
+License. Licensor hereby grants the person ("You" or "Licensee") accessing or
+using the Partium software and associated documentation files to which this
+license is attached (the "Software", being the Partium App or SDK), a limited,
+royalty-free, non-transferable and non-sublicensable right (a) to install and
+use the Software in order to develop, test and prototype Your applications as
+a Partium Integration Project ("Partium Project"), including non-transferable
+rights to use, copy and modify the Software as necessary to integrate the
+Software into the Your own applications and (b) to distribute and sublicense
+the use of the Software, with or without modifications, to Your clients only
+as part of Your applications for a Partium Project. Distribution and/or public
+communication of the Software to Your clients are permitted only if the
+Software is embedded in the Licensee's own applications as part of a Partium
+Project. As an exception to the above license, you may not extract, reproduce
+modify or use except as part of this Software the UAPARSER.JS which is part of
+and/or downloaded and installed as the Software.
+
+Licensee undertakings. Licensee agrees that (a) it will not remove any
+proprietary notices on the Software; (b) it will maintain the confidentiality
+of the Software, (c) it will only use the Software as part of a Partium
+Project and shall not distribute the Software in any form or under any
+agreement that allows it to be reused by any application other than Licensee's
+applications in a Partium Project; and (d) it will not use the Software to
+build or form part of any product that competes with the Partium product or
+technologies as described in the associated documentation or at
+https://partium.io.
+
+Reservation of rights. Except as expressly licensed hereunder, Licensor and
+its own licensors retain all ownership and intellectual property rights to the
+Software.
+
+Disclaimer. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, (A) THE
+SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF SATISFACTORY QUALITY,
+OR FITNESS FOR A PARTICULAR PURPOSE; AND (B) IN NO EVENT SHALL THE LICENSOR BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Data collection: The Software contains certain features that trigger tracking
+events in the Partium cloud-service. These events are used for understanding
+usage, improve technology, but also to provide to customer statistics (as
+requested by them in product configuration). As delivered by Licensor, the
+Software does not collect any personal data.
+
+Export Controls. Export laws and regulations of the United States and any
+other relevant local export laws and regulations apply to the Software. You
+agree that such export control laws govern Your use of the Software (including
+technical data) and any services deliverables provided under this agreement,
+and You agree to comply with all such export laws and regulations (including
+"deemed export" and "deemed re-export" regulations). You agree that no data,
+information, program and/or materials resulting from Software or services (or
+direct products thereof) will be exported, directly or indirectly, in
+violation of these laws, or will be used for any purpose prohibited by these
+laws including, without limitation, nuclear, chemical, or biological weapons
+proliferation, or development of missile technology. Accordingly, You confirm:
+- You will not download, provide, make available or otherwise export or
+re-export the Software, directly or indirectly, to countries prohibited by
+applicable laws and regulations nor to citizens, nationals, or residents of
+those countries.
+- You are not listed on the United States Department of Treasury lists of
+Specially Designated Nationals and Blocked Persons, Specially Designated
+Terrorists, and Specially Designated Narcotic Traffickers, nor are You listed
+on the United States Department of Commerce Table of Denial Orders.
+- You will not download or otherwise export or re-export the Software,
+directly or indirectly, to persons on the above mentioned lists.
+
+No support. The Licensor does not provide any support under this license.
+Support may be provided under a separate service agreement with Licensor.
+Updates may be provided at Licensor's discretion.
+
+Term and Termination. This license is for the term of Your service agreement
+with Licensor and shall automatically terminate without notice if You fail to
+comply with any of the terms of this license or the service agreement with
+Licensor, in which case You shall promptly stop using and destroy all copies
+of the Software.
+
+Third-Party components (including open source). The Software requires the use
+of third-party software (open source or other) that is not provided with the
+Software (as indicated in the Software documentation or listed dependencies).
+Licensor may provide certain notices to Licensee in the Software documentation,
+readmes or notice files in connection with such third-party software.
+Third-party software is licensed to Licensee under the terms of the corresponding
+software license indicated in the documentation or the repository of the listed
+dependencies (provided to Licensee and downloaded with the dependency software
+code). Licensee's rights to use such software are not restricted in any way by
+this license.
+
+Applicable Law and Jurisdiction. This Agreement is governed by the substantive
+and procedural laws of Delaware (US), and Licensee and Licensor, agree to
+submit to the exclusive jurisdiction of, and venue in, the courts of Delaware
+in any dispute arising out of or relating to this Agreement.
+
+Notices. For any questions concerning this license, or to contact the Licensor
+for any reason, please write to support@partium.io
+
+Version 4: 15 July 2024

package/README.md

@@ -0,0 +1,9 @@
+# Partium Find SDK for Cordova
+
+The *Partium Find SDK* enables seamless integration of Partium’s parts and materials search capabilities into Cordova-based applications. It supports multiple search modalities, including text, image, and multi-modal search, and offers advanced features like hierarchy navigation (Bill of Materials) and attribute-based filtering.
+
+The Find SDK enables efficient spare part search, retrieval of relevant results, and seamless integration of those results into applications through an intuitive interface. Additional information about material and part search with Partium, along with user interface examples and usage guidelines, is available in the [Partium Help Center](https://www.partium.io/help-center/material-and-part-search).
+
+# Installation & Usage
+
+For complete installation instructions and code samples, please visit the Partium [Developer Center](https://developer.partium.io/). Access requires credentials; please contact your Partium representative for access. If you don’t yet have a contact, reach out to us via [Partium.io](https://www.partium.io/contact).

package/core/index.d.ts

@@ -0,0 +1,2 @@
+// Copyright © 2022-2025 Partium, Inc. DBA Partium
+export * from '@partium/js-sdk/core';

package/core/index.js

@@ -0,0 +1,2 @@
+// Copyright © 2022-2025 Partium, Inc. DBA Partium
+"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,i,t){void 0===t&&(t=i);var c=Object.getOwnPropertyDescriptor(r,i);c&&!("get"in c?!r.__esModule:c.writable||c.configurable)||(c={enumerable:!0,get:function(){return r[i]}}),Object.defineProperty(e,t,c)}:function(e,r,i,t){void 0===t&&(t=i),e[t]=r[i]}),__exportStar=this&&this.__exportStar||function(e,r){for(var i in e)"default"===i||Object.prototype.hasOwnProperty.call(r,i)||__createBinding(r,e,i)};Object.defineProperty(exports,"__esModule",{value:!0}),__exportStar(require("@partium/js-sdk/core"),exports);const js_sdk_1=require("@partium/js-sdk"),core_1=require("@partium/js-sdk/core"),cordova_device_status_service_1=require("./services/cordova-device-status.service"),origInit=js_sdk_1.Partium.init;js_sdk_1.Partium.init=function(e){return console.log("Initializing Partium..."),origInit(Object.assign(e,{authenticationConfig:e.authenticationConfig,httpsClientService:e.httpsClientService||core_1.FetchAPIHttpsClientService,fileTransferService:e.fileTransferService||core_1.FetchAPIFileTransferService,localStorageService:e.localStorageService||core_1.WebLocalStorageService,deviceStatusService:e.deviceStatusService||cordova_device_status_service_1.CordovaDeviceStatusService,fileService:e.fileService||core_1.WebFileService}))};

package/core/services/cordova-device-status.service.d.ts

@@ -0,0 +1,40 @@
+// Copyright © 2022-2025 Partium, Inc. DBA Partium
+import { DeviceStatusService, DeviceInfo } from '@partium/js-sdk/core';
+/**
+ * Implementation of the DeviceStatusService for Cordova applications.
+ */
+export declare class CordovaDeviceStatusService extends DeviceStatusService {
+    /**
+     * Returns Promise that resolves with true if connection to a network is available.
+     * (Usually the internet, but for intranet-only systems it can also be only intranet)
+     *
+     * @returns promise that resolves with true or false, depending on network-connection is available or not
+     */
+    isConnectionAvailable(): Promise<boolean>;
+    /**
+     * Returns Promise that resolves with a DeviceInfo object, containing
+     * information about the device and the installation.
+     * Used for logging.
+     *
+     * @returns Promise that resolves with DeviceInfo
+     */
+    getDeviceInfo(): Promise<DeviceInfo>;
+    /**
+     * Promisify a function that takes two callbacks for success and error.
+     *
+     * @returns Resolves with the result as string, if success or '' in error case.
+     */
+    private promisify;
+    private getConnectivityType;
+    /**
+     * Returns whether the application is connected to the internet or not.
+     */
+    private isConnectionAvailableCordova;
+    /**
+     * Returns true when the application is currently running on Cordova and
+     * not directly in the browser.
+     *
+     * This works, because when running in Cordova, the url would start with 'file://'.
+     */
+    private isCordova;
+}

package/core/services/cordova-device-status.service.js

@@ -0,0 +1,2 @@
+// Copyright © 2022-2025 Partium, Inc. DBA Partium
+"use strict";var __awaiter=this&&this.__awaiter||function(e,n,i,o){return new(i||(i=Promise))((function(t,r){function c(e){try{v(o.next(e))}catch(e){r(e)}}function a(e){try{v(o.throw(e))}catch(e){r(e)}}function v(e){var n;e.done?t(e.value):(n=e.value,n instanceof i?n:new i((function(e){e(n)}))).then(c,a)}v((o=o.apply(e,n||[])).next())}))};Object.defineProperty(exports,"__esModule",{value:!0}),exports.CordovaDeviceStatusService=void 0;const core_1=require("@partium/js-sdk/core"),Connection=require("cordova-plugin-network-information/www/Connection"),AppVersion=require("cordova-plugin-app-version/www/AppVersionPlugin");class CordovaDeviceStatusService extends core_1.DeviceStatusService{isConnectionAvailable(){return __awaiter(this,void 0,void 0,(function*(){return this.isCordova()?this.isConnectionAvailableCordova():window.navigator.onLine}))}getDeviceInfo(){return __awaiter(this,void 0,void 0,(function*(){var e;const n=yield this.promisify(AppVersion.getVersionCode),i=yield this.promisify(AppVersion.getVersionNumber),o=yield this.promisify(AppVersion.getPackageName),t=(null===(e=null===window||void 0===window?void 0:window.navigator)||void 0===e?void 0:e.language)||"unavailable";return new core_1.DeviceInfo({deviceId:null===device||void 0===device?void 0:device.uuid,manufacturer:null===device||void 0===device?void 0:device.manufacturer,model:null===device||void 0===device?void 0:device.model,os:null===device||void 0===device?void 0:device.platform,osVersion:null===device||void 0===device?void 0:device.version,deviceType:null===device||void 0===device?void 0:device.model,deviceLanguage:t,appVersionCode:n,appVersionName:i,appId:o,connectivityType:this.getConnectivityType()})}))}promisify(e){return __awaiter(this,void 0,void 0,(function*(){try{return(yield new Promise(((n,i)=>e(n,i)))).toString()}catch(e){return""}}))}getConnectivityType(){let e;switch(e=navigator&&navigator.connection&&navigator.connection.type?navigator.connection.type:null,e){case Connection.ETHERNET:return"Ethernet";case Connection.WIFI:return"WiFi";case Connection.CELL_2G:return"Cell 2G";case Connection.CELL_3G:return"Cell 3G";case Connection.CELL_4G:return"Cell 4G";case Connection.CELL:return"Cell generic connection";case Connection.NONE:return"No network connection";case Connection.UNKNOWN:default:return"Unknown connection"}}isConnectionAvailableCordova(){if(!navigator.connection||!navigator.connection.type)throw new core_1.SdkError(core_1.SDK_ERROR_CODES.INTEGRATION_ERROR,null,"Could not determine network state in CordovaLocalStorageService. "+navigator.connection);return navigator.connection.type!==Connection.NONE}isCordova(){return 0===document.URL.indexOf("file://")}}exports.CordovaDeviceStatusService=CordovaDeviceStatusService;

package/index.d.ts

@@ -0,0 +1,10 @@
+// Copyright © 2022-2025 Partium, Inc. DBA Partium
+export * from './core';
+export * from '@partium/js-sdk/core';
+export * from '@partium/js-sdk/find';
+export * from '@partium/js-sdk/data';
+export * from '@partium/js-sdk/user-data';
+export * from '@partium/js-sdk/ocr';
+export * from '@partium/js-sdk/management';
+export * from '@partium/js-sdk/catalog';
+export { Partium, INITIALIZATION_STATUS } from '@partium/js-sdk';

package/index.js

@@ -0,0 +1,2 @@
+// Copyright © 2022-2025 Partium, Inc. DBA Partium
+"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,i){void 0===i&&(i=t);var o=Object.getOwnPropertyDescriptor(r,t);o&&!("get"in o?!r.__esModule:o.writable||o.configurable)||(o={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,i,o)}:function(e,r,t,i){void 0===i&&(i=t),e[i]=r[t]}),__exportStar=this&&this.__exportStar||function(e,r){for(var t in e)"default"===t||Object.prototype.hasOwnProperty.call(r,t)||__createBinding(r,e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),exports.INITIALIZATION_STATUS=exports.Partium=void 0,__exportStar(require("./core"),exports),__exportStar(require("@partium/js-sdk/core"),exports),__exportStar(require("@partium/js-sdk/find"),exports),__exportStar(require("@partium/js-sdk/data"),exports),__exportStar(require("@partium/js-sdk/user-data"),exports),__exportStar(require("@partium/js-sdk/ocr"),exports),__exportStar(require("@partium/js-sdk/management"),exports),__exportStar(require("@partium/js-sdk/catalog"),exports);var js_sdk_1=require("@partium/js-sdk");Object.defineProperty(exports,"Partium",{enumerable:!0,get:function(){return js_sdk_1.Partium}}),Object.defineProperty(exports,"INITIALIZATION_STATUS",{enumerable:!0,get:function(){return js_sdk_1.INITIALIZATION_STATUS}});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@partium/cordova-sdk",
+  "version": "14.0.0",
+  "description": "The Partium Find SDK enables integration of Partium’s parts and materials search capabilities into Cordova-based applications.",
+  "author": "Partium Inc.",
+  "license": "See LICENSE.txt",
+  "keywords": [
+    "partium find sdk",
+    "part search",
+    "material search",
+    "visual search",
+    "image search",
+    "text search",
+    "semantic search",
+    "bill of materials search"
+  ],
+  "typings": "index.d.ts",
+  "scripts": {
+    "clean": "npx rimraf -- node_modules package-lock.json && npm i"
+  },
+  "dependencies": {
+    "@partium/js-sdk": "14.0.0",
+    "rxjs": "~7.8.1"
+  },
+  "devDependencies": {
+    "typescript": "~5.5.4"
+  },
+  "peerDependencies": {
+    "cordova": "~12",
+    "cordova-plugin-app-version": "~0.1.14",
+    "cordova-plugin-device": "~3.0.0",
+    "cordova-plugin-network-information": "~3.0.0",
+    "rxjs": "~7.8.1"
+  }
+}