Merge pull request #67 from dubinc/speakeasy-sdk-regen-1736829146

chore: 🐝 Update SDK - Generate 0.11.14

.speakeasy/gen.lock

@@ -1,12 +1,12 @@
 lockVersion: 2.0.0
 id: 43187d3e-7c3c-4c11-b5d4-4b2334fb6d96
 management:
-  docChecksum: a6a1e65c1a9ddd2d1b445252e12b8157
+  docChecksum: 0c06ef8b2bdec6b49e32f18c56e32ee4
   docVersion: 0.0.1
-  speakeasyVersion: 1.468.2
-  generationVersion: 2.493.4
-  releaseVersion: 0.11.13
-  configChecksum: 481be501d2f37979cdf2544785028b08
+  speakeasyVersion: 1.468.4
+  generationVersion: 2.493.10
+  releaseVersion: 0.11.14
+  configChecksum: e772e6603a5d9076f2d1b1acd0157cc6
   repoURL: https://github.com/dubinc/dub-php.git
   installationURL: https://github.com/dubinc/dub-php
   published: true

.speakeasy/gen.yaml

@@ -13,7 +13,7 @@ generation:
     oAuth2ClientCredentialsEnabled: true
     oAuth2PasswordEnabled: false
 php:
-  version: 0.11.13
+  version: 0.11.14
   additionalDependencies:
     autoload: {}
     autoload-dev: {}

.speakeasy/workflow.lock

@@ -1,21 +1,21 @@
-speakeasyVersion: 1.468.2
+speakeasyVersion: 1.468.4
 sources:
     dub:
         sourceNamespace: dub
-        sourceRevisionDigest: sha256:43c54b15d5e3b8dbfdf06770fa74bdd295946eeddb65091ec1ad855898d1c450
-        sourceBlobDigest: sha256:e455cd12338a6074213fe801f891abdf883b45dae8c4f90f6ac421ee4b3c4449
+        sourceRevisionDigest: sha256:d48d5f07831570587e2a2d687a6ce335f00b19323a111ae7362cff54bc11f2a6
+        sourceBlobDigest: sha256:95e092e1faeefc534d84f8dc5a72fd5c0ddbda08a02ae70b6246d5fdc0e8fea6
         tags:
             - latest
-            - speakeasy-sdk-regen-1736295578
+            - speakeasy-sdk-regen-1736829146
             - 0.0.1
 targets:
     my-first-target:
         source: dub
         sourceNamespace: dub
-        sourceRevisionDigest: sha256:43c54b15d5e3b8dbfdf06770fa74bdd295946eeddb65091ec1ad855898d1c450
-        sourceBlobDigest: sha256:e455cd12338a6074213fe801f891abdf883b45dae8c4f90f6ac421ee4b3c4449
+        sourceRevisionDigest: sha256:d48d5f07831570587e2a2d687a6ce335f00b19323a111ae7362cff54bc11f2a6
+        sourceBlobDigest: sha256:95e092e1faeefc534d84f8dc5a72fd5c0ddbda08a02ae70b6246d5fdc0e8fea6
         codeSamplesNamespace: code-samples-php-my-first-target
-        codeSamplesRevisionDigest: sha256:1adcfada46e7f4118ceb2849f172f61931d78065f3db63da652238f4566a8e13
+        codeSamplesRevisionDigest: sha256:7ecc9e5d3c43e4a5ea1743ed096ebc2240ca561ac86f718416d0f652371730eb
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

CONTRIBUTING.md

@@ -0,0 +1,26 @@
+# Contributing to This Repository
+
+Thank you for your interest in contributing to this repository. Please note that this repository contains generated code. As such, we do not accept direct changes or pull requests. Instead, we encourage you to follow the guidelines below to report issues and suggest improvements.
+
+## How to Report Issues
+
+If you encounter any bugs or have suggestions for improvements, please open an issue on GitHub. When reporting an issue, please provide as much detail as possible to help us reproduce the problem. This includes:
+
+- A clear and descriptive title
+- Steps to reproduce the issue
+- Expected and actual behavior
+- Any relevant logs, screenshots, or error messages
+- Information about your environment (e.g., operating system, software versions)
+    - For example can be collected using the `npx envinfo` command from your terminal if you have Node.js installed
+
+## Issue Triage and Upstream Fixes
+
+We will review and triage issues as quickly as possible. Our goal is to address bugs and incorporate improvements in the upstream source code. Fixes will be included in the next generation of the generated code.
+
+## Contact
+
+If you have any questions or need further assistance, please feel free to reach out by opening an issue.
+
+Thank you for your understanding and cooperation!
+
+The Maintainers

README.md

@@ -19,6 +19,7 @@ Dub.co API: Dub is link management infrastructure for companies to create market
 * [dub/dub-php](#dubdub-php)
   * [SDK Installation](#sdk-installation)
   * [SDK Example Usage](#sdk-example-usage)
+  * [Authentication](#authentication)
   * [Available Resources and Operations](#available-resources-and-operations)
   * [Pagination](#pagination)
   * [Error Handling](#error-handling)
@@ -110,6 +111,52 @@ if ($response->linkSchema !== null) {
 ```
 <!-- End SDK Example Usage [usage] -->
 
+<!-- Start Authentication [security] -->
+## Authentication
+
+### Per-Client Security Schemes
+
+This SDK supports the following security scheme globally:
+
+| Name    | Type | Scheme      |
+| ------- | ---- | ----------- |
+| `token` | http | HTTP Bearer |
+
+To authenticate with the API the `token` parameter must be set when initializing the SDK. For example:
+```php
+declare(strict_types=1);
+
+require 'vendor/autoload.php';
+
+use Dub;
+use Dub\Models\Operations;
+
+$sdk = Dub\Dub::builder()
+    ->setSecurity(
+        'DUB_API_KEY'
+    )
+    ->build();
+
+$request = [
+    new Operations\RequestBody(
+        url: 'https://google.com',
+        tagIds: [
+            'clux0rgak00011...',
+        ],
+        externalId: '123456',
+    ),
+];
+
+$response = $sdk->links->createMany(
+    request: $request
+);
+
+if ($response->responseBodies !== null) {
+    // handle response
+}
+```
+<!-- End Authentication [security] -->
+
 <!-- Start Available Resources and Operations [operations] -->
 ## Available Resources and Operations
 

RELEASES.md

@@ -580,4 +580,14 @@ Based on:
 ### Generated
 - [php v0.11.13] .
 ### Releases
-- [Composer v0.11.13] https://packagist.org/packages/dub/dub-php#v0.11.13 - .
+- [Composer v0.11.13] https://packagist.org/packages/dub/dub-php#v0.11.13 - .
+
+## 2025-01-14 04:32:11
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.468.4 (2.493.10) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [php v0.11.14] .
+### Releases
+- [Composer v0.11.14] https://packagist.org/packages/dub/dub-php#v0.11.14 - .