npm - @drttix/drt-sdk - Versions diffs - 0.6.0 → 0.6.2 - Mend

@drttix/drt-sdk 0.6.0 → 0.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/demo/test.html +240 -0
package/dist/cjs/src/functions/sdkConfig.d.ts +55 -0
package/dist/cjs/src/functions/sdkConfig.js +111 -0
package/dist/cjs/src/generated/portal/core/OpenAPI.js +1 -1
package/dist/esm/src/functions/sdkConfig.d.ts +55 -0
package/dist/esm/src/functions/sdkConfig.js +103 -0
package/dist/esm/src/generated/portal/core/OpenAPI.js +1 -1
package/package.json +1 -1
package/src/functions/sdkConfig.ts +132 -0
package/src/generated/portal/core/OpenAPI.ts +1 -1

package/demo/test.html ADDED Viewed

@@ -0,0 +1,240 @@
+<!doctype html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <title>DRT SDK Test Page</title>
+        <style>
+            body {
+                font-family: system-ui, sans-serif;
+                max-width: 900px;
+                margin: 2rem auto;
+                padding: 0 1rem;
+            }
+            h1 {
+                color: #333;
+            }
+            h2 {
+                color: #555;
+                margin-top: 2rem;
+            }
+            button {
+                padding: 0.5rem 1rem;
+                font-size: 1rem;
+                cursor: pointer;
+                margin: 0.25rem;
+            }
+            pre {
+                background: #f4f4f4;
+                padding: 1rem;
+                overflow: auto;
+                border-radius: 4px;
+                max-height: 400px;
+            }
+            .success {
+                color: green;
+            }
+            .error {
+                color: red;
+            }
+            #status {
+                margin: 1rem 0;
+                font-weight: bold;
+            }
+            .config-form {
+                background: #f9f9f9;
+                padding: 1rem;
+                border-radius: 4px;
+                margin-bottom: 1rem;
+            }
+            .config-form label {
+                display: block;
+                margin: 0.5rem 0 0.25rem;
+            }
+            .config-form input {
+                width: 100%;
+                padding: 0.5rem;
+                font-size: 1rem;
+                box-sizing: border-box;
+            }
+        </style>
+    </head>
+    <body>
+        <h1>DRT SDK Test Page</h1>
+        <h2>1. Initialize SDK</h2>
+        <div class="config-form">
+            <label for="shopperGuid">Shopper GUID:</label>
+            <input
+                type="text"
+                id="shopperGuid"
+                placeholder="e.g., F1199DCD-BB45-4BD0-8DED600A3A234C75"
+            />
+            <label for="accountId">Account ID:</label>
+            <input type="text" id="accountId" placeholder="e.g., 508" />
+            <label for="apiKey">API Key:</label>
+            <input type="text" id="apiKey" placeholder="e.g., your-api-key" />
+            <button id="btn-init" style="margin-top: 1rem">
+                Initialize SDK
+            </button>
+        </div>
+        <h2>2. Test API Calls</h2>
+        <p>
+            After initializing, these calls will automatically use your
+            credentials.
+        </p>
+        <div>
+            <button id="btn-check-sdk">Check SDK Status</button>
+            <button id="btn-strings">Get Scanner Strings (no auth)</button>
+            <button id="btn-theme">Get Theme (requires auth)</button>
+        </div>
+        <div id="status"></div>
+        <pre id="output">
+Initialize the SDK above, then click a button to test...</pre
+        >
+        <script type="module">
+            import { DRT } from '../dist/esm/index.js';
+            const out = document.getElementById('output');
+            const status = document.getElementById('status');
+            function setStatus(msg, isError = false) {
+                status.textContent = msg;
+                status.className = isError ? 'error' : 'success';
+            }
+            function setOutput(data) {
+                out.textContent =
+                    typeof data === 'string'
+                        ? data
+                        : JSON.stringify(data, null, 2);
+            }
+            // Expose DRT globally for console testing
+            window.DRT = DRT;
+            // Initialize SDK
+            document
+                .getElementById('btn-init')
+                .addEventListener('click', () => {
+                    const shopperGuid = document
+                        .getElementById('shopperGuid')
+                        .value.trim();
+                    const accountId = document
+                        .getElementById('accountId')
+                        .value.trim();
+                    const apiKey = document
+                        .getElementById('apiKey')
+                        .value.trim();
+                    if (!shopperGuid || !accountId || !apiKey) {
+                        setStatus('Please fill in all fields', true);
+                        return;
+                    }
+                    try {
+                        DRT.init({
+                            shopperGuid,
+                            accountId,
+                            apiKey,
+                        });
+                        setStatus('SDK Initialized!', false);
+                        setOutput({
+                            message: 'SDK initialized successfully!',
+                            config: {
+                                shopperGuid,
+                                accountId,
+                                apiKey: '***', // Don't show full key
+                            },
+                        });
+                    } catch (err) {
+                        setStatus('Init failed: ' + err.message, true);
+                        setOutput({ error: err.message });
+                    }
+                });
+            // Check SDK status
+            document
+                .getElementById('btn-check-sdk')
+                .addEventListener('click', () => {
+                    setStatus('SDK Status', false);
+                    const config = DRT.getConfig();
+                    setOutput({
+                        isReady: DRT.isReady(),
+                        config: config
+                            ? {
+                                  shopperGuid: config.shopperGuid,
+                                  accountId: config.accountId,
+                                  apiKey: '***',
+                              }
+                            : null,
+                        availableServices: {
+                            shopper: Object.keys(DRT.shopper),
+                            scanner: Object.keys(DRT.scanner),
+                            portal: Object.keys(DRT.portal),
+                        },
+                    });
+                });
+            // Get scanner strings (no auth required)
+            document
+                .getElementById('btn-strings')
+                .addEventListener('click', async () => {
+                    setStatus('Fetching...', false);
+                    try {
+                        const strings =
+                            await DRT.scanner.scanning.appControllerGetStrings();
+                        setStatus('Success!', false);
+                        setOutput(strings);
+                    } catch (err) {
+                        setStatus('Error: ' + err.message, true);
+                        setOutput({
+                            error: err.message,
+                            details: err.toString(),
+                        });
+                        console.error(err);
+                    }
+                });
+            // Get theme (requires auth - credentials auto-injected after init!)
+            document
+                .getElementById('btn-theme')
+                .addEventListener('click', async () => {
+                    if (!DRT.isReady()) {
+                        setStatus(
+                            'SDK not initialized! Please initialize first.',
+                            true,
+                        );
+                        return;
+                    }
+                    setStatus('Fetching theme...', false);
+                    try {
+                        // After DRT.init(), credentials are automatically injected - no params needed!
+                        const theme = await DRT.shopper.account.getTheme();
+                        setStatus('Success!', false);
+                        setOutput(theme);
+                    } catch (err) {
+                        setStatus('Error: ' + err.message, true);
+                        setOutput({
+                            error: err.message,
+                            details: err.toString(),
+                        });
+                        console.error(err);
+                    }
+                });
+            // Auto-check on load
+            setStatus(
+                'SDK loaded! Initialize with your credentials above.',
+                false,
+            );
+            console.log('DRT SDK available at window.DRT for console testing');
+        </script>
+    </body>
+</html>

package/dist/cjs/src/functions/sdkConfig.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+export interface SDKConfig {
+    shopperGuid: string;
+    accountId: string;
+    apiKey: string;
+}
+/**
+ * Initialize the DRT SDK with credentials.
+ * Once initialized, these credentials will be automatically included
+ * in all API requests as headers.
+ *
+ * @param config - The SDK configuration containing shopperGuid, accountId, and apiKey
+ *
+ * @example
+ * ```javascript
+ * import { DRT } from '@drttix/drt-sdk';
+ *
+ * // Initialize once
+ * DRT.init({
+ *   shopperGuid: 'your-shopper-guid',
+ *   accountId: 'your-account-id',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * // Now make calls without passing credentials
+ * const theme = await DRT.shopper.account.getTheme();
+ * ```
+ */
+export declare function init(config: SDKConfig): void;
+/**
+ * Check if the SDK has been initialized with credentials.
+ */
+export declare function isReady(): boolean;
+/**
+ * Get the current SDK configuration (if initialized).
+ */
+export declare function getConfig(): SDKConfig | null;
+/**
+ * Reset the SDK configuration.
+ */
+export declare function reset(): void;
+/**
+ * Get credentials from config, throwing if not initialized.
+ * Used internally by wrapped services.
+ */
+export declare function getCredentials(): {
+    shopperGuid: string;
+    accountId: string;
+    apiKey: string;
+};
+/**
+ * Creates a proxy that auto-injects credentials for service methods.
+ * Methods that take (shopperguid, accountid, apikey, ...rest) as first 3 params
+ * will have those auto-filled from the SDK config.
+ */
+export declare function createAutoCredentialsProxy<T extends object>(service: T): T;

package/dist/cjs/src/functions/sdkConfig.js ADDED Viewed

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.init = init;
+exports.isReady = isReady;
+exports.getConfig = getConfig;
+exports.reset = reset;
+exports.getCredentials = getCredentials;
+exports.createAutoCredentialsProxy = createAutoCredentialsProxy;
+// SDK Configuration - allows initializing credentials once
+const OpenAPI_1 = require("../generated/shopper/core/OpenAPI");
+const OpenAPI_2 = require("../generated/scanner/core/OpenAPI");
+const OpenAPI_3 = require("../generated/portal/core/OpenAPI");
+let isInitialized = false;
+let currentConfig = null;
+/**
+ * Initialize the DRT SDK with credentials.
+ * Once initialized, these credentials will be automatically included
+ * in all API requests as headers.
+ *
+ * @param config - The SDK configuration containing shopperGuid, accountId, and apiKey
+ *
+ * @example
+ * ```javascript
+ * import { DRT } from '@drttix/drt-sdk';
+ *
+ * // Initialize once
+ * DRT.init({
+ *   shopperGuid: 'your-shopper-guid',
+ *   accountId: 'your-account-id',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * // Now make calls without passing credentials
+ * const theme = await DRT.shopper.account.getTheme();
+ * ```
+ */
+function init(config) {
+    if (!config.shopperGuid || !config.accountId || !config.apiKey) {
+        throw new Error('DRT SDK init requires shopperGuid, accountId, and apiKey');
+    }
+    currentConfig = config;
+    const headers = {
+        shopperguid: config.shopperGuid,
+        accountid: config.accountId,
+        apikey: config.apiKey,
+    };
+    // Set headers on all API clients
+    OpenAPI_1.OpenAPI.HEADERS = headers;
+    OpenAPI_2.OpenAPI.HEADERS = headers;
+    OpenAPI_3.OpenAPI.HEADERS = headers;
+    isInitialized = true;
+}
+/**
+ * Check if the SDK has been initialized with credentials.
+ */
+function isReady() {
+    return isInitialized;
+}
+/**
+ * Get the current SDK configuration (if initialized).
+ */
+function getConfig() {
+    return currentConfig;
+}
+/**
+ * Reset the SDK configuration.
+ */
+function reset() {
+    currentConfig = null;
+    isInitialized = false;
+    OpenAPI_1.OpenAPI.HEADERS = undefined;
+    OpenAPI_2.OpenAPI.HEADERS = undefined;
+    OpenAPI_3.OpenAPI.HEADERS = undefined;
+}
+/**
+ * Get credentials from config, throwing if not initialized.
+ * Used internally by wrapped services.
+ */
+function getCredentials() {
+    if (!currentConfig) {
+        throw new Error('DRT SDK not initialized. Call DRT.init() first.');
+    }
+    return {
+        shopperGuid: currentConfig.shopperGuid,
+        accountId: currentConfig.accountId,
+        apiKey: currentConfig.apiKey,
+    };
+}
+/**
+ * Creates a proxy that auto-injects credentials for service methods.
+ * Methods that take (shopperguid, accountid, apikey, ...rest) as first 3 params
+ * will have those auto-filled from the SDK config.
+ */
+function createAutoCredentialsProxy(service) {
+    return new Proxy(service, {
+        get(target, prop) {
+            const value = target[prop];
+            if (typeof value === 'function') {
+                return (...args) => {
+                    // If SDK is initialized, prepend credentials
+                    if (isInitialized && currentConfig) {
+                        return value.call(target, currentConfig.shopperGuid, currentConfig.accountId, currentConfig.apiKey, ...args);
+                    }
+                    // Otherwise call with original args
+                    return value.apply(target, args);
+                };
+            }
+            return value;
+        },
+    });
+}

package/dist/cjs/src/generated/portal/core/OpenAPI.js CHANGED Viewed

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenAPI = void 0;
 exports.OpenAPI = {
     BASE: '',
-    VERSION: '20260318.1',
+    VERSION: '20260319.1',
     WITH_CREDENTIALS: false,
     CREDENTIALS: 'include',
     TOKEN: undefined,

package/dist/esm/src/functions/sdkConfig.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+export interface SDKConfig {
+    shopperGuid: string;
+    accountId: string;
+    apiKey: string;
+}
+/**
+ * Initialize the DRT SDK with credentials.
+ * Once initialized, these credentials will be automatically included
+ * in all API requests as headers.
+ *
+ * @param config - The SDK configuration containing shopperGuid, accountId, and apiKey
+ *
+ * @example
+ * ```javascript
+ * import { DRT } from '@drttix/drt-sdk';
+ *
+ * // Initialize once
+ * DRT.init({
+ *   shopperGuid: 'your-shopper-guid',
+ *   accountId: 'your-account-id',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * // Now make calls without passing credentials
+ * const theme = await DRT.shopper.account.getTheme();
+ * ```
+ */
+export declare function init(config: SDKConfig): void;
+/**
+ * Check if the SDK has been initialized with credentials.
+ */
+export declare function isReady(): boolean;
+/**
+ * Get the current SDK configuration (if initialized).
+ */
+export declare function getConfig(): SDKConfig | null;
+/**
+ * Reset the SDK configuration.
+ */
+export declare function reset(): void;
+/**
+ * Get credentials from config, throwing if not initialized.
+ * Used internally by wrapped services.
+ */
+export declare function getCredentials(): {
+    shopperGuid: string;
+    accountId: string;
+    apiKey: string;
+};
+/**
+ * Creates a proxy that auto-injects credentials for service methods.
+ * Methods that take (shopperguid, accountid, apikey, ...rest) as first 3 params
+ * will have those auto-filled from the SDK config.
+ */
+export declare function createAutoCredentialsProxy<T extends object>(service: T): T;

package/dist/esm/src/functions/sdkConfig.js ADDED Viewed

@@ -0,0 +1,103 @@
+// SDK Configuration - allows initializing credentials once
+import { OpenAPI as ShopperAPI } from '../generated/shopper/core/OpenAPI';
+import { OpenAPI as ScannerAPI } from '../generated/scanner/core/OpenAPI';
+import { OpenAPI as PortalAPI } from '../generated/portal/core/OpenAPI';
+let isInitialized = false;
+let currentConfig = null;
+/**
+ * Initialize the DRT SDK with credentials.
+ * Once initialized, these credentials will be automatically included
+ * in all API requests as headers.
+ *
+ * @param config - The SDK configuration containing shopperGuid, accountId, and apiKey
+ *
+ * @example
+ * ```javascript
+ * import { DRT } from '@drttix/drt-sdk';
+ *
+ * // Initialize once
+ * DRT.init({
+ *   shopperGuid: 'your-shopper-guid',
+ *   accountId: 'your-account-id',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * // Now make calls without passing credentials
+ * const theme = await DRT.shopper.account.getTheme();
+ * ```
+ */
+export function init(config) {
+    if (!config.shopperGuid || !config.accountId || !config.apiKey) {
+        throw new Error('DRT SDK init requires shopperGuid, accountId, and apiKey');
+    }
+    currentConfig = config;
+    const headers = {
+        shopperguid: config.shopperGuid,
+        accountid: config.accountId,
+        apikey: config.apiKey,
+    };
+    // Set headers on all API clients
+    ShopperAPI.HEADERS = headers;
+    ScannerAPI.HEADERS = headers;
+    PortalAPI.HEADERS = headers;
+    isInitialized = true;
+}
+/**
+ * Check if the SDK has been initialized with credentials.
+ */
+export function isReady() {
+    return isInitialized;
+}
+/**
+ * Get the current SDK configuration (if initialized).
+ */
+export function getConfig() {
+    return currentConfig;
+}
+/**
+ * Reset the SDK configuration.
+ */
+export function reset() {
+    currentConfig = null;
+    isInitialized = false;
+    ShopperAPI.HEADERS = undefined;
+    ScannerAPI.HEADERS = undefined;
+    PortalAPI.HEADERS = undefined;
+}
+/**
+ * Get credentials from config, throwing if not initialized.
+ * Used internally by wrapped services.
+ */
+export function getCredentials() {
+    if (!currentConfig) {
+        throw new Error('DRT SDK not initialized. Call DRT.init() first.');
+    }
+    return {
+        shopperGuid: currentConfig.shopperGuid,
+        accountId: currentConfig.accountId,
+        apiKey: currentConfig.apiKey,
+    };
+}
+/**
+ * Creates a proxy that auto-injects credentials for service methods.
+ * Methods that take (shopperguid, accountid, apikey, ...rest) as first 3 params
+ * will have those auto-filled from the SDK config.
+ */
+export function createAutoCredentialsProxy(service) {
+    return new Proxy(service, {
+        get(target, prop) {
+            const value = target[prop];
+            if (typeof value === 'function') {
+                return (...args) => {
+                    // If SDK is initialized, prepend credentials
+                    if (isInitialized && currentConfig) {
+                        return value.call(target, currentConfig.shopperGuid, currentConfig.accountId, currentConfig.apiKey, ...args);
+                    }
+                    // Otherwise call with original args
+                    return value.apply(target, args);
+                };
+            }
+            return value;
+        },
+    });
+}

package/dist/esm/src/generated/portal/core/OpenAPI.js CHANGED Viewed

@@ -1,6 +1,6 @@
 export const OpenAPI = {
     BASE: '',
-    VERSION: '20260318.1',
+    VERSION: '20260319.1',
     WITH_CREDENTIALS: false,
     CREDENTIALS: 'include',
     TOKEN: undefined,

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
     "name": "@drttix/drt-sdk",
     "description": "DRT SDK",
-    "version": "0.6.0",
+    "version": "0.6.2",
     "main": "dist/cjs/index.js",
     "module": "dist/esm/index.js",
     "types": "dist/esm/index.d.ts",

package/src/functions/sdkConfig.ts ADDED Viewed

@@ -0,0 +1,132 @@
+// SDK Configuration - allows initializing credentials once
+import { OpenAPI as ShopperAPI } from '../generated/shopper/core/OpenAPI';
+import { OpenAPI as ScannerAPI } from '../generated/scanner/core/OpenAPI';
+import { OpenAPI as PortalAPI } from '../generated/portal/core/OpenAPI';
+export interface SDKConfig {
+    shopperGuid: string;
+    accountId: string;
+    apiKey: string;
+}
+let isInitialized = false;
+let currentConfig: SDKConfig | null = null;
+/**
+ * Initialize the DRT SDK with credentials.
+ * Once initialized, these credentials will be automatically included
+ * in all API requests as headers.
+ *
+ * @param config - The SDK configuration containing shopperGuid, accountId, and apiKey
+ *
+ * @example
+ * ```javascript
+ * import { DRT } from '@drttix/drt-sdk';
+ *
+ * // Initialize once
+ * DRT.init({
+ *   shopperGuid: 'your-shopper-guid',
+ *   accountId: 'your-account-id',
+ *   apiKey: 'your-api-key'
+ * });
+ *
+ * // Now make calls without passing credentials
+ * const theme = await DRT.shopper.account.getTheme();
+ * ```
+ */
+export function init(config: SDKConfig): void {
+    if (!config.shopperGuid || !config.accountId || !config.apiKey) {
+        throw new Error(
+            'DRT SDK init requires shopperGuid, accountId, and apiKey',
+        );
+    }
+    currentConfig = config;
+    const headers = {
+        shopperguid: config.shopperGuid,
+        accountid: config.accountId,
+        apikey: config.apiKey,
+    };
+    // Set headers on all API clients
+    ShopperAPI.HEADERS = headers;
+    ScannerAPI.HEADERS = headers;
+    PortalAPI.HEADERS = headers;
+    isInitialized = true;
+}
+/**
+ * Check if the SDK has been initialized with credentials.
+ */
+export function isReady(): boolean {
+    return isInitialized;
+}
+/**
+ * Get the current SDK configuration (if initialized).
+ */
+export function getConfig(): SDKConfig | null {
+    return currentConfig;
+}
+/**
+ * Reset the SDK configuration.
+ */
+export function reset(): void {
+    currentConfig = null;
+    isInitialized = false;
+    ShopperAPI.HEADERS = undefined;
+    ScannerAPI.HEADERS = undefined;
+    PortalAPI.HEADERS = undefined;
+}
+/**
+ * Get credentials from config, throwing if not initialized.
+ * Used internally by wrapped services.
+ */
+export function getCredentials(): {
+    shopperGuid: string;
+    accountId: string;
+    apiKey: string;
+} {
+    if (!currentConfig) {
+        throw new Error('DRT SDK not initialized. Call DRT.init() first.');
+    }
+    return {
+        shopperGuid: currentConfig.shopperGuid,
+        accountId: currentConfig.accountId,
+        apiKey: currentConfig.apiKey,
+    };
+}
+/**
+ * Creates a proxy that auto-injects credentials for service methods.
+ * Methods that take (shopperguid, accountid, apikey, ...rest) as first 3 params
+ * will have those auto-filled from the SDK config.
+ */
+export function createAutoCredentialsProxy<T extends object>(service: T): T {
+    return new Proxy(service, {
+        get(target, prop) {
+            const value = (target as any)[prop];
+            if (typeof value === 'function') {
+                return (...args: any[]) => {
+                    // If SDK is initialized, prepend credentials
+                    if (isInitialized && currentConfig) {
+                        return value.call(
+                            target,
+                            currentConfig.shopperGuid,
+                            currentConfig.accountId,
+                            currentConfig.apiKey,
+                            ...args,
+                        );
+                    }
+                    // Otherwise call with original args
+                    return value.apply(target, args);
+                };
+            }
+            return value;
+        },
+    });
+}

package/src/generated/portal/core/OpenAPI.ts CHANGED Viewed

@@ -21,7 +21,7 @@ export type OpenAPIConfig = {
 export const OpenAPI: OpenAPIConfig = {
     BASE: '',
-    VERSION: '20260318.1',
+    VERSION: '20260319.1',
     WITH_CREDENTIALS: false,
     CREDENTIALS: 'include',
     TOKEN: undefined,