ts-procedures 5.9.1 → 5.10.2

package/build/src/implementations/http/doc-registry.test.js

@@ -0,0 +1,347 @@
+import { describe, expect, it, test } from 'vitest';
+import { v } from 'suretype';
+import { Procedures } from '../../index.js';
+import { HonoRPCAppBuilder } from './hono-rpc/index.js';
+import { DocRegistry } from './doc-registry.js';
+// ---------------------------------------------------------------------------
+// Helpers — minimal doc fixtures
+// ---------------------------------------------------------------------------
+const rpcDoc = {
+    kind: 'rpc',
+    name: 'Echo',
+    path: '/echo/1',
+    method: 'post',
+    scope: 'echo',
+    version: 1,
+    jsonSchema: { body: { type: 'object' } },
+};
+const apiDoc = {
+    kind: 'api',
+    name: 'GetUser',
+    path: '/users/:id',
+    method: 'get',
+    fullPath: '/api/users/:id',
+    jsonSchema: { pathParams: { type: 'object' } },
+};
+const streamDoc = {
+    kind: 'stream',
+    name: 'Feed',
+    path: '/feed/1',
+    methods: ['get'],
+    streamMode: 'sse',
+    scope: 'feed',
+    version: 1,
+    jsonSchema: { yieldType: { type: 'object' } },
+};
+function makeSource(docs) {
+    return { docs };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('DocRegistry', () => {
+    // --------------------------------------------------------------------------
+    // Constructor
+    // --------------------------------------------------------------------------
+    describe('constructor', () => {
+        test('uses defaults when no config provided', () => {
+            const registry = new DocRegistry();
+            const out = registry.toJSON();
+            expect(out.basePath).toBe('');
+            expect(out.headers).toEqual([]);
+            expect(out.errors).toEqual([]);
+        });
+        test('accepts partial config', () => {
+            const registry = new DocRegistry({ basePath: '/v1' });
+            const out = registry.toJSON();
+            expect(out.basePath).toBe('/v1');
+            expect(out.headers).toEqual([]);
+            expect(out.errors).toEqual([]);
+        });
+        test('accepts full config', () => {
+            const headers = [{ name: 'Authorization', description: 'Bearer token', required: true }];
+            const errors = [{ name: 'Unauthorized', statusCode: 401, description: 'Missing token' }];
+            const registry = new DocRegistry({ basePath: '/api', headers, errors });
+            const out = registry.toJSON();
+            expect(out.basePath).toBe('/api');
+            expect(out.headers).toEqual(headers);
+            expect(out.errors).toEqual(errors);
+        });
+    });
+    // --------------------------------------------------------------------------
+    // from()
+    // --------------------------------------------------------------------------
+    describe('from()', () => {
+        test('returns this for chaining', () => {
+            const registry = new DocRegistry();
+            const result = registry.from(makeSource([rpcDoc]));
+            expect(result).toBe(registry);
+        });
+        test('accepts RPC builder source', () => {
+            const registry = new DocRegistry().from(makeSource([rpcDoc]));
+            expect(registry.toJSON().routes).toEqual([rpcDoc]);
+        });
+        test('accepts API builder source', () => {
+            const registry = new DocRegistry().from(makeSource([apiDoc]));
+            expect(registry.toJSON().routes).toEqual([apiDoc]);
+        });
+        test('accepts Stream builder source', () => {
+            const registry = new DocRegistry().from(makeSource([streamDoc]));
+            expect(registry.toJSON().routes).toEqual([streamDoc]);
+        });
+        test('accepts plain { docs } object', () => {
+            const plain = { docs: [rpcDoc, apiDoc] };
+            const registry = new DocRegistry().from(plain);
+            expect(registry.toJSON().routes).toHaveLength(2);
+        });
+        test('builder not yet built returns empty routes', () => {
+            const emptySource = makeSource([]);
+            const registry = new DocRegistry().from(emptySource);
+            expect(registry.toJSON().routes).toEqual([]);
+        });
+        test('same builder twice duplicates routes', () => {
+            const source = makeSource([rpcDoc]);
+            const registry = new DocRegistry().from(source).from(source);
+            expect(registry.toJSON().routes).toHaveLength(2);
+            expect(registry.toJSON().routes[0]).toEqual(registry.toJSON().routes[1]);
+        });
+        test('reads docs lazily at toJSON() time', () => {
+            const mutableDocs = [];
+            const source = { get docs() { return mutableDocs; } };
+            const registry = new DocRegistry().from(source);
+            expect(registry.toJSON().routes).toHaveLength(0);
+            mutableDocs.push(rpcDoc);
+            expect(registry.toJSON().routes).toHaveLength(1);
+        });
+    });
+    // --------------------------------------------------------------------------
+    // toJSON()
+    // --------------------------------------------------------------------------
+    describe('toJSON()', () => {
+        test('returns correct DocEnvelope shape', () => {
+            const registry = new DocRegistry({ basePath: '/api' });
+            const out = registry.toJSON();
+            expect(out).toHaveProperty('basePath');
+            expect(out).toHaveProperty('headers');
+            expect(out).toHaveProperty('errors');
+            expect(out).toHaveProperty('routes');
+        });
+        test('collects routes from all sources', () => {
+            const registry = new DocRegistry()
+                .from(makeSource([rpcDoc]))
+                .from(makeSource([apiDoc]))
+                .from(makeSource([streamDoc]));
+            const out = registry.toJSON();
+            expect(out.routes).toHaveLength(3);
+            expect(out.routes).toEqual([rpcDoc, apiDoc, streamDoc]);
+        });
+        test('empty when no sources', () => {
+            const out = new DocRegistry().toJSON();
+            expect(out.routes).toEqual([]);
+        });
+        test('headers and errors are copies', () => {
+            const headers = [{ name: 'X-Custom' }];
+            const errors = [{ name: 'E', statusCode: 500, description: 'd' }];
+            const registry = new DocRegistry({ headers, errors });
+            const out = registry.toJSON();
+            expect(out.headers).toEqual(headers);
+            expect(out.headers).not.toBe(headers);
+            expect(out.errors).toEqual(errors);
+            expect(out.errors).not.toBe(errors);
+        });
+    });
+    // --------------------------------------------------------------------------
+    // toJSON() filter
+    // --------------------------------------------------------------------------
+    describe('toJSON() filter', () => {
+        test('excludes routes by name', () => {
+            const registry = new DocRegistry()
+                .from(makeSource([rpcDoc]))
+                .from(makeSource([apiDoc]));
+            const out = registry.toJSON({ filter: (r) => r.name !== 'Echo' });
+            expect(out.routes).toHaveLength(1);
+            expect(out.routes[0].name).toBe('GetUser');
+        });
+        test('excludes routes by type field', () => {
+            const registry = new DocRegistry()
+                .from(makeSource([rpcDoc]))
+                .from(makeSource([apiDoc]));
+            const out = registry.toJSON({
+                filter: (r) => 'method' in r && r.method === 'post' && 'scope' in r,
+            });
+            expect(out.routes).toHaveLength(1);
+            expect(out.routes[0].name).toBe('Echo');
+        });
+        test('all filtered returns empty routes array', () => {
+            const registry = new DocRegistry().from(makeSource([rpcDoc]));
+            const out = registry.toJSON({ filter: () => false });
+            expect(out.routes).toEqual([]);
+        });
+    });
+    // --------------------------------------------------------------------------
+    // toJSON() transform
+    // --------------------------------------------------------------------------
+    describe('toJSON() transform', () => {
+        test('adds fields', () => {
+            const registry = new DocRegistry({ basePath: '/api' }).from(makeSource([rpcDoc]));
+            const out = registry.toJSON({
+                transform: (envelope) => ({ ...envelope, version: '2.0' }),
+            });
+            expect(out.version).toBe('2.0');
+            expect(out.basePath).toBe('/api');
+        });
+        test('reshapes envelope', () => {
+            const registry = new DocRegistry().from(makeSource([rpcDoc]));
+            const out = registry.toJSON({
+                transform: (envelope) => ({ count: envelope.routes.length }),
+            });
+            expect(out).toEqual({ count: 1 });
+        });
+        test('runs after filter', () => {
+            const registry = new DocRegistry()
+                .from(makeSource([rpcDoc]))
+                .from(makeSource([apiDoc]));
+            const out = registry.toJSON({
+                filter: (r) => r.name === 'Echo',
+                transform: (envelope) => ({ ...envelope, filteredCount: envelope.routes.length }),
+            });
+            expect(out.filteredCount).toBe(1);
+            expect(out.routes).toHaveLength(1);
+        });
+    });
+    // --------------------------------------------------------------------------
+    // defaultErrors()
+    // --------------------------------------------------------------------------
+    describe('defaultErrors()', () => {
+        test('returns 4 entries', () => {
+            const errors = DocRegistry.defaultErrors();
+            expect(errors).toHaveLength(4);
+        });
+        test('has correct error names', () => {
+            const names = DocRegistry.defaultErrors().map((e) => e.name);
+            expect(names).toEqual([
+                'ProcedureError',
+                'ProcedureValidationError',
+                'ProcedureYieldValidationError',
+                'ProcedureRegistrationError',
+            ]);
+        });
+        test('has correct status codes', () => {
+            const errors = DocRegistry.defaultErrors();
+            expect(errors[0].statusCode).toBe(500); // ProcedureError
+            expect(errors[1].statusCode).toBe(400); // ProcedureValidationError
+            expect(errors[2].statusCode).toBe(500); // ProcedureYieldValidationError
+            expect(errors[3].statusCode).toBe(500); // ProcedureRegistrationError
+        });
+        test('each entry has schema', () => {
+            for (const err of DocRegistry.defaultErrors()) {
+                expect(err.schema).toBeDefined();
+                expect(err.schema.type).toBe('object');
+            }
+        });
+        test('returns a new array each call', () => {
+            const a = DocRegistry.defaultErrors();
+            const b = DocRegistry.defaultErrors();
+            expect(a).not.toBe(b);
+            expect(a).toEqual(b);
+        });
+    });
+    // --------------------------------------------------------------------------
+    // kind discriminant
+    // --------------------------------------------------------------------------
+    describe('kind discriminant', () => {
+        it('rpcDoc fixture requires kind field', () => {
+            const doc = rpcDoc;
+            expect(doc.kind).toBe('rpc');
+        });
+        it('apiDoc fixture requires kind field', () => {
+            const doc = apiDoc;
+            expect(doc.kind).toBe('api');
+        });
+        it('streamDoc fixture requires kind field', () => {
+            const doc = streamDoc;
+            expect(doc.kind).toBe('stream');
+        });
+        it('narrows AnyHttpRouteDoc union via kind', () => {
+            const routes = [rpcDoc, apiDoc, streamDoc];
+            for (const route of routes) {
+                expect(route.kind).toBeDefined();
+            }
+        });
+    });
+    // --------------------------------------------------------------------------
+    // Integration
+    // --------------------------------------------------------------------------
+    describe('integration', () => {
+        test('multiple builder types composed', () => {
+            const registry = new DocRegistry({
+                basePath: '/api',
+                headers: [{ name: 'Authorization', description: 'Bearer token', required: false }],
+                errors: DocRegistry.defaultErrors(),
+            })
+                .from(makeSource([rpcDoc]))
+                .from(makeSource([apiDoc]))
+                .from(makeSource([streamDoc]));
+            const out = registry.toJSON();
+            expect(out.basePath).toBe('/api');
+            expect(out.headers).toHaveLength(1);
+            expect(out.errors).toHaveLength(4);
+            expect(out.routes).toHaveLength(3);
+        });
+        test('filter + transform combined', () => {
+            const registry = new DocRegistry({
+                basePath: '/api',
+                errors: DocRegistry.defaultErrors(),
+            })
+                .from(makeSource([rpcDoc]))
+                .from(makeSource([apiDoc]))
+                .from(makeSource([streamDoc]));
+            const out = registry.toJSON({
+                filter: (r) => r.name !== 'Feed',
+                transform: (envelope) => ({
+                    ...envelope,
+                    generatedAt: '2026-01-01',
+                }),
+            });
+            expect(out.routes).toHaveLength(2);
+            expect(out.routes.map((r) => r.name)).toEqual(['Echo', 'GetUser']);
+            expect(out.generatedAt).toBe('2026-01-01');
+        });
+        test('output is JSON.stringify-safe', () => {
+            const registry = new DocRegistry({
+                basePath: '/api',
+                headers: [{ name: 'X-Request-Id', example: 'abc-123' }],
+                errors: DocRegistry.defaultErrors(),
+            })
+                .from(makeSource([rpcDoc]))
+                .from(makeSource([apiDoc]));
+            const out = registry.toJSON();
+            const str = JSON.stringify(out);
+            expect(() => JSON.parse(str)).not.toThrow();
+            expect(JSON.parse(str)).toEqual(out);
+        });
+        test('JSON.stringify(registry) produces default envelope', () => {
+            const registry = new DocRegistry({ basePath: '/api' })
+                .from(makeSource([rpcDoc]));
+            const str = JSON.stringify(registry);
+            const parsed = JSON.parse(str);
+            expect(parsed.basePath).toBe('/api');
+            expect(parsed.routes).toHaveLength(1);
+            expect(parsed.routes[0].name).toBe('Echo');
+        });
+        test('accepts a real HonoRPCAppBuilder as source', () => {
+            const RPC = Procedures();
+            RPC.Create('Ping', { scope: 'ping', version: 1, schema: { params: v.object({ msg: v.string() }) } }, async (_ctx, params) => params);
+            const builder = new HonoRPCAppBuilder();
+            builder.register(RPC, () => ({ userId: '123' }));
+            builder.build();
+            const registry = new DocRegistry({ basePath: '/rpc' }).from(builder);
+            const out = registry.toJSON();
+            expect(out.basePath).toBe('/rpc');
+            expect(out.routes).toHaveLength(1);
+            expect(out.routes[0].name).toBe('Ping');
+            expect(out.routes[0]).toHaveProperty('jsonSchema');
+        });
+    });
+});
+//# sourceMappingURL=doc-registry.test.js.map

package/build/src/implementations/http/doc-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-registry.test.js","sourceRoot":"","sources":["../../../../src/implementations/http/doc-registry.test.ts"],"names":[],"mappings":"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"}

package/build/src/implementations/http/express-rpc/index.d.ts

@@ -0,0 +1,94 @@
+import express from 'express';
+import { TProcedureRegistration } from '../../../index.js';
+import { ExtractConfig, ExtractContext, ProceduresFactory, RPCConfig, RPCHttpRouteDoc } from '../../types.js';
+export type { RPCConfig, RPCHttpRouteDoc };
+export type ExpressRPCAppBuilderConfig = {
+    /**
+     * An existing Express application instance to use.
+     * When provided, ensure to set up necessary middleware (e.g., json/body parser) beforehand.
+     * If not provided, a new instance will be created.
+     */
+    app?: express.Express;
+    /** Optional path prefix for all RPC routes. */
+    pathPrefix?: string;
+    onRequestStart?: (req: express.Request) => void;
+    onRequestEnd?: (req: express.Request, res: express.Response) => void;
+    onSuccess?: (procedure: TProcedureRegistration, req: express.Request, res: express.Response) => void;
+    /**
+     * Error handler called when a procedure throws an error.
+     * @param procedure
+     * @param req
+     * @param res
+     * @param error
+     */
+    onError?: (procedure: TProcedureRegistration, req: express.Request, res: express.Response, error: Error) => void;
+};
+/**
+ * Builder class for creating an Express application with RPC routes.
+ *
+ * Usage:
+ *   const PublicRPC = Procedures<PublicRPCContext, RPCConfig>()
+ *   const ProtectedRPC = Procedures<ProtectedRPCContext, RPCConfig>()
+ *
+ *   const rpcApp = new ExpressRPCAppBuilder()
+ *     .register(PublicRPC, (req): Promise<PublicRPCContext> => { /* context resolution logic * / })
+ *     .register(ProtectedRPC, (req): Promise<ProtectedRPCContext> => { /* context resolution logic * / })
+ *     .build();
+ *
+ *   const app = rpcApp.app; // Express application
+ *   const docs = rpcApp.docs; // RPC route documentation
+ */
+export declare class ExpressRPCAppBuilder {
+    readonly config?: ExpressRPCAppBuilderConfig | undefined;
+    /**
+     * Constructor for ExpressRPCAppBuilder.
+     *
+     * @param config
+     */
+    constructor(config?: ExpressRPCAppBuilderConfig | undefined);
+    /**
+     * Generates the RPC route path based on the RPC configuration.
+     * The RPCConfig name can be a string or an array of strings to form nested paths.
+     *
+     * Example
+     *  name: ['string', 'string-string', 'string']
+     *  path: /string/string-string/string/version
+     * @param config
+     */
+    static makeRPCHttpRoutePath({ name, config, prefix, }: {
+        name: string;
+        prefix?: string;
+        config: RPCConfig;
+    }): string;
+    /**
+     * Instance method wrapper for makeRPCHttpRoutePath that uses the builder's pathPrefix.
+     * @param config - The RPC configuration
+     */
+    makeRPCHttpRoutePath(name: string, config: RPCConfig): string;
+    private factories;
+    private _app;
+    private _docs;
+    get app(): express.Express;
+    get docs(): RPCHttpRouteDoc[];
+    /**
+     * Registers a procedure factory with its context.
+     * @param factory - The procedure factory created by Procedures<Context, RPCConfig>()
+     * @param factoryContext - The context for procedure handlers. Can be a direct value,
+     *                         a sync function (req) => Context, or an async function (req) => Promise<Context>
+     * @param extendProcedureDoc - A custom function to extend the generated RPC route documentation for each procedure.
+     */
+    register<TFactory extends ProceduresFactory>(factory: TFactory, factoryContext: ExtractContext<TFactory> | ((req: express.Request) => ExtractContext<TFactory> | Promise<ExtractContext<TFactory>>), extendProcedureDoc?: (params: {
+        base: RPCHttpRouteDoc;
+        procedure: TProcedureRegistration<any, ExtractConfig<TFactory>>;
+    }) => Record<string, any>): this;
+    /**
+     * Builds and returns the Express application with registered RPC routes.
+     * @return express.Application
+     */
+    build(): express.Application;
+    /**
+     * Generates the RPC HTTP route for the given procedure.
+     * @param procedure
+     */
+    private buildRpcHttpRouteDoc;
+}

package/build/src/implementations/http/express-rpc/index.js

@@ -0,0 +1,185 @@
+import express from 'express';
+import { kebabCase } from 'es-toolkit/string';
+import { castArray } from 'es-toolkit/compat';
+/**
+ * Builder class for creating an Express application with RPC routes.
+ *
+ * Usage:
+ *   const PublicRPC = Procedures<PublicRPCContext, RPCConfig>()
+ *   const ProtectedRPC = Procedures<ProtectedRPCContext, RPCConfig>()
+ *
+ *   const rpcApp = new ExpressRPCAppBuilder()
+ *     .register(PublicRPC, (req): Promise<PublicRPCContext> => { /* context resolution logic * / })
+ *     .register(ProtectedRPC, (req): Promise<ProtectedRPCContext> => { /* context resolution logic * / })
+ *     .build();
+ *
+ *   const app = rpcApp.app; // Express application
+ *   const docs = rpcApp.docs; // RPC route documentation
+ */
+export class ExpressRPCAppBuilder {
+    config;
+    /**
+     * Constructor for ExpressRPCAppBuilder.
+     *
+     * @param config
+     */
+    constructor(config) {
+        this.config = config;
+        if (config?.app) {
+            this._app = config.app;
+        }
+        else {
+            // Default middleware if no app is provided
+            this._app.use(express.json());
+        }
+        if (config?.onRequestStart) {
+            this._app.use((req, res, next) => {
+                config.onRequestStart(req);
+                next();
+            });
+        }
+        if (config?.onRequestEnd) {
+            this._app.use((req, res, next) => {
+                res.on('finish', () => {
+                    config.onRequestEnd(req, res);
+                });
+                next();
+            });
+        }
+    }
+    /**
+     * Generates the RPC route path based on the RPC configuration.
+     * The RPCConfig name can be a string or an array of strings to form nested paths.
+     *
+     * Example
+     *  name: ['string', 'string-string', 'string']
+     *  path: /string/string-string/string/version
+     * @param config
+     */
+    static makeRPCHttpRoutePath({ name, config, prefix, }) {
+        const normalizedPrefix = prefix ? (prefix.startsWith('/') ? prefix : `/${prefix}`) : '';
+        return `${normalizedPrefix}/${castArray(config.scope).map(kebabCase).join('/')}/${kebabCase(name)}/${String(config.version).trim()}`;
+    }
+    /**
+     * Instance method wrapper for makeRPCHttpRoutePath that uses the builder's pathPrefix.
+     * @param config - The RPC configuration
+     */
+    makeRPCHttpRoutePath(name, config) {
+        return ExpressRPCAppBuilder.makeRPCHttpRoutePath({
+            name,
+            config,
+            prefix: this.config?.pathPrefix,
+        });
+    }
+    factories = [];
+    _app = express();
+    _docs = [];
+    get app() {
+        return this._app;
+    }
+    get docs() {
+        return this._docs;
+    }
+    /**
+     * Registers a procedure factory with its context.
+     * @param factory - The procedure factory created by Procedures<Context, RPCConfig>()
+     * @param factoryContext - The context for procedure handlers. Can be a direct value,
+     *                         a sync function (req) => Context, or an async function (req) => Promise<Context>
+     * @param extendProcedureDoc - A custom function to extend the generated RPC route documentation for each procedure.
+     */
+    register(factory, factoryContext, extendProcedureDoc) {
+        this.factories.push({ factory, factoryContext, extendProcedureDoc });
+        return this;
+    }
+    /**
+     * Builds and returns the Express application with registered RPC routes.
+     * @return express.Application
+     */
+    build() {
+        this.factories.forEach(({ factory, factoryContext, extendProcedureDoc }) => {
+            factory.getProcedures().map((procedure) => {
+                const route = this.buildRpcHttpRouteDoc(procedure, extendProcedureDoc);
+                this._docs.push(route);
+                this._app[route.method](route.path, async (req, res) => {
+                    try {
+                        const context = typeof factoryContext === 'function'
+                            ? await factoryContext(req)
+                            : factoryContext;
+                        let ac;
+                        const ctxWithSignal = Object.defineProperty({ ...context }, 'signal', {
+                            get() {
+                                if (!ac) {
+                                    ac = new AbortController();
+                                    req.on('close', () => { if (!res.writableFinished)
+                                        ac.abort(); });
+                                }
+                                return ac.signal;
+                            },
+                            enumerable: true,
+                        });
+                        res.json(await procedure.handler(ctxWithSignal, req.body));
+                        if (this.config?.onSuccess) {
+                            this.config.onSuccess(procedure, req, res);
+                        }
+                        // if status not set, set to 200
+                        if (!res.status) {
+                            res.status(200);
+                        }
+                    }
+                    catch (error) {
+                        if (this.config?.onError) {
+                            this.config.onError(procedure, req, res, error);
+                            return;
+                        }
+                        if (!res.status) {
+                            res.status(500);
+                        }
+                        // if no res.json set, set default error message
+                        if (!res.headersSent) {
+                            res.json({ error: error.message });
+                        }
+                    }
+                });
+            });
+        });
+        return this._app;
+    }
+    /**
+     * Generates the RPC HTTP route for the given procedure.
+     * @param procedure
+     */
+    buildRpcHttpRouteDoc(procedure, extendProcedureDoc) {
+        const { config } = procedure;
+        const path = ExpressRPCAppBuilder.makeRPCHttpRoutePath({
+            name: procedure.name,
+            config,
+            prefix: this.config?.pathPrefix,
+        });
+        const method = 'post'; // RPCs use POST method
+        const jsonSchema = {};
+        if (config.schema?.params) {
+            jsonSchema.body = config.schema.params;
+        }
+        if (config.schema?.returnType) {
+            jsonSchema.response = config.schema.returnType;
+        }
+        const base = {
+            kind: 'rpc',
+            name: procedure.name,
+            version: config.version,
+            scope: config.scope,
+            path,
+            method,
+            jsonSchema,
+        };
+        let extendedDoc = {};
+        if (extendProcedureDoc) {
+            extendedDoc = extendProcedureDoc({ base, procedure });
+        }
+        return {
+            ...extendedDoc,
+            ...base,
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/src/implementations/http/express-rpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/implementations/http/express-rpc/index.ts"],"names":[],"mappings":"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"}