@panneau/protocol 0.0.0-stage → 5.0.0-alpha.0

package/dist/openapi.js

@@ -0,0 +1,540 @@
+import { PROBLEM_CONTENT_TYPE } from "./version.js";
+import { Definition } from "./schemas/definition.js";
+import { BootConfig } from "./schemas/boot.js";
+import { createSchemaRegistry } from "./schemas/index.js";
+import { z } from "zod";
+//#region src/openapi.ts
+var ref = (id) => ({ $ref: `#/components/schemas/${id}` });
+var json = (schema) => ({ "application/json": { schema } });
+var ok = (description, schema, headers) => ({
+	description,
+	...schema !== void 0 ? { content: json(schema) } : {},
+	...headers !== void 0 ? { headers } : {}
+});
+var PROBLEMS = {
+	401: "Not authenticated.",
+	403: "Not allowed.",
+	404: "Not found.",
+	409: "Conflict with a business rule.",
+	412: "Version conflict: `If-Match` does not match the current version, which is in `current`.",
+	422: "Invalid values: messages are in `errors`, keyed by dot path."
+};
+function problems(...statuses) {
+	return Object.fromEntries(statuses.map((status) => [String(status), {
+		description: PROBLEMS[status],
+		content: { [PROBLEM_CONTENT_TYPE]: { schema: ref("Problem") } }
+	}]));
+}
+var etag = { ETag: {
+	description: "The version of the item.",
+	schema: { type: "string" }
+} };
+var pathParameter = (name, description) => ({
+	name,
+	in: "path",
+	required: true,
+	description,
+	schema: { type: "string" }
+});
+var queryParameter = (name, description, schema) => ({
+	name,
+	in: "query",
+	required: false,
+	description,
+	schema
+});
+var listParameters = [
+	queryParameter("page", "Page number, from 1.", {
+		type: "integer",
+		minimum: 1
+	}),
+	queryParameter("perPage", "Items per page.", {
+		type: "integer",
+		minimum: 1
+	}),
+	queryParameter("sort", "Comma-separated fields; a `-` prefix sorts descending.", { type: "string" }),
+	{
+		name: "filter",
+		in: "query",
+		required: false,
+		style: "deepObject",
+		explode: true,
+		description: "`filter[status]=published`, `filter[tags][]=a`.",
+		schema: {
+			type: "object",
+			additionalProperties: true
+		}
+	},
+	queryParameter("q", "Search.", { type: "string" }),
+	queryParameter("fields", "Comma-separated fields to include in each item.", { type: "string" })
+];
+var resource = pathParameter("resource", "Resource id.");
+var id = pathParameter("id", "Item id.");
+var values = {
+	type: "object",
+	additionalProperties: true
+};
+/** Component schemas, generated from the protocol's Zod schemas. */
+function createComponentSchemas() {
+	const { schemas } = z.toJSONSchema(createSchemaRegistry(), {
+		io: "input",
+		uri: (schemaId) => `#/components/schemas/${schemaId}`
+	});
+	return Object.fromEntries(Object.entries(schemas).map(([schemaId, schema]) => {
+		const { $schema: _schema, $id: _id, ...rest } = schema;
+		return [schemaId, rest];
+	}));
+}
+/** The JSON Schema of the definition (`GET /definition`). */
+function createDefinitionJsonSchema() {
+	return {
+		$id: "https://github.com/folkloreinc/panneau-js/blob/v5.x/packages/protocol/schema/definition.schema.json",
+		...z.toJSONSchema(Definition, {
+			io: "input",
+			metadata: createSchemaRegistry()
+		})
+	};
+}
+/** The JSON Schema of the boot config, which a server writes in the page of the app. */
+function createBootConfigJsonSchema() {
+	return {
+		$id: "https://github.com/folkloreinc/panneau-js/blob/v5.x/packages/protocol/schema/boot.schema.json",
+		...z.toJSONSchema(BootConfig, {
+			io: "input",
+			metadata: createSchemaRegistry()
+		})
+	};
+}
+/** The OpenAPI 3.1 document of the Panneau HTTP API. */
+function createOpenApiDocument() {
+	return {
+		openapi: "3.1.0",
+		info: {
+			title: "Panneau protocol",
+			version: String(1),
+			description: "The HTTP API between a Panneau frontend and its backend. Paths are relative to `api.baseUrl` of the definition. Authentication is up to the backend (session cookie or bearer token). Errors use `application/problem+json`."
+		},
+		paths: {
+			"/definition": { get: {
+				operationId: "getDefinition",
+				summary: "The definition for the current user, in the current locale.",
+				responses: {
+					200: ok("The definition.", ref("Definition")),
+					...problems(401, 403)
+				}
+			} },
+			"/resources/{resource}": {
+				parameters: [resource],
+				get: {
+					operationId: "listItems",
+					parameters: listParameters,
+					responses: {
+						200: ok("A page of items.", ref("ListResponse")),
+						...problems(401, 403, 404)
+					}
+				},
+				post: {
+					operationId: "createItem",
+					requestBody: {
+						required: true,
+						content: json(values)
+					},
+					responses: {
+						201: ok("The created item.", ref("ItemResponse"), etag),
+						...problems(401, 403, 404, 409, 422)
+					}
+				}
+			},
+			"/resources/{resource}/{id}": {
+				parameters: [resource, id],
+				get: {
+					operationId: "getItem",
+					responses: {
+						200: ok("The item.", ref("ItemResponse"), etag),
+						...problems(401, 403, 404)
+					}
+				},
+				patch: {
+					operationId: "updateItem",
+					description: "Partial update: only the values sent are changed.",
+					parameters: [{
+						name: "If-Match",
+						in: "header",
+						required: false,
+						description: "The version the client edited.",
+						schema: { type: "string" }
+					}],
+					requestBody: {
+						required: true,
+						content: json(values)
+					},
+					responses: {
+						200: ok("The updated item.", ref("ItemResponse"), etag),
+						...problems(401, 403, 404, 409, 412, 422)
+					}
+				},
+				delete: {
+					operationId: "deleteItem",
+					responses: {
+						204: ok("Deleted."),
+						...problems(401, 403, 404, 409)
+					}
+				}
+			},
+			"/resources/{resource}/{id}/preview": {
+				parameters: [resource, id],
+				post: {
+					operationId: "previewItem",
+					requestBody: {
+						required: true,
+						content: json(values)
+					},
+					responses: {
+						200: ok("A short-lived preview URL.", ref("PreviewResponse")),
+						...problems(401, 403, 404, 422)
+					}
+				}
+			},
+			"/resources/{resource}/actions/{action}": {
+				parameters: [resource, pathParameter("action", "Action id.")],
+				post: {
+					operationId: "runAction",
+					requestBody: {
+						required: true,
+						content: {
+							...json(ref("ActionRequest")),
+							"multipart/form-data": { schema: ref("ActionRequest") }
+						}
+					},
+					responses: {
+						200: ok("The result.", ref("ActionResult")),
+						202: ok("The action runs in the background.", ref("ActionRunResponse")),
+						...problems(401, 403, 404, 409, 422)
+					}
+				}
+			},
+			"/actions/runs": { get: {
+				operationId: "listActionRuns",
+				summary: "The current user's recent runs.",
+				responses: {
+					200: ok("Runs, newest first.", {
+						type: "object",
+						required: ["data"],
+						properties: { data: {
+							type: "array",
+							items: ref("ActionRun")
+						} }
+					}),
+					...problems(401)
+				}
+			} },
+			"/actions/runs/{run}": {
+				parameters: [pathParameter("run", "Run id.")],
+				get: {
+					operationId: "getActionRun",
+					responses: {
+						200: ok("The run.", ref("ActionRunResponse")),
+						...problems(401, 403, 404)
+					}
+				},
+				delete: {
+					operationId: "cancelActionRun",
+					responses: {
+						204: ok("Cancelled."),
+						...problems(401, 403, 404, 409)
+					}
+				}
+			},
+			"/media": {
+				get: {
+					operationId: "listMedia",
+					parameters: listParameters,
+					responses: {
+						200: ok("A page of media.", ref("MediaListResponse")),
+						...problems(401, 403)
+					}
+				},
+				post: {
+					operationId: "uploadMedia",
+					requestBody: {
+						required: true,
+						content: { "multipart/form-data": { schema: {
+							type: "object",
+							required: ["file"],
+							properties: {
+								file: {
+									type: "string",
+									contentMediaType: "application/octet-stream"
+								},
+								name: { type: "string" },
+								tags: {
+									type: "array",
+									items: { type: "string" }
+								}
+							}
+						} } }
+					},
+					responses: {
+						201: ok("The created media.", ref("MediaResponse")),
+						...problems(401, 403, 422)
+					}
+				}
+			},
+			"/media/tags": { get: {
+				operationId: "listMediaTags",
+				responses: {
+					200: ok("Tags in use.", {
+						type: "object",
+						required: ["data"],
+						properties: { data: {
+							type: "array",
+							items: { type: "string" }
+						} }
+					}),
+					...problems(401, 403)
+				}
+			} },
+			"/media/{id}": {
+				parameters: [pathParameter("id", "Media id.")],
+				get: {
+					operationId: "getMedia",
+					responses: {
+						200: ok("The media.", ref("MediaResponse")),
+						...problems(401, 403, 404)
+					}
+				},
+				patch: {
+					operationId: "updateMedia",
+					description: "Updates metadata, tags or the image `transform`.",
+					requestBody: {
+						required: true,
+						content: json(values)
+					},
+					responses: {
+						200: ok("The updated media.", ref("MediaResponse")),
+						...problems(401, 403, 404, 422)
+					}
+				},
+				delete: {
+					operationId: "deleteMedia",
+					responses: {
+						204: ok("Moved to the trash."),
+						...problems(401, 403, 404, 409)
+					}
+				}
+			},
+			"/media/{id}/file": {
+				parameters: [pathParameter("id", "Media id.")],
+				post: {
+					operationId: "replaceMediaFile",
+					requestBody: {
+						required: true,
+						content: { "multipart/form-data": { schema: {
+							type: "object",
+							required: ["file"],
+							properties: { file: {
+								type: "string",
+								contentMediaType: "application/octet-stream"
+							} }
+						} } }
+					},
+					responses: {
+						200: ok("The media.", ref("MediaResponse")),
+						...problems(401, 403, 404, 422)
+					}
+				}
+			},
+			"/media/{id}/restore": {
+				parameters: [pathParameter("id", "Media id.")],
+				post: {
+					operationId: "restoreMedia",
+					responses: {
+						200: ok("The restored media.", ref("MediaResponse")),
+						...problems(401, 403, 404)
+					}
+				}
+			},
+			"/auth/session": { get: {
+				operationId: "getSession",
+				responses: {
+					200: ok("The current user.", ref("Session")),
+					...problems(401)
+				}
+			} },
+			"/auth/login": { post: {
+				operationId: "login",
+				requestBody: {
+					required: true,
+					content: json({
+						type: "object",
+						required: ["email", "password"],
+						properties: {
+							email: { type: "string" },
+							password: { type: "string" },
+							remember: { type: "boolean" }
+						}
+					})
+				},
+				responses: {
+					200: ok("Logged in.", ref("Session")),
+					202: ok("A second factor is required: answer `/auth/two-factor/challenge`.", {
+						type: "object",
+						properties: { twoFactor: {
+							type: "boolean",
+							const: true
+						} }
+					}),
+					...problems(422)
+				}
+			} },
+			"/auth/logout": { post: {
+				operationId: "logout",
+				responses: { 204: ok("Logged out.") }
+			} },
+			"/auth/providers/{provider}/redirect": {
+				parameters: [pathParameter("provider", "Provider id.")],
+				get: {
+					operationId: "redirectToProvider",
+					parameters: [queryParameter("next", "Local path to go to after login.", { type: "string" })],
+					responses: {
+						302: { description: "Redirect to the provider." },
+						...problems(404)
+					}
+				}
+			},
+			"/auth/password/forgot": { post: {
+				operationId: "forgotPassword",
+				requestBody: {
+					required: true,
+					content: json({
+						type: "object",
+						required: ["email"],
+						properties: { email: { type: "string" } }
+					})
+				},
+				responses: {
+					204: ok("A reset link was sent, if the account exists."),
+					...problems(422)
+				}
+			} },
+			"/auth/password/reset": { post: {
+				operationId: "resetPassword",
+				requestBody: {
+					required: true,
+					content: json({
+						type: "object",
+						required: [
+							"token",
+							"email",
+							"password"
+						],
+						properties: {
+							token: { type: "string" },
+							email: { type: "string" },
+							password: { type: "string" }
+						}
+					})
+				},
+				responses: {
+					204: ok("The password was reset."),
+					...problems(422)
+				}
+			} },
+			"/auth/two-factor/challenge": { post: {
+				operationId: "twoFactorChallenge",
+				requestBody: {
+					required: true,
+					content: json({
+						type: "object",
+						properties: {
+							code: { type: "string" },
+							recoveryCode: { type: "string" }
+						}
+					})
+				},
+				responses: {
+					200: ok("Logged in.", ref("Session")),
+					...problems(422)
+				}
+			} },
+			"/auth/passkeys/options": { post: {
+				operationId: "passkeyOptions",
+				responses: { 200: ok("WebAuthn request options.", {
+					type: "object",
+					additionalProperties: true
+				}) }
+			} },
+			"/auth/passkeys/login": { post: {
+				operationId: "passkeyLogin",
+				requestBody: {
+					required: true,
+					content: json({
+						type: "object",
+						additionalProperties: true
+					})
+				},
+				responses: {
+					200: ok("Logged in.", ref("Session")),
+					...problems(422)
+				}
+			} },
+			"/account": {
+				get: {
+					operationId: "getAccount",
+					responses: {
+						200: ok("The current user.", {
+							type: "object",
+							required: ["data"],
+							properties: { data: ref("User") }
+						}),
+						...problems(401)
+					}
+				},
+				patch: {
+					operationId: "updateAccount",
+					requestBody: {
+						required: true,
+						content: json(values)
+					},
+					responses: {
+						200: ok("The updated user.", {
+							type: "object",
+							required: ["data"],
+							properties: { data: ref("User") }
+						}),
+						...problems(401, 422)
+					}
+				}
+			},
+			"/search": { get: {
+				operationId: "search",
+				parameters: [{
+					...queryParameter("q", "Search terms.", { type: "string" }),
+					required: true
+				}],
+				responses: {
+					200: ok("Results grouped by resource.", ref("SearchResponse")),
+					...problems(401)
+				}
+			} },
+			"/dashboard/widgets/{widget}": {
+				parameters: [pathParameter("widget", "Widget id.")],
+				get: {
+					operationId: "getWidgetData",
+					responses: {
+						200: ok("The widget's data. Its shape depends on the widget type.", {
+							type: "object",
+							additionalProperties: true
+						}),
+						...problems(401, 403, 404)
+					}
+				}
+			}
+		},
+		components: { schemas: createComponentSchemas() }
+	};
+}
+//#endregion
+export { createBootConfigJsonSchema, createComponentSchemas, createDefinitionJsonSchema, createOpenApiDocument };
+
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","names":[],"sources":["../src/openapi.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { createSchemaRegistry } from './schemas';\nimport { BootConfig } from './schemas/boot';\nimport { Definition } from './schemas/definition';\nimport { PROBLEM_CONTENT_TYPE, PROTOCOL_VERSION } from './version';\n\ntype JsonObject = Record<string, unknown>;\n\nconst ref = (id: string): JsonObject => ({ $ref: `#/components/schemas/${id}` });\n\nconst json = (schema: JsonObject): JsonObject => ({ 'application/json': { schema } });\n\nconst ok = (description: string, schema?: JsonObject, headers?: JsonObject): JsonObject => ({\n    description,\n    ...(schema !== undefined ? { content: json(schema) } : {}),\n    ...(headers !== undefined ? { headers } : {}),\n});\n\nconst PROBLEMS: Record<number, string> = {\n    401: 'Not authenticated.',\n    403: 'Not allowed.',\n    404: 'Not found.',\n    409: 'Conflict with a business rule.',\n    412: 'Version conflict: `If-Match` does not match the current version, which is in `current`.',\n    422: 'Invalid values: messages are in `errors`, keyed by dot path.',\n};\n\nfunction problems(...statuses: number[]): JsonObject {\n    return Object.fromEntries(\n        statuses.map((status) => [\n            String(status),\n            {\n                description: PROBLEMS[status],\n                content: { [PROBLEM_CONTENT_TYPE]: { schema: ref('Problem') } },\n            },\n        ]),\n    );\n}\n\nconst etag = { ETag: { description: 'The version of the item.', schema: { type: 'string' } } };\n\nconst pathParameter = (name: string, description: string): JsonObject => ({\n    name,\n    in: 'path',\n    required: true,\n    description,\n    schema: { type: 'string' },\n});\n\nconst queryParameter = (name: string, description: string, schema: JsonObject): JsonObject => ({\n    name,\n    in: 'query',\n    required: false,\n    description,\n    schema,\n});\n\nconst listParameters = [\n    queryParameter('page', 'Page number, from 1.', { type: 'integer', minimum: 1 }),\n    queryParameter('perPage', 'Items per page.', { type: 'integer', minimum: 1 }),\n    queryParameter('sort', 'Comma-separated fields; a `-` prefix sorts descending.', {\n        type: 'string',\n    }),\n    {\n        name: 'filter',\n        in: 'query',\n        required: false,\n        style: 'deepObject',\n        explode: true,\n        description: '`filter[status]=published`, `filter[tags][]=a`.',\n        schema: { type: 'object', additionalProperties: true },\n    },\n    queryParameter('q', 'Search.', { type: 'string' }),\n    queryParameter('fields', 'Comma-separated fields to include in each item.', { type: 'string' }),\n];\n\nconst resource = pathParameter('resource', 'Resource id.');\nconst id = pathParameter('id', 'Item id.');\nconst values = { type: 'object', additionalProperties: true };\n\n/** Component schemas, generated from the protocol's Zod schemas. */\nexport function createComponentSchemas(): Record<string, JsonObject> {\n    const { schemas } = z.toJSONSchema(createSchemaRegistry(), {\n        io: 'input',\n        uri: (schemaId) => `#/components/schemas/${schemaId}`,\n    });\n    return Object.fromEntries(\n        Object.entries(schemas).map(([schemaId, schema]) => {\n            const { $schema: _schema, $id: _id, ...rest } = schema as JsonObject;\n            return [schemaId, rest];\n        }),\n    );\n}\n\n/** The JSON Schema of the definition (`GET /definition`). */\nexport function createDefinitionJsonSchema(): JsonObject {\n    return {\n        $id: 'https://github.com/folkloreinc/panneau-js/blob/v5.x/packages/protocol/schema/definition.schema.json',\n        ...(z.toJSONSchema(Definition, {\n            io: 'input',\n            metadata: createSchemaRegistry(),\n        }) as JsonObject),\n    };\n}\n\n/** The JSON Schema of the boot config, which a server writes in the page of the app. */\nexport function createBootConfigJsonSchema(): JsonObject {\n    return {\n        $id: 'https://github.com/folkloreinc/panneau-js/blob/v5.x/packages/protocol/schema/boot.schema.json',\n        ...(z.toJSONSchema(BootConfig, {\n            io: 'input',\n            metadata: createSchemaRegistry(),\n        }) as JsonObject),\n    };\n}\n\n/** The OpenAPI 3.1 document of the Panneau HTTP API. */\nexport function createOpenApiDocument(): JsonObject {\n    return {\n        openapi: '3.1.0',\n        info: {\n            title: 'Panneau protocol',\n            version: String(PROTOCOL_VERSION),\n            description:\n                'The HTTP API between a Panneau frontend and its backend. Paths are relative to `api.baseUrl` of the definition. Authentication is up to the backend (session cookie or bearer token). Errors use `application/problem+json`.',\n        },\n        paths: {\n            '/definition': {\n                get: {\n                    operationId: 'getDefinition',\n                    summary: 'The definition for the current user, in the current locale.',\n                    responses: {\n                        200: ok('The definition.', ref('Definition')),\n                        ...problems(401, 403),\n                    },\n                },\n            },\n            '/resources/{resource}': {\n                parameters: [resource],\n                get: {\n                    operationId: 'listItems',\n                    parameters: listParameters,\n                    responses: {\n                        200: ok('A page of items.', ref('ListResponse')),\n                        ...problems(401, 403, 404),\n                    },\n                },\n                post: {\n                    operationId: 'createItem',\n                    requestBody: { required: true, content: json(values) },\n                    responses: {\n                        201: ok('The created item.', ref('ItemResponse'), etag),\n                        ...problems(401, 403, 404, 409, 422),\n                    },\n                },\n            },\n            '/resources/{resource}/{id}': {\n                parameters: [resource, id],\n                get: {\n                    operationId: 'getItem',\n                    responses: {\n                        200: ok('The item.', ref('ItemResponse'), etag),\n                        ...problems(401, 403, 404),\n                    },\n                },\n                patch: {\n                    operationId: 'updateItem',\n                    description: 'Partial update: only the values sent are changed.',\n                    parameters: [\n                        {\n                            name: 'If-Match',\n                            in: 'header',\n                            required: false,\n                            description: 'The version the client edited.',\n                            schema: { type: 'string' },\n                        },\n                    ],\n                    requestBody: { required: true, content: json(values) },\n                    responses: {\n                        200: ok('The updated item.', ref('ItemResponse'), etag),\n                        ...problems(401, 403, 404, 409, 412, 422),\n                    },\n                },\n                delete: {\n                    operationId: 'deleteItem',\n                    responses: { 204: ok('Deleted.'), ...problems(401, 403, 404, 409) },\n                },\n            },\n            '/resources/{resource}/{id}/preview': {\n                parameters: [resource, id],\n                post: {\n                    operationId: 'previewItem',\n                    requestBody: { required: true, content: json(values) },\n                    responses: {\n                        200: ok('A short-lived preview URL.', ref('PreviewResponse')),\n                        ...problems(401, 403, 404, 422),\n                    },\n                },\n            },\n            '/resources/{resource}/actions/{action}': {\n                parameters: [resource, pathParameter('action', 'Action id.')],\n                post: {\n                    operationId: 'runAction',\n                    requestBody: {\n                        required: true,\n                        content: {\n                            ...json(ref('ActionRequest')),\n                            'multipart/form-data': { schema: ref('ActionRequest') },\n                        },\n                    },\n                    responses: {\n                        200: ok('The result.', ref('ActionResult')),\n                        202: ok('The action runs in the background.', ref('ActionRunResponse')),\n                        ...problems(401, 403, 404, 409, 422),\n                    },\n                },\n            },\n            '/actions/runs': {\n                get: {\n                    operationId: 'listActionRuns',\n                    summary: \"The current user's recent runs.\",\n                    responses: {\n                        200: ok('Runs, newest first.', {\n                            type: 'object',\n                            required: ['data'],\n                            properties: { data: { type: 'array', items: ref('ActionRun') } },\n                        }),\n                        ...problems(401),\n                    },\n                },\n            },\n            '/actions/runs/{run}': {\n                parameters: [pathParameter('run', 'Run id.')],\n                get: {\n                    operationId: 'getActionRun',\n                    responses: {\n                        200: ok('The run.', ref('ActionRunResponse')),\n                        ...problems(401, 403, 404),\n                    },\n                },\n                delete: {\n                    operationId: 'cancelActionRun',\n                    responses: { 204: ok('Cancelled.'), ...problems(401, 403, 404, 409) },\n                },\n            },\n            '/media': {\n                get: {\n                    operationId: 'listMedia',\n                    parameters: listParameters,\n                    responses: {\n                        200: ok('A page of media.', ref('MediaListResponse')),\n                        ...problems(401, 403),\n                    },\n                },\n                post: {\n                    operationId: 'uploadMedia',\n                    requestBody: {\n                        required: true,\n                        content: {\n                            'multipart/form-data': {\n                                schema: {\n                                    type: 'object',\n                                    required: ['file'],\n                                    properties: {\n                                        file: {\n                                            type: 'string',\n                                            contentMediaType: 'application/octet-stream',\n                                        },\n                                        name: { type: 'string' },\n                                        tags: { type: 'array', items: { type: 'string' } },\n                                    },\n                                },\n                            },\n                        },\n                    },\n                    responses: {\n                        201: ok('The created media.', ref('MediaResponse')),\n                        ...problems(401, 403, 422),\n                    },\n                },\n            },\n            '/media/tags': {\n                get: {\n                    operationId: 'listMediaTags',\n                    responses: {\n                        200: ok('Tags in use.', {\n                            type: 'object',\n                            required: ['data'],\n                            properties: { data: { type: 'array', items: { type: 'string' } } },\n                        }),\n                        ...problems(401, 403),\n                    },\n                },\n            },\n            '/media/{id}': {\n                parameters: [pathParameter('id', 'Media id.')],\n                get: {\n                    operationId: 'getMedia',\n                    responses: {\n                        200: ok('The media.', ref('MediaResponse')),\n                        ...problems(401, 403, 404),\n                    },\n                },\n                patch: {\n                    operationId: 'updateMedia',\n                    description: 'Updates metadata, tags or the image `transform`.',\n                    requestBody: { required: true, content: json(values) },\n                    responses: {\n                        200: ok('The updated media.', ref('MediaResponse')),\n                        ...problems(401, 403, 404, 422),\n                    },\n                },\n                delete: {\n                    operationId: 'deleteMedia',\n                    responses: { 204: ok('Moved to the trash.'), ...problems(401, 403, 404, 409) },\n                },\n            },\n            '/media/{id}/file': {\n                parameters: [pathParameter('id', 'Media id.')],\n                post: {\n                    operationId: 'replaceMediaFile',\n                    requestBody: {\n                        required: true,\n                        content: {\n                            'multipart/form-data': {\n                                schema: {\n                                    type: 'object',\n                                    required: ['file'],\n                                    properties: {\n                                        file: {\n                                            type: 'string',\n                                            contentMediaType: 'application/octet-stream',\n                                        },\n                                    },\n                                },\n                            },\n                        },\n                    },\n                    responses: {\n                        200: ok('The media.', ref('MediaResponse')),\n                        ...problems(401, 403, 404, 422),\n                    },\n                },\n            },\n            '/media/{id}/restore': {\n                parameters: [pathParameter('id', 'Media id.')],\n                post: {\n                    operationId: 'restoreMedia',\n                    responses: {\n                        200: ok('The restored media.', ref('MediaResponse')),\n                        ...problems(401, 403, 404),\n                    },\n                },\n            },\n            '/auth/session': {\n                get: {\n                    operationId: 'getSession',\n                    responses: { 200: ok('The current user.', ref('Session')), ...problems(401) },\n                },\n            },\n            '/auth/login': {\n                post: {\n                    operationId: 'login',\n                    requestBody: {\n                        required: true,\n                        content: json({\n                            type: 'object',\n                            required: ['email', 'password'],\n                            properties: {\n                                email: { type: 'string' },\n                                password: { type: 'string' },\n                                remember: { type: 'boolean' },\n                            },\n                        }),\n                    },\n                    responses: {\n                        200: ok('Logged in.', ref('Session')),\n                        202: ok(\n                            'A second factor is required: answer `/auth/two-factor/challenge`.',\n                            {\n                                type: 'object',\n                                properties: { twoFactor: { type: 'boolean', const: true } },\n                            },\n                        ),\n                        ...problems(422),\n                    },\n                },\n            },\n            '/auth/logout': {\n                post: { operationId: 'logout', responses: { 204: ok('Logged out.') } },\n            },\n            '/auth/providers/{provider}/redirect': {\n                parameters: [pathParameter('provider', 'Provider id.')],\n                get: {\n                    operationId: 'redirectToProvider',\n                    parameters: [\n                        queryParameter('next', 'Local path to go to after login.', {\n                            type: 'string',\n                        }),\n                    ],\n                    responses: {\n                        302: { description: 'Redirect to the provider.' },\n                        ...problems(404),\n                    },\n                },\n            },\n            '/auth/password/forgot': {\n                post: {\n                    operationId: 'forgotPassword',\n                    requestBody: {\n                        required: true,\n                        content: json({\n                            type: 'object',\n                            required: ['email'],\n                            properties: { email: { type: 'string' } },\n                        }),\n                    },\n                    responses: {\n                        204: ok('A reset link was sent, if the account exists.'),\n                        ...problems(422),\n                    },\n                },\n            },\n            '/auth/password/reset': {\n                post: {\n                    operationId: 'resetPassword',\n                    requestBody: {\n                        required: true,\n                        content: json({\n                            type: 'object',\n                            required: ['token', 'email', 'password'],\n                            properties: {\n                                token: { type: 'string' },\n                                email: { type: 'string' },\n                                password: { type: 'string' },\n                            },\n                        }),\n                    },\n                    responses: { 204: ok('The password was reset.'), ...problems(422) },\n                },\n            },\n            '/auth/two-factor/challenge': {\n                post: {\n                    operationId: 'twoFactorChallenge',\n                    requestBody: {\n                        required: true,\n                        content: json({\n                            type: 'object',\n                            properties: {\n                                code: { type: 'string' },\n                                recoveryCode: { type: 'string' },\n                            },\n                        }),\n                    },\n                    responses: { 200: ok('Logged in.', ref('Session')), ...problems(422) },\n                },\n            },\n            '/auth/passkeys/options': {\n                post: {\n                    operationId: 'passkeyOptions',\n                    responses: {\n                        200: ok('WebAuthn request options.', {\n                            type: 'object',\n                            additionalProperties: true,\n                        }),\n                    },\n                },\n            },\n            '/auth/passkeys/login': {\n                post: {\n                    operationId: 'passkeyLogin',\n                    requestBody: {\n                        required: true,\n                        content: json({ type: 'object', additionalProperties: true }),\n                    },\n                    responses: { 200: ok('Logged in.', ref('Session')), ...problems(422) },\n                },\n            },\n            '/account': {\n                get: {\n                    operationId: 'getAccount',\n                    responses: {\n                        200: ok('The current user.', {\n                            type: 'object',\n                            required: ['data'],\n                            properties: { data: ref('User') },\n                        }),\n                        ...problems(401),\n                    },\n                },\n                patch: {\n                    operationId: 'updateAccount',\n                    requestBody: { required: true, content: json(values) },\n                    responses: {\n                        200: ok('The updated user.', {\n                            type: 'object',\n                            required: ['data'],\n                            properties: { data: ref('User') },\n                        }),\n                        ...problems(401, 422),\n                    },\n                },\n            },\n            '/search': {\n                get: {\n                    operationId: 'search',\n                    parameters: [\n                        {\n                            ...queryParameter('q', 'Search terms.', { type: 'string' }),\n                            required: true,\n                        },\n                    ],\n                    responses: {\n                        200: ok('Results grouped by resource.', ref('SearchResponse')),\n                        ...problems(401),\n                    },\n                },\n            },\n            '/dashboard/widgets/{widget}': {\n                parameters: [pathParameter('widget', 'Widget id.')],\n                get: {\n                    operationId: 'getWidgetData',\n                    responses: {\n                        200: ok(\"The widget's data. Its shape depends on the widget type.\", {\n                            type: 'object',\n                            additionalProperties: true,\n                        }),\n                        ...problems(401, 403, 404),\n                    },\n                },\n            },\n        },\n        components: { schemas: createComponentSchemas() },\n    };\n}\n"],"mappings":"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"}

package/dist/query.d.ts

@@ -0,0 +1,17 @@
+export type FilterValue = string | number | boolean | Array<string | number | boolean>;
+/** Query of a list request (`GET /resources/{resource}`). */
+export interface ListQuery {
+    page?: number;
+    perPage?: number;
+    /** Fields to sort by, in order. A `-` prefix sorts descending. */
+    sort?: string[];
+    filter?: Record<string, FilterValue>;
+    q?: string;
+    /** Fields to include in each item. */
+    fields?: string[];
+}
+/** Serializes a list query to the protocol's query string format. */
+export declare function toSearchParams(query: ListQuery): URLSearchParams;
+/** Parses a list query from the protocol's query string format. Filter values stay strings. */
+export declare function fromSearchParams(params: URLSearchParams): ListQuery;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEvF,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,CAyBhE;AAID,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CA2CnE"}

package/dist/query.js

@@ -0,0 +1,49 @@
+//#region src/query.ts
+/** Serializes a list query to the protocol's query string format. */
+function toSearchParams(query) {
+	const params = new URLSearchParams();
+	if (query.page !== void 0) params.set("page", String(query.page));
+	if (query.perPage !== void 0) params.set("perPage", String(query.perPage));
+	if (query.sort !== void 0 && query.sort.length > 0) params.set("sort", query.sort.join(","));
+	Object.entries(query.filter ?? {}).forEach(([key, value]) => {
+		if (Array.isArray(value)) value.forEach((item) => params.append(`filter[${key}][]`, String(item)));
+		else params.set(`filter[${key}]`, String(value));
+	});
+	if (query.q !== void 0 && query.q !== "") params.set("q", query.q);
+	if (query.fields !== void 0 && query.fields.length > 0) params.set("fields", query.fields.join(","));
+	return params;
+}
+var FILTER_KEY = /^filter\[([^\]]+)\](\[\])?$/;
+/** Parses a list query from the protocol's query string format. Filter values stay strings. */
+function fromSearchParams(params) {
+	const query = {};
+	const integer = (value) => {
+		if (value === null || !/^\d+$/.test(value)) return;
+		return Number.parseInt(value, 10);
+	};
+	const page = integer(params.get("page"));
+	if (page !== void 0) query.page = page;
+	const perPage = integer(params.get("perPage"));
+	if (perPage !== void 0) query.perPage = perPage;
+	const sort = params.get("sort");
+	if (sort !== null && sort !== "") query.sort = sort.split(",").filter((part) => part !== "");
+	const q = params.get("q");
+	if (q !== null && q !== "") query.q = q;
+	const fields = params.get("fields");
+	if (fields !== null && fields !== "") query.fields = fields.split(",").filter((part) => part !== "");
+	params.forEach((value, key) => {
+		const match = FILTER_KEY.exec(key);
+		if (match?.[1] === void 0) return;
+		query.filter ??= {};
+		const name = match[1];
+		if (match[2] !== void 0) {
+			const current = query.filter[name];
+			query.filter[name] = [...Array.isArray(current) ? current : [], value];
+		} else query.filter[name] = value;
+	});
+	return query;
+}
+//#endregion
+export { fromSearchParams, toSearchParams };
+
+//# sourceMappingURL=query.js.map