{"id":21971755,"url":"https://github.com/cristopher1/json-serializer-base-serializers","last_synced_at":"2026-05-06T22:08:48.989Z","repository":{"id":194598702,"uuid":"690221655","full_name":"cristopher1/json-serializer-base-serializers","owner":"cristopher1","description":"A set of serializers used by the npm package @cljimenez/json-serializer-core.","archived":false,"fork":false,"pushed_at":"2023-10-28T02:17:30.000Z","size":394,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-22T10:49:28.707Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@cljimenez/json-serializer-base-serializers","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cristopher1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-11T19:15:32.000Z","updated_at":"2023-11-06T17:00:38.000Z","dependencies_parsed_at":"2023-10-14T20:04:51.326Z","dependency_job_id":"20adbe37-2138-4f86-b57d-e622cdf53a23","html_url":"https://github.com/cristopher1/json-serializer-base-serializers","commit_stats":null,"previous_names":["cristopher1/jsonserializerplugins","cristopher1/json-serializer-plugins","cristopher1/json-serializer-base-serializers"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/cristopher1/json-serializer-base-serializers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristopher1%2Fjson-serializer-base-serializers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristopher1%2Fjson-serializer-base-serializers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristopher1%2Fjson-serializer-base-serializers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristopher1%2Fjson-serializer-base-serializers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cristopher1","download_url":"https://codeload.github.com/cristopher1/json-serializer-base-serializers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristopher1%2Fjson-serializer-base-serializers/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32713881,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T19:35:05.142Z","status":"ssl_error","status_checked_at":"2026-05-06T19:35:03.996Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-29T14:55:32.586Z","updated_at":"2026-05-06T22:08:48.960Z","avatar_url":"https://github.com/cristopher1.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eWelcome to @cljimenez/json-serializer-base-serializers 👋\u003c/h1\u003e\n\u003cp\u003e\n  \u003cimg alt=\"Version\" src=\"https://img.shields.io/badge/version-1.0.2-blue.svg?cacheSeconds=2592000\" /\u003e\n  \u003ca href=\"https://github.com/cristopher1/json-serializer-plugins#readme\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Documentation\" src=\"https://img.shields.io/badge/documentation-yes-brightgreen.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/cristopher1/json-serializer-plugins/graphs/commit-activity\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Maintenance\" src=\"https://img.shields.io/badge/Maintained%3F-yes-green.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/cristopher1/json-serializer-plugins/blob/master/LICENSE\" target=\"_blank\"\u003e\n    \u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/github/license/cristopher1/json-serializer-base-serializers\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e A set of serializers used by the npm package @cljimenez/json-serializer-core.\n\n### 🏠 [Homepage](https://github.com/cristopher1/json-serializer-plugins#readme)\n\n### [See @cljimenez/json-serializer-base-serializers in npm](https://www.npmjs.com/package/@cljimenez/json-serializer-base-serializers)\n\n### [Index](#index)\n\n- [Install](#install)\n- [Prerequisites](#prerequisites)\n- [What is a Serializer?](#what-is-a-serializer?)\n  - [About methods](#about-method)\n- [How to use?](#how-to-use?)\n  - [1. Install base serializers using the installer object (baseSerializerInstaller)](#using-installer)\n  - [2. Add Serializers separately](#add-serializers-separately)\n- [Author](#author)\n- [Contributing](#contributing)\n- [License](#license)\n\n## \u003ca id=\"install\"\u003e\u003c/a\u003e Install\n\n```sh\nnpm install @cljimenez/json-serializer-base-serializers\n```\n\n## \u003ca id=\"prerequisites\"\u003e\u003c/a\u003e Prerequisites\n\nIf you want to use `@cljimenez/json-serializer-base-serializers` with `@cljimenez/json-serializer-core`, you must install both packages.\n\n```script\nnpm install @cljimenez/json-serializer-core @cljimenez/json-serializer-base-serializers\n```\n\n## \u003ca id=\"what-is-a-serializer?\"\u003e\u003c/a\u003e What is a Serializer?\n\nA Serializer is an object that contains three methods:\n\n- **getSerializerType(void)=\u003estring**\n- **serialize(unserializedData: any)=\u003eobject**\n- **parse(serializedData: object)=\u003eany**\n\nThe `@cljimenez/json-serializer-base-serializers` includes five serializers:\n\n- **BigIntSerializer**: Serializes and unserializes `big integer`.\n- **DateSerializer**: Serializes and unserializes `dates`.\n- **FunctionSerializer**: Serializes and unserializes `functions`.\n- **MapSerializer**: Serializes and unserializes `maps`.\n- **SetSerializer**: Serializes and unserializes `sets`.\n\n### \u003ca id=\"about-method\"\u003e\u003c/a\u003e About methods\n\n**`getSerializerType(void)=\u003estring`**: Returns a string that represents the type of Serializer.\n\n**Example for commonjs:**\n\n```js\nconst baseSerializers = require('@cljimenez/json-serializer-base-serializers')\n\nconst BigIntSerializer = baseSerializers.BigIntSerializer\nconst DateSerializer = baseSerializers.DateSerializer\nconst FunctionSerializer = baseSerializers.FunctionSerializer\nconst MapSerializer = baseSerializers.MapSerializer\nconst SetSerializer = baseSerializers.SetSerializer\n\nconst bigIntSerializer = new BigIntSerializer()\nconst dateSerializer = new DateSerializer()\nconst functionSerializer = new FunctionSerializer()\nconst mapSerializer = new MapSerializer()\nconst setSerializer = new SetSerializer()\n\n// returns 'bigint'\nbigIntSerializer.getSerializerType()\n\n// returns 'Date'\ndateSerializer.getSerializerType()\n\n// returns 'function'\nfunctionSerializer.getSerializerType()\n\n// returns 'Map'\nmapSerializer.getSerializerType()\n\n// returns 'Set'\nsetSerializer.getSerializerType()\n```\n\n**Example for ES Modules:**\n\n```js\nimport {\n  BigIntSerializer,\n  DateSerializer,\n  FunctionSerializer,\n  MapSerializer,\n  SetSerializer,\n} from '@cljimenez/json-serializer-base-serializers'\n\nconst bigIntSerializer = new BigIntSerializer()\nconst dateSerializer = new DateSerializer()\nconst functionSerializer = new FunctionSerializer()\nconst mapSerializer = new MapSerializer()\nconst setSerializer = new SetSerializer()\n\n// returns 'bigint'\nbigIntSerializer.getSerializerType()\n\n// returns 'Date'\ndateSerializer.getSerializerType()\n\n// returns 'function'\nfunctionSerializer.getSerializerType()\n\n// returns 'Map'\nmapSerializer.getSerializerType()\n\n// returns 'Set'\nsetSerializer.getSerializerType()\n```\n\n**`serialize(unserializedData: any)=\u003eobject`**. Serializes data, returns an object using the format `{value: serializedData}`.\n\n**Example for commonjs**:\n\n```js\nconst baseSerializers = require('@cljimenez/json-serializer-base-serializers')\n\nconst FunctionSerializer = baseSerializers.FunctionSerializer\n\nconst functionSerializer = new FunctionSerializer()\n\n// returns: { value: '(() =\u003e {\\n        \"string\"\\n      })' }\nconst serializedData = functionSerializer.serialize(() =\u003e {\n  'string'\n})\n```\n\n**Example for ES Modules**:\n\n```js\nimport { FunctionSerializer } from '@cljimenez/json-serializer-base-serializers'\n\nconst functionSerializer = new FunctionSerializer()\n\n// returns: { value: '(() =\u003e {\\n        \"string\"\\n      })' }\nconst serializedData = functionSerializer.serialize(() =\u003e {\n  'string'\n})\n```\n\n**`parse(serializedData: object)=\u003eany`**. Unserializes data, returns the value formated by serialize method.\n\n**Example for commonjs**:\n\n```js\nconst baseSerializers = require('@cljimenez/json-serializer-base-serializers')\n\nconst FunctionSerializer = baseSerializers.FunctionSerializer\n\nconst functionSerializer = new FunctionSerializer()\n\nconst serializedData = functionSerializer.serialize(\n  (arg1, arg2) =\u003e `${arg1} and ${arg2}`,\n)\n\n// { value: '((arg1, arg2) =\u003e `${arg1} and ${arg2}`)' }\nconsole.log(serializedData)\n\nconst unserializedData = functionSerializer.parse(serializedData)\n\n// string1 and string2\nconsole.log(unserializedData('string1', 'string2'))\n```\n\n**Example for ES Modules**:\n\n```js\nimport { FunctionSerializer } from '@cljimenez/json-serializer-base-serializers'\n\nconst functionSerializer = new FunctionSerializer()\n\nconst serializedData = functionSerializer.serialize(\n  (arg1, arg2) =\u003e `${arg1} and ${arg2}`,\n)\n\n// { value: '((arg1, arg2) =\u003e `${arg1} and ${arg2}`)' }\nconsole.log(serializedData)\n\nconst unserializedData = functionSerializer.parse(serializedData)\n\n// string1 and string2\nconsole.log(unserializedData('string1', 'string2'))\n```\n\n## \u003ca id=\"how-to-use?\"\u003e\u003c/a\u003e How to use?\n\n### \u003ca id=\"using-installer\"\u003e\u003c/a\u003e 1. Install base serializers using the installer object (baseSerializerInstaller):\n\n**Note**: The FunctionSerializer is not included by default in the installer, if you want include it, you must use the **installOptions** parameter in the **jsonSerializer.installSerializersAndRefreshJsonSerializer** method.\n\n```js\nconst installOptions = { includeFunctionSerializer: true }\njsonSerializer.installSerializersAndRefreshJsonSerializer(\n  baseSerializers,\n  installOptions,\n)\n```\n\n**Complete example for commonjs:**\n\n```js\n// Import the packages.\nconst core = require('@cljimenez/json-serializer-core')\nconst baseSerializers = require('@cljimenez/json-serializer-base-serializers')\n\n// Obtain the installer object.\nconst installer = baseSerializers.baseSerializersInstaller\n\n// Obtain the JsonSerializer object.\nconst jsonSerializer = core.JsonSerializerFactory.createJsonSerializer()\n\n// Install the serializers without FunctionSerializer.\njsonSerializer.installSerializersAndRefreshJsonSerializer(installer)\n\n// If you want install the FunctionSerializer, you can use:\njsonSerializer.installSerializersAndRefreshJsonSerializer(installer, {\n  includeFunctionSerializer: true,\n})\n\njsonSerializer.serialize(/*Replace by the unserialized data supports to the installed Serializers*/)\n\njsonSerializer.parse(/*Replace by the serialized data serializes by jsonSerializer.serialize method*/)\n```\n\n**Complete example for ES Modules:**\n\n```js\n// Import the JsonSerializerFactory class.\nimport { JsonSerializerFactory } from '@cljimenez/json-serializer-core'\n// Import the baseSerializerInstaller object.\nimport { baseSerializersInstaller } from '@cljimenez/json-serializer-base-serializers'\n\n// Obtain the JsonSerializer object.\nconst jsonSerializer = JsonSerializerFactory.createJsonSerializer()\n\n// Install the serializers without FunctionSerializer.\njsonSerializer.installSerializersAndRefreshJsonSerializer(\n  baseSerializersInstaller,\n)\n\n// If you want install the FunctionSerializer, you can use:\njsonSerializer.installSerializersAndRefreshJsonSerializer(\n  baseSerializersInstaller,\n  { includeFunctionSerializer: true },\n)\n\njsonSerializer.serialize(/*Replace by the unserialized data supports to the installed Serializers*/)\n\njsonSerializer.parse(/*Replace by the serialized data serializes by jsonSerializer.serialize method*/)\n```\n\n### \u003ca id=\"add-serializers-separately\"\u003e\u003c/a\u003e 2. Add Serializers separately\n\n**Complete example for commonjs:**\n\n```js\n// Import the packages.\nconst core = require('@cljimenez/json-serializer-core')\nconst baseSerializers = require('@cljimenez/json-serializer-base-serializers')\n\n// Obtain the JsonSerializer object.\nconst jsonSerializer = core.JsonSerializerFactory.createJsonSerializer()\n\n// Import Serializers to add.\nconst BigIntSerializer = baseSerializers.BigIntSerializer\nconst FunctionSerializer = baseSerializers.FunctionSerializer\nconst MapSerializer = baseSerializers.MapSerializer\n\n// Create the instances.\nconst bigIntSerializer = new BigIntSerializer()\nconst functionSerializer = new FunctionSerializer()\nconst mapSerializer = new MapSerializer()\n\n// Add Serializers.\njsonSerializer.addSerializerAndRefreshJsonSerializer(bigIntSerializer)\njsonSerializer.addSerializerAndRefreshJsonSerializer(functionSerializer)\njsonSerializer.addSerializerAndRefreshJsonSerializer(mapSerializer)\n\njsonSerializer.serialize(/*Insert unserialized data supports to the installed Serializers*/)\n\njsonSerializer.parse(/*Insert serialized data serializes by jsonSerializer.serialize method*/)\n```\n\n**Complete example for ES Modules:**\n\n```js\n// Import the JsonSerializerFactory class.\nimport { JsonSerializerFactory } from '@cljimenez/json-serializer-core'\n// Import Serializers to add.\nimport {\n  BigIntSerializer,\n  FunctionSerializer,\n  MapSerializer,\n} from '@cljimenez/json-serializer-base-serializers'\n\n// Obtain the JsonSerializer object.\nconst jsonSerializer = JsonSerializerFactory.createJsonSerializer()\n\n// Create the instances.\nconst bigIntSerializer = new BigIntSerializer()\nconst functionSerializer = new FunctionSerializer()\nconst mapSerializer = new MapSerializer()\n\n// Add Serializers.\njsonSerializer.addSerializerAndRefreshJsonSerializer(bigIntSerializer)\njsonSerializer.addSerializerAndRefreshJsonSerializer(functionSerializer)\njsonSerializer.addSerializerAndRefreshJsonSerializer(mapSerializer)\n\njsonSerializer.serialize(/*Insert unserialized data supports to the installed Serializers*/)\n\njsonSerializer.parse(/*Insert serialized data serializes by jsonSerializer.serialize method*/)\n```\n\n## \u003ca id=\"author\"\u003e\u003c/a\u003e Author\n\n👤 **Cristopher Jiménez**\n\n- Github: [@cristopher1](https://github.com/cristopher1)\n\n## \u003ca id=\"contributing\"\u003e\u003c/a\u003e 🤝 Contributing\n\nContributions, issues and feature requests are welcome!\u003cbr /\u003eFeel free to check [issues page](https://github.com/cristopher1/json-serializer-base-serializers/issues).\n\n## \u003ca id=\"license\"\u003e\u003c/a\u003e 📝 License\n\nCopyright © 2023 [Cristopher Jiménez](https://github.com/cristopher1).\u003cbr /\u003e\nThis project is [MIT](https://github.com/cristopher1/json-serializer-plugins/blob/master/LICENSE) licensed.\n\n---\n\n_This README was generated with ❤️ by [readme-md-generator](https://github.com/kefranabg/readme-md-generator)_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcristopher1%2Fjson-serializer-base-serializers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcristopher1%2Fjson-serializer-base-serializers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcristopher1%2Fjson-serializer-base-serializers/lists"}