release: 2024.12-rc1

CHANGELOG.md

@@ -1,3 +1,21 @@
+# Karrio 2024.12-rc1
+
+## Changes
+
+### Feat
+
+- feat(WIP): introduce new customizable dashboard with a new stack shacdn|tailwind|radix|tanstack
+- feat: Introduce advanced Karrio CLI features with API connectivity and data query
+- feat: make rate limit configurable using env vars (#589)
+
+### Fix
+
+- fix:`usps` API proxy and payment authentication (#709)
+- fix: version freeze git reference for `dockerless` install (#721)
+- fix: invalid reference useSystemConnection causing permission error (#706)
+- fix: Consolidate`fedex` duties payor definition with missing account number with live tests (#718, #697)
+- fix: issue with `shipping_date` and `shipment_date` being set to None and options getting overridden
+
 # Karrio 2024.9.15
 
 ## Changes

apps/api/karrio/server/VERSION

@@ -1 +1 @@
-2024.9.15
+2024.12-rc1

apps/www/openapi.yml

@@ -14,7 +14,7 @@ info:
     ## Versioning
 
     When backwards-incompatible changes are made to the API, a new, dated version is released.
-    The current version is `2024.9.15`.
+    The current version is `2024.12-rc1`.
 
     Read our API changelog to learn more about backwards compatibility.
 
@@ -84,7 +84,7 @@ info:
     All API requests must be made over [HTTPS](http://en.wikipedia.org/wiki/HTTP_Secure).
     API requests without authentication will also fail.
   title: Karrio API
-  version: 2024.9.15
+  version: 2024.12-rc1
 paths:
   /:
     get:

bin/deploy-hobby

@@ -2,7 +2,7 @@
 
 set -e
 
-export KARRIO_TAG="${KARRIO_TAG:-2024.9.15}"
+export KARRIO_TAG="${KARRIO_TAG:-2024.12-rc1}"
 export SENTRY_DSN="${SENTRY_DSN:-'https://[email protected]/1'}"
 
 SECRET_KEY=$(head -c 28 /dev/urandom | sha224sum -b | head -c 56)
@@ -23,7 +23,7 @@ if ! [ -z "$1" ]
 then
 export KARRIO_TAG=$1
 else
-echo "What version of Karrio would you like to install? (We default to '2024.9.15')"
+echo "What version of Karrio would you like to install? (We default to '2024.12-rc1')"
 echo "You can check out available versions here: https://hub.docker.com/r/karrio/server/tags"
 read -r KARRIO_TAG_READ
 if [ -z "$KARRIO_TAG_READ" ]

bin/upgrade-hobby

@@ -44,7 +44,7 @@ else
 fi
 
 [[ -f ".env" ]] && export $(cat .env | xargs) || ( echo "No .env file found. Please create it with SECRET_KEY and DOMAIN set." && exit 1)
-export KARRIO_TAG="${KARRIO_TAG:-2024.9.15}"
+export KARRIO_TAG="${KARRIO_TAG:-2024.12-rc1}"
 
 # get karrio scripts
 mkdir -p ./karrio

docker/.env

@@ -30,7 +30,7 @@ REDIS_PORT=6379
 # API - Configuration for the Nginx Reverse proxy.
 ############
 
-KARRIO_TAG=2024.9.15
+KARRIO_TAG=2024.12-rc1
 KARRIO_HTTP_PORT=5002
 
 ############

modules/connectors/usps/karrio/providers/usps/utils.py

@@ -1,6 +1,7 @@
 """USPS connection settings."""
 
 import re
+import typing
 import datetime
 import karrio.lib as lib
 import karrio.core as core
@@ -266,8 +267,10 @@ def parse_response(response) -> dict:
             continue  # Skip empty parts and the final boundary marker
 
         part_data = {}
-        headers, content = part.split("\n\n", 1) if "\n\n" in part else (part, "")
-        headers = headers.strip().split("\n")
+        headers_content, content = (
+            part.split("\n\n", 1) if "\n\n" in part else (part, "")
+        )
+        headers: typing.List[str] = headers_content.strip().split("\n")
 
         # Extract Content-Disposition and Content-Type
         for header in headers:
@@ -288,12 +291,12 @@ def parse_response(response) -> dict:
         if part_data.get("content_type") == "application/json":
             data[part_data["name"]] = {**lib.to_dict(content.strip())}
         elif part_data.get("filename"):
-            data[part_data["name"]] = content.strip()
+            data[part_data["name"]] = content.strip()  # type: ignore
 
     return data
 
 
-def parse_error_response(response: str) -> dict:
+def parse_error_response(response) -> dict:
     # Check if the response is JSON
     content = lib.failsafe(lambda: response.read())
     json_data = lib.failsafe(lambda: lib.to_dict(content))

modules/connectors/usps_international/karrio/providers/usps_international/utils.py

@@ -273,8 +273,10 @@ def parse_response(response) -> dict:
             continue  # Skip empty parts and the final boundary marker
 
         part_data = {}
-        headers, content = part.split("\n\n", 1) if "\n\n" in part else (part, "")
-        headers = headers.strip().split("\n")
+        headers_content, content = (
+            part.split("\n\n", 1) if "\n\n" in part else (part, "")
+        )
+        headers = headers_content.strip().split("\n")
 
         # Extract Content-Disposition and Content-Type
         for header in headers:
@@ -295,12 +297,12 @@ def parse_response(response) -> dict:
         if part_data.get("content_type") == "application/json":
             data[part_data["name"]] = {**lib.to_dict(content.strip())}
         elif part_data.get("filename"):
-            data[part_data["name"]] = content.strip()
+            data[part_data["name"]] = content.strip()  # type: ignore
 
     return data
 
 
-def parse_error_response(response: str) -> dict:
+def parse_error_response(response) -> dict:
     # Check if the response is JSON
     content = lib.failsafe(lambda: response.read())
     json_data = lib.failsafe(lambda: lib.to_dict(content))

modules/sdk/karrio/core/units.py

@@ -1521,14 +1521,14 @@ def contact(self) -> typing.Optional[str]:
     @property
     def first_name(self) -> typing.Optional[str]:
         if self.address.person_name is None:
-            return self.address.first_name
+            return None
 
         return self.address.person_name.split(" ")[0]
 
     @property
     def last_name(self) -> typing.Optional[str]:
         if self.address.person_name is None:
-            return self.address.last_name
+            return None
 
         return self.address.person_name.split(" ")[-1]
 

packages/types/rest/api.ts

@@ -2,9 +2,9 @@
 /* eslint-disable */
 /**
  * Karrio API
- *  Karrio is a multi-carrier shipping API that simplifies the integration of logistics carrier services.  The Karrio API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.  The Karrio API differs for every account as we release new versions. These docs are customized to your version of the API.   ## Versioning  When backwards-incompatible changes are made to the API, a new, dated version is released. The current version is `2024.9.15`.  Read our API changelog to learn more about backwards compatibility.  As a precaution, use API versioning to check a new API version before committing to an upgrade.   ## Environments  The Karrio API offer the possibility to create and retrieve certain objects in `test_mode`. In development, it is therefore possible to add carrier connections, get live rates, buy labels, create trackers and schedule pickups in `test_mode`.   ## Pagination  All top-level API resources have support for bulk fetches via \"list\" API methods. For instance, you can list addresses, list shipments, and list trackers. These list API methods share a common structure, taking at least these two parameters: limit, and offset.  Karrio utilizes offset-based pagination via the offset and limit parameters. Both parameters take a number as value (see below) and return objects in reverse chronological order. The offset parameter returns objects listed after an index. The limit parameter take a limit on the number of objects to be returned from 1 to 100.   ```json {     \"count\": 100,     \"next\": \"/v1/shipments?limit=25&offset=50\",     \"previous\": \"/v1/shipments?limit=25&offset=25\",     \"results\": [         { ... },     ] } ```  ## Metadata  Updateable Karrio objects—including Shipment and Order have a metadata parameter. You can use this parameter to attach key-value data to these Karrio objects.  Metadata is useful for storing additional, structured information on an object. As an example, you could store your user\'s full name and corresponding unique identifier from your system on a Karrio Order object.  Do not store any sensitive information as metadata.  ## Authentication  API keys are used to authenticate requests. You can view and manage your API keys in the Dashboard.  Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.  Authentication to the API is performed via HTTP Basic Auth. Provide your API token as the basic auth username value. You do not need to provide a password.  ```shell $ curl https://instance.api.com/v1/shipments \\     -u key_xxxxxx: # The colon prevents curl from asking for a password. ```  If you need to authenticate via bearer auth (e.g., for a cross-origin request), use `-H \"Authorization: Token key_xxxxxx\"` instead of `-u key_xxxxxx`.  All API requests must be made over [HTTPS](http://en.wikipedia.org/wiki/HTTP_Secure). API requests without authentication will also fail. 
+ *  Karrio is a multi-carrier shipping API that simplifies the integration of logistics carrier services.  The Karrio API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.  The Karrio API differs for every account as we release new versions. These docs are customized to your version of the API.   ## Versioning  When backwards-incompatible changes are made to the API, a new, dated version is released. The current version is `2024.12-rc1`.  Read our API changelog to learn more about backwards compatibility.  As a precaution, use API versioning to check a new API version before committing to an upgrade.   ## Environments  The Karrio API offer the possibility to create and retrieve certain objects in `test_mode`. In development, it is therefore possible to add carrier connections, get live rates, buy labels, create trackers and schedule pickups in `test_mode`.   ## Pagination  All top-level API resources have support for bulk fetches via \"list\" API methods. For instance, you can list addresses, list shipments, and list trackers. These list API methods share a common structure, taking at least these two parameters: limit, and offset.  Karrio utilizes offset-based pagination via the offset and limit parameters. Both parameters take a number as value (see below) and return objects in reverse chronological order. The offset parameter returns objects listed after an index. The limit parameter take a limit on the number of objects to be returned from 1 to 100.   ```json {     \"count\": 100,     \"next\": \"/v1/shipments?limit=25&offset=50\",     \"previous\": \"/v1/shipments?limit=25&offset=25\",     \"results\": [         { ... },     ] } ```  ## Metadata  Updateable Karrio objects—including Shipment and Order have a metadata parameter. You can use this parameter to attach key-value data to these Karrio objects.  Metadata is useful for storing additional, structured information on an object. As an example, you could store your user\'s full name and corresponding unique identifier from your system on a Karrio Order object.  Do not store any sensitive information as metadata.  ## Authentication  API keys are used to authenticate requests. You can view and manage your API keys in the Dashboard.  Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.  Authentication to the API is performed via HTTP Basic Auth. Provide your API token as the basic auth username value. You do not need to provide a password.  ```shell $ curl https://instance.api.com/v1/shipments \\     -u key_xxxxxx: # The colon prevents curl from asking for a password. ```  If you need to authenticate via bearer auth (e.g., for a cross-origin request), use `-H \"Authorization: Token key_xxxxxx\"` instead of `-u key_xxxxxx`.  All API requests must be made over [HTTPS](http://en.wikipedia.org/wiki/HTTP_Secure). API requests without authentication will also fail. 
  *
- * The version of the OpenAPI document: 2024.9.15
+ * The version of the OpenAPI document: 2024.12-rc1
  * 
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).