@xyo-network/payload-plugin 5.3.25 → 5.3.26

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 (2) hide show
  1. package/README.md +427 -10
  2. package/package.json +15 -15
package/README.md CHANGED
@@ -1,23 +1,440 @@
1
+ [![logo][]](https://xyo.network)
2
+
1
3
  # @xyo-network/payload-plugin
2
4
 
3
- [![logo][]](https://xyo.network)
5
+ [![npm][npm-badge]][npm-link]
6
+ [![license][license-badge]][license-link]
7
+
8
+ > Primary SDK for using XYO Protocol 2.0
9
+
10
+ ## Install
11
+
12
+ Using npm:
4
13
 
5
- Version: 5.0.2
14
+ ```sh
15
+ npm install {{name}}
16
+ ```
6
17
 
7
- Primary SDK for using XYO Protocol 2.0
18
+ Using yarn:
8
19
 
9
- ## Documentation
20
+ ```sh
21
+ yarn add {{name}}
22
+ ```
10
23
 
11
- [TypeDoc Generated Documentation](https://gitbook.xyo.network/xyo-data-lab/xyo-reference/package-documentation/xyo-network__payload-plugin)
24
+ Using pnpm:
25
+
26
+ ```sh
27
+ pnpm add {{name}}
28
+ ```
29
+
30
+ Using bun:
31
+
32
+ ```sh
33
+ bun add {{name}}
34
+ ```
12
35
 
13
- Part of [sdk-xyo-client-js](https://www.npmjs.com/package/@xyo-network/sdk-xyo-client-js)
14
36
 
15
37
  ## License
16
38
 
17
- > See the [LICENSE](LICENSE) file for license details
39
+ See the [LICENSE](LICENSE) file for license rights and limitations (LGPL-3.0-only).
40
+
41
+ ## Reference
42
+
43
+ ### packages
44
+
45
+ ### sdk-utils
46
+
47
+ ### packages
48
+
49
+ ### payload-plugin
50
+
51
+ ### .temp-typedoc
52
+
53
+ ### classes
54
+
55
+ ### <a id="PayloadPluginResolver"></a>PayloadPluginResolver
56
+
57
+ [**@xyo-network/payload-plugin**](#../README)
58
+
59
+ ***
60
+
61
+ ## Constructors
62
+
63
+ ### Constructor
64
+
65
+ ```ts
66
+ new PayloadPluginResolver(plugins?, defaultPlugin?): PayloadPluginResolver;
67
+ ```
68
+
69
+ ### Parameters
70
+
71
+ #### plugins?
72
+
73
+ [`PayloadPlugin`](#../type-aliases/PayloadPlugin)\<`Payload`\>[]
74
+
75
+ **Param**
76
+
77
+ The initial set of plugins
78
+
79
+ #### defaultPlugin?
80
+
81
+ [`PayloadPlugin`](#../type-aliases/PayloadPlugin)\<`Payload`\> = `...`
82
+
83
+ **Param**
84
+
85
+ Specifies the plugin to be used if no plugins resolve
86
+
87
+ ### Returns
88
+
89
+ `PayloadPluginResolver`
90
+
91
+ ## Properties
92
+
93
+ ### schema
94
+
95
+ ```ts
96
+ schema: "network.xyo.payload" & object = PayloadSchema;
97
+ ```
98
+
99
+ ### Type Declaration
100
+
101
+ #### \_\_schema
102
+
103
+ ```ts
104
+ readonly __schema: true;
105
+ ```
106
+
107
+ ***
108
+
109
+ ### \_plugins
110
+
111
+ ```ts
112
+ protected _plugins: Record<string, PayloadPlugin> = {};
113
+ ```
114
+
115
+ ***
116
+
117
+ ### defaultPlugin
118
+
119
+ ```ts
120
+ protected defaultPlugin: PayloadPlugin;
121
+ ```
122
+
123
+ ## Methods
124
+
125
+ ### plugins()
126
+
127
+ ```ts
128
+ plugins(): PayloadPlugin[];
129
+ ```
130
+
131
+ ### Returns
132
+
133
+ [`PayloadPlugin`](#../type-aliases/PayloadPlugin)[]
134
+
135
+ ### Description
136
+
137
+ Create list of plugins, optionally filtered by ability to witness/divine
138
+
139
+ ***
140
+
141
+ ### register()
142
+
143
+ ```ts
144
+ register<TPlugin>(plugin): PayloadPluginResolver;
145
+ ```
146
+
147
+ ### Type Parameters
148
+
149
+ #### TPlugin
150
+
151
+ `TPlugin` *extends* [`PayloadPlugin`](#../type-aliases/PayloadPlugin) = [`PayloadPlugin`](#../type-aliases/PayloadPlugin)
152
+
153
+ ### Parameters
154
+
155
+ #### plugin
156
+
157
+ `TPlugin`
158
+
159
+ ### Returns
160
+
161
+ `PayloadPluginResolver`
162
+
163
+ ***
164
+
165
+ ### resolve()
166
+
167
+ ### Call Signature
168
+
169
+ ```ts
170
+ resolve(schema?): PayloadPlugin;
171
+ ```
172
+
173
+ #### Parameters
174
+
175
+ ##### schema?
176
+
177
+ `string`
178
+
179
+ #### Returns
180
+
181
+ [`PayloadPlugin`](#../type-aliases/PayloadPlugin)
182
+
183
+ ### Call Signature
184
+
185
+ ```ts
186
+ resolve(payload): PayloadPlugin;
187
+ ```
188
+
189
+ #### Parameters
190
+
191
+ ##### payload
192
+
193
+ `Payload`
194
+
195
+ #### Returns
196
+
197
+ [`PayloadPlugin`](#../type-aliases/PayloadPlugin)
198
+
199
+ ***
200
+
201
+ ### schemas()
202
+
203
+ ```ts
204
+ schemas(): string[];
205
+ ```
206
+
207
+ ### Returns
208
+
209
+ `string`[]
210
+
211
+ ### Description
212
+
213
+ Create list of schema, optionally filtered by ability to witness/divine
214
+
215
+ ***
216
+
217
+ ### validate()
218
+
219
+ ```ts
220
+ validate(payload): Validator<Payload> | undefined;
221
+ ```
222
+
223
+ ### Parameters
224
+
225
+ #### payload
226
+
227
+ `Payload`
228
+
229
+ ### Returns
230
+
231
+ `Validator`\<`Payload`\> \| `undefined`
232
+
233
+ ***
234
+
235
+ ### wrap()
236
+
237
+ ```ts
238
+ wrap(payload): PayloadWrapper<Payload> | undefined;
239
+ ```
240
+
241
+ ### Parameters
242
+
243
+ #### payload
244
+
245
+ `Payload`
246
+
247
+ ### Returns
248
+
249
+ `PayloadWrapper`\<`Payload`\> \| `undefined`
250
+
251
+ ### functions
252
+
253
+ ### <a id="createPayloadPlugin"></a>createPayloadPlugin
254
+
255
+ [**@xyo-network/payload-plugin**](#../README)
256
+
257
+ ***
258
+
259
+ ```ts
260
+ function createPayloadPlugin<TPayload>(plugin): PayloadPlugin<TPayload>;
261
+ ```
262
+
263
+ ## Type Parameters
264
+
265
+ ### TPayload
266
+
267
+ `TPayload` *extends* `Payload` = `Payload`
268
+
269
+ ## Parameters
270
+
271
+ ### plugin
272
+
273
+ [`PayloadPlugin`](#../type-aliases/PayloadPlugin)\<`TPayload`\>
274
+
275
+ ## Returns
276
+
277
+ [`PayloadPlugin`](#../type-aliases/PayloadPlugin)\<`TPayload`\>
278
+
279
+ ### <a id="defaultPayloadPluginFunctions"></a>defaultPayloadPluginFunctions
280
+
281
+ [**@xyo-network/payload-plugin**](#../README)
282
+
283
+ ***
284
+
285
+ ```ts
286
+ function defaultPayloadPluginFunctions<T>(schema): PayloadPlugin<T>;
287
+ ```
288
+
289
+ ## Type Parameters
290
+
291
+ ### T
292
+
293
+ `T` *extends* `Payload`
294
+
295
+ ## Parameters
296
+
297
+ ### schema
298
+
299
+ `Schema`
300
+
301
+ ## Returns
302
+
303
+ [`PayloadPlugin`](#../type-aliases/PayloadPlugin)\<`T`\>
304
+
305
+ ### type-aliases
306
+
307
+ ### <a id="PayloadPlugin"></a>PayloadPlugin
308
+
309
+ [**@xyo-network/payload-plugin**](#../README)
310
+
311
+ ***
312
+
313
+ ```ts
314
+ type PayloadPlugin<TPayload> = object;
315
+ ```
316
+
317
+ ## Type Parameters
318
+
319
+ ### TPayload
320
+
321
+ `TPayload` *extends* `Payload` = `Payload`
322
+
323
+ ## Properties
324
+
325
+ ### build?
326
+
327
+ ```ts
328
+ optional build?: () => PayloadBuilder<TPayload>;
329
+ ```
330
+
331
+ ### Returns
332
+
333
+ `PayloadBuilder`\<`TPayload`\>
334
+
335
+ ***
336
+
337
+ ### ~~jsonSchema?~~
338
+
339
+ ```ts
340
+ optional jsonSchema?: SomeJSONSchema;
341
+ ```
342
+
343
+ ### Deprecated
344
+
345
+ use zod instead
346
+
347
+ ***
348
+
349
+ ### schema
350
+
351
+ ```ts
352
+ schema: TPayload["schema"];
353
+ ```
354
+
355
+ ***
356
+
357
+ ### ~~template?~~
358
+
359
+ ```ts
360
+ optional template?: () => Partial<TPayload>;
361
+ ```
362
+
363
+ ### Returns
364
+
365
+ `Partial`\<`TPayload`\>
366
+
367
+ ### Deprecated
368
+
369
+ use zod defaults instead
370
+
371
+ ***
372
+
373
+ ### validate?
374
+
375
+ ```ts
376
+ optional validate?: (payload) => Validator<Payload>;
377
+ ```
378
+
379
+ ### Parameters
380
+
381
+ #### payload
382
+
383
+ `Payload`
384
+
385
+ ### Returns
386
+
387
+ `Validator`\<`Payload`\>
388
+
389
+ ***
390
+
391
+ ### wrap?
392
+
393
+ ```ts
394
+ optional wrap?: (payload) => PayloadWrapper;
395
+ ```
396
+
397
+ ### Parameters
398
+
399
+ #### payload
400
+
401
+ `Payload`
402
+
403
+ ### Returns
404
+
405
+ `PayloadWrapper`
406
+
407
+ ***
408
+
409
+ ### zod?
410
+
411
+ ```ts
412
+ optional zod?: ZodType;
413
+ ```
414
+
415
+ ### <a id="PayloadPluginFunc"></a>PayloadPluginFunc
416
+
417
+ [**@xyo-network/payload-plugin**](#../README)
418
+
419
+ ***
420
+
421
+ ```ts
422
+ type PayloadPluginFunc<TPayload> = () => PayloadPlugin<TPayload>;
423
+ ```
424
+
425
+ ## Type Parameters
426
+
427
+ ### TPayload
428
+
429
+ `TPayload` *extends* `Payload` = `Payload`
430
+
431
+ ## Returns
18
432
 
19
- ## Credits
433
+ [`PayloadPlugin`](#PayloadPlugin)\<`TPayload`\>
20
434
 
21
- [Made with 🔥 and ❄️ by XYO](https://xyo.network)
22
435
 
23
- [logo]: https://cdn.xy.company/img/brand/XYO_full_colored.png
436
+ [logo]: https://cdn.xy.company/img/brand/XYO_full_colored.png
437
+ [npm-badge]: https://img.shields.io/npm/v/@xyo-network/payload-plugin.svg
438
+ [npm-link]: https://www.npmjs.com/package/@xyo-network/payload-plugin
439
+ [license-badge]: https://img.shields.io/npm/l/@xyo-network/payload-plugin.svg
440
+ [license-link]: https://github.com/xylabs/sdk-js/blob/main/LICENSE
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xyo-network/payload-plugin",
3
- "version": "5.3.25",
3
+ "version": "5.3.26",
4
4
  "description": "Primary SDK for using XYO Protocol 2.0",
5
5
  "homepage": "https://xyo.network",
6
6
  "bugs": {
@@ -22,11 +22,11 @@
22
22
  "exports": {
23
23
  ".": {
24
24
  "types": "./dist/neutral/index.d.ts",
25
+ "import": "./dist/neutral/index.mjs",
25
26
  "default": "./dist/neutral/index.mjs"
26
27
  },
27
28
  "./package.json": "./package.json"
28
29
  },
29
- "module": "dist/neutral/index.mjs",
30
30
  "types": "dist/neutral/index.d.ts",
31
31
  "files": [
32
32
  "dist",
@@ -36,28 +36,28 @@
36
36
  "README.md"
37
37
  ],
38
38
  "dependencies": {
39
- "@xyo-network/payload-builder": "~5.3.25",
40
- "@xyo-network/payload-model": "~5.3.25",
41
- "@xyo-network/payload-wrapper": "~5.3.25",
42
- "@xyo-network/payload-validator": "~5.3.25"
39
+ "@xyo-network/payload-builder": "~5.3.26",
40
+ "@xyo-network/payload-model": "~5.3.26",
41
+ "@xyo-network/payload-validator": "~5.3.26",
42
+ "@xyo-network/payload-wrapper": "~5.3.26"
43
43
  },
44
44
  "devDependencies": {
45
45
  "@opentelemetry/api": "^1.9.1",
46
- "@types/node": "^25.5.0",
47
- "@xylabs/sdk-js": "^5.0.93",
48
- "@xylabs/ts-scripts-common": "~7.6.16",
49
- "@xylabs/ts-scripts-pnpm": "~7.6.16",
50
- "@xylabs/tsconfig": "~7.6.16",
46
+ "@types/node": "^25.5.2",
47
+ "@xylabs/sdk-js": "^5.0.94",
48
+ "@xylabs/ts-scripts-common": "~7.7.5",
49
+ "@xylabs/ts-scripts-pnpm": "~7.7.5",
50
+ "@xylabs/tsconfig": "~7.7.5",
51
51
  "acorn": "^8.16.0",
52
52
  "ajv": "^8.18.0",
53
53
  "axios": "^1.14.0",
54
54
  "esbuild": "^0.28.0",
55
55
  "typescript": "~5.9.3",
56
56
  "zod": "^4.3.6",
57
- "@xyo-network/payload-model": "~5.3.25",
58
- "@xyo-network/payload-builder": "~5.3.25",
59
- "@xyo-network/payload-validator": "~5.3.25",
60
- "@xyo-network/payload-wrapper": "~5.3.25"
57
+ "@xyo-network/payload-model": "~5.3.26",
58
+ "@xyo-network/payload-builder": "~5.3.26",
59
+ "@xyo-network/payload-validator": "~5.3.26",
60
+ "@xyo-network/payload-wrapper": "~5.3.26"
61
61
  },
62
62
  "peerDependencies": {
63
63
  "@xylabs/sdk-js": "^5",