npm - @authorizedretailers/spec - Versions diffs - 0.1.0 - Mend

@authorizedretailers/spec 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (98) hide show

package/LICENSE +202 -0
package/LICENSE-SPEC +396 -0
package/README.md +130 -0
package/dist/constants.d.ts +6 -0
package/dist/constants.js +7 -0
package/dist/identity.d.ts +27 -0
package/dist/identity.js +92 -0
package/dist/index.d.ts +8 -0
package/dist/index.js +8 -0
package/dist/jcs.d.ts +5 -0
package/dist/jcs.js +47 -0
package/dist/jws.d.ts +42 -0
package/dist/jws.js +90 -0
package/dist/published.d.ts +15 -0
package/dist/published.js +15 -0
package/dist/schemas.d.ts +519 -0
package/dist/schemas.js +662 -0
package/dist/timestamp.d.ts +6 -0
package/dist/timestamp.js +26 -0
package/dist/types.d.ts +116 -0
package/dist/types.js +2 -0
package/dist/validate.d.ts +28 -0
package/dist/validate.js +147 -0
package/fixtures/file/invalid/full-all-mixed.json +47 -0
package/fixtures/file/invalid/full-amazon-missing-seller-id.json +45 -0
package/fixtures/file/invalid/full-attached-jws.json +50 -0
package/fixtures/file/invalid/full-authorization-expires-after-file.json +46 -0
package/fixtures/file/invalid/full-duplicate-authorization-id.json +80 -0
package/fixtures/file/invalid/full-empty-territories.json +43 -0
package/fixtures/file/invalid/full-expires-before-issued.json +46 -0
package/fixtures/file/invalid/full-expiry-over-180-days.json +46 -0
package/fixtures/file/invalid/full-extra-property.json +47 -0
package/fixtures/file/invalid/full-impossible-date.json +46 -0
package/fixtures/file/invalid/full-lowercase-territory.json +45 -0
package/fixtures/file/invalid/full-missing-authorization-expires.json +45 -0
package/fixtures/file/invalid/full-missing-file-expires.json +45 -0
package/fixtures/file/invalid/full-missing-product-lines.json +43 -0
package/fixtures/file/invalid/full-missing-scope.json +37 -0
package/fixtures/file/invalid/full-missing-territories.json +42 -0
package/fixtures/file/invalid/full-name-only-retailer.json +30 -0
package/fixtures/file/invalid/full-no-channels.json +31 -0
package/fixtures/file/invalid/full-non-utc-timestamp.json +46 -0
package/fixtures/file/invalid/full-physical-missing-country.json +50 -0
package/fixtures/file/invalid/full-signature-missing-kid.json +49 -0
package/fixtures/file/invalid/full-unknown-channel-type.json +50 -0
package/fixtures/file/invalid/full-web-domain-is-url.json +46 -0
package/fixtures/file/invalid/full-web-missing-domain.json +45 -0
package/fixtures/file/invalid/full-wildcard-mixed.json +46 -0
package/fixtures/file/invalid/full-wrong-spec.json +46 -0
package/fixtures/file/invalid/pointer-http-url.json +9 -0
package/fixtures/file/invalid/private-missing-verify.json +8 -0
package/fixtures/file/invalid/private-with-authorizations.json +45 -0
package/fixtures/file/invalid/unknown-form.json +9 -0
package/fixtures/file/valid/full-fractional-seconds.json +46 -0
package/fixtures/file/valid/full-max-expiry.json +46 -0
package/fixtures/file/valid/full-no-authorizations.json +11 -0
package/fixtures/file/valid/full-signed.json +50 -0
package/fixtures/file/valid/full-unsigned-handwritten.json +46 -0
package/fixtures/file/valid/full-worldwide-physical-proposed.json +82 -0
package/fixtures/file/valid/pointer.json +9 -0
package/fixtures/file/valid/private.json +9 -0
package/fixtures/manifest.json +434 -0
package/fixtures/verify-request/invalid/domain-with-scheme.json +10 -0
package/fixtures/verify-request/invalid/missing-channel.json +5 -0
package/fixtures/verify-request/invalid/physical-channel.json +10 -0
package/fixtures/verify-request/invalid/retailer-name-only.json +6 -0
package/fixtures/verify-request/invalid/wildcard-territory.json +10 -0
package/fixtures/verify-request/valid/amazon.json +10 -0
package/fixtures/verify-request/valid/web-no-product-line.json +8 -0
package/fixtures/verify-response/invalid/authorized-missing-authorization-id.json +12 -0
package/fixtures/verify-response/invalid/missing-observed.json +12 -0
package/fixtures/verify-response/invalid/missing-signature.json +9 -0
package/fixtures/verify-response/invalid/missing-valid-until.json +12 -0
package/fixtures/verify-response/invalid/observed-without-last-seen.json +13 -0
package/fixtures/verify-response/invalid/unknown-status.json +13 -0
package/fixtures/verify-response/invalid/unlisted-observed.json +13 -0
package/fixtures/verify-response/invalid/unlisted-with-authorization-id.json +12 -0
package/fixtures/verify-response/invalid/unlisted-with-reason.json +12 -0
package/fixtures/verify-response/invalid/valid-until-before-checked.json +13 -0
package/fixtures/verify-response/invalid/valid-until-over-24h.json +13 -0
package/fixtures/verify-response/invalid/with-tier.json +14 -0
package/fixtures/verify-response/valid/authorized-observed.json +15 -0
package/fixtures/verify-response/valid/authorized.json +13 -0
package/fixtures/verify-response/valid/brand-unverified-no-reason.json +11 -0
package/fixtures/verify-response/valid/brand-unverified-reason.json +12 -0
package/fixtures/verify-response/valid/disputed.json +13 -0
package/fixtures/verify-response/valid/expired.json +13 -0
package/fixtures/verify-response/valid/unlisted.json +11 -0
package/fixtures/verify-response/valid/with-signal.json +19 -0
package/package.json +76 -0
package/schemas/common.json +170 -0
package/schemas/file-full.json +23 -0
package/schemas/file-pointer.json +14 -0
package/schemas/file-private.json +14 -0
package/schemas/file.json +13 -0
package/schemas/verify-request.json +18 -0
package/schemas/verify-response.json +61 -0
package/spec/spec-v0.1.md +282 -0

package/fixtures/file/invalid/full-web-domain-is-url.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "full",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "issued": "2026-09-23T00:00:00Z",
+  "expires": "2026-12-22T00:00:00Z",
+  "authorizations": [
+    {
+      "id": "auth_01J9X2",
+      "retailer": {
+        "name": "Example Retail LLC",
+        "entity_id": "ent_7Q4M"
+      },
+      "channels": [
+        {
+          "type": "amazon",
+          "marketplace": "US",
+          "seller_id": "A1B2C3D4E5F6G7"
+        },
+        {
+          "type": "walmart",
+          "marketplace": "US",
+          "seller_id": "101234567"
+        },
+        {
+          "type": "web",
+          "domain": "https://retailer.example/"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "US",
+          "CA"
+        ],
+        "product_lines": [
+          "all"
+        ]
+      },
+      "proposed_by": null,
+      "expires": "2026-12-22T00:00:00Z"
+    }
+  ]
+}

package/fixtures/file/invalid/full-web-missing-domain.json ADDED Viewed

@@ -0,0 +1,45 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "full",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "issued": "2026-09-23T00:00:00Z",
+  "expires": "2026-12-22T00:00:00Z",
+  "authorizations": [
+    {
+      "id": "auth_01J9X2",
+      "retailer": {
+        "name": "Example Retail LLC",
+        "entity_id": "ent_7Q4M"
+      },
+      "channels": [
+        {
+          "type": "amazon",
+          "marketplace": "US",
+          "seller_id": "A1B2C3D4E5F6G7"
+        },
+        {
+          "type": "walmart",
+          "marketplace": "US",
+          "seller_id": "101234567"
+        },
+        {
+          "type": "web"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "US",
+          "CA"
+        ],
+        "product_lines": [
+          "all"
+        ]
+      },
+      "proposed_by": null,
+      "expires": "2026-12-22T00:00:00Z"
+    }
+  ]
+}

package/fixtures/file/invalid/full-wildcard-mixed.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "full",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "issued": "2026-09-23T00:00:00Z",
+  "expires": "2026-12-22T00:00:00Z",
+  "authorizations": [
+    {
+      "id": "auth_01J9X2",
+      "retailer": {
+        "name": "Example Retail LLC",
+        "entity_id": "ent_7Q4M"
+      },
+      "channels": [
+        {
+          "type": "amazon",
+          "marketplace": "US",
+          "seller_id": "A1B2C3D4E5F6G7"
+        },
+        {
+          "type": "walmart",
+          "marketplace": "US",
+          "seller_id": "101234567"
+        },
+        {
+          "type": "web",
+          "domain": "retailer.example"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "*",
+          "US"
+        ],
+        "product_lines": [
+          "all"
+        ]
+      },
+      "proposed_by": null,
+      "expires": "2026-12-22T00:00:00Z"
+    }
+  ]
+}

package/fixtures/file/invalid/full-wrong-spec.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+  "spec": "authorized-retailers/1.0",
+  "form": "full",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "issued": "2026-09-23T00:00:00Z",
+  "expires": "2026-12-22T00:00:00Z",
+  "authorizations": [
+    {
+      "id": "auth_01J9X2",
+      "retailer": {
+        "name": "Example Retail LLC",
+        "entity_id": "ent_7Q4M"
+      },
+      "channels": [
+        {
+          "type": "amazon",
+          "marketplace": "US",
+          "seller_id": "A1B2C3D4E5F6G7"
+        },
+        {
+          "type": "walmart",
+          "marketplace": "US",
+          "seller_id": "101234567"
+        },
+        {
+          "type": "web",
+          "domain": "retailer.example"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "US",
+          "CA"
+        ],
+        "product_lines": [
+          "all"
+        ]
+      },
+      "proposed_by": null,
+      "expires": "2026-12-22T00:00:00Z"
+    }
+  ]
+}

package/fixtures/file/invalid/pointer-http-url.json ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "pointer",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "list": "http://authorizedretailers.ai/v0/brands/brand.example/list"
+}

package/fixtures/file/invalid/private-missing-verify.json ADDED Viewed

@@ -0,0 +1,8 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "private",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  }
+}

package/fixtures/file/invalid/private-with-authorizations.json ADDED Viewed

@@ -0,0 +1,45 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "private",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "verify": "https://authorizedretailers.ai/v0/verify",
+  "authorizations": [
+    {
+      "id": "auth_01J9X2",
+      "retailer": {
+        "name": "Example Retail LLC",
+        "entity_id": "ent_7Q4M"
+      },
+      "channels": [
+        {
+          "type": "amazon",
+          "marketplace": "US",
+          "seller_id": "A1B2C3D4E5F6G7"
+        },
+        {
+          "type": "walmart",
+          "marketplace": "US",
+          "seller_id": "101234567"
+        },
+        {
+          "type": "web",
+          "domain": "retailer.example"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "US",
+          "CA"
+        ],
+        "product_lines": [
+          "all"
+        ]
+      },
+      "proposed_by": null,
+      "expires": "2026-12-22T00:00:00Z"
+    }
+  ]
+}

package/fixtures/file/invalid/unknown-form.json ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "partial",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "verify": "https://authorizedretailers.ai/v0/verify"
+}

package/fixtures/file/valid/full-fractional-seconds.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "full",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "issued": "2026-09-23T00:00:00.123Z",
+  "expires": "2026-12-22T00:00:00Z",
+  "authorizations": [
+    {
+      "id": "auth_01J9X2",
+      "retailer": {
+        "name": "Example Retail LLC",
+        "entity_id": "ent_7Q4M"
+      },
+      "channels": [
+        {
+          "type": "amazon",
+          "marketplace": "US",
+          "seller_id": "A1B2C3D4E5F6G7"
+        },
+        {
+          "type": "walmart",
+          "marketplace": "US",
+          "seller_id": "101234567"
+        },
+        {
+          "type": "web",
+          "domain": "retailer.example"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "US",
+          "CA"
+        ],
+        "product_lines": [
+          "all"
+        ]
+      },
+      "proposed_by": null,
+      "expires": "2026-12-22T00:00:00Z"
+    }
+  ]
+}

package/fixtures/file/valid/full-max-expiry.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "full",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "issued": "2026-09-23T00:00:00Z",
+  "expires": "2027-03-22T00:00:00Z",
+  "authorizations": [
+    {
+      "id": "auth_01J9X2",
+      "retailer": {
+        "name": "Example Retail LLC",
+        "entity_id": "ent_7Q4M"
+      },
+      "channels": [
+        {
+          "type": "amazon",
+          "marketplace": "US",
+          "seller_id": "A1B2C3D4E5F6G7"
+        },
+        {
+          "type": "walmart",
+          "marketplace": "US",
+          "seller_id": "101234567"
+        },
+        {
+          "type": "web",
+          "domain": "retailer.example"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "US",
+          "CA"
+        ],
+        "product_lines": [
+          "all"
+        ]
+      },
+      "proposed_by": null,
+      "expires": "2026-12-22T00:00:00Z"
+    }
+  ]
+}

package/fixtures/file/valid/full-no-authorizations.json ADDED Viewed

@@ -0,0 +1,11 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "full",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "issued": "2026-09-23T00:00:00Z",
+  "expires": "2026-12-22T00:00:00Z",
+  "authorizations": []
+}

package/fixtures/file/valid/full-signed.json ADDED Viewed

@@ -0,0 +1,50 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "full",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "issued": "2026-09-23T00:00:00Z",
+  "expires": "2026-12-22T00:00:00Z",
+  "authorizations": [
+    {
+      "id": "auth_01J9X2",
+      "retailer": {
+        "name": "Example Retail LLC",
+        "entity_id": "ent_7Q4M"
+      },
+      "channels": [
+        {
+          "type": "amazon",
+          "marketplace": "US",
+          "seller_id": "A1B2C3D4E5F6G7"
+        },
+        {
+          "type": "walmart",
+          "marketplace": "US",
+          "seller_id": "101234567"
+        },
+        {
+          "type": "web",
+          "domain": "retailer.example"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "US",
+          "CA"
+        ],
+        "product_lines": [
+          "all"
+        ]
+      },
+      "proposed_by": null,
+      "expires": "2026-12-22T00:00:00Z"
+    }
+  ],
+  "signature": {
+    "kid": "ar-2026-09",
+    "jws": "eyJhbGciOiJFZERTQSIsImtpZCI6ImFyLTIwMjYtMDkifQ..c2lnbmF0dXJlLXBsYWNlaG9sZGVy"
+  }
+}

package/fixtures/file/valid/full-unsigned-handwritten.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "full",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "issued": "2026-09-23T00:00:00Z",
+  "expires": "2026-12-22T00:00:00Z",
+  "authorizations": [
+    {
+      "id": "auth_01J9X2",
+      "retailer": {
+        "name": "Example Retail LLC",
+        "entity_id": "ent_7Q4M"
+      },
+      "channels": [
+        {
+          "type": "amazon",
+          "marketplace": "US",
+          "seller_id": "A1B2C3D4E5F6G7"
+        },
+        {
+          "type": "walmart",
+          "marketplace": "US",
+          "seller_id": "101234567"
+        },
+        {
+          "type": "web",
+          "domain": "retailer.example"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "US",
+          "CA"
+        ],
+        "product_lines": [
+          "all"
+        ]
+      },
+      "proposed_by": null,
+      "expires": "2026-12-22T00:00:00Z"
+    }
+  ]
+}

package/fixtures/file/valid/full-worldwide-physical-proposed.json ADDED Viewed

@@ -0,0 +1,82 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "full",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "issued": "2026-09-23T00:00:00Z",
+  "expires": "2026-12-22T00:00:00Z",
+  "authorizations": [
+    {
+      "id": "auth_01J9X2",
+      "retailer": {
+        "name": "Example Retail LLC",
+        "entity_id": "ent_7Q4M"
+      },
+      "channels": [
+        {
+          "type": "amazon",
+          "marketplace": "US",
+          "seller_id": "A1B2C3D4E5F6G7"
+        },
+        {
+          "type": "walmart",
+          "marketplace": "US",
+          "seller_id": "101234567"
+        },
+        {
+          "type": "web",
+          "domain": "retailer.example"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "US",
+          "CA"
+        ],
+        "product_lines": [
+          "all"
+        ]
+      },
+      "proposed_by": null,
+      "expires": "2026-12-22T00:00:00Z"
+    },
+    {
+      "id": "auth_02",
+      "retailer": {
+        "name": "Corner Shoes"
+      },
+      "channels": [
+        {
+          "type": "ebay",
+          "marketplace": "GB",
+          "seller_id": "cornershoes"
+        },
+        {
+          "type": "physical",
+          "address": "1 High St, London",
+          "country": "GB"
+        }
+      ],
+      "scope": {
+        "territories": [
+          "*"
+        ],
+        "product_lines": [
+          "running",
+          "trail"
+        ]
+      },
+      "proposed_by": {
+        "name": "Example Distribution Ltd",
+        "entity_id": "ent_DIST1"
+      },
+      "expires": "2026-11-01T00:00:00Z"
+    }
+  ],
+  "signature": {
+    "kid": "ar-2026-09",
+    "jws": "eyJhbGciOiJFZERTQSIsImtpZCI6ImFyLTIwMjYtMDkifQ..c2lnbmF0dXJlLXBsYWNlaG9sZGVy"
+  }
+}

package/fixtures/file/valid/pointer.json ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "pointer",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "list": "https://authorizedretailers.ai/v0/brands/brand.example/list"
+}

package/fixtures/file/valid/private.json ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "spec": "authorized-retailers/0.1",
+  "form": "private",
+  "brand": {
+    "name": "Example Brand",
+    "domain": "brand.example"
+  },
+  "verify": "https://authorizedretailers.ai/v0/verify"
+}