@yurkimus/cookies 0.0.0 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 yurkimus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/deno.json

@@ -1,12 +1,9 @@
 {
   "name": "@yurkimus/cookies",
-  "version": "0.0.0",
-  "fmt": {
-    "semiColons": false,
-    "singleQuote": true
-  },
+  "version": "0.0.2",
   "exports": "./source/index.js",
   "imports": {
-    "@yurkimus/curry": "https://raw.githubusercontent.com/yurkimus/curry/main/source/index.js"
+    "@yurkimus/curry": "https://raw.githubusercontent.com/yurkimus/curry/main/source/index.js",
+    "@yurkimus/types": "https://raw.githubusercontent.com/yurkimus/types/main/source/index.js"
   }
 }

package/dprint.json

@@ -0,0 +1,24 @@
+{
+  "typescript": {
+    "semiColons": "asi",
+    "quoteStyle": "preferSingle",
+    "useBraces": "maintain"
+  },
+
+  "json": {
+  },
+
+  "markdown": {
+  },
+
+  "excludes": [
+    "**/node_modules",
+    "**/*-lock.json"
+  ],
+
+  "plugins": [
+    "https://plugins.dprint.dev/typescript-0.93.0.wasm",
+    "https://plugins.dprint.dev/json-0.19.3.wasm",
+    "https://plugins.dprint.dev/markdown-0.17.8.wasm"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "type": "module",
-  "version": "0.0.0",
+  "version": "0.0.2",
   "name": "@yurkimus/cookies",
   "author": {
     "name": "yurkimus",

package/readme.md

@@ -1,53 +1,83 @@
 # Cookies
 
-A collection of utilities for handling cookies in JavaScript.
+JavaScript-utilities to handle cookies everywhere.
 
-## parseCookie
+## Table of Contents
 
-Parses a cookie string into a list of key-value pairs.
+- [Installation](#installation)
+- [Exports](#exports)
+  - [parse](#parse)
+  - [read](#read)
+  - [serialize](#serialize)
+- [License](#license)
 
-| Parameter | Type     | Description   |
-| --------- | -------- | ------------- |
-| cookie    | `string` | Cookie string |
+## Installation
 
-**Returns**: `[string, string][]`
+### npm
 
-**Example**:
+```
+npm install @yurkimus/cookies
+```
+
+### urls
+
+```
+"@yurkimus/cookies": "npm:@yurkimus/cookies"
+```
 
-```javascript
-parseCookie('name=John; age=30; role=admin') // => [['name', 'John'], ['age', '30'], ['role', 'admin']]
+```
+"@yurkimus/cookies": "github:yurkimus/cookies"
+```
+
+```
+"@yurkimus/cookies": "https://raw.githubusercontent.com/yurkimus/cookies/main/source/index.js"
 ```
 
-## readCookie
+## Exports
 
-Reads cookies from a cookie string using a provided list of keys.
+### read
 
-| Parameter | Type                   | Description                  |
-| --------- | ---------------------- | ---------------------------- |
-| keys      | `string` or `string[]` | List of keys or a single key |
-| cookie    | `string`               | Cookie string                |
+#### Definition
+
+```
+read :: string -> string -> string
+```
 
-**Example**:
+#### Example
 
 ```javascript
 let cookie = 'name=John; age=30; role=admin'
 
-readCookie('age', cookie) // => '30'
+let age = read('age', cookie) // => '30'
 
-readCookie(['age', 'name'], cookie) // => ['30', 'John']
+let [age, name] = ['age', 'name']
+  .map(key => read(key))
+  .map(reader => reader(cookie)) // => ['30', 'John']
 ```
 
-## serializeCookie
+### parse
 
-Serializes a cookie from its components into a string.
+#### Definition
 
-| Parameter  | Type                 | Description                                              |
-| ---------- | -------------------- | -------------------------------------------------------- |
-| name       | `string`             | The name of the cookie                                   |
-| value      | `string`             | The value of the cookie                                  |
-| attributes | `[string, string][]` | An array containing additional attributes for the cookie |
+```
+parse :: string -> object
+```
 
-**Example**:
+#### Example
+
+```javascript
+parse('name=John; age=30; role=admin') // => { name: 'John', age: '30', role: 'admin' }
+```
+
+### serialize
+
+#### Definition
+
+```
+serialize :: string -> * -> [(string, string)] -> string
+```
+
+#### Example
 
 ```javascript
 let attributes = [
@@ -55,5 +85,9 @@ let attributes = [
   ['expires', 'Wed, 21 Oct 2026 07:28:00 GMT'],
 ]
 
-serializeCookie('name', 'John', attributes) // => 'name=John; path=/; expires=Wed, 21 Oct 2026 07:28:00 GMT'
+serialize('name', 'John', attributes) // => 'name=John; path=/; expires=Wed, 21 Oct 2026 07:28:00 GMT'
 ```
+
+## License
+
+[MIT](LICENSE)

package/source/index.js

@@ -1,62 +1,34 @@
-import { is, isLike } from '@yurkimus/types'
+import { curry } from '@yurkimus/curry'
+import { is } from '@yurkimus/types'
 
 /**
  * Parses a cookie string into a list of key-value pairs.
- *
- * @param {string} cookie
- *
- * @returns {[string, string][]}
- *
- * @example
- * ```
- * let  cookie = 'name=John; age=30; role=admin',
- *      parsed = parseCookie(cookieString); // => [string, string][]
- * ```
  */
-export var parseCookie = (cookie) => {
-  if (!is('String', cookie)) {
-    throw new TypeError('"cookie" must be a string!')
-  }
+export var parse = value => {
+  if (!is('String', value))
+    throw new TypeError(`Parameter 'value' must be a string.`)
 
-  return cookie.split('; ').map((string) => string.split('='))
+  return value
+    .split('; ')
+    .map(string => string.split('='))
+    .reduce((object, [key, value]) => (object[key] = value, object), {})
 }
 
 /**
  * Reads cookies from a cookie string using a provided list of keys.
- *
- * @param {string | string[]} keys
- * @param {string} cookie
- *
- * @returns {string | string[]}
- *
- * @example
- * ```
- * let  cookie = 'name=John; age=30; role=admin',
- *      cookies1 = readCookie('age', cookie); // => '30'
- *      cookies2 = readCookie(['age', 'name'], cookie); // => ['30', 'John']
- * ```
  */
-export var readCookie = (keys, cookie) => {
-  if (!is('String', cookie)) {
-    throw new TypeError('"cookie" must be a String!')
-  }
+export var read = curry(
+  (key, value) => {
+    if (!is('String', value))
+      throw new TypeError(`Parameter 'value' must be a string.`)
 
-  var cookies = Object.fromEntries(parseCookie(cookie))
-
-  if (isLike('Array')) {
-    return Array.prototype.map.call(keys, (key) => cookies[key])
-  }
-
-  return cookies[keys]
-}
+    return parse(value)[key]
+  },
+)
 
 /**
  * Serializes a cookie from its components into a string.
  *
- * @param {string} name The name of the cookie.
- * @param {string} value The value of the cookie.
- * @param {[string, string][]} attributes An array containing additional attributes for the cookie.
- *
  * @example
  * ```
  * let  name = 'name',
@@ -65,11 +37,10 @@ export var readCookie = (keys, cookie) => {
  *      serialized = serializeCookie(name, value, attributes); // => 'name=John; path=/; expires=Wed, 21 Oct 2026 07:28:00 GMT'
  * ```
  */
-export var serializeCookie = (name, value, attributes) =>
-  name +
-  '=' +
-  value +
-  attributes.reduce(
-    (string, attribute) => string + '; ' + attribute.join('='),
-    '',
-  )
+export var serialize = curry(
+  (name, value, attributes) =>
+    name
+    + '='
+    + value
+    + attributes.reduce((string, attribute) => string + '; ' + attribute.join('='), ''),
+)