open-index/open-npm huggingface dataset:
npm package: @shopgrouper/payme
Description: # You must instlal firebase@8.10.0 in order to use with this package
Latest version: 0.2.8

# shopgrouper-core

# You must instlal firebase@8.10.0 in order to use with this package

This package contains some UI Component of Shopgrouper and ShopgrouperSDK (API service) of Shopgrouper

```
  npm i firebase@8.10.0

  # or you're using yarn

  yarn add firebase@8.10.0

```
npm package: @shophost/client
Description: `@shophost/client` is the generated TypeScript client for the ShopHost API.
Author: Abhishek Shaji
Latest version: 2.0.75

# @shophost/client

`@shophost/client` is the generated TypeScript client for the ShopHost API.

It wraps the generated OpenAPI SDK with a small runtime that normalizes request
shapes and responses.

## Installation

```bash
pnpm add @shophost/client
```

## Usage

Create a client pointed at the public app origin:

```ts
import { initClient } from "@shophost/client";

const shophost = initClient({
  baseUrl: "http://localhost:3000",
  credentials: "include",
  throwOnUnknownStatus: true,
});
```

Fetch products:

```ts
const response = await shophost.product.getProducts({
  params: {
    organizationId: "org_123",
  },
  query: {
    page: 1,
    limit: 20,
    locale: "en",
  },
});

if (response.status === 200) {
  console.log(response.body.list);
}
```

Create a temporary upload record:

```ts
const response = await shophost.file.createTemporaryFile({
  body: {
    filename: "hero.jpg",
    mimeType: "image/jpeg",
    size: 1024,
  },
});
```

## Client Options

- `baseUrl`
  Public origin of the app exposing ShopHost routes. The client appends `/api`.
- `baseHeaders`
  Default headers sent with every request.
- `credentials`
  Forward cookies for auth-aware calls.
- `fetch`
  Custom fetch implementation.
- `throwOnUnknownStatus`
  Throw when the API returns a status code that is not documented in OpenAPI.

## Regenerate

```sh
pnpm exec nx run client:generate
```

## License

MIT
npm package: @shophost/react
Description: `@shophost/react` is the UI package for ShopHost. It provides:
Author: Abhishek Shaji
Latest version: 2.0.75

# @shophost/react

`@shophost/react` is the UI package for ShopHost. It provides:

- the admin app shell and route helpers
- Next.js App Router server entrypoints
- storefront providers, pages, and reusable components

## Installation

```bash
pnpm add @shophost/react @shophost/rest-api @prisma/client @prisma/client-runtime-utils
```

Peer dependencies:

- `next >= 14`
- `react >= 18`
- `react-dom >= 18`

## Entry Points

- `@shophost/react`
  Use for admin config, route helpers, and auth helpers.
- `@shophost/react/next/server`
  Use for App Router server-safe exports like `RootPage`.
- `@shophost/react/storefront`
  Use for storefront providers, checkout/account pages, cart UI, and hooks.

## Admin Usage

Create an admin config:

```ts
import { defineConfig } from "@shophost/react";

export const adminConfig = defineConfig({
  apiBaseUrl: process.env.NEXT_PUBLIC_API_BASE_URL!,
  basePath: "/admin",
  branding: {
    name: "ShopHost",
  },
});
```

Mount the admin routes in Next.js App Router:

```tsx
import { generatePageMetadata, RootPage } from "@shophost/react/next/server";
import type { Metadata } from "next";

import { adminConfig } from "../config";

export function generateMetadata(): Metadata {
  return generatePageMetadata(adminConfig);
}

export default function Page(props: { params: Promise<{ segments?: string[] }> }) {
  return <RootPage {...props} config={adminConfig} />;
}
```

Create the matching not-found page:

```tsx
export { NotFoundPage as default } from "@shophost/react/next/server";
```

Useful root exports:

- `defineConfig`
- `createRoutes`
- `createAdminAuthClient`
- `getAdminAuthClient`

## Storefront Usage

Wrap your storefront with `ShophostProvider`:

```tsx
"use client";

import type { Locale } from "@shophost/client";
import { ModifiersDialog, ShophostProvider } from "@shophost/react/storefront";
import React from "react";

export function AppProvider({ children, locale }: { children: React.ReactNode; locale: Locale }) {
  return (
    <ShophostProvider baseUrl={process.env.NEXT_PUBLIC_APP_DOMAIN!} locale={locale} organizationId={process.env.NEXT_PUBLIC_ORGANIZATION_ID!} appearance={{ primaryColor: "#0f766e" }} modifiersModal={<ModifiersDialog />}>
      {children}
    </ShophostProvider>
  );
}
```

`appearance.primaryColor` accepts either a Tailwind color token like `bg-emerald-500`
or a raw CSS color such as `#10b981`.

Mount the built-in checkout and account flows:

```tsx
"use client";

import { AccountPages, CheckoutPages } from "@shophost/react/storefront";

export function CheckoutRoute() {
  return <CheckoutPages />;
}

export function AccountRoute() {
  return <AccountPages />;
}
```

Useful storefront exports:

- `ShophostProvider`
- `CheckoutPages`
- `AccountPages`
- `CartDrawer`
- `CartItems`
- `ModifiersDialog`
- `useCart`
- `useAPI`
- `useOrganization`

## Reference App

For a complete integration, see `apps/example` and the workspace README in the
repository root.

## License

MIT
npm package: @shophost/rest-api
Description: `@shophost/rest-api` is the backend package for ShopHost. It provides:
Author: Abhishek Shaji
Latest version: 2.0.75

# @shophost/rest-api

`@shophost/rest-api` is the backend package for ShopHost. It provides:

- the core API app builder
- a Next.js route handler integration
- exported Zod/OpenAPI schemas
- a packaged Prisma schema and CLI for database sync

## Installation

```bash
pnpm add @shophost/rest-api prisma @prisma/client @prisma/client-runtime-utils
```

Peer dependencies:

- `next >= 14`
- `react >= 18`
- `react-dom >= 18`

## Entry Points

- `@shophost/rest-api`
  Exposes `buildApiApp`, `generateOpenApiSpec`, and schema exports.
- `@shophost/rest-api/next`
  Exposes `createNextHandler` for Next.js App Router route handlers.
- `@shophost/rest-api/db`
  Exposes packaged Prisma client helpers.
- `@shophost/rest-api/schemas`
  Exposes reusable request/response schemas.

## Next.js Usage

Create an App Router API route:

```ts
import { createNextHandler } from "@shophost/rest-api/next";

const handler = createNextHandler({
  database: {
    connectionString: process.env.DATABASE_URL!,
    log: ["info", "warn", "error"],
  },
  maps: {
    google: {
      key: process.env.GOOGLE_PLACES_API_KEY!,
    },
  },
  auth: {
    baseURL: process.env.NEXT_PUBLIC_API_BASE_URL!,
    domain: new URL(process.env.NEXT_PUBLIC_API_BASE_URL!).hostname.split(".").slice(-2).join("."),
    trustedOrigins: [process.env.NEXT_PUBLIC_APP_DOMAIN!],
    socialProviders: {
      google: {
        clientId: process.env.AUTH_GOOGLE_ID!,
        clientSecret: process.env.AUTH_GOOGLE_SECRET!,
      },
    },
  },
});

export { handler as GET, handler as POST, handler as PUT, handler as PATCH, handler as DELETE, handler as OPTIONS };
```

You can configure Resend per organization from the admin UI under
`Settings -> Integrations -> Resend`.

## Database Schema Sync

The published package ships the Prisma schema and a CLI so a consuming app can
push the schema without copying Prisma files into the host project.

1. Set `DATABASE_URL` in `.env.local`, `.env`, or your shell.
2. Run:

```bash
pnpm exec shophost-rest-api db push
```

You can also pass standard Prisma flags through:

```bash
pnpm exec shophost-rest-api db push --accept-data-loss
pnpm exec shophost-rest-api db push --url "postgresql://user:password@host:5432/dbname?sslmode=require"
```

## Schemas and Utilities

Import shared schemas:

```ts
import { CreateProductSchema, ProductSchema } from "@shophost/rest-api/schemas";
```

Import Prisma helpers owned by this package:

```ts
import { createPrismaClient, PrismaClient } from "@shophost/rest-api/db";
```

Generate the OpenAPI document:

```ts
import { generateOpenApiSpec } from "@shophost/rest-api";

const spec = generateOpenApiSpec();
```

## Local Development

```bash
pnpm exec nx run rest-api:prisma:generate
pnpm exec nx run rest-api:test
```

## License

MIT
npm package: @shopickup/adapters-foxpost
Description: Foxpost shipping carrier adapter for Shopickup
Author: Shopickup Contributors
Latest version: 0.0.6

# @shopickup/adapters-foxpost

Foxpost adapter for Shopickup.

[GitHub repo](https://github.com/shopickup/shopickup-integration-layer)
[Issues](https://github.com/shopickup/shopickup-integration-layer/issues)

## What it does

- `CREATE_PARCEL`
- `CREATE_LABEL`
- `TRACK`
- `LIST_PICKUP_POINTS`

## Install

```bash
pnpm add @shopickup/adapters-foxpost @shopickup/core
```

## Quick start

```ts
import { FoxpostAdapter } from '@shopickup/adapters-foxpost';
import { executeCreateLabelFlow } from '@shopickup/core';

const adapter = new FoxpostAdapter('https://webapi.foxpost.hu');

const result = await executeCreateLabelFlow({
  adapter,
  shipment: {
    id: 'order-001',
    sender: { name: 'Shop', street: 'Main', city: 'Budapest', postalCode: '1011', country: 'HU' },
    recipient: { name: 'Customer', street: 'Fo utca 2', city: 'Siofok', postalCode: '8600', country: 'HU' },
    service: 'standard',
    totalWeight: 1200,
    createdAt: new Date(),
    updatedAt: new Date(),
  },
  parcels: [{ id: 'parcel-1', weight: 1200 }],
  credentials: { apiKey: 'your-foxpost-api-key' },
  context: { http: yourHttpClient, logger: console },
});
```

## Status

Published as `0.x.x` while the adapter API is still evolving.
npm package: @shopickup/adapters-gls
Description: GLS shipping carrier adapter for Shopickup (Hungary & Eastern Europe)
Author: Shopickup Contributors
Latest version: 0.0.3

# @shopickup/adapters-gls

GLS adapter for Shopickup.

[GitHub repo](https://github.com/shopickup/shopickup-integration-layer)
[Issues](https://github.com/shopickup/shopickup-integration-layer/issues)

## What it does

- `CREATE_PARCEL` and `CREATE_PARCELS`
- `CREATE_LABEL` and `CREATE_LABELS`
- `TRACK`
- `LIST_PICKUP_POINTS`

## Install

```bash
pnpm add @shopickup/adapters-gls @shopickup/core
```

## Quick start

```ts
import { GLSAdapter } from '@shopickup/adapters-gls';
import { createAxiosHttpClient } from '@shopickup/core';

const adapter = new GLSAdapter();
const http = createAxiosHttpClient();

const result = await adapter.createParcel!(
  {
    parcel: {
      id: 'ORDER-001',
      package: { weightGrams: 1200 },
      service: 'standard',
      shipper: {
        contact: { name: 'Shop', phone: '+361111111', email: 'ship@example.com' },
        address: { name: 'Shop', street: 'Main utca 1', city: 'Budapest', postalCode: '1011', country: 'HU' },
      },
      recipient: {
        contact: { name: 'Customer', phone: '+362222222', email: 'customer@example.com' },
        delivery: {
          method: 'HOME',
          address: { name: 'Customer', street: 'Fo utca 2', city: 'Siofok', postalCode: '8600', country: 'HU' },
        },
      },
    },
    credentials: {
      username: 'integration@example.com',
      password: 'your-password',
      clientNumberList: [12345],
    },
    options: { useTestApi: true, gls: { country: 'HU' } },
  },
  { http, logger: console }
);
```

## Status

Published as `0.x.x` while the adapter API is still evolving.
npm package: @shopickup/adapters-mpl
Description: MPL shipping carrier adapter for Shopickup
Author: Shopickup Contributors
Latest version: 0.0.4

# @shopickup/adapters-mpl

MPL adapter for Shopickup.

[GitHub repo](https://github.com/shopickup/shopickup-integration-layer)
[Issues](https://github.com/shopickup/shopickup-integration-layer/issues)

## What it does

- `CREATE_PARCEL`
- `CREATE_PARCELS`
- `CREATE_LABEL`
- `CREATE_LABELS`
- `LIST_PICKUP_POINTS`
- OAuth/basic auth exchange helpers

## Install

```bash
pnpm add @shopickup/adapters-mpl @shopickup/core
```

## Quick start

```ts
import { MPLAdapter } from '@shopickup/adapters-mpl';
import { createAxiosHttpClient } from '@shopickup/core';

const adapter = new MPLAdapter();
const http = createAxiosHttpClient();

const result = await adapter.exchangeAuthToken(
  {
    credentials: { apiKey: 'your-api-key', apiSecret: 'your-api-secret' },
    options: { useTestApi: true },
  },
  { http, logger: console }
);
```

## Status

Published as `0.x.x` while the adapter API is still evolving.
npm package: @shopickup/core
Description: Shopickup core library - canonical types, adapter interface, and orchestration helpers
Author: David Fodor
Latest version: 0.0.4

# @shopickup/core

Core types, interfaces, flows, and HTTP helpers for Shopickup.

Open source on GitHub: <https://github.com/shopickup/shopickup-integration-layer>

## What this is

- Canonical shipping domain types
- Carrier adapter interfaces and capabilities
- Orchestration helpers for label flows
- Pluggable HTTP client wrappers

## What this is not

- A carrier-specific SDK
- A persistence layer
- An API server

## Install

```bash
pnpm add @shopickup/core
```

## Use

```ts
import { createAxiosHttpClient, type CarrierAdapter } from '@shopickup/core';
```

```ts
import { createFetchHttpClient } from '@shopickup/core/http/fetch-client';
```

## HTTP clients

- `createAxiosHttpClient()` is included for Node-friendly integrations that want Axios.
- `createFetchHttpClient()` is included for environments that prefer `fetch`.
- Adapters do not own HTTP behavior; callers provide the client.

## Status

This package is early and published as `0.0.1`.

## Releases

The package follows `0.x.x` versioning while the API is still evolving.