@maixio/pstore 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,47 @@
+import { fetchBrowseGrid, type BrowseGridResult, type BrowseQuery } from "./api/browse.js";
+import { fetchCategoryGrid, fetchCategoryGridResult, type CategoryGridItem, type CategoryGridParams, type CategoryGridResult } from "./api/graphql.js";
+import { searchGames, type SearchOptions, type SearchResponse } from "./api/search.js";
+import { fetchPsnStatus, type PsnStatusOptions, type PsnStatusResult } from "./api/status.js";
+import { lookupGame, type LookupResponse } from "./provider.js";
+import type { LookupOptions, PsnLocale } from "./types.js";
+export interface PstoreClientOptions {
+    locale?: PsnLocale;
+}
+export interface PstoreClient {
+    readonly locale: PsnLocale;
+    lookup(id: string, options?: Omit<LookupOptions, "locale"> & {
+        locale?: PsnLocale;
+    }): Promise<LookupResponse>;
+    search(options: Omit<SearchOptions, "locale"> & {
+        locale?: PsnLocale;
+    }): Promise<SearchResponse>;
+    browse(query?: Omit<BrowseQuery, "locale"> & {
+        locale?: PsnLocale;
+    }): Promise<BrowseGridResult | null>;
+    category(params: Omit<CategoryGridParams, "locale"> & {
+        locale?: PsnLocale;
+    }): Promise<CategoryGridItem[] | null>;
+    categoryGrid(params: Omit<CategoryGridParams, "locale"> & {
+        locale?: PsnLocale;
+    }): Promise<CategoryGridResult | null>;
+    status(options?: Omit<PsnStatusOptions, "locale"> & {
+        locale?: PsnLocale;
+    }): Promise<PsnStatusResult>;
+}
+interface PstoreClientDeps {
+    lookupGame: typeof lookupGame;
+    searchGames: typeof searchGames;
+    fetchBrowseGrid: typeof fetchBrowseGrid;
+    fetchCategoryGrid: typeof fetchCategoryGrid;
+    fetchCategoryGridResult: typeof fetchCategoryGridResult;
+    fetchPsnStatus: typeof fetchPsnStatus;
+}
+/**
+ * Create a small SDK facade with a default locale. Current provider caches are
+ * still process-global; this facade keeps call sites stable while leaving room
+ * for per-client cache/logger injection in a future minor release.
+ */
+export declare function createPstoreClient(options?: PstoreClientOptions): PstoreClient;
+/** @internal */
+export declare function createPstoreClientWithDeps(options: PstoreClientOptions | undefined, deps: PstoreClientDeps): PstoreClient;
+export {};

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+export interface CliConfig {
+    /** Default locale */
+    locale?: string;
+    /** Default output format: "text" | "json" */
+    format?: "text" | "json";
+    /** Default page size for search/category */
+    pageSize?: number;
+    /** Enable verbose timing by default */
+    verbose?: boolean;
+    /** Whether to show colors */
+    color?: boolean;
+    /** Cache TTL overrides */
+    cacheTtl?: {
+        lookup?: number;
+        search?: number;
+        category?: number;
+    };
+}
+/**
+ * Get the merged configuration (file config + defaults).
+ */
+export declare function getConfig(): CliConfig;
+/**
+ * Reload configuration from disk.
+ */
+export declare function reloadConfig(): CliConfig;
+/**
+ * Create a default config file in the project root.
+ */
+export declare function initConfig(): string;

package/dist/fetch.d.ts

@@ -0,0 +1,19 @@
+import type { PsnLocale } from "./types.js";
+/**
+ * Fetch from PSN GraphQL API with retry, timeout, and gzip.
+ *
+ * @param operationName - GraphQL operation name
+ * @param sha256Hash - Persisted query SHA256 hash
+ * @param variables - Query variables
+ * @param locale - Optional locale override
+ * @returns Parsed JSON response
+ */
+export declare function fetchPsnApi<T>(operationName: string, sha256Hash: string, variables: Record<string, unknown>, locale?: PsnLocale): Promise<T>;
+/**
+ * Fetch a PSN store HTML page.
+ */
+export declare function fetchHtml(url: string): Promise<string>;
+/**
+ * Check if a string is a valid URL.
+ */
+export declare function isValidUrl(str: string): boolean;

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { createPstoreClient } from "./client.js";
+export type { PstoreClient, PstoreClientOptions } from "./client.js";
+export { lookupGame, clearCaches as clearPstoreCaches } from "./provider.js";
+export type { LookupResponse } from "./provider.js";
+export { searchGames } from "./api/search.js";
+export type { SearchOptions, SearchResponse } from "./api/search.js";
+export { fetchPsnStatus, parsePsnStatus, regionForCountry } from "./api/status.js";
+export type { PsnServiceStatus, PsnStatusIncident, PsnStatusOptions, PsnStatusRegion, PsnStatusResult, PsnStatusService, PsnStatusServiceResource, } from "./api/status.js";
+export { fetchBrowseGrid, normalizeBrowseWindow, resolveBrowseQuery, resolveBrowseSortDefaults, sampleItems, } from "./api/browse.js";
+export type { BrowseGridResult, BrowseOrder, BrowseQuery, BrowseResolvedQuery, BrowseWindow, } from "./api/browse.js";
+export { fetchCategoryGrid, fetchCategoryGridResult } from "./api/graphql.js";
+export type { CategoryFacet, CategoryFacetValue, CategoryGridItem, CategoryGridPageInfo, CategoryGridParams, CategoryGridResult, CategorySortingOption, } from "./api/graphql.js";
+export { resolveCategoryDisplayName } from "./api/category-names.js";
+export { validateCatalog, validateCatalogs } from "./api/catalog-validation.js";
+export type { CatalogValidationOptions, CatalogValidationResult, } from "./api/catalog-validation.js";
+export { BUILTIN_CATALOGS, CATALOG_ALIASES, resolveCatalogAlias, resolveCatalogDisplayName, resolveCatalogVisibility, } from "./api/catalog-registry.js";
+export type { CatalogRegistryEntry, CatalogRegistrySource, CatalogVisibility, } from "./api/catalog-registry.js";
+export { discoverCatalogs } from "./api/catalog-discovery.js";
+export type { CatalogDiscoveryCatalog, CatalogDiscoveryPage, CatalogDiscoveryResult, DiscoverCatalogsOptions, } from "./api/catalog-discovery.js";
+export { DEFAULT_LOCALE, TITLE_LOCALE_PRESETS, getLocaleInfo, isPsnLocale, localeToSearchParams, localeToStorePath, normalizeLocale, parseLocaleList, } from "./locale.js";
+export { LOCALE_MAP } from "./types.js";
+export type { BatarangData, CategoryResults, ConceptId, ContentRating, Description, DescriptionType, Edition, GameCTA, LocaleInfo, LookupOptions, LookupResult, LookupSource, LookupSources, LookupWarning, Media, MediaRole, MediaType, Price, Product, ProductId, PsnLocale, RatingDistribution, SearchResultItem, SearchResults, Sku, StarRating, } from "./types.js";