@webpieces/core-util 0.4.760 → 0.4.762

package/src/ipc/IpcCompileAssertions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IpcCompileAssertions.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/ipc/IpcCompileAssertions.ts"],"names":[],"mappings":";;;AAAA,+CAA8E;AAC9E,uDAAgD;AAChD,MAAM,OAAO;IACY;IAArB,YAAqB,EAAU;QAAV,OAAE,GAAF,EAAE,CAAQ;IAAG,CAAC;CACtC;AACD,MAAM,MAAM;IACR,0IAA0I;IAC1I,KAAK,CAAC,KAAc;QAChB,IAAI,CAAC,CAAC,KAAK,YAAY,OAAO,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACrE,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AACD,MAAe,GAAG;CAGjB;AACD,MAAM,UAAU;IACH,KAAK,GAAG,IAAI,uBAAS,CAAC,OAAO,EAAE,IAAI,MAAM,EAAE,EAAE,IAAI,MAAM,EAAE,EAAE,IAAI,uBAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;CACzF;AACD,MAAe,WAAW;CAEzB;AACD,oGAAoG;AACpG,MAAa,oBAAoB;IAC7B,oIAAoI;IACpI,MAAM,CAAC,wBAAwB;QAC3B,oEAAoE;QACpE,IAAI,yBAAW,CAAC,YAAY,EAAE,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC,CAAC;QACrD,wEAAwE;QACxE,MAAM,QAAQ,GAA4B,IAAI,UAAU,EAAE,CAAC;QAC3D,KAAK,QAAQ,CAAC;IAClB,CAAC;CACJ;AATD,oDASC","sourcesContent":["import { IpcContract, IpcMethod, IpcMethods, IpcSchema } from './IpcContract';\nimport { MaskSpec } from '../http/LogFieldMask';\nclass Request {\n    constructor(readonly id: string) {}\n}\nclass Schema implements IpcSchema<Request> {\n    // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n    parse(value: unknown): Request {\n        if (!(value instanceof Request)) throw new Error('Expected Request');\n        return value;\n    }\n}\nabstract class Api {\n    abstract first(request: Request): Promise<Request>;\n    abstract second(request: Request): Promise<Request>;\n}\nclass Incomplete {\n    readonly first = new IpcMethod('first', new Schema(), new Schema(), new MaskSpec({}));\n}\nabstract class MultipleApi {\n    abstract bad(a: Request, b: Request): Promise<Request>;\n}\n/** These assertions compile in package builds, unlike transpiled-only spec files. Never invoked. */\nexport class IpcCompileAssertions {\n    // webpieces-disable no-function-outside-class -- portable stateless IPC primitive; no platform DI container exists on this boundary\n    static assertExhaustiveMetadata(): void {\n        // @ts-expect-error every API member needs explicit runtime metadata\n        new IpcContract('incomplete', Api, new Incomplete());\n        // @ts-expect-error multi-argument API methods are not IPC DTO contracts\n        const multiple: IpcMethods<MultipleApi> = new Incomplete();\n        void multiple;\n    }\n}\n"]}

package/src/ipc/IpcContract.d.ts

@@ -1,32 +0,0 @@
-import { MaskSpec } from '../http/LogFieldMask';
-/** A portable schema owns parsing and validation, including class reconstruction. */
-export interface IpcSchema<T> {
-    parse(value: unknown): T;
-}
-/** Acknowledged void has an explicit null wire representation. */
-export declare class IpcVoidSchema implements IpcSchema<void> {
-    parse(value: unknown): void;
-}
-export declare class IpcMethod<Q, R> {
-    readonly id: string;
-    readonly request: IpcSchema<Q>;
-    readonly response: IpcSchema<R>;
-    readonly mask: MaskSpec;
-    readonly kind: 'request' | 'notification';
-    constructor(id: string, request: IpcSchema<Q>, response: IpcSchema<R>, mask: MaskSpec, kind?: 'request' | 'notification');
-}
-/** Every API member must have exactly one DTO argument and a Promise reply. */
-export type IpcMethods<T> = {
-    [K in keyof T]: T[K] extends (...args: infer A) => Promise<infer R> ? A extends [infer Q] ? IpcMethod<Q, R> : never : never;
-};
-export type IpcApiType<T> = abstract new (...args: never[]) => T;
-/** Runtime metadata is declared once beside the shared contract. IDs survive minification. */
-export declare class IpcContract<T extends object> {
-    readonly id: string;
-    readonly api: IpcApiType<T>;
-    readonly methods: Readonly<IpcMethods<T>>;
-    constructor(id: string, api: IpcApiType<T>, methods: IpcMethods<T>);
-}
-export declare class IpcIdentity {
-    static assert(value: unknown, label: string): asserts value is string;
-}

package/src/ipc/IpcContract.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IpcIdentity = exports.IpcContract = exports.IpcMethod = exports.IpcVoidSchema = void 0;
-const errors_1 = require("../errors");
-/** Acknowledged void has an explicit null wire representation. */
-class IpcVoidSchema {
-    // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation
-    parse(value) {
-        if (value !== null && value !== undefined) {
-            throw new errors_1.BadRequestError('Expected an acknowledged void response');
-        }
-    }
-}
-exports.IpcVoidSchema = IpcVoidSchema;
-class IpcMethod {
-    id;
-    request;
-    response;
-    mask;
-    kind;
-    constructor(id, request, response, mask, kind = 'request') {
-        this.id = id;
-        this.request = request;
-        this.response = response;
-        this.mask = mask;
-        this.kind = kind;
-        IpcIdentity.assert(id, 'method');
-    }
-}
-exports.IpcMethod = IpcMethod;
-/** Runtime metadata is declared once beside the shared contract. IDs survive minification. */
-class IpcContract {
-    id;
-    api;
-    methods;
-    constructor(id, api, methods) {
-        this.id = id;
-        this.api = api;
-        IpcIdentity.assert(id, 'API');
-        const ids = new Set();
-        for (const key of Object.keys(methods)) {
-            // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation
-            const method = methods[key];
-            if (!(method instanceof IpcMethod) ||
-                ids.has(method.id) ||
-                ['then', 'constructor', '__proto__'].includes(key)) {
-                throw new errors_1.BadRequestError(`Invalid or duplicate IPC metadata: ${id}.${key}`);
-            }
-            ids.add(method.id);
-            Object.freeze(method);
-        }
-        this.methods = Object.freeze(Object.assign(Object.create(null), methods));
-    }
-}
-exports.IpcContract = IpcContract;
-class IpcIdentity {
-    // webpieces-disable no-function-outside-class -- portable stateless IPC primitive; no platform DI container exists on this boundary; webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation
-    static assert(value, label) {
-        if (typeof value !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9_.:-]{0,127}$/.test(value)) {
-            throw new errors_1.BadRequestError(`Invalid IPC ${label} identity`);
-        }
-    }
-}
-exports.IpcIdentity = IpcIdentity;
-//# sourceMappingURL=IpcContract.js.map

package/src/ipc/IpcContract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IpcContract.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/ipc/IpcContract.ts"],"names":[],"mappings":";;;AACA,sCAA4C;AAQ5C,kEAAkE;AAClE,MAAa,aAAa;IACtB,0IAA0I;IAC1I,KAAK,CAAC,KAAc;QAChB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,wBAAe,CAAC,wCAAwC,CAAC,CAAC;QACxE,CAAC;IACL,CAAC;CACJ;AAPD,sCAOC;AAED,MAAa,SAAS;IAEL;IACA;IACA;IACA;IACA;IALb,YACa,EAAU,EACV,OAAqB,EACrB,QAAsB,EACtB,IAAc,EACd,OAAmC,SAAS;QAJ5C,OAAE,GAAF,EAAE,CAAQ;QACV,YAAO,GAAP,OAAO,CAAc;QACrB,aAAQ,GAAR,QAAQ,CAAc;QACtB,SAAI,GAAJ,IAAI,CAAU;QACd,SAAI,GAAJ,IAAI,CAAwC;QAErD,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;CACJ;AAVD,8BAUC;AAYD,8FAA8F;AAC9F,MAAa,WAAW;IAGP;IACA;IAHJ,OAAO,CAA0B;IAC1C,YACa,EAAU,EACV,GAAkB,EAC3B,OAAsB;QAFb,OAAE,GAAF,EAAE,CAAQ;QACV,QAAG,GAAH,GAAG,CAAe;QAG3B,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,0IAA0I;YAC1I,MAAM,MAAM,GAAY,OAAO,CAAC,GAAc,CAAC,CAAC;YAChD,IACI,CAAC,CAAC,MAAM,YAAY,SAAS,CAAC;gBAC9B,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClB,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EACpD,CAAC;gBACC,MAAM,IAAI,wBAAe,CAAC,sCAAsC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9E,CAAC;CACJ;AAxBD,kCAwBC;AAED,MAAa,WAAW;IACpB,6QAA6Q;IAC7Q,MAAM,CAAC,MAAM,CAAC,KAAc,EAAE,KAAa;QACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,qCAAqC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,wBAAe,CAAC,eAAe,KAAK,WAAW,CAAC,CAAC;QAC/D,CAAC;IACL,CAAC;CACJ;AAPD,kCAOC","sourcesContent":["import { MaskSpec } from '../http/LogFieldMask';\nimport { BadRequestError } from '../errors';\n\n/** A portable schema owns parsing and validation, including class reconstruction. */\nexport interface IpcSchema<T> {\n    // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n    parse(value: unknown): T;\n}\n\n/** Acknowledged void has an explicit null wire representation. */\nexport class IpcVoidSchema implements IpcSchema<void> {\n    // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n    parse(value: unknown): void {\n        if (value !== null && value !== undefined) {\n            throw new BadRequestError('Expected an acknowledged void response');\n        }\n    }\n}\n\nexport class IpcMethod<Q, R> {\n    constructor(\n        readonly id: string,\n        readonly request: IpcSchema<Q>,\n        readonly response: IpcSchema<R>,\n        readonly mask: MaskSpec,\n        readonly kind: 'request' | 'notification' = 'request',\n    ) {\n        IpcIdentity.assert(id, 'method');\n    }\n}\n\n/** Every API member must have exactly one DTO argument and a Promise reply. */\nexport type IpcMethods<T> = {\n    [K in keyof T]: T[K] extends (...args: infer A) => Promise<infer R>\n        ? A extends [infer Q]\n            ? IpcMethod<Q, R>\n            : never\n        : never;\n};\nexport type IpcApiType<T> = abstract new (...args: never[]) => T;\n\n/** Runtime metadata is declared once beside the shared contract. IDs survive minification. */\nexport class IpcContract<T extends object> {\n    readonly methods: Readonly<IpcMethods<T>>;\n    constructor(\n        readonly id: string,\n        readonly api: IpcApiType<T>,\n        methods: IpcMethods<T>,\n    ) {\n        IpcIdentity.assert(id, 'API');\n        const ids = new Set<string>();\n        for (const key of Object.keys(methods)) {\n            // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n            const method: unknown = methods[key as keyof T];\n            if (\n                !(method instanceof IpcMethod) ||\n                ids.has(method.id) ||\n                ['then', 'constructor', '__proto__'].includes(key)\n            ) {\n                throw new BadRequestError(`Invalid or duplicate IPC metadata: ${id}.${key}`);\n            }\n            ids.add(method.id);\n            Object.freeze(method);\n        }\n        this.methods = Object.freeze(Object.assign(Object.create(null), methods));\n    }\n}\n\nexport class IpcIdentity {\n    // webpieces-disable no-function-outside-class -- portable stateless IPC primitive; no platform DI container exists on this boundary; webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n    static assert(value: unknown, label: string): asserts value is string {\n        if (typeof value !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9_.:-]{0,127}$/.test(value)) {\n            throw new BadRequestError(`Invalid IPC ${label} identity`);\n        }\n    }\n}\n"]}