@sylphx/sdk 0.8.0-rc.2 → 0.9.0

package/dist/server/index.d.ts

@@ -1,6 +1,4 @@
 import { SdkBillingPlan, SdkConsentType } from '@sylphx/contract';
-import { OAuthProvider } from '@sylphx/ui';
-export { OAuthProvider } from '@sylphx/ui';
 
 /**
  * REST Client for Sylphx Platform
@@ -622,6 +620,32 @@ declare function validateAndSanitizeKey(key: string | undefined | null): string;
  */
 declare function isDevelopmentRuntime(): boolean;
 
+/**
+ * OAuth SDK — customer-app-facing social login (ADR-089 Phase 4a)
+ *
+ * Backed by `apps/runtime/src/server/runtime/routes/oauth.ts`:
+ *
+ *   POST /oauth/authorize   — initiate OAuth flow, returns provider URL
+ *
+ * The per-provider callback handler is a browser-side redirect endpoint
+ * on the runtime (`GET /oauth/callback/{provider}`); SDK consumers
+ * redirect the user to `authorizationUrl`, then receive a `code` on
+ * their own `redirect_uri` which they exchange via `signIn()` or
+ * `auth/login` with grant_type=authorization_code.
+ *
+ * PKCE is required per OAuth 2.1. Callers MUST generate `code_verifier`
+ * + `code_challenge` and persist the verifier in session / cookie for
+ * the subsequent token exchange — this SDK does not retain state.
+ *
+ * ## Distinction from `auth.oauth`
+ *
+ * `auth.oauth.*` (from `./auth`) targets platform-plane admin mint
+ * (`/auth/platform-jwt/mint`) used by Console / CLI. The functions
+ * here target the customer-app social-login flow.
+ */
+
+type OAuthProvider = OAuthProviderId | (string & {});
+
 /**
  * Functions Client — Serverless V8 Isolate Functions (ADR-043)
  *
@@ -1843,4 +1867,4 @@ declare function getDatabaseConnection(options: AuthenticatedFetchOptions): Prom
  */
 declare function getDatabaseStatus(options: AuthenticatedFetchOptions): Promise<DatabaseStatusInfo>;
 
-export { type AIClient, type AIClientOptions, type AppConfig, type AppMetadata, type ChannelHelper, type ChatCompletionChunk, type ChatCompletionOptions, type ChatCompletionResponse, type ChatCompletionStreamOptions, type ChatMessage, type ConsentType, type DatabaseConnectionInfo, type DatabaseStatusInfo, type EmbeddingOptions, type EmbeddingResponse, type EngagementLeaderboardEntry, type EngagementLeaderboardResult, type EnvironmentType, type FeatureFlagDefinition, type FunctionDeployOptions, type FunctionDeployResult, type FunctionInvokeOptions, type FunctionListOptions, type FunctionLogEntry, type FunctionLogsOptions, type FunctionRecord, type FunctionRuntime, type FunctionStatus, FunctionsClient, type GetAppConfigOptions, InvalidConnectionUrlError, type KeyType, type KeyValidationResult, type KvClient, type KvClientOptions, type KvRateLimitResult, type KvSetOptions, type KvZMember, type ModelInfo, type ModelsResponse, type OAuthProviderInfo, type Plan, type ReferralLeaderboardEntry, type ReferralLeaderboardResult, type RestClient, type RestClientConfig as ServerClientConfig, type ServerConfig, type StreamHistoryOptions, type StreamMessage, type StreamsClient, type StreamsClientOptions, type SylphxClientInput, type SylphxConfig, type WebhookPayload, type WebhookVerifyOptions, type WebhookVerifyResult, createAI, createAuthenticatedServerClient, createClient, createKv, createServerClient, createServerRestClient, createStreams, createWebhookHandler, decodeUserId, detectEnvironment, detectKeyType, encodeUserId, getAI, getAppConfig, getAppMetadata, getConsentTypes, getCookieNamespace, getDatabaseConnection, getDatabaseStatus, getEngagementLeaderboard, getFeatureFlags, getJwks, getKv, getOAuthProviders, getOAuthProvidersWithInfo, getPlans, getReferralLeaderboard, getStreams, isAppId, isDevelopmentKey, isDevelopmentRuntime, isProductionKey, isSecretKey, resetJwksCache, validateAndSanitizeAppId, validateAndSanitizeKey, validateAndSanitizeSecretKey, validateAppId, validateKey, validateSecretKey, verifyAccessToken, verifyWebhook };
+export { type AIClient, type AIClientOptions, type AppConfig, type AppMetadata, type ChannelHelper, type ChatCompletionChunk, type ChatCompletionOptions, type ChatCompletionResponse, type ChatCompletionStreamOptions, type ChatMessage, type ConsentType, type DatabaseConnectionInfo, type DatabaseStatusInfo, type EmbeddingOptions, type EmbeddingResponse, type EngagementLeaderboardEntry, type EngagementLeaderboardResult, type EnvironmentType, type FeatureFlagDefinition, type FunctionDeployOptions, type FunctionDeployResult, type FunctionInvokeOptions, type FunctionListOptions, type FunctionLogEntry, type FunctionLogsOptions, type FunctionRecord, type FunctionRuntime, type FunctionStatus, FunctionsClient, type GetAppConfigOptions, InvalidConnectionUrlError, type KeyType, type KeyValidationResult, type KvClient, type KvClientOptions, type KvRateLimitResult, type KvSetOptions, type KvZMember, type ModelInfo, type ModelsResponse, type OAuthProvider, type OAuthProviderInfo, type Plan, type ReferralLeaderboardEntry, type ReferralLeaderboardResult, type RestClient, type RestClientConfig as ServerClientConfig, type ServerConfig, type StreamHistoryOptions, type StreamMessage, type StreamsClient, type StreamsClientOptions, type SylphxClientInput, type SylphxConfig, type WebhookPayload, type WebhookVerifyOptions, type WebhookVerifyResult, createAI, createAuthenticatedServerClient, createClient, createKv, createServerClient, createServerRestClient, createStreams, createWebhookHandler, decodeUserId, detectEnvironment, detectKeyType, encodeUserId, getAI, getAppConfig, getAppMetadata, getConsentTypes, getCookieNamespace, getDatabaseConnection, getDatabaseStatus, getEngagementLeaderboard, getFeatureFlags, getJwks, getKv, getOAuthProviders, getOAuthProvidersWithInfo, getPlans, getReferralLeaderboard, getStreams, isAppId, isDevelopmentKey, isDevelopmentRuntime, isProductionKey, isSecretKey, resetJwksCache, validateAndSanitizeAppId, validateAndSanitizeKey, validateAndSanitizeSecretKey, validateAppId, validateKey, validateSecretKey, verifyAccessToken, verifyWebhook };

package/dist/server/index.mjs

@@ -2209,7 +2209,7 @@ function createConfigFromComponents(input) {
     const credentialType = match[1];
     const env = match[2];
     const slug = resolvedSlug.trim().toLowerCase();
-    const domain = input.domain?.trim() || "api.sylphx.com";
+    const domain = input.domain?.trim() || DEFAULT_SDK_API_HOST;
     const baseUrl = `https://${slug}.${domain}/v1`;
     return freezeConfig({
       credential: trimmedCred,
@@ -2232,7 +2232,7 @@ function createConfigFromComponents(input) {
       const platform = input.platformUrl.trim().replace(/\/$/, "");
       baseUrl = platform.includes("/v1") ? platform : `${platform}/v1`;
     } else {
-      const domain = input.domain?.trim() || "api.sylphx.com";
+      const domain = input.domain?.trim() || DEFAULT_SDK_API_HOST;
       baseUrl = `https://${slug}.${domain}/v1`;
     }
     return freezeConfig({