@burdenoff/microfe-devportal 2026.915.10 → 2026.915.12

package/dist/generated/global-types.d.ts

@@ -937,6 +937,8 @@ export type AppRevenueSummary = {
     __typename?: 'AppRevenueSummary';
     applicationId: Scalars['ID']['output'];
     applicationName: Scalars['String']['output'];
+    /** Same currency as the parent RevenueSummary — see its doc comment. */
+    currency: Scalars['String']['output'];
     grossRevenue: Scalars['Float']['output'];
     netRevenue: Scalars['Float']['output'];
     salesCount: Scalars['Int']['output'];
@@ -2070,6 +2072,14 @@ export type CannedResponseFilterInput = {
     isActive?: InputMaybe<Scalars['Boolean']['input']>;
     tags?: InputMaybe<Array<Scalars['String']['input']>>;
 };
+/** One of a shipping carrier's own registered pickup/warehouse addresses (see carrierPickupLocations query). Not organization-scoped — a pickup location belongs to whichever carrier account it's registered with (e.g. Shiprocket today; more carriers may be added later), since a store's ShippingMethods can each use a different carrier. */
+export type CarrierPickupLocation = {
+    __typename?: 'CarrierPickupLocation';
+    /** Which carrier this pickup address is registered with (matches ShippingMethod.carrier, e.g. "shiprocket"). */
+    carrier: Scalars['String']['output'];
+    label: Scalars['String']['output'];
+    postalCode: Scalars['String']['output'];
+};
 /** Shopping cart for collecting products before checkout */
 export type Cart = {
     __typename?: 'Cart';
@@ -5049,6 +5059,27 @@ export type DeveloperOrgPayoutEdge = {
     cursor: Scalars['String']['output'];
     node: DeveloperOrgPayout;
 };
+/** A real, physical pickup/warehouse address an organization has registered with a shipping carrier (e.g. Shiprocket) for physical-order fulfillment. An org can have several; exactly one is isDefault at a time. Created by global-store-svc's registerCarrierPickupLocation after a successful carrier-side registration (see recordDeveloperOrgPickupAddress) — removing a row here only stops us from using that address for this org, it does not reach out to the carrier (carriers like Shiprocket have no delete API). */
+export type DeveloperOrgPickupAddress = {
+    __typename?: 'DeveloperOrgPickupAddress';
+    address: Scalars['String']['output'];
+    addressLine2?: Maybe<Scalars['String']['output']>;
+    carrier: Scalars['String']['output'];
+    carrierLocationLabel: Scalars['String']['output'];
+    city: Scalars['String']['output'];
+    country: Scalars['String']['output'];
+    createdAt: Scalars['DateTime']['output'];
+    email: Scalars['String']['output'];
+    id: Scalars['ID']['output'];
+    isDefault: Scalars['Boolean']['output'];
+    name: Scalars['String']['output'];
+    organization: DeveloperOrganization;
+    organizationId: Scalars['ID']['output'];
+    phone: Scalars['String']['output'];
+    postalCode: Scalars['String']['output'];
+    state: Scalars['String']['output'];
+    updatedAt: Scalars['DateTime']['output'];
+};
 /** Developer Organization Revenue Analytics - aggregated revenue data */
 export type DeveloperOrgRevenueAnalytics = {
     __typename?: 'DeveloperOrgRevenueAnalytics';
@@ -5234,7 +5265,8 @@ export type DeveloperOrganization = {
     paymentMethods: Array<DeveloperOrgPaymentMethod>;
     payouts: Array<DeveloperOrgPayout>;
     pendingBalance: Scalars['Float']['output'];
-    /** Dedicated pickup pincode for carrier rate quoting (Shiprocket, etc) on physical-goods orders. Checked before falling back to the linked billing account's address — see global-store-svc's resolvePickupPostalCode. */
+    pickupAddresses: Array<DeveloperOrgPickupAddress>;
+    /** Legacy single pickup pincode, superseded by pickupAddresses (an org can now register several real addresses with a carrier and pick one as active). Kept only as a fallback for orgs that set this before DeveloperOrgPickupAddress existed — see organizationPickupPostalCode. */
     pickupPostalCode?: Maybe<Scalars['String']['output']>;
     platformFeeRate: Scalars['Float']['output'];
     publishedApps: Scalars['Int']['output'];
@@ -8480,6 +8512,8 @@ export type Mutation = {
     /** Feature a review */
     featureAppReview: AppReview;
     fileDSAR: DsarRequest;
+    /** Seller reports a problem fulfilling a physical order (out of stock, cannot fulfill, wrong address, etc). The resolver verifies organizationId actually owns a physical line item on this order (real evidence in store-svc's own data) — scopeType: "organization" at the gateway only confirms the actor has SOME org context, not that it's this specific one. */
+    flagOrderIssue: OrderIssueFlag;
     freeUpUsage: Scalars['Boolean']['output'];
     generateAPIKey: ApiKeyResult;
     generateAppAsUserToken: AppAsUserTokenResponse;
@@ -8641,6 +8675,8 @@ export type Mutation = {
     recordBounce: NewsletterBounce;
     recordComplaint: NewsletterComplaint;
     recordConsent: NewsletterConsent;
+    /** Service-to-service only: records that global-store-svc successfully registered this address with a carrier, on behalf of the given org. actorId/actorType identify the real end user who requested the registration (for the audit trail) — the caller is responsible for verifying that actor's access via assertDeveloperOrgAccess first. */
+    recordDeveloperOrgPickupAddress: DeveloperOrgPickupAddress;
     recordDownload: ProductDownload;
     recordEarningEntry: EarningsEntry;
     /** Record that a visitor followed a link the answer offered. Fire-and-forget from the browser: a click must never be blocked or delayed by analytics, so this reports `recorded: false` rather than throwing when the click cannot be attributed. */
@@ -8666,6 +8702,8 @@ export type Mutation = {
     regenerateAffiliateCode: AffiliateCode;
     /** Register (or re-register) an approved application with global-auth-svc so it can issue OAuth clients, API keys, and delegations. Safe to call more than once — skips if appId is already set. */
     registerAppWithAuthService: Application;
+    /** Register a seller's real address as a new pickup/warehouse location on a carrier account (currently only "shiprocket" supports this), so it becomes a real, bookable pickup point instead of just an unregistered pincode a seller typed in. This is a real, permanent write to the carrier's account — not a local list we maintain; any address the carrier itself accepts is supported, we never hardcode which pincodes are valid. scopeType: "self" — same authenticated-actor bar as carrierPickupLocations. This doesn't touch a store-svc-owned resource with an ownership row to check against (it writes directly to the carrier account), so there's no org-ownership verification here — a known trust-boundary gap, same shape as flagOrderIssue's caller-supplied organizationId. */
+    registerCarrierPickupLocation: CarrierPickupLocation;
     /** Register (or refresh) a push-notification device token for the current user. Upserts on the OS-issued token — safe to call on every app launch and on every token-refresh event. `platform` is one of "ios", "android", "web". `productSlug` names the product whose install minted the token; the server derives the Firebase project from it, and an unmapped product is rejected outright rather than stored as an undeliverable row. `metadata` is optional free-form context (app version, OS version). Deliberately takes no `fcmProject` and no identity argument: the project is derived server-side so a client cannot file a device under a project that cannot reach it, and the owner is always the calling actor. */
     registerDeviceToken: DeviceToken;
     registerProductAsset: ProductAsset;
@@ -8699,6 +8737,8 @@ export type Mutation = {
     removeAppsFromCollection: AppCollection;
     /** Remove a member from an organization */
     removeDeveloperOrgMember: Scalars['Boolean']['output'];
+    /** Stop using this pickup address for the organization. Only removes our own record — carriers like Shiprocket have no delete API, so the address may still exist on the carrier's account, it just won't be used for this org's shipments anymore. If the removed address was the default and others remain, the most recently added one is promoted to default. */
+    removeDeveloperOrgPickupAddress: Scalars['Boolean']['output'];
     /** Remove an item from the cart */
     removeFromCart: CartPayload;
     /** Remove a waitlist entry entirely (admin operation). */
@@ -8800,6 +8840,8 @@ export type Mutation = {
     resolveContextWidgetConversation: ContextWidgetConversationPayload;
     resolveDLQEntry: Scalars['Boolean']['output'];
     resolveInventoryAlert: InventoryAlert;
+    /** Mark a seller-reported issue flag resolved. Allowed for a super-admin (no organizationId needed) or the org that raised the flag (organizationId must match) — enforced in the resolver. */
+    resolveOrderIssueFlag: OrderIssueFlag;
     resolveSupportTicket: SupportTicket;
     /** Respond to a review (developer) */
     respondToAppReview: AppReview;
@@ -8933,6 +8975,8 @@ export type Mutation = {
     /** Set a payment method as default */
     setDefaultPaymentMethod: DeveloperOrgPaymentMethod;
     setDefaultPayoutAccount: PayoutAccount;
+    /** Mark one of the organization's pickup addresses as the active one used for carrier rate quoting and shipment booking. Unsets any other default. */
+    setDefaultPickupAddress: DeveloperOrgPickupAddress;
     setEntitlementSeatLimit: ProductEntitlement;
     /** Subscribe or unsubscribe the current user from a notification topic */
     setNotificationTopicSubscription: NotificationTopicSubscription;
@@ -10944,6 +10988,13 @@ export type MutationFileDsarArgs = {
     input: FileDsarInput;
 };
 /** Root mutation type */
+export type MutationFlagOrderIssueArgs = {
+    category: OrderIssueCategory;
+    note?: InputMaybe<Scalars['String']['input']>;
+    orderId: Scalars['ID']['input'];
+    organizationId: Scalars['ID']['input'];
+};
+/** Root mutation type */
 export type MutationFreeUpUsageArgs = {
     billingAccountId: Scalars['ID']['input'];
     description?: InputMaybe<Scalars['String']['input']>;
@@ -11396,6 +11447,13 @@ export type MutationRecordConsentArgs = {
     input: RecordConsentInput;
 };
 /** Root mutation type */
+export type MutationRecordDeveloperOrgPickupAddressArgs = {
+    actorId: Scalars['ID']['input'];
+    actorType?: InputMaybe<Scalars['String']['input']>;
+    input: RecordPickupAddressInput;
+    organizationId: Scalars['ID']['input'];
+};
+/** Root mutation type */
 export type MutationRecordDownloadArgs = {
     ipAddress?: InputMaybe<Scalars['String']['input']>;
     productId: Scalars['String']['input'];
@@ -11463,6 +11521,10 @@ export type MutationRegisterAppWithAuthServiceArgs = {
     id: Scalars['ID']['input'];
 };
 /** Root mutation type */
+export type MutationRegisterCarrierPickupLocationArgs = {
+    input: RegisterCarrierPickupLocationInput;
+};
+/** Root mutation type */
 export type MutationRegisterDeviceTokenArgs = {
     deviceId: Scalars['String']['input'];
     metadata?: InputMaybe<Scalars['JSONObject']['input']>;
@@ -11570,6 +11632,10 @@ export type MutationRemoveDeveloperOrgMemberArgs = {
     id: Scalars['ID']['input'];
 };
 /** Root mutation type */
+export type MutationRemoveDeveloperOrgPickupAddressArgs = {
+    id: Scalars['ID']['input'];
+};
+/** Root mutation type */
 export type MutationRemoveFromCartArgs = {
     cartItemId: Scalars['String']['input'];
 };
@@ -11842,6 +11908,11 @@ export type MutationResolveInventoryAlertArgs = {
     alertId: Scalars['ID']['input'];
 };
 /** Root mutation type */
+export type MutationResolveOrderIssueFlagArgs = {
+    id: Scalars['ID']['input'];
+    organizationId?: InputMaybe<Scalars['ID']['input']>;
+};
+/** Root mutation type */
 export type MutationResolveSupportTicketArgs = {
     id: Scalars['ID']['input'];
     resolution?: InputMaybe<Scalars['String']['input']>;
@@ -12153,6 +12224,10 @@ export type MutationSetDefaultPayoutAccountArgs = {
     id: Scalars['ID']['input'];
 };
 /** Root mutation type */
+export type MutationSetDefaultPickupAddressArgs = {
+    id: Scalars['ID']['input'];
+};
+/** Root mutation type */
 export type MutationSetEntitlementSeatLimitArgs = {
     entitlementId: Scalars['ID']['input'];
     maxSeats: Scalars['Int']['input'];
@@ -14126,6 +14201,32 @@ export type OrderFulfillment = {
     trackingUrl?: Maybe<Scalars['String']['output']>;
     updatedAt: Scalars['DateTime']['output'];
 };
+/** Category of a seller-reported problem fulfilling an order. */
+export declare enum OrderIssueCategory {
+    CannotFulfill = "CANNOT_FULFILL",
+    Other = "OTHER",
+    OutOfStock = "OUT_OF_STOCK",
+    WrongAddress = "WRONG_ADDRESS"
+}
+/** A seller-reported problem fulfilling a physical order (e.g. out of stock, cannot fulfill, wrong address). Raised by the org that owns the physical line item(s) on the order; resolvable by admin or the org that raised it. */
+export type OrderIssueFlag = {
+    __typename?: 'OrderIssueFlag';
+    category: OrderIssueCategory;
+    createdAt: Scalars['DateTime']['output'];
+    id: Scalars['ID']['output'];
+    note?: Maybe<Scalars['String']['output']>;
+    orderId: Scalars['String']['output'];
+    /** Developer organization ID that raised this flag */
+    raisedByOrgId: Scalars['String']['output'];
+    resolvedAt?: Maybe<Scalars['DateTime']['output']>;
+    resolvedBy?: Maybe<Scalars['String']['output']>;
+    status: OrderIssueStatus;
+    updatedAt: Scalars['DateTime']['output'];
+};
+export declare enum OrderIssueStatus {
+    Open = "OPEN",
+    Resolved = "RESOLVED"
+}
 /** Shipping estimate for a selected method and destination */
 export type OrderShippingEstimate = {
     __typename?: 'OrderShippingEstimate';
@@ -15778,6 +15879,8 @@ export type Query = {
     adminAffiliateAnalytics: AffiliateAdminAnalytics;
     adminPayoutRequests: PayoutRequestConnection;
     adminPayoutSummary: PayoutAdminSummary;
+    /** Admin-only: paginated list of physical (fulfillment-tracked) orders, with optional status/search filters. Used by the admin fulfillment console. */
+    adminPhysicalOrders: StoreOrdersResult;
     affiliateCode?: Maybe<AffiliateCode>;
     affiliateCodeAnalytics: AffiliateCodeAnalytics;
     affiliateJourneyEvents: Array<AffiliateJourneyEvent>;
@@ -15824,6 +15927,8 @@ export type Query = {
     /** Internal: get all approved waitlist entries for an email. Used by tenant-svc for product access checks. */
     approvedWaitlistProducts: Array<NewsletterWaitlist>;
     appsActingAsCurrentUser: AppConnection;
+    /** Service-to-service only: verifies the given actor (forwarded explicitly by the calling service, since the gateway-level actor on an internal M2M call is the calling service itself, not the original end user) has at least minRole membership on the organization. Used by global-store-svc's registerCarrierPickupLocation before it registers a pickup address on an org's behalf, closing a trust-boundary gap where any authenticated caller could otherwise attribute a carrier registration to an arbitrary org. */
+    assertDeveloperOrgAccess: Scalars['Boolean']['output'];
     auditLogs: AuditLogConnection;
     /** List auth audit events visible to the current user. Resolver filters by actorId/userId — membership IS the access list. */
     authAuditLogs: AuthAuditLogConnection;
@@ -15847,6 +15952,8 @@ export type Query = {
     cannedResponse?: Maybe<CannedResponse>;
     cannedResponseByShortcut?: Maybe<CannedResponse>;
     cannedResponses: CannedResponseConnection;
+    /** Registered pickup/warehouse addresses across every configured shipping carrier (currently Shiprocket; more may be added later — see listCarrierAdapters) — lets a seller pick a pincode that can actually be booked instead of typing an arbitrary one that checkout will later refuse to ship. Each result is tagged with which carrier it belongs to. Carriers that aren't configured, or that don't support pickup-location listing at all (e.g. the manual carrier), simply contribute nothing — never blocks org configuration. */
+    carrierPickupLocations: Array<CarrierPickupLocation>;
     /** Get a cart by ID (admin or owner only) */
     cart?: Maybe<Cart>;
     /** Get available shipping options for the current cart (caller's own cart) */
@@ -16406,6 +16513,8 @@ export type Query = {
     orderEstimate?: Maybe<OrderEstimate>;
     /** Get fulfillment details for an order */
     orderFulfillment?: Maybe<OrderFulfillment>;
+    /** Get seller-reported issue flags for an order */
+    orderIssueFlags: Array<OrderIssueFlag>;
     /** Get a single organization by ID */
     organization?: Maybe<Organization>;
     /** Paginated keyset connection over the persistent OrganizationAuditLog table. Returns audit events for a single organization, newest first. Supports optional filtering by `action` (event name) and `actorId`. */
@@ -16420,7 +16529,7 @@ export type Query = {
     organizationMemberIdentities: Array<OrganizationMemberIdentity>;
     /** Get members of an organization */
     organizationMembers: OrganizationMemberList;
-    /** M2M lookup for global-store-svc's shipping-cost quote pipeline: the org's dedicated pickup pincode, or null when unset (caller falls back to the linked billing account's address, then a platform-wide default). */
+    /** M2M lookup for global-store-svc's shipping-cost quote pipeline: the org's active pickup postal code — the default DeveloperOrgPickupAddress's postalCode, falling back to the legacy pickupPostalCode scalar for orgs that set one before DeveloperOrgPickupAddress existed, then null (caller falls back to the linked billing account's address, then a platform-wide default). */
     organizationPickupPostalCode?: Maybe<Scalars['String']['output']>;
     organizationScheduleQuotas: OrganizationScheduleQuotas;
     payoutRunHistory: Array<PayoutRunLog>;
@@ -16772,6 +16881,13 @@ export type QueryAdminPayoutSummaryArgs = {
     filter?: InputMaybe<PayoutRequestFilterInput>;
 };
 /** Root query type */
+export type QueryAdminPhysicalOrdersArgs = {
+    limit: Scalars['Int']['input'];
+    page: Scalars['Int']['input'];
+    search?: InputMaybe<Scalars['String']['input']>;
+    status?: InputMaybe<OrderStatus>;
+};
+/** Root query type */
 export type QueryAffiliateCodeArgs = {
     id: Scalars['ID']['input'];
 };
@@ -16927,6 +17043,13 @@ export type QueryAppsActingAsCurrentUserArgs = {
     pagination?: InputMaybe<PaginationInput>;
 };
 /** Root query type */
+export type QueryAssertDeveloperOrgAccessArgs = {
+    actorId: Scalars['ID']['input'];
+    actorType?: InputMaybe<Scalars['String']['input']>;
+    minRole?: InputMaybe<Scalars['String']['input']>;
+    organizationId: Scalars['ID']['input'];
+};
+/** Root query type */
 export type QueryAuditLogsArgs = {
     actorId?: InputMaybe<Scalars['ID']['input']>;
     limit?: InputMaybe<Scalars['Int']['input']>;
@@ -18538,6 +18661,10 @@ export type QueryOrderFulfillmentArgs = {
     orderId: Scalars['ID']['input'];
 };
 /** Root query type */
+export type QueryOrderIssueFlagsArgs = {
+    orderId: Scalars['ID']['input'];
+};
+/** Root query type */
 export type QueryOrganizationArgs = {
     id: Scalars['ID']['input'];
 };
@@ -19887,6 +20014,20 @@ export type RecordNotificationActionInput = {
     metadata?: InputMaybe<Scalars['JSON']['input']>;
     notificationId: Scalars['ID']['input'];
 };
+export type RecordPickupAddressInput = {
+    address: Scalars['String']['input'];
+    addressLine2?: InputMaybe<Scalars['String']['input']>;
+    carrier: Scalars['String']['input'];
+    carrierLocationLabel: Scalars['String']['input'];
+    city: Scalars['String']['input'];
+    country: Scalars['String']['input'];
+    email: Scalars['String']['input'];
+    isDefault?: InputMaybe<Scalars['Boolean']['input']>;
+    name: Scalars['String']['input'];
+    phone: Scalars['String']['input'];
+    postalCode: Scalars['String']['input'];
+    state: Scalars['String']['input'];
+};
 export type RecordProductVisitInput = {
     /** Optional: app URL the user landed on. Used as CTA target in the welcome email. Defaults to https://app.<slug>.com when omitted. */
     appUrl?: InputMaybe<Scalars['String']['input']>;
@@ -20122,6 +20263,22 @@ export declare enum RefundStatus {
     Pending = "PENDING",
     Succeeded = "SUCCEEDED"
 }
+/** A seller's real pickup address, to be registered with a shipping carrier (see registerCarrierPickupLocation). `carrier` selects which configured carrier adapter to register it with — carrier-agnostic by design, since more providers than Shiprocket may be added over time. */
+export type RegisterCarrierPickupLocationInput = {
+    address: Scalars['String']['input'];
+    addressLine2?: InputMaybe<Scalars['String']['input']>;
+    carrier: Scalars['String']['input'];
+    city: Scalars['String']['input'];
+    country: Scalars['String']['input'];
+    email: Scalars['String']['input'];
+    /** Contact person at this address. */
+    name: Scalars['String']['input'];
+    /** The DeveloperOrganization this address is being registered for. Verified via a cross-service call to global-devportal-svc's assertDeveloperOrgAccess before any carrier API call is made. */
+    organizationId: Scalars['ID']['input'];
+    phone: Scalars['String']['input'];
+    postalCode: Scalars['String']['input'];
+    state: Scalars['String']['input'];
+};
 export type RegisterProductAssetInput = {
     caption?: InputMaybe<Scalars['String']['input']>;
     fileName?: InputMaybe<Scalars['String']['input']>;
@@ -20320,6 +20477,8 @@ export type RetrySyncOutboxResult = {
 /** Revenue summary for dashboard */
 export type RevenueSummary = {
     __typename?: 'RevenueSummary';
+    /** ISO 4217 currency code these totals are denominated in — derived from the org's DeveloperOrgSale rows (the dominant currency by sale count). Orgs are expected to transact in one currency; if an org's sales genuinely span multiple currencies, only the dominant one is reflected here. */
+    currency: Scalars['String']['output'];
     nextPayoutAmount?: Maybe<Scalars['Float']['output']>;
     nextPayoutDate?: Maybe<Scalars['DateTime']['output']>;
     pendingBalance: Scalars['Float']['output'];
@@ -21734,6 +21893,8 @@ export type StoreOrder = {
     /** Fulfillment tracking for physical orders */
     fulfillment?: Maybe<OrderFulfillment>;
     id: Scalars['ID']['output'];
+    /** Seller-reported issues on this order (e.g. out of stock, cannot fulfill). */
+    issueFlags: Array<OrderIssueFlag>;
     /** Array of line items in this order */
     lineItems: Scalars['JSON']['output'];
     metadata?: Maybe<Scalars['JSON']['output']>;