@swarm.ing/pieui 2.1.2 → 2.1.3

package/dist/util/ajaxCommonUtils.d.ts

@@ -27,23 +27,64 @@ export type GetAjaxSubmitOptions = {
     retryPolicy?: RetryPolicy;
 };
 /**
- * Reads the value(s) for a single dep name from the DOM, following the same
- * convention used by Ajax cards. Returns an array because file inputs can
- * contribute multiple values for the same key.
+ * The origin a dep value is read from. `dom` is the default for any name
+ * without a recognized prefix.
+ */
+export type DepSource = 'dom' | 'sid' | 'localStorage' | 'sessionStorage' | 'cookie' | 'url' | 'telegram:cloud' | 'telegram:secure';
+/**
+ * Splits a dep name into its source and bare key, following the magic-name
+ * convention used by Ajax cards.
+ *
+ * - `'sid'` → `{ source: 'sid', key: 'sid' }` (SocketIO session id).
+ * - `'localStorage:token'` → `{ source: 'localStorage', key: 'token' }`; the
+ *   same for `sessionStorage:`, `cookie:`, `url:`, `telegram:cloud:` and
+ *   `telegram:secure:` prefixes.
+ * - Anything else (including a name that contains a colon but no recognized
+ *   prefix) → `{ source: 'dom', key: <name> }`.
  *
+ * The returned `key` is what gets sent to the backend as the field name, so a
+ * prefixed dep is submitted under its bare key (`localStorage:token` → `token`).
+ */
+export declare const parseDepName: (depName: string) => {
+    source: DepSource;
+    key: string;
+};
+/**
+ * Reads the value(s) for a single dep name, following the same convention used
+ * by Ajax cards. Returns an array because file inputs (and cookies / repeated
+ * URL params) can contribute multiple values for the same key.
+ *
+ * The source is determined by {@link parseDepName}:
  * - `'sid'` resolves to `window.sid`. The caller must ensure SocketIO is
  *   ready (e.g. via {@link waitForSidAvailable}) before calling this.
- * - Other names are looked up via `document.getElementsByName`; only the
- *   first match is read.
- * - `<input type="file">` returns every selected `File`.
- * - Other `<input>` / `<textarea>` returns the current `.value`.
- * - Missing inputs return `[]` (and emit a warning when `renderingLogEnabled`).
+ * - `localStorage:` / `sessionStorage:` read `getItem(key)` (try/caught, since
+ *   storage access can throw in private mode); missing/blocked → `[]`.
+ * - `cookie:` reads and `decodeURIComponent`s the matching cookie; missing →
+ *   `[]`.
+ * - `url:` reads `URLSearchParams(location.search).getAll(key)` (repeated
+ *   params supported); missing → `[]`.
+ * - `telegram:cloud:` / `telegram:secure:` are asynchronous and cannot be
+ *   served here — they return `[]`. Use {@link readAjaxKeyAsync} instead (the
+ *   Ajax submit flow already does).
+ * - DOM names are looked up via `document.getElementsByName`; only the first
+ *   match is read. `<input type="file">` returns every selected `File`; other
+ *   `<input>` / `<textarea>` returns the current `.value`.
+ * - Missing values return `[]` (and emit a warning when `renderingLogEnabled`).
  *
  * Must run in a browser environment — relies on `document` and `window`.
  *
- * @throws if `depName === 'sid'` and `window.sid` is not initialized.
+ * @throws if the resolved source is `sid` and `window.sid` is not initialized.
  */
 export declare const readAjaxKey: (depName: string, renderingLogEnabled?: boolean) => Array<string | File>;
+/**
+ * Asynchronous counterpart to {@link readAjaxKey}. Behaves identically for all
+ * synchronous sources (it delegates to `readAjaxKey`) but additionally resolves
+ * the asynchronous Telegram sources (`telegram:cloud:` / `telegram:secure:`).
+ *
+ * This is what the Ajax submit flow uses so that every supported source — sync
+ * or async — can contribute values to the request.
+ */
+export declare const readAjaxKeyAsync: (depName: string, renderingLogEnabled?: boolean) => Promise<Array<string | File>>;
 /**
  * Builds an async "submit" function that issues an AJAX request to
  * `api/ajax_content{pathname}` and streams (or JSON-decodes) the response
@@ -52,8 +93,11 @@ export declare const readAjaxKey: (depName: string, renderingLogEnabled?: boolea
  * The returned function collects form data from:
  * 1. the static `kwargs` object,
  * 2. any `extraKwargs` passed at call time,
- * 3. named inputs from the DOM listed in `depsNames` (including `sid`,
- *    which is resolved via {@link waitForSidAvailable}), and
+ * 3. the dep names in `depsNames`, each resolved by {@link readAjaxKeyAsync}
+ *    from its source: DOM inputs by default, `sid` (resolved via
+ *    {@link waitForSidAvailable}), or the `localStorage:`, `sessionStorage:`,
+ *    `cookie:`, `url:`, `telegram:cloud:` and `telegram:secure:` prefixes —
+ *    submitted under the bare key, and
  * 4. file inputs (multiple files supported).
  *
  * If the server streams NDJSON, each line is parsed as a `UIEventType` and
@@ -65,8 +109,11 @@ export declare const readAjaxKey: (depName: string, renderingLogEnabled?: boolea
  *
  * @param setUiAjaxConfiguration Setter provided by the enclosing Ajax card.
  * @param kwargs                 Static key/value pairs appended to the request.
- * @param depsNames              Names of DOM inputs whose current values should
- *                               also be sent.
+ * @param depsNames              Dep names whose current values should also be
+ *                               sent. Plain names read DOM inputs; the
+ *                               `localStorage:`, `sessionStorage:`, `cookie:`,
+ *                               `url:`, `telegram:cloud:` and `telegram:secure:`
+ *                               prefixes read those client sources.
  * @param pathname               Path segment appended to `api/ajax_content`.
  * @param options                See {@link GetAjaxSubmitOptions}.
  * @returns An `async (extraKwargs?) => Promise<any>` submit function.

package/dist/util/ajaxCommonUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ajaxCommonUtils.d.ts","sourceRoot":"","sources":["../../src/util/ajaxCommonUtils.ts"],"names":[],"mappings":"AAEA,OAAO,UAAU,CAAA;AACjB,OAAO,EAAE,0BAA0B,EAAe,MAAM,UAAU,CAAA;AAKlE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kJAAkJ;IAClJ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,WAAW,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GACpB,SAAS,MAAM,EACf,sBAAqB,OAAe,KACrC,KAAK,CAAC,MAAM,GAAG,IAAI,CAyBrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,aAAa,GACtB,yBAAyB,0BAA0B,EACnD,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAChC,YAAW,KAAK,CAAC,MAAM,CAAM,EAC7B,WAAW,MAAM,EACjB,UAAU,oBAAoB,MAahB,cAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,iBAuKtD,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GACtB,yBAAyB,0BAA0B,EACnD,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAChC,YAAW,KAAK,CAAC,MAAM,CAAM,EAC7B,WAAW,MAAM,EACjB,UAAU;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,oBA7L9B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,iBAyNjD,CAAA"}
+{"version":3,"file":"ajaxCommonUtils.d.ts","sourceRoot":"","sources":["../../src/util/ajaxCommonUtils.ts"],"names":[],"mappings":"AAEA,OAAO,UAAU,CAAA;AACjB,OAAO,EAAE,0BAA0B,EAAe,MAAM,UAAU,CAAA;AAKlE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kJAAkJ;IAClJ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,WAAW,CAAA;CAC5B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GACf,KAAK,GACL,KAAK,GACL,cAAc,GACd,gBAAgB,GAChB,QAAQ,GACR,KAAK,GACL,gBAAgB,GAChB,iBAAiB,CAAA;AAmBvB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GACrB,SAAS,MAAM,KAChB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAWlC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,WAAW,GACpB,SAAS,MAAM,EACf,sBAAqB,OAAe,KACrC,KAAK,CAAC,MAAM,GAAG,IAAI,CA6ErB,CAAA;AA6ED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GACzB,SAAS,MAAM,EACf,sBAAqB,OAAe,KACrC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAM9B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,aAAa,GACtB,yBAAyB,0BAA0B,EACnD,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAChC,YAAW,KAAK,CAAC,MAAM,CAAM,EAC7B,WAAW,MAAM,EACjB,UAAU,oBAAoB,MAahB,cAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,iBA2KtD,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GACtB,yBAAyB,0BAA0B,EACnD,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAChC,YAAW,KAAK,CAAC,MAAM,CAAM,EAC7B,WAAW,MAAM,EACjB,UAAU;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,oBAjM9B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,iBA6NjD,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@swarm.ing/pieui",
-    "version": "2.1.2",
+    "version": "2.1.3",
     "description": "A React component library featuring PieCard component",
     "repository": {
         "type": "git",
@@ -61,7 +61,7 @@
         }
     },
     "scripts": {
-        "build": "rm -rf ./dist && rm -rf pieui-*.tgz && bun run build:clean && NODE_ENV=production bun run build:esm && NODE_ENV=production bun run build:cjs && NODE_ENV=production bun run build:components:esm && NODE_ENV=production bun run build:components:cjs && NODE_ENV=production bun run build:agent:esm && NODE_ENV=production bun run build:agent:cjs && NODE_ENV=production bun run build:telegram:esm && NODE_ENV=production bun run build:telegram:cjs && NODE_ENV=production bun run build:max:esm && NODE_ENV=production bun run build:max:cjs && NODE_ENV=production bun run build:storybook:esm && NODE_ENV=production bun run build:storybook:cjs && NODE_ENV=production bun run build:storybook:addon:esm && NODE_ENV=production bun run build:storybook:addon:cjs && NODE_ENV=production bun run build:storybook:addon:preset && bun run build:banner && NODE_ENV=production bun run build:types && NODE_ENV=production bun run build:cli && bun src/cli.ts postbuild --src-dir src --out-dir dist && bun pm pack",
+        "build": "rm -rf ./dist && rm -rf pieui-*.tgz && bun run build:clean && NODE_ENV=production bun run build:esm && NODE_ENV=production bun run build:cjs && NODE_ENV=production bun run build:components:esm && NODE_ENV=production bun run build:components:cjs && NODE_ENV=production bun run build:agent:esm && NODE_ENV=production bun run build:agent:cjs && NODE_ENV=production bun run build:telegram:esm && NODE_ENV=production bun run build:telegram:cjs && NODE_ENV=production bun run build:max:esm && NODE_ENV=production bun run build:max:cjs && NODE_ENV=production bun run build:storybook:esm && NODE_ENV=production bun run build:storybook:cjs && NODE_ENV=production bun run build:storybook:addon:esm && NODE_ENV=production bun run build:storybook:addon:cjs && NODE_ENV=production bun run build:storybook:addon:manager:esm && NODE_ENV=production bun run build:storybook:addon:manager:cjs && NODE_ENV=production bun run build:storybook:addon:preset && bun run build:banner && NODE_ENV=production bun run build:types && NODE_ENV=production bun run build:cli && bun src/cli.ts postbuild --src-dir src --out-dir dist && bun pm pack",
         "build:banner": "node -e \"const fs=require('fs');['dist/index.esm.js','dist/index.js','dist/components/index.esm.js','dist/components/index.js','dist/agent/index.esm.js','dist/agent/index.js','dist/telegram/index.esm.js','dist/telegram/index.js','dist/max/index.esm.js','dist/max/index.js','dist/storybook/index.esm.js','dist/storybook/index.js','dist/storybook/addon/index.esm.js','dist/storybook/addon/index.js'].forEach(f=>{if(fs.existsSync(f)){fs.writeFileSync(f,'\\\"use client\\\";\\n'+fs.readFileSync(f,'utf8'))}})\"",
         "build:clean": "rm -rf dist",
         "build:esm": "bun build src/index.ts --outfile dist/index.esm.js --format esm --target browser --jsx=automatic --jsx-import-source=react --minify --packages=external",

package/dist/components/Common/CloudStorageCard/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Common/CloudStorageCard/index.ts"],"names":[],"mappings":";AAGA,wBAIE"}

package/dist/components/Common/CloudStorageCard/types/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/Common/CloudStorageCard/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IAEb,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB,CAAC,oBAAoB,CAAC;CAAG"}

package/dist/components/Common/CloudStorageCard/ui/CloudStorageCard.d.ts

@@ -1,4 +0,0 @@
-import { CloudStorageCardProps } from '../types';
-declare const CloudStorageCard: ({ data }: CloudStorageCardProps) => import("react").JSX.Element;
-export default CloudStorageCard;
-//# sourceMappingURL=CloudStorageCard.d.ts.map

package/dist/components/Common/CloudStorageCard/ui/CloudStorageCard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CloudStorageCard.d.ts","sourceRoot":"","sources":["../../../../../src/components/Common/CloudStorageCard/ui/CloudStorageCard.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAGhD,QAAA,MAAM,gBAAgB,GAAI,UAAU,qBAAqB,gCA6CxD,CAAA;AAED,eAAe,gBAAgB,CAAA"}

package/dist/components/Common/SecureStorageCard/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/Common/SecureStorageCard/index.ts"],"names":[],"mappings":";AAGA,wBAIE"}

package/dist/components/Common/SecureStorageCard/types/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/Common/SecureStorageCard/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IAEb,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB,CAAC,qBAAqB,CAAC;CAAG"}

package/dist/components/Common/SecureStorageCard/ui/SecureStorageCard.d.ts

@@ -1,4 +0,0 @@
-import { SecureStorageCardProps } from '../types';
-declare const SecureStorageCard: ({ data }: SecureStorageCardProps) => import("react").JSX.Element;
-export default SecureStorageCard;
-//# sourceMappingURL=SecureStorageCard.d.ts.map

package/dist/components/Common/SecureStorageCard/ui/SecureStorageCard.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SecureStorageCard.d.ts","sourceRoot":"","sources":["../../../../../src/components/Common/SecureStorageCard/ui/SecureStorageCard.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAGjD,QAAA,MAAM,iBAAiB,GAAI,UAAU,sBAAsB,gCA6C1D,CAAA;AAED,eAAe,iBAAiB,CAAA"}