@x12i/provider-metadata 1.0.0

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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 x12i
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,57 @@
1
+ # @x12i/provider-metadata
2
+
3
+ Pack and open one metadata record. The keys are whatever the caller stored.
4
+
5
+ `packMetadata` writes the same object for every provider. `openMetadata` reads that object back. A reader passes the log object and gets every stored pair, for any provider and any set of keys.
6
+
7
+ The package runs on Node 20 or newer and publishes ESM and CommonJS from the same entry.
8
+
9
+ ## Install
10
+
11
+ ```bash
12
+ npm install @x12i/provider-metadata
13
+ ```
14
+
15
+ ## Pack and open
16
+
17
+ ```ts
18
+ import { openMetadata, packMetadata } from "@x12i/provider-metadata";
19
+
20
+ const wire = packMetadata({
21
+ objectType: "finding",
22
+ stepId: "nx-p1-context-finding",
23
+ agentId: "neo-networks-v2",
24
+ skillId: "skill-9",
25
+ recordId: "rec-1"
26
+ });
27
+
28
+ const record = openMetadata(wire);
29
+ ```
30
+
31
+ `record` is the full string map. Another caller map, with different keys, packs and opens the same way.
32
+
33
+ `packMetadata(...layers)` accepts `Record<string, unknown> | undefined`. Later layers win on the same key. String, number, and boolean values are stored. A number becomes its decimal string, and a boolean becomes `"true"` or `"false"`. Objects and arrays are omitted. When a later value is an object or array, the earlier scalar for that key stays. An empty result is `undefined`.
34
+
35
+ ## Wire object
36
+
37
+ The stored value is UTF-8 JSON of the string map, with keys sorted, then base64. That base64 string is split into `m.0`, `m.1`, and so on.
38
+
39
+ | Constant | Value |
40
+ | --- | --- |
41
+ | `PROVIDER_METADATA_CHUNK_SIZE` | 256 characters |
42
+ | `PROVIDER_METADATA_MAX_CHUNKS` | 16 |
43
+
44
+ A larger record throws `METADATA_RECORD_TOO_LARGE` (4096 base64 characters).
45
+
46
+ `openMetadata` joins `m.0`, `m.1`, … in order, decodes the base64, and returns every string in that JSON object. A missing record, or a value that is not an object, returns `{}`.
47
+
48
+ These provider slots hold that same object:
49
+
50
+ | Provider | Log field |
51
+ | --- | --- |
52
+ | OpenRouter | Body `metadata` |
53
+ | OpenAI | Responses body `metadata` |
54
+ | Bedrock | `requestMetadata` |
55
+ | Cloudflare | Body `metadata` and the `cf-aig-metadata` header |
56
+
57
+ `@x12i/ai-dispatcher` calls `packMetadata` for the caller. The caller sends one map on the request. The dispatcher writes this object onto the provider that runs the call.
package/dist/index.cjs ADDED
@@ -0,0 +1,100 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/index.ts
21
+ var index_exports = {};
22
+ __export(index_exports, {
23
+ PROVIDER_METADATA_CHUNK_SIZE: () => PROVIDER_METADATA_CHUNK_SIZE,
24
+ PROVIDER_METADATA_MAX_CHUNKS: () => PROVIDER_METADATA_MAX_CHUNKS,
25
+ openMetadata: () => openMetadata,
26
+ packMetadata: () => packMetadata
27
+ });
28
+ module.exports = __toCommonJS(index_exports);
29
+ var PROVIDER_METADATA_CHUNK_SIZE = 256;
30
+ var PROVIDER_METADATA_MAX_CHUNKS = 16;
31
+ var MAX_ENCODED_LENGTH = PROVIDER_METADATA_CHUNK_SIZE * PROVIDER_METADATA_MAX_CHUNKS;
32
+ function packMetadata(...layers) {
33
+ const map = {};
34
+ for (const layer of layers) {
35
+ if (!layer) continue;
36
+ for (const [key, value] of Object.entries(layer)) {
37
+ const asString = asMetadataString(value);
38
+ if (asString !== void 0) map[key] = asString;
39
+ }
40
+ }
41
+ return encodeProviderRecord(map);
42
+ }
43
+ function openMetadata(wire) {
44
+ if (!isRecord(wire)) return {};
45
+ const parts = [];
46
+ for (let index = 0; ; index += 1) {
47
+ const chunk = wire[`m.${index}`];
48
+ if (typeof chunk !== "string") break;
49
+ parts.push(chunk);
50
+ }
51
+ if (!parts.length) return {};
52
+ const parsed = JSON.parse(Buffer.from(parts.join(""), "base64").toString("utf8"));
53
+ if (!isRecord(parsed)) return {};
54
+ const record = {};
55
+ for (const [key, value] of Object.entries(parsed)) {
56
+ if (typeof value === "string") record[key] = value;
57
+ }
58
+ return record;
59
+ }
60
+ function encodeProviderRecord(map) {
61
+ const keys = Object.keys(map).sort();
62
+ if (!keys.length) return void 0;
63
+ const ordered = {};
64
+ for (const key of keys) {
65
+ const value = map[key];
66
+ if (value !== void 0) ordered[key] = value;
67
+ }
68
+ const encoded = Buffer.from(JSON.stringify(ordered), "utf8").toString("base64");
69
+ const chunks = Math.ceil(encoded.length / PROVIDER_METADATA_CHUNK_SIZE);
70
+ if (chunks > PROVIDER_METADATA_MAX_CHUNKS) {
71
+ throw new Error(
72
+ `METADATA_RECORD_TOO_LARGE: provider metadata is ${encoded.length} base64 characters; the maximum is ${MAX_ENCODED_LENGTH}.`
73
+ );
74
+ }
75
+ const wire = {};
76
+ for (let index = 0; index < chunks; index += 1) {
77
+ wire[`m.${index}`] = encoded.slice(
78
+ index * PROVIDER_METADATA_CHUNK_SIZE,
79
+ (index + 1) * PROVIDER_METADATA_CHUNK_SIZE
80
+ );
81
+ }
82
+ return wire;
83
+ }
84
+ function asMetadataString(value) {
85
+ if (typeof value === "string") return value;
86
+ if (typeof value === "boolean") return value ? "true" : "false";
87
+ if (typeof value === "number" && Number.isFinite(value)) return String(value);
88
+ return void 0;
89
+ }
90
+ function isRecord(value) {
91
+ return typeof value === "object" && value !== null && !Array.isArray(value);
92
+ }
93
+ // Annotate the CommonJS export names for ESM import in node:
94
+ 0 && (module.exports = {
95
+ PROVIDER_METADATA_CHUNK_SIZE,
96
+ PROVIDER_METADATA_MAX_CHUNKS,
97
+ openMetadata,
98
+ packMetadata
99
+ });
100
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["export const PROVIDER_METADATA_CHUNK_SIZE = 256;\r\nexport const PROVIDER_METADATA_MAX_CHUNKS = 16;\r\n\r\nconst MAX_ENCODED_LENGTH = PROVIDER_METADATA_CHUNK_SIZE * PROVIDER_METADATA_MAX_CHUNKS;\r\n\r\n/**\r\n * Packs caller maps into one provider metadata object.\r\n * Later layers win on the same key. String, number, and boolean values are stored.\r\n * Numbers and booleans are stored as their string form. Objects and arrays are omitted.\r\n * An empty result is `undefined`.\r\n * The packed object is the same for every provider: `m.0`, `m.1`, and so on.\r\n */\r\nexport function packMetadata(\r\n ...layers: Array<Record<string, unknown> | undefined>\r\n): Record<string, string> | undefined {\r\n const map: Record<string, string> = {};\r\n for (const layer of layers) {\r\n if (!layer) continue;\r\n for (const [key, value] of Object.entries(layer)) {\r\n const asString = asMetadataString(value);\r\n if (asString !== undefined) map[key] = asString;\r\n }\r\n }\r\n return encodeProviderRecord(map);\r\n}\r\n\r\n/**\r\n * Opens the `m.0`, `m.1`, ... object from a provider log.\r\n * Returns every stored pair. A missing record returns `{}`.\r\n */\r\nexport function openMetadata(wire: unknown): Record<string, string> {\r\n if (!isRecord(wire)) return {};\r\n const parts: string[] = [];\r\n for (let index = 0; ; index += 1) {\r\n const chunk = wire[`m.${index}`];\r\n if (typeof chunk !== \"string\") break;\r\n parts.push(chunk);\r\n }\r\n if (!parts.length) return {};\r\n const parsed: unknown = JSON.parse(Buffer.from(parts.join(\"\"), \"base64\").toString(\"utf8\"));\r\n if (!isRecord(parsed)) return {};\r\n const record: Record<string, string> = {};\r\n for (const [key, value] of Object.entries(parsed)) {\r\n if (typeof value === \"string\") record[key] = value;\r\n }\r\n return record;\r\n}\r\n\r\nfunction encodeProviderRecord(map: Record<string, string>): Record<string, string> | undefined {\r\n const keys = Object.keys(map).sort();\r\n if (!keys.length) return undefined;\r\n const ordered: Record<string, string> = {};\r\n for (const key of keys) {\r\n const value = map[key];\r\n if (value !== undefined) ordered[key] = value;\r\n }\r\n const encoded = Buffer.from(JSON.stringify(ordered), \"utf8\").toString(\"base64\");\r\n const chunks = Math.ceil(encoded.length / PROVIDER_METADATA_CHUNK_SIZE);\r\n if (chunks > PROVIDER_METADATA_MAX_CHUNKS) {\r\n throw new Error(\r\n `METADATA_RECORD_TOO_LARGE: provider metadata is ${encoded.length} base64 characters; the maximum is ${MAX_ENCODED_LENGTH}.`\r\n );\r\n }\r\n const wire: Record<string, string> = {};\r\n for (let index = 0; index < chunks; index += 1) {\r\n wire[`m.${index}`] = encoded.slice(\r\n index * PROVIDER_METADATA_CHUNK_SIZE,\r\n (index + 1) * PROVIDER_METADATA_CHUNK_SIZE\r\n );\r\n }\r\n return wire;\r\n}\r\n\r\nfunction asMetadataString(value: unknown): string | undefined {\r\n if (typeof value === \"string\") return value;\r\n if (typeof value === \"boolean\") return value ? \"true\" : \"false\";\r\n if (typeof value === \"number\" && Number.isFinite(value)) return String(value);\r\n return undefined;\r\n}\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,IAAM,+BAA+B;AACrC,IAAM,+BAA+B;AAE5C,IAAM,qBAAqB,+BAA+B;AASnD,SAAS,gBACX,QACiC;AACpC,QAAM,MAA8B,CAAC;AACrC,aAAW,SAAS,QAAQ;AAC1B,QAAI,CAAC,MAAO;AACZ,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,YAAM,WAAW,iBAAiB,KAAK;AACvC,UAAI,aAAa,OAAW,KAAI,GAAG,IAAI;AAAA,IACzC;AAAA,EACF;AACA,SAAO,qBAAqB,GAAG;AACjC;AAMO,SAAS,aAAa,MAAuC;AAClE,MAAI,CAAC,SAAS,IAAI,EAAG,QAAO,CAAC;AAC7B,QAAM,QAAkB,CAAC;AACzB,WAAS,QAAQ,KAAK,SAAS,GAAG;AAChC,UAAM,QAAQ,KAAK,KAAK,KAAK,EAAE;AAC/B,QAAI,OAAO,UAAU,SAAU;AAC/B,UAAM,KAAK,KAAK;AAAA,EAClB;AACA,MAAI,CAAC,MAAM,OAAQ,QAAO,CAAC;AAC3B,QAAM,SAAkB,KAAK,MAAM,OAAO,KAAK,MAAM,KAAK,EAAE,GAAG,QAAQ,EAAE,SAAS,MAAM,CAAC;AACzF,MAAI,CAAC,SAAS,MAAM,EAAG,QAAO,CAAC;AAC/B,QAAM,SAAiC,CAAC;AACxC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,QAAI,OAAO,UAAU,SAAU,QAAO,GAAG,IAAI;AAAA,EAC/C;AACA,SAAO;AACT;AAEA,SAAS,qBAAqB,KAAiE;AAC7F,QAAM,OAAO,OAAO,KAAK,GAAG,EAAE,KAAK;AACnC,MAAI,CAAC,KAAK,OAAQ,QAAO;AACzB,QAAM,UAAkC,CAAC;AACzC,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,IAAI,GAAG;AACrB,QAAI,UAAU,OAAW,SAAQ,GAAG,IAAI;AAAA,EAC1C;AACA,QAAM,UAAU,OAAO,KAAK,KAAK,UAAU,OAAO,GAAG,MAAM,EAAE,SAAS,QAAQ;AAC9E,QAAM,SAAS,KAAK,KAAK,QAAQ,SAAS,4BAA4B;AACtE,MAAI,SAAS,8BAA8B;AACzC,UAAM,IAAI;AAAA,MACR,mDAAmD,QAAQ,MAAM,sCAAsC,kBAAkB;AAAA,IAC3H;AAAA,EACF;AACA,QAAM,OAA+B,CAAC;AACtC,WAAS,QAAQ,GAAG,QAAQ,QAAQ,SAAS,GAAG;AAC9C,SAAK,KAAK,KAAK,EAAE,IAAI,QAAQ;AAAA,MAC3B,QAAQ;AAAA,OACP,QAAQ,KAAK;AAAA,IAChB;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,OAAoC;AAC5D,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,UAAW,QAAO,QAAQ,SAAS;AACxD,MAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,EAAG,QAAO,OAAO,KAAK;AAC5E,SAAO;AACT;AAEA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;","names":[]}
@@ -0,0 +1,17 @@
1
+ declare const PROVIDER_METADATA_CHUNK_SIZE = 256;
2
+ declare const PROVIDER_METADATA_MAX_CHUNKS = 16;
3
+ /**
4
+ * Packs caller maps into one provider metadata object.
5
+ * Later layers win on the same key. String, number, and boolean values are stored.
6
+ * Numbers and booleans are stored as their string form. Objects and arrays are omitted.
7
+ * An empty result is `undefined`.
8
+ * The packed object is the same for every provider: `m.0`, `m.1`, and so on.
9
+ */
10
+ declare function packMetadata(...layers: Array<Record<string, unknown> | undefined>): Record<string, string> | undefined;
11
+ /**
12
+ * Opens the `m.0`, `m.1`, ... object from a provider log.
13
+ * Returns every stored pair. A missing record returns `{}`.
14
+ */
15
+ declare function openMetadata(wire: unknown): Record<string, string>;
16
+
17
+ export { PROVIDER_METADATA_CHUNK_SIZE, PROVIDER_METADATA_MAX_CHUNKS, openMetadata, packMetadata };
@@ -0,0 +1,17 @@
1
+ declare const PROVIDER_METADATA_CHUNK_SIZE = 256;
2
+ declare const PROVIDER_METADATA_MAX_CHUNKS = 16;
3
+ /**
4
+ * Packs caller maps into one provider metadata object.
5
+ * Later layers win on the same key. String, number, and boolean values are stored.
6
+ * Numbers and booleans are stored as their string form. Objects and arrays are omitted.
7
+ * An empty result is `undefined`.
8
+ * The packed object is the same for every provider: `m.0`, `m.1`, and so on.
9
+ */
10
+ declare function packMetadata(...layers: Array<Record<string, unknown> | undefined>): Record<string, string> | undefined;
11
+ /**
12
+ * Opens the `m.0`, `m.1`, ... object from a provider log.
13
+ * Returns every stored pair. A missing record returns `{}`.
14
+ */
15
+ declare function openMetadata(wire: unknown): Record<string, string>;
16
+
17
+ export { PROVIDER_METADATA_CHUNK_SIZE, PROVIDER_METADATA_MAX_CHUNKS, openMetadata, packMetadata };
package/dist/index.js ADDED
@@ -0,0 +1,72 @@
1
+ // src/index.ts
2
+ var PROVIDER_METADATA_CHUNK_SIZE = 256;
3
+ var PROVIDER_METADATA_MAX_CHUNKS = 16;
4
+ var MAX_ENCODED_LENGTH = PROVIDER_METADATA_CHUNK_SIZE * PROVIDER_METADATA_MAX_CHUNKS;
5
+ function packMetadata(...layers) {
6
+ const map = {};
7
+ for (const layer of layers) {
8
+ if (!layer) continue;
9
+ for (const [key, value] of Object.entries(layer)) {
10
+ const asString = asMetadataString(value);
11
+ if (asString !== void 0) map[key] = asString;
12
+ }
13
+ }
14
+ return encodeProviderRecord(map);
15
+ }
16
+ function openMetadata(wire) {
17
+ if (!isRecord(wire)) return {};
18
+ const parts = [];
19
+ for (let index = 0; ; index += 1) {
20
+ const chunk = wire[`m.${index}`];
21
+ if (typeof chunk !== "string") break;
22
+ parts.push(chunk);
23
+ }
24
+ if (!parts.length) return {};
25
+ const parsed = JSON.parse(Buffer.from(parts.join(""), "base64").toString("utf8"));
26
+ if (!isRecord(parsed)) return {};
27
+ const record = {};
28
+ for (const [key, value] of Object.entries(parsed)) {
29
+ if (typeof value === "string") record[key] = value;
30
+ }
31
+ return record;
32
+ }
33
+ function encodeProviderRecord(map) {
34
+ const keys = Object.keys(map).sort();
35
+ if (!keys.length) return void 0;
36
+ const ordered = {};
37
+ for (const key of keys) {
38
+ const value = map[key];
39
+ if (value !== void 0) ordered[key] = value;
40
+ }
41
+ const encoded = Buffer.from(JSON.stringify(ordered), "utf8").toString("base64");
42
+ const chunks = Math.ceil(encoded.length / PROVIDER_METADATA_CHUNK_SIZE);
43
+ if (chunks > PROVIDER_METADATA_MAX_CHUNKS) {
44
+ throw new Error(
45
+ `METADATA_RECORD_TOO_LARGE: provider metadata is ${encoded.length} base64 characters; the maximum is ${MAX_ENCODED_LENGTH}.`
46
+ );
47
+ }
48
+ const wire = {};
49
+ for (let index = 0; index < chunks; index += 1) {
50
+ wire[`m.${index}`] = encoded.slice(
51
+ index * PROVIDER_METADATA_CHUNK_SIZE,
52
+ (index + 1) * PROVIDER_METADATA_CHUNK_SIZE
53
+ );
54
+ }
55
+ return wire;
56
+ }
57
+ function asMetadataString(value) {
58
+ if (typeof value === "string") return value;
59
+ if (typeof value === "boolean") return value ? "true" : "false";
60
+ if (typeof value === "number" && Number.isFinite(value)) return String(value);
61
+ return void 0;
62
+ }
63
+ function isRecord(value) {
64
+ return typeof value === "object" && value !== null && !Array.isArray(value);
65
+ }
66
+ export {
67
+ PROVIDER_METADATA_CHUNK_SIZE,
68
+ PROVIDER_METADATA_MAX_CHUNKS,
69
+ openMetadata,
70
+ packMetadata
71
+ };
72
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["export const PROVIDER_METADATA_CHUNK_SIZE = 256;\r\nexport const PROVIDER_METADATA_MAX_CHUNKS = 16;\r\n\r\nconst MAX_ENCODED_LENGTH = PROVIDER_METADATA_CHUNK_SIZE * PROVIDER_METADATA_MAX_CHUNKS;\r\n\r\n/**\r\n * Packs caller maps into one provider metadata object.\r\n * Later layers win on the same key. String, number, and boolean values are stored.\r\n * Numbers and booleans are stored as their string form. Objects and arrays are omitted.\r\n * An empty result is `undefined`.\r\n * The packed object is the same for every provider: `m.0`, `m.1`, and so on.\r\n */\r\nexport function packMetadata(\r\n ...layers: Array<Record<string, unknown> | undefined>\r\n): Record<string, string> | undefined {\r\n const map: Record<string, string> = {};\r\n for (const layer of layers) {\r\n if (!layer) continue;\r\n for (const [key, value] of Object.entries(layer)) {\r\n const asString = asMetadataString(value);\r\n if (asString !== undefined) map[key] = asString;\r\n }\r\n }\r\n return encodeProviderRecord(map);\r\n}\r\n\r\n/**\r\n * Opens the `m.0`, `m.1`, ... object from a provider log.\r\n * Returns every stored pair. A missing record returns `{}`.\r\n */\r\nexport function openMetadata(wire: unknown): Record<string, string> {\r\n if (!isRecord(wire)) return {};\r\n const parts: string[] = [];\r\n for (let index = 0; ; index += 1) {\r\n const chunk = wire[`m.${index}`];\r\n if (typeof chunk !== \"string\") break;\r\n parts.push(chunk);\r\n }\r\n if (!parts.length) return {};\r\n const parsed: unknown = JSON.parse(Buffer.from(parts.join(\"\"), \"base64\").toString(\"utf8\"));\r\n if (!isRecord(parsed)) return {};\r\n const record: Record<string, string> = {};\r\n for (const [key, value] of Object.entries(parsed)) {\r\n if (typeof value === \"string\") record[key] = value;\r\n }\r\n return record;\r\n}\r\n\r\nfunction encodeProviderRecord(map: Record<string, string>): Record<string, string> | undefined {\r\n const keys = Object.keys(map).sort();\r\n if (!keys.length) return undefined;\r\n const ordered: Record<string, string> = {};\r\n for (const key of keys) {\r\n const value = map[key];\r\n if (value !== undefined) ordered[key] = value;\r\n }\r\n const encoded = Buffer.from(JSON.stringify(ordered), \"utf8\").toString(\"base64\");\r\n const chunks = Math.ceil(encoded.length / PROVIDER_METADATA_CHUNK_SIZE);\r\n if (chunks > PROVIDER_METADATA_MAX_CHUNKS) {\r\n throw new Error(\r\n `METADATA_RECORD_TOO_LARGE: provider metadata is ${encoded.length} base64 characters; the maximum is ${MAX_ENCODED_LENGTH}.`\r\n );\r\n }\r\n const wire: Record<string, string> = {};\r\n for (let index = 0; index < chunks; index += 1) {\r\n wire[`m.${index}`] = encoded.slice(\r\n index * PROVIDER_METADATA_CHUNK_SIZE,\r\n (index + 1) * PROVIDER_METADATA_CHUNK_SIZE\r\n );\r\n }\r\n return wire;\r\n}\r\n\r\nfunction asMetadataString(value: unknown): string | undefined {\r\n if (typeof value === \"string\") return value;\r\n if (typeof value === \"boolean\") return value ? \"true\" : \"false\";\r\n if (typeof value === \"number\" && Number.isFinite(value)) return String(value);\r\n return undefined;\r\n}\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\r\n}\r\n"],"mappings":";AAAO,IAAM,+BAA+B;AACrC,IAAM,+BAA+B;AAE5C,IAAM,qBAAqB,+BAA+B;AASnD,SAAS,gBACX,QACiC;AACpC,QAAM,MAA8B,CAAC;AACrC,aAAW,SAAS,QAAQ;AAC1B,QAAI,CAAC,MAAO;AACZ,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,YAAM,WAAW,iBAAiB,KAAK;AACvC,UAAI,aAAa,OAAW,KAAI,GAAG,IAAI;AAAA,IACzC;AAAA,EACF;AACA,SAAO,qBAAqB,GAAG;AACjC;AAMO,SAAS,aAAa,MAAuC;AAClE,MAAI,CAAC,SAAS,IAAI,EAAG,QAAO,CAAC;AAC7B,QAAM,QAAkB,CAAC;AACzB,WAAS,QAAQ,KAAK,SAAS,GAAG;AAChC,UAAM,QAAQ,KAAK,KAAK,KAAK,EAAE;AAC/B,QAAI,OAAO,UAAU,SAAU;AAC/B,UAAM,KAAK,KAAK;AAAA,EAClB;AACA,MAAI,CAAC,MAAM,OAAQ,QAAO,CAAC;AAC3B,QAAM,SAAkB,KAAK,MAAM,OAAO,KAAK,MAAM,KAAK,EAAE,GAAG,QAAQ,EAAE,SAAS,MAAM,CAAC;AACzF,MAAI,CAAC,SAAS,MAAM,EAAG,QAAO,CAAC;AAC/B,QAAM,SAAiC,CAAC;AACxC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,QAAI,OAAO,UAAU,SAAU,QAAO,GAAG,IAAI;AAAA,EAC/C;AACA,SAAO;AACT;AAEA,SAAS,qBAAqB,KAAiE;AAC7F,QAAM,OAAO,OAAO,KAAK,GAAG,EAAE,KAAK;AACnC,MAAI,CAAC,KAAK,OAAQ,QAAO;AACzB,QAAM,UAAkC,CAAC;AACzC,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,IAAI,GAAG;AACrB,QAAI,UAAU,OAAW,SAAQ,GAAG,IAAI;AAAA,EAC1C;AACA,QAAM,UAAU,OAAO,KAAK,KAAK,UAAU,OAAO,GAAG,MAAM,EAAE,SAAS,QAAQ;AAC9E,QAAM,SAAS,KAAK,KAAK,QAAQ,SAAS,4BAA4B;AACtE,MAAI,SAAS,8BAA8B;AACzC,UAAM,IAAI;AAAA,MACR,mDAAmD,QAAQ,MAAM,sCAAsC,kBAAkB;AAAA,IAC3H;AAAA,EACF;AACA,QAAM,OAA+B,CAAC;AACtC,WAAS,QAAQ,GAAG,QAAQ,QAAQ,SAAS,GAAG;AAC9C,SAAK,KAAK,KAAK,EAAE,IAAI,QAAQ;AAAA,MAC3B,QAAQ;AAAA,OACP,QAAQ,KAAK;AAAA,IAChB;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,OAAoC;AAC5D,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,UAAW,QAAO,QAAQ,SAAS;AACxD,MAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,EAAG,QAAO,OAAO,KAAK;AAC5E,SAAO;AACT;AAEA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;","names":[]}
package/package.json ADDED
@@ -0,0 +1,41 @@
1
+ {
2
+ "name": "@x12i/provider-metadata",
3
+ "version": "1.0.0",
4
+ "description": "Pack and open one provider metadata record. The same wire object for every provider.",
5
+ "type": "module",
6
+ "main": "./dist/index.cjs",
7
+ "module": "./dist/index.js",
8
+ "types": "./dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "types": "./dist/index.d.ts",
12
+ "import": "./dist/index.js",
13
+ "require": "./dist/index.cjs"
14
+ }
15
+ },
16
+ "files": [
17
+ "dist",
18
+ "README.md",
19
+ "LICENSE"
20
+ ],
21
+ "scripts": {
22
+ "build": "tsup src/index.ts --format esm,cjs --dts",
23
+ "test": "vitest run",
24
+ "test:watch": "vitest",
25
+ "typecheck": "tsc --noEmit",
26
+ "prepublishOnly": "npm run typecheck && npm run test && npm run build"
27
+ },
28
+ "devDependencies": {
29
+ "@types/node": "^22.15.30",
30
+ "tsup": "^8.5.0",
31
+ "typescript": "^5.8.3",
32
+ "vitest": "^3.2.4"
33
+ },
34
+ "engines": {
35
+ "node": ">=20"
36
+ },
37
+ "license": "MIT",
38
+ "publishConfig": {
39
+ "access": "public"
40
+ }
41
+ }