@sockethub/schemas 3.0.0-alpha.4 → 3.0.0-alpha.5

package/dist/schemas/activity-stream.d.ts

@@ -1,239 +0,0 @@
-declare const _default: {
-    $id: string;
-    description: string;
-    type: string;
-    required: string[];
-    properties: {
-        id: {
-            type: string;
-        };
-        type: {
-            type: string;
-        };
-        context: {
-            type: string;
-        };
-        actor: {
-            type: string;
-            oneOf: any[];
-        };
-        target: {
-            type: string;
-            oneOf: any[];
-        };
-        object: {
-            type: string;
-            oneOf: any[];
-        };
-        published: {
-            type: string;
-            format: string;
-        };
-    };
-    definitions: {
-        type: {
-            credentials: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    type: {
-                        enum: string[];
-                    };
-                };
-            };
-            feed: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    type: {
-                        enum: string[];
-                    };
-                    id: {
-                        type: string;
-                        format: string;
-                    };
-                    name: {
-                        type: string;
-                    };
-                    description: {
-                        type: string;
-                    };
-                    author: {
-                        type: string;
-                    };
-                    favicon: {
-                        type: string;
-                    };
-                };
-            };
-            message: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    type: {
-                        enum: string[];
-                    };
-                    id: {
-                        type: string;
-                    };
-                    name: {
-                        type: string;
-                    };
-                    content: {
-                        type: string;
-                    };
-                };
-            };
-            me: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    type: {
-                        enum: string[];
-                    };
-                    content: {
-                        type: string;
-                    };
-                };
-            };
-            person: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    id: {
-                        type: string;
-                    };
-                    type: {
-                        enum: string[];
-                    };
-                    name: {
-                        type: string;
-                    };
-                };
-            };
-            room: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    id: {
-                        type: string;
-                    };
-                    type: {
-                        enum: string[];
-                    };
-                    name: {
-                        type: string;
-                    };
-                };
-            };
-            service: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    id: {
-                        type: string;
-                    };
-                    type: {
-                        enum: string[];
-                    };
-                    name: {
-                        type: string;
-                    };
-                };
-            };
-            website: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    id: {
-                        type: string;
-                        format: string;
-                    };
-                    type: {
-                        enum: string[];
-                    };
-                    name: {
-                        type: string;
-                    };
-                };
-            };
-            attendance: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    type: {
-                        enum: string[];
-                    };
-                    members: {
-                        type: string;
-                        items: {
-                            type: string;
-                        };
-                    };
-                };
-            };
-            presence: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    type: {
-                        enum: string[];
-                    };
-                    presence: {
-                        enum: string[];
-                    };
-                    role: {
-                        enum: string[];
-                    };
-                    content: {
-                        type: string;
-                    };
-                };
-            };
-            relationship: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    type: {
-                        enum: string[];
-                    };
-                    relationship: {
-                        enum: string[];
-                    };
-                    subject: {
-                        type: string;
-                        oneOf: {
-                            $ref: string;
-                        }[];
-                    };
-                    object: {
-                        type: string;
-                        oneOf: any[];
-                    };
-                };
-            };
-            topic: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    type: {
-                        enum: string[];
-                    };
-                    content: {
-                        type: string;
-                    };
-                };
-            };
-            address: {
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    type: {
-                        enum: string[];
-                    };
-                };
-            };
-        };
-    };
-};
-export default _default;

package/dist/schemas/activity-stream.js

@@ -1,53 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const activity_object_1 = __importDefault(require("./activity-object"));
-const objects_1 = require("../helpers/objects");
-const validActorRefs = activity_object_1.default.properties.object.oneOf;
-const validTargetRefs = activity_object_1.default.properties.object.oneOf;
-// eslint-disable-next-line security-node/detect-crlf
-console.log(validActorRefs);
-const validObjectRefs = [];
-objects_1.ObjectTypesList.forEach(function (type) {
-    validObjectRefs.push({ "$ref": "#/definitions/type/" + type });
-});
-const contextSchema = {
-    "type": "string"
-};
-const typeSchema = {
-    "type": "string"
-};
-exports.default = {
-    "$id": "https://sockethub.org/schemas/v0/activity-stream#",
-    "description": "Schema for Sockethub Activity Streams",
-    "type": "object",
-    "required": ["context", "type", "actor"],
-    "properties": {
-        "id": {
-            "type": "string"
-        },
-        "type": typeSchema,
-        "context": contextSchema,
-        "actor": {
-            "type": "object",
-            "oneOf": validActorRefs
-        },
-        "target": {
-            "type": "object",
-            "oneOf": validTargetRefs
-        },
-        "object": {
-            "type": "object",
-            "oneOf": validObjectRefs
-        },
-        "published": {
-            "type": "string",
-            "format": "date-time"
-        }
-    },
-    "definitions": {
-        "type": objects_1.ObjectTypesSchema
-    }
-};

package/dist/schemas/platform.d.ts

@@ -1,41 +0,0 @@
-/**
- * This file is part of Sockethub.
- *
- * Developed by Nick Jennings (https://github.com/silverbucket)
- *
- * server is licensed under the LGPL.
- * See the LICENSE file for details.
- *
- * The latest version of server can be found here:
- *   git://github.com/sockethub/sockethub.git
- *
- * For more information about Sockethub visit https://sockethub.org/.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
- */
-declare const _default: {
-    type: string;
-    required: string[];
-    additionalProperties: boolean;
-    properties: {
-        credentials: {
-            title: string;
-            type: string;
-        };
-        messages: {
-            title: string;
-            type: string;
-        };
-        name: {
-            title: string;
-            type: string;
-        };
-        version: {
-            title: string;
-            type: string;
-        };
-    };
-};
-export default _default;

package/dist/schemas/platform.js

@@ -1,44 +0,0 @@
-"use strict";
-/**
- * This file is part of Sockethub.
- *
- * Developed by Nick Jennings (https://github.com/silverbucket)
- *
- * server is licensed under the LGPL.
- * See the LICENSE file for details.
- *
- * The latest version of server can be found here:
- *   git://github.com/sockethub/sockethub.git
- *
- * For more information about Sockethub visit https://sockethub.org/.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-// this schema defines the general structure of the schema object which should
-// be returned from platforms.
-exports.default = {
-    'type': 'object',
-    'required': ['name', 'version', 'messages'],
-    'additionalProperties': false,
-    'properties': {
-        'credentials': {
-            'title': 'credentials',
-            'type': 'object'
-        },
-        'messages': {
-            'title': 'messages',
-            'type': 'object',
-        },
-        'name': {
-            'title': 'name',
-            'type': 'string',
-        },
-        'version': {
-            'title': 'version',
-            'type': 'string',
-        }
-    }
-};

package/dist/types.d.ts

@@ -1,34 +0,0 @@
-export interface IActivityStream {
-    type: string;
-    context: string;
-    actor: IActivityObjectActor;
-    object?: IActivityObjectObject;
-    target?: IActivityObjectActor;
-    error?: string;
-    sessionSecret?: string;
-}
-export interface IActivityObject {
-    id?: string;
-    type: string;
-}
-export interface IActivityObjectActor extends IActivityObject {
-    id: string;
-    name?: string;
-}
-export interface IActivityObjectObject extends IActivityObject {
-    content?: never;
-}
-declare type ErrorMsg = string | Error;
-export interface CallbackInterface {
-    (err?: ErrorMsg, data?: unknown): void;
-}
-export interface CallbackActivityStreamInterface {
-    (data: IActivityStream | Error): void;
-}
-export interface CompletedJobHandler {
-    (data: IActivityStream): void;
-}
-export interface LogInterface {
-    (msg: string): void;
-}
-export {};

package/dist/types.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/validator.d.ts

@@ -1,8 +0,0 @@
-import { Schema } from 'ajv';
-import { IActivityStream } from "./types";
-export declare function validateActivityObject(msg: IActivityStream): string;
-export declare function validateActivityStream(msg: IActivityStream): string;
-export declare function validateCredentials(msg: IActivityStream): string;
-export declare function validatePlatformSchema(schema: Schema): string;
-export declare function addPlatformSchema(schema: Schema, platform_type: string): void;
-export declare function getPlatformSchema(platform_type: string): import("ajv/dist/types").AnyValidateFunction<unknown>;

package/dist/validator.js

@@ -1,80 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPlatformSchema = exports.addPlatformSchema = exports.validatePlatformSchema = exports.validateCredentials = exports.validateActivityStream = exports.validateActivityObject = void 0;
-const debug_1 = __importDefault(require("debug"));
-const ajv_1 = __importDefault(require("ajv"));
-const ajv_formats_1 = __importDefault(require("ajv-formats"));
-const ajv_formats_draft2019_1 = __importDefault(require("ajv-formats-draft2019"));
-const error_parser_1 = __importDefault(require("./helpers/error-parser"));
-const platform_1 = __importDefault(require("./schemas/platform"));
-const activity_stream_1 = __importDefault(require("./schemas/activity-stream"));
-const activity_object_1 = __importDefault(require("./schemas/activity-object"));
-const log = (0, debug_1.default)('sockethub:schemas');
-const ajv = new ajv_1.default({ strictTypes: false, allErrors: true });
-(0, ajv_formats_1.default)(ajv);
-(0, ajv_formats_draft2019_1.default)(ajv);
-const schemaURL = 'https://sockethub.org/schemas/v0';
-const schemas = {};
-schemas[`${schemaURL}/activity-stream`] = activity_stream_1.default;
-schemas[`${schemaURL}/activity-object`] = activity_object_1.default;
-for (const uri in schemas) {
-    log(`registering schema ${uri}`);
-    ajv.addSchema(schemas[uri], uri);
-}
-function handleValidation(schemaRef, msg, isObject = false) {
-    const validator = ajv.getSchema(schemaRef);
-    let result;
-    if (isObject) {
-        result = validator({ object: msg });
-    }
-    else {
-        result = validator(msg);
-    }
-    if (!result) {
-        return (0, error_parser_1.default)(msg, validator.errors);
-    }
-    return "";
-}
-function validateActivityObject(msg) {
-    return handleValidation(`${schemaURL}/activity-object`, msg, true);
-}
-exports.validateActivityObject = validateActivityObject;
-function validateActivityStream(msg) {
-    return handleValidation(`${schemaURL}/activity-stream`, msg);
-}
-exports.validateActivityStream = validateActivityStream;
-function validateCredentials(msg) {
-    if (!msg.context) {
-        return 'credential activity streams must have a context set';
-    }
-    if (msg.type !== 'credentials') {
-        return 'credential activity streams must have credentials set as type';
-    }
-    return handleValidation(`${schemaURL}/context/${msg.context}/credentials`, msg);
-}
-exports.validateCredentials = validateCredentials;
-function validatePlatformSchema(schema) {
-    const validate = ajv.compile(platform_1.default);
-    // validate schema property
-    const err = validate(schema);
-    if (!err) {
-        return `platform schema failed to validate: ` +
-            `${validate.errors[0].instancePath} ${validate.errors[0].message}`;
-    }
-    else {
-        return "";
-    }
-}
-exports.validatePlatformSchema = validatePlatformSchema;
-function addPlatformSchema(schema, platform_type) {
-    log(`registering schema ${schemaURL}/context/${platform_type}`);
-    ajv.addSchema(schema, `${schemaURL}/context/${platform_type}`);
-}
-exports.addPlatformSchema = addPlatformSchema;
-function getPlatformSchema(platform_type) {
-    return ajv.getSchema(`${schemaURL}/context/${platform_type}`);
-}
-exports.getPlatformSchema = getPlatformSchema;

package/src/helpers/error-parser.ts

@@ -1,96 +0,0 @@
-import {ErrorObject} from "ajv";
-import {ObjectTypesList} from "./objects";
-import {IActivityStream, IActivityObject} from "../types";
-
-interface TypeBreakdown {
-  actor: Array<string>,
-  object: Array<string>,
-  target: Array<string>
-}
-
-function parseMsg(error: ErrorObject): string {
-  let err = `${error.instancePath ? error.instancePath : 'activity stream'}: ${error.message}`;
-  if (error.keyword === 'additionalProperties') {
-    err += `: ${error.params.additionalProperty}`;
-  } else if (error.keyword === 'enum') {
-    err += `: ${error.params.allowedValues.join(', ')}`;
-  }
-  return err;
-}
-
-function getTypeList(msg: IActivityStream | IActivityObject): Array<string> {
-  let types = [];
-  types.push(msg?.type);
-  for (const prop in msg) {
-    if (msg[prop]?.type) {
-      types = [...types, ...getTypeList(msg[prop])];
-    }
-  }
-  return types;
-}
-
-function getSchemaType(error: ErrorObject): string {
-  const schemaTypeRes = error.schemaPath.match(/#\/\w+\/\w+\/([\w-]+)\//);
-  return schemaTypeRes ? schemaTypeRes[1] : undefined;
-}
-
-function getErrType(error: ErrorObject): string {
-  const errTypeRes = error.instancePath.match(/\/(\w+)/);
-  return errTypeRes ? errTypeRes[1] : undefined;
-}
-
-function getPartsCount(error: ErrorObject, types: TypeBreakdown): number {
-  const schemaType = getSchemaType(error);
-  const errType = getErrType(error);
-  if (!errType) { return -1; }
-  if (!types[errType]) { return -1; }
-  if (!types[errType].includes(schemaType)) { return -1; }
-  const parts = error.instancePath.split('/');
-  return parts.length;
-}
-
-function getTypes(msg: IActivityStream): TypeBreakdown {
-  return {
-    actor: getTypeList(msg.actor),
-    target: getTypeList(msg.target),
-    object: getTypeList(msg.context ? msg.object : msg)
-  };
-}
-
-/**
- * Traverses the errors array from ajv, and makes a series of filtering decisions to
- * try to arrive at the most useful error.
- * @param msg
- * @param errors
- * @returns {string}
- */
-export default function getErrorMessage(msg, errors: Array<ErrorObject>): string {
-  const types = getTypes(msg);
-  let deepest_entry = 0, highest_depth = -1;
-
-  for (let i = 0; i < errors.length; i++) {
-    const partsCount = getPartsCount(errors[i], types);
-    if (partsCount > highest_depth) {
-      highest_depth = partsCount;
-      deepest_entry = i;
-    }
-  }
-
-  return highest_depth >= 0 ?
-    parseMsg(errors[deepest_entry]) :
-    composeFinalError(errors[errors.length - 1]);
-}
-
-function composeFinalError(error) {
-  // if we have yet to build an error message, assume this is an invalid type value (oneOf),
-  // try to build a list of valid types
-  let msg: string;
-  if (error.keyword === 'oneOf') {
-    msg = `${error.instancePath}: ${error.message}: ` +
-      `${ObjectTypesList.join(', ')}`;
-  } else {
-    msg = `${error.instancePath ?
-      error.instancePath : 'activity stream'}: ${error.message}`;
-  }
-  return msg;
-}