Merge upstream and update generated code for v879

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 13.14.0 - 2024-03-14
+* [#1660](https://github.com/stripe/stripe-php/pull/1660) Update generated code
+  * Add support for new resources `Issuing.PersonalizationDesign` and `Issuing.PhysicalBundle`
+  * Add support for `all`, `create`, `retrieve`, and `update` methods on resource `PersonalizationDesign`
+  * Add support for `all` and `retrieve` methods on resource `PhysicalBundle`
+  * Add support for `personalization_design` on `Issuing.Card`
+
 ## 13.14.0-beta.1 - 2024-02-29
 * [#1655](https://github.com/stripe/stripe-php/pull/1655) Update generated code for beta
   * Remove support for resource `Entitlements.Event`

OPENAPI_VERSION

@@ -1 +1 @@
-v878
+v879

init.php

@@ -94,6 +94,10 @@
 require __DIR__ . '/lib/Balance.php';
 require __DIR__ . '/lib/BalanceTransaction.php';
 require __DIR__ . '/lib/BankAccount.php';
+require __DIR__ . '/lib/Billing/Meter.php';
+require __DIR__ . '/lib/Billing/MeterEvent.php';
+require __DIR__ . '/lib/Billing/MeterEventAdjustment.php';
+require __DIR__ . '/lib/Billing/MeterEventSummary.php';
 require __DIR__ . '/lib/BillingPortal/Configuration.php';
 require __DIR__ . '/lib/BillingPortal/Session.php';
 require __DIR__ . '/lib/Capability.php';
@@ -191,6 +195,10 @@
 require __DIR__ . '/lib/Service/Apps/SecretService.php';
 require __DIR__ . '/lib/Service/BalanceService.php';
 require __DIR__ . '/lib/Service/BalanceTransactionService.php';
+require __DIR__ . '/lib/Service/Billing/BillingServiceFactory.php';
+require __DIR__ . '/lib/Service/Billing/MeterEventAdjustmentService.php';
+require __DIR__ . '/lib/Service/Billing/MeterEventService.php';
+require __DIR__ . '/lib/Service/Billing/MeterService.php';
 require __DIR__ . '/lib/Service/BillingPortal/BillingPortalServiceFactory.php';
 require __DIR__ . '/lib/Service/BillingPortal/ConfigurationService.php';
 require __DIR__ . '/lib/Service/BillingPortal/SessionService.php';

lib/Billing/Meter.php

@@ -0,0 +1,89 @@
+<?php
+
+// File generated from our OpenAPI spec
+
+namespace Stripe\Billing;
+
+/**
+ * A billing meter is a resource that allows you to track usage of a particular event. For example, you might create a billing meter to track the number of API calls made by a particular user. You can then use the billing meter to charge the user for the number of API calls they make.
+ *
+ * @property string $id Unique identifier for the object.
+ * @property string $object String representing the object's type. Objects of the same type share the same value.
+ * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.
+ * @property \Stripe\StripeObject $customer_mapping
+ * @property \Stripe\StripeObject $default_aggregation
+ * @property string $display_name The meter's name.
+ * @property string $event_name The name of the usage event to record usage for. Corresponds with the <code>event_name</code> field on usage events.
+ * @property null|string $event_time_window The time window to pre-aggregate usage events for, if any.
+ * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
+ * @property string $status The meter's status.
+ * @property \Stripe\StripeObject $status_transitions
+ * @property int $updated Time at which the object was last updated. Measured in seconds since the Unix epoch.
+ * @property \Stripe\StripeObject $value_settings
+ */
+class Meter extends \Stripe\ApiResource
+{
+    const OBJECT_NAME = 'billing.meter';
+
+    use \Stripe\ApiOperations\All;
+    use \Stripe\ApiOperations\Create;
+    use \Stripe\ApiOperations\NestedResource;
+    use \Stripe\ApiOperations\Retrieve;
+    use \Stripe\ApiOperations\Update;
+
+    const EVENT_TIME_WINDOW_DAY = 'day';
+    const EVENT_TIME_WINDOW_HOUR = 'hour';
+
+    const STATUS_ACTIVE = 'active';
+    const STATUS_INACTIVE = 'inactive';
+
+    /**
+     * @param null|array $params
+     * @param null|array|string $opts
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
+     *
+     * @return \Stripe\Billing\Meter the deactivated meter
+     */
+    public function deactivate($params = null, $opts = null)
+    {
+        $url = $this->instanceUrl() . '/deactivate';
+        list($response, $opts) = $this->_request('post', $url, $params, $opts);
+        $this->refreshFrom($response, $opts);
+
+        return $this;
+    }
+
+    /**
+     * @param null|array $params
+     * @param null|array|string $opts
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
+     *
+     * @return \Stripe\Billing\Meter the reactivated meter
+     */
+    public function reactivate($params = null, $opts = null)
+    {
+        $url = $this->instanceUrl() . '/reactivate';
+        list($response, $opts) = $this->_request('post', $url, $params, $opts);
+        $this->refreshFrom($response, $opts);
+
+        return $this;
+    }
+
+    const PATH_EVENT_SUMMARIES = '/event_summaries';
+
+    /**
+     * @param string $id the ID of the meter on which to retrieve the meter event summaries
+     * @param null|array $params
+     * @param null|array|string $opts
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
+     *
+     * @return \Stripe\Collection<\Stripe\Billing\MeterEventSummary> the list of meter event summaries
+     */
+    public static function allEventSummaries($id, $params = null, $opts = null)
+    {
+        return self::_allNestedResources($id, static::PATH_EVENT_SUMMARIES, $params, $opts);
+    }
+}

lib/Billing/MeterEvent.php

@@ -0,0 +1,24 @@
+<?php
+
+// File generated from our OpenAPI spec
+
+namespace Stripe\Billing;
+
+/**
+ * A billing meter event represents a customer's usage of a product. Meter events are used to bill a customer based on their usage.
+ * Meter events are associated with billing meters, which define the shape of the event's payload and how those events are aggregated for billing.
+ *
+ * @property string $object String representing the object's type. Objects of the same type share the same value.
+ * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch.
+ * @property string $event_name The name of the meter event. Corresponds with the <code>event_name</code> field on a meter.
+ * @property string $identifier A unique identifier for the event.
+ * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
+ * @property \Stripe\StripeObject $payload The payload of the event.
+ * @property int $timestamp The timestamp passed in when creating the event. Measured in seconds since the Unix epoch.
+ */
+class MeterEvent extends \Stripe\ApiResource
+{
+    const OBJECT_NAME = 'billing.meter_event';
+
+    use \Stripe\ApiOperations\Create;
+}

lib/Billing/MeterEventAdjustment.php

@@ -0,0 +1,22 @@
+<?php
+
+// File generated from our OpenAPI spec
+
+namespace Stripe\Billing;
+
+/**
+ * A billing meter event adjustment represents the status of a meter event adjustment.
+ *
+ * @property string $object String representing the object's type. Objects of the same type share the same value.
+ * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
+ * @property string $status The meter event adjustment's status.
+ */
+class MeterEventAdjustment extends \Stripe\ApiResource
+{
+    const OBJECT_NAME = 'billing.meter_event_adjustment';
+
+    use \Stripe\ApiOperations\Create;
+
+    const STATUS_COMPLETE = 'complete';
+    const STATUS_PENDING = 'pending';
+}

lib/Billing/MeterEventSummary.php

@@ -0,0 +1,22 @@
+<?php
+
+// File generated from our OpenAPI spec
+
+namespace Stripe\Billing;
+
+/**
+ * A billing meter event summary represents an aggregated view of a customer's billing meter events within a specified timeframe. It indicates how much
+ * usage was accrued by a customer for that period.
+ *
+ * @property string $id Unique identifier for the object.
+ * @property string $object String representing the object's type. Objects of the same type share the same value.
+ * @property float $aggregated_value Aggregated value of all the events within start_time (inclusive) and end_time (inclusive). The aggregation strategy is defined on meter via `default_aggregation``.
+ * @property int $end_time End timestamp for this usage summary (inclusive).
+ * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
+ * @property string $meter The meter associated with this usage summary.
+ * @property int $start_time Start timestamp for this usage summary (inclusive).
+ */
+class MeterEventSummary extends \Stripe\ApiResource
+{
+    const OBJECT_NAME = 'billing.meter_event_summary';
+}

lib/Plan.php

@@ -27,6 +27,7 @@
  * @property int $interval_count The number of intervals (specified in the <code>interval</code> attribute) between subscription billings. For example, <code>interval=month</code> and <code>interval_count=3</code> bills every 3 months.
  * @property bool $livemode Has the value <code>true</code> if the object exists in live mode or the value <code>false</code> if the object exists in test mode.
  * @property null|\Stripe\StripeObject $metadata Set of <a href="https://stripe.com/docs/api/metadata">key-value pairs</a> that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+ * @property null|string $meter The meter tracking the usage of a metered price
  * @property null|string $nickname A brief description of the plan, hidden from customers.
  * @property null|string|\Stripe\Product $product The product whose pricing this plan determines.
  * @property null|\Stripe\StripeObject[] $tiers Each element represents a pricing tier. This parameter requires <code>billing_scheme</code> to be set to <code>tiered</code>. See also the documentation for <code>billing_scheme</code>.

lib/Service/Billing/BillingServiceFactory.php

@@ -0,0 +1,29 @@
+<?php
+
+// File generated from our OpenAPI spec
+
+namespace Stripe\Service\Billing;
+
+/**
+ * Service factory class for API resources in the Billing namespace.
+ *
+ * @property MeterEventAdjustmentService $meterEventAdjustments
+ * @property MeterEventService $meterEvents
+ * @property MeterService $meters
+ */
+class BillingServiceFactory extends \Stripe\Service\AbstractServiceFactory
+{
+    /**
+     * @var array<string, string>
+     */
+    private static $classMap = [
+        'meterEventAdjustments' => MeterEventAdjustmentService::class,
+        'meterEvents' => MeterEventService::class,
+        'meters' => MeterService::class,
+    ];
+
+    protected function getServiceClass($name)
+    {
+        return \array_key_exists($name, self::$classMap) ? self::$classMap[$name] : null;
+    }
+}

lib/Service/Billing/MeterEventAdjustmentService.php

@@ -0,0 +1,29 @@
+<?php
+
+// File generated from our OpenAPI spec
+
+namespace Stripe\Service\Billing;
+
+/**
+ * @phpstan-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
+ */
+/**
+ * @psalm-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
+ */
+class MeterEventAdjustmentService extends \Stripe\Service\AbstractService
+{
+    /**
+     * Creates a billing meter event adjustment.
+     *
+     * @param null|array $params
+     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
+     *
+     * @return \Stripe\Billing\MeterEventAdjustment
+     */
+    public function create($params = null, $opts = null)
+    {
+        return $this->request('post', '/v1/billing/meter_event_adjustments', $params, $opts);
+    }
+}

lib/Service/Billing/MeterEventService.php

@@ -0,0 +1,29 @@
+<?php
+
+// File generated from our OpenAPI spec
+
+namespace Stripe\Service\Billing;
+
+/**
+ * @phpstan-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
+ */
+/**
+ * @psalm-import-type RequestOptionsArray from \Stripe\Util\RequestOptions
+ */
+class MeterEventService extends \Stripe\Service\AbstractService
+{
+    /**
+     * Creates a billing meter event.
+     *
+     * @param null|array $params
+     * @param null|RequestOptionsArray|\Stripe\Util\RequestOptions $opts
+     *
+     * @throws \Stripe\Exception\ApiErrorException if the request fails
+     *
+     * @return \Stripe\Billing\MeterEvent
+     */
+    public function create($params = null, $opts = null)
+    {
+        return $this->request('post', '/v1/billing/meter_events', $params, $opts);
+    }
+}