@parallelworks/client 6.12.0

package/README.md

@@ -0,0 +1,114 @@
+# @parallelworks/client
+
+Official TypeScript client for the Parallel Works ACTIVATE platform API.
+
+## Installation
+
+```bash
+npm install @parallelworks/client
+```
+
+For SWR hooks support (React):
+
+```bash
+npm install @parallelworks/client swr swr-openapi
+```
+
+## Quick Start
+
+The simplest way to create a client - just pass your credential:
+
+```typescript
+import { Client } from '@parallelworks/client'
+
+// The platform host is automatically extracted from your credential
+const client = Client.fromCredential(process.env.PW_API_KEY!)
+
+const { data, error } = await client.GET('/api/buckets')
+```
+
+See the [examples](./examples) directory for complete runnable examples.
+
+## Authentication
+
+### Automatic Host Detection
+
+API keys (`pwt_...`) and JWT tokens contain the platform host encoded within them. Use `fromCredential` to automatically extract it:
+
+```typescript
+// API key - host decoded from first segment after pwt_
+const client = Client.fromCredential('pwt_Y2xvdWQucGFyYWxsZWwud29ya3M.xxxxx')
+// Connects to: https://activate.parallel.works
+
+// JWT token - host read from platform_host claim
+const client = Client.fromCredential('eyJhbGci...')
+// Connects to the host in the token's platform_host claim
+```
+
+### Explicit Host
+
+If you prefer to specify the host explicitly:
+
+```typescript
+// API Key (Basic Auth) - best for long-running integrations
+const client = new Client('https://activate.parallel.works')
+  .withApiKey('pwt_...')
+
+// JWT Token (Bearer) - best for scripts, expires in 24h
+const client = new Client('https://activate.parallel.works')
+  .withToken('eyJhbGci...')
+
+// Auto-detect credential type
+const client = new Client('https://activate.parallel.works')
+  .withCredential(process.env.PW_CREDENTIAL!)
+```
+
+### Credential Helpers
+
+```typescript
+import { isApiKey, isToken, extractPlatformHost } from '@parallelworks/client'
+
+isApiKey('pwt_abc.xyz')           // true
+isToken('eyJ.abc.def')            // true
+extractPlatformHost('pwt_...')    // "activate.parallel.works"
+```
+
+## SWR Hooks (React)
+
+```tsx
+// lib/api.ts
+import { Client } from '@parallelworks/client'
+import { createSwrHooks } from '@parallelworks/client/swr'
+
+const client = Client.fromCredential(process.env.NEXT_PUBLIC_PW_API_KEY!)
+
+export const { useQuery, useImmutable, useInfinite } = createSwrHooks(client)
+```
+
+```tsx
+// components/BucketList.tsx
+import { useQuery } from '@/lib/api'
+
+export function BucketList() {
+  const { data, error, isLoading } = useQuery('/api/buckets')
+
+  if (isLoading) return <div>Loading...</div>
+  if (error) return <div>Error: {error.message}</div>
+
+  return (
+    <ul>
+      {data?.map(bucket => (
+        <li key={bucket.id}>{bucket.name}</li>
+      ))}
+    </ul>
+  )
+}
+```
+
+## Documentation
+
+For full API documentation, visit [https://parallelworks.com/docs](https://parallelworks.com/docs).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,122 @@
+import createClient, { type ClientOptions as OpenAPIClientOptions } from 'openapi-fetch';
+import type { paths } from './types/api';
+export type { paths };
+export type { components } from './types/api';
+type OpenAPIFetchClient = ReturnType<typeof createClient<paths>>;
+export interface ClientOptions extends Omit<OpenAPIClientOptions, 'baseUrl'> {
+}
+/** Prefix for Parallel Works API keys */
+export declare const API_KEY_PREFIX = "pwt_";
+/** Error thrown when credential parsing fails */
+export declare class CredentialError extends Error {
+    constructor(message: string);
+}
+/**
+ * Check if a credential is an API key.
+ *
+ * API keys start with the prefix "pwt_".
+ *
+ * @param credential - The credential string to check
+ * @returns True if the credential appears to be an API key
+ */
+export declare function isApiKey(credential: string): boolean;
+/**
+ * Check if a credential is a JWT token.
+ *
+ * JWTs have three base64-encoded parts separated by dots.
+ *
+ * @param credential - The credential string to check
+ * @returns True if the credential appears to be a JWT token
+ */
+export declare function isToken(credential: string): boolean;
+/**
+ * Extract the platform host from an API key or JWT token.
+ *
+ * For API keys (pwt_xxxx.yyyy): decodes the first part after pwt_ to get the host
+ * For JWT tokens: decodes the payload (second segment) and reads platform_host field
+ *
+ * @param credential - The API key or JWT token
+ * @returns The platform host (e.g., "activate.parallel.works")
+ * @throws CredentialError if the credential format is invalid
+ */
+export declare function extractPlatformHost(credential: string): string;
+/**
+ * Parallel Works API Client
+ *
+ * @example
+ * ```ts
+ * import { Client } from '@parallelworks/client'
+ *
+ * // Using API Key (Basic Auth) - recommended for integrations
+ * const client = new Client('https://activate.parallel.works')
+ *   .withApiKey('pwt_...')
+ *
+ * // Using Bearer Token (JWT) - for scripts
+ * const client = new Client('https://activate.parallel.works')
+ *   .withToken('eyJ...')
+ *
+ * // Or let the client extract the host from your credential
+ * const client = Client.fromCredential(process.env.PW_API_KEY!)
+ *
+ * // Make requests
+ * const { data, error } = await client.GET('/api/buckets')
+ * ```
+ */
+export declare class Client {
+    private baseUrl;
+    private options;
+    private authHeader?;
+    constructor(baseUrl: string, options?: ClientOptions);
+    /**
+     * Create a client using only a credential.
+     *
+     * The platform host is automatically extracted from the credential:
+     * - For API keys: host is decoded from the first part after pwt_
+     * - For JWT tokens: host is read from the platform_host claim
+     *
+     * @param credential - Your API key or JWT token
+     * @param options - Additional client options
+     * @returns Configured API client ready to make requests
+     * @throws CredentialError if the credential format is invalid
+     *
+     * @example
+     * ```ts
+     * // Just pass your credential - no URL needed!
+     * const client = Client.fromCredential(process.env.PW_API_KEY!)
+     * ```
+     */
+    static fromCredential(credential: string, options?: ClientOptions): OpenAPIFetchClient;
+    /**
+     * Authenticate with an API Key using Basic Auth
+     *
+     * Best for long-running integrations with configurable expiration.
+     * API keys can be generated from your ACTIVATE account settings.
+     *
+     * @param apiKey - Your API key from account settings
+     * @returns Configured API client ready to make requests
+     */
+    withApiKey(apiKey: string): OpenAPIFetchClient;
+    /**
+     * Authenticate with a Bearer Token (JWT)
+     *
+     * Best for scripts and CLI tools. Tokens expire after 24 hours.
+     * Tokens can be generated from your ACTIVATE account settings.
+     *
+     * @param token - Your JWT token from account settings
+     * @returns Configured API client ready to make requests
+     */
+    withToken(token: string): OpenAPIFetchClient;
+    /**
+     * Authenticate with automatic credential type detection
+     *
+     * Automatically detects whether the credential is an API key (starts with "pwt_")
+     * or a JWT token and configures the appropriate authentication method.
+     *
+     * @param credential - Your API key or JWT token
+     * @returns Configured API client ready to make requests
+     */
+    withCredential(credential: string): OpenAPIFetchClient;
+    private build;
+}
+export default Client;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,EAAE,EAAE,KAAK,aAAa,IAAI,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACxF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,YAAY,EAAE,KAAK,EAAE,CAAA;AACrB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA;AAEhE,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC;CAAG;AAE/E,yCAAyC;AACzC,eAAO,MAAM,cAAc,SAAS,CAAA;AAEpC,iDAAiD;AACjD,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAInD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAS9D;AAoFD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAQ;gBAEf,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB;IAKxD;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,kBAAkB;IAW1F;;;;;;;;OAQG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB;IAW9C;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB;IAM5C;;;;;;;;OAQG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB;IAOtD,OAAO,CAAC,KAAK;CAUd;AAED,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -0,0 +1,245 @@
+import createClient from 'openapi-fetch';
+/** Prefix for Parallel Works API keys */
+export const API_KEY_PREFIX = 'pwt_';
+/** Error thrown when credential parsing fails */
+export class CredentialError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CredentialError';
+    }
+}
+/**
+ * Check if a credential is an API key.
+ *
+ * API keys start with the prefix "pwt_".
+ *
+ * @param credential - The credential string to check
+ * @returns True if the credential appears to be an API key
+ */
+export function isApiKey(credential) {
+    return credential.trim().startsWith(API_KEY_PREFIX);
+}
+/**
+ * Check if a credential is a JWT token.
+ *
+ * JWTs have three base64-encoded parts separated by dots.
+ *
+ * @param credential - The credential string to check
+ * @returns True if the credential appears to be a JWT token
+ */
+export function isToken(credential) {
+    const trimmed = credential.trim();
+    const parts = trimmed.split('.');
+    return parts.length === 3 && !trimmed.startsWith(API_KEY_PREFIX);
+}
+/**
+ * Extract the platform host from an API key or JWT token.
+ *
+ * For API keys (pwt_xxxx.yyyy): decodes the first part after pwt_ to get the host
+ * For JWT tokens: decodes the payload (second segment) and reads platform_host field
+ *
+ * @param credential - The API key or JWT token
+ * @returns The platform host (e.g., "activate.parallel.works")
+ * @throws CredentialError if the credential format is invalid
+ */
+export function extractPlatformHost(credential) {
+    credential = credential.trim();
+    if (isApiKey(credential)) {
+        return extractHostFromApiKey(credential);
+    }
+    if (isToken(credential)) {
+        return extractHostFromToken(credential);
+    }
+    throw new CredentialError('Invalid credential format');
+}
+function extractHostFromApiKey(apiKey) {
+    // Remove pwt_ prefix
+    const withoutPrefix = apiKey.slice(API_KEY_PREFIX.length);
+    // Split by dot
+    const dotIndex = withoutPrefix.indexOf('.');
+    if (dotIndex === -1) {
+        throw new CredentialError('Invalid API key format');
+    }
+    const encodedHost = withoutPrefix.slice(0, dotIndex);
+    // Decode base64 (handle both browser and Node.js)
+    let host;
+    try {
+        if (typeof atob !== 'undefined') {
+            // Browser - handle URL-safe base64
+            const normalized = encodedHost.replace(/-/g, '+').replace(/_/g, '/');
+            host = atob(normalized);
+        }
+        else {
+            // Node.js
+            host = Buffer.from(encodedHost, 'base64url').toString();
+        }
+    }
+    catch {
+        try {
+            // Fallback to standard base64
+            if (typeof atob !== 'undefined') {
+                host = atob(encodedHost);
+            }
+            else {
+                host = Buffer.from(encodedHost, 'base64').toString();
+            }
+        }
+        catch (e) {
+            throw new CredentialError(`Could not decode API key host: ${e}`);
+        }
+    }
+    if (!host) {
+        throw new CredentialError('No platform host in API key');
+    }
+    return host;
+}
+function extractHostFromToken(token) {
+    const parts = token.split('.');
+    if (parts.length !== 3) {
+        throw new CredentialError('Invalid JWT format');
+    }
+    const payload = parts[1];
+    // Decode base64url payload
+    let payloadJson;
+    try {
+        if (typeof atob !== 'undefined') {
+            // Browser - handle URL-safe base64
+            const normalized = payload.replace(/-/g, '+').replace(/_/g, '/');
+            // Add padding if needed
+            const padded = normalized + '='.repeat((4 - (normalized.length % 4)) % 4);
+            payloadJson = atob(padded);
+        }
+        else {
+            // Node.js
+            payloadJson = Buffer.from(payload, 'base64url').toString();
+        }
+    }
+    catch (e) {
+        throw new CredentialError(`Could not decode JWT payload: ${e}`);
+    }
+    let claims;
+    try {
+        claims = JSON.parse(payloadJson);
+    }
+    catch (e) {
+        throw new CredentialError(`Could not parse JWT claims: ${e}`);
+    }
+    if (!claims.platform_host) {
+        throw new CredentialError('No platform_host in JWT claims');
+    }
+    return claims.platform_host;
+}
+/**
+ * Parallel Works API Client
+ *
+ * @example
+ * ```ts
+ * import { Client } from '@parallelworks/client'
+ *
+ * // Using API Key (Basic Auth) - recommended for integrations
+ * const client = new Client('https://activate.parallel.works')
+ *   .withApiKey('pwt_...')
+ *
+ * // Using Bearer Token (JWT) - for scripts
+ * const client = new Client('https://activate.parallel.works')
+ *   .withToken('eyJ...')
+ *
+ * // Or let the client extract the host from your credential
+ * const client = Client.fromCredential(process.env.PW_API_KEY!)
+ *
+ * // Make requests
+ * const { data, error } = await client.GET('/api/buckets')
+ * ```
+ */
+export class Client {
+    constructor(baseUrl, options = {}) {
+        this.baseUrl = baseUrl;
+        this.options = options;
+    }
+    /**
+     * Create a client using only a credential.
+     *
+     * The platform host is automatically extracted from the credential:
+     * - For API keys: host is decoded from the first part after pwt_
+     * - For JWT tokens: host is read from the platform_host claim
+     *
+     * @param credential - Your API key or JWT token
+     * @param options - Additional client options
+     * @returns Configured API client ready to make requests
+     * @throws CredentialError if the credential format is invalid
+     *
+     * @example
+     * ```ts
+     * // Just pass your credential - no URL needed!
+     * const client = Client.fromCredential(process.env.PW_API_KEY!)
+     * ```
+     */
+    static fromCredential(credential, options = {}) {
+        let host = extractPlatformHost(credential);
+        // Ensure https:// prefix
+        if (!host.startsWith('http://') && !host.startsWith('https://')) {
+            host = `https://${host}`;
+        }
+        return new Client(host, options).withCredential(credential);
+    }
+    /**
+     * Authenticate with an API Key using Basic Auth
+     *
+     * Best for long-running integrations with configurable expiration.
+     * API keys can be generated from your ACTIVATE account settings.
+     *
+     * @param apiKey - Your API key from account settings
+     * @returns Configured API client ready to make requests
+     */
+    withApiKey(apiKey) {
+        // Trim whitespace to handle env vars with trailing newlines
+        apiKey = apiKey.trim();
+        // API Keys use Basic Auth with base64(apiKey:)
+        const encoded = typeof btoa !== 'undefined'
+            ? btoa(`${apiKey}:`)
+            : Buffer.from(`${apiKey}:`).toString('base64');
+        this.authHeader = `Basic ${encoded}`;
+        return this.build();
+    }
+    /**
+     * Authenticate with a Bearer Token (JWT)
+     *
+     * Best for scripts and CLI tools. Tokens expire after 24 hours.
+     * Tokens can be generated from your ACTIVATE account settings.
+     *
+     * @param token - Your JWT token from account settings
+     * @returns Configured API client ready to make requests
+     */
+    withToken(token) {
+        // Trim whitespace to handle env vars with trailing newlines
+        this.authHeader = `Bearer ${token.trim()}`;
+        return this.build();
+    }
+    /**
+     * Authenticate with automatic credential type detection
+     *
+     * Automatically detects whether the credential is an API key (starts with "pwt_")
+     * or a JWT token and configures the appropriate authentication method.
+     *
+     * @param credential - Your API key or JWT token
+     * @returns Configured API client ready to make requests
+     */
+    withCredential(credential) {
+        if (isApiKey(credential)) {
+            return this.withApiKey(credential);
+        }
+        return this.withToken(credential);
+    }
+    build() {
+        return createClient({
+            baseUrl: this.baseUrl,
+            ...this.options,
+            headers: {
+                ...(this.authHeader && { Authorization: this.authHeader }),
+                ...this.options.headers,
+            },
+        });
+    }
+}
+export default Client;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/swr/index.d.ts

@@ -0,0 +1,44 @@
+import type { Client } from '../index';
+export interface SwrHooksOptions {
+    /** Key prefix for SWR cache (default: 'api') */
+    prefix?: string;
+}
+type AuthenticatedClient = ReturnType<Client['withApiKey']>;
+/**
+ * Create SWR hooks from an authenticated Parallel Works client
+ *
+ * @example
+ * ```tsx
+ * import { Client } from '@parallelworks/client'
+ * import { createSwrHooks } from '@parallelworks/client/swr'
+ *
+ * const client = new Client('https://activate.parallel.works')
+ *   .withApiKey(process.env.NEXT_PUBLIC_PW_API_KEY!)
+ *
+ * export const { useQuery, useImmutable, useInfinite } = createSwrHooks(client)
+ *
+ * // In your component
+ * function BucketList() {
+ *   const { data, error, isLoading } = useQuery('/api/buckets')
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (error) return <div>Error: {error.message}</div>
+ *
+ *   return (
+ *     <ul>
+ *       {data?.map(org => <li key={org.id}>{org.name}</li>)}
+ *     </ul>
+ *   )
+ * }
+ * ```
+ */
+export declare function createSwrHooks(client: AuthenticatedClient, options?: SwrHooksOptions): {
+    /** Hook for standard queries with SWR caching and revalidation */
+    useQuery: <Path extends import("openapi-typescript-helpers").PathsWithMethod<import("../index").paths, "get">, R extends import("swr-openapi").TypesForGetRequest<import("../index").paths, Path>, Init extends import("type-fest").Exact<R["Init"], Init>, Data extends R["Data"], Error extends R["Error"], Config extends R["SWRConfig"]>(path: Path, ...[init, config]: import("openapi-typescript-helpers").RequiredKeysOf<Init> extends never ? [(Init | null | undefined)?, (Config | undefined)?] : [Init | null, (Config | undefined)?]) => import("swr").SWRResponse<Data, Error, Config>;
+    /** Hook for immutable data that never revalidates */
+    useImmutable: <Path extends import("openapi-typescript-helpers").PathsWithMethod<import("../index").paths, "get">, R extends import("swr-openapi").TypesForGetRequest<import("../index").paths, Path>, Init extends import("type-fest").Exact<R["Init"], Init>, Data extends R["Data"], Error extends R["Error"], Config extends R["SWRConfig"]>(path: Path, ...[init, config]: import("openapi-typescript-helpers").RequiredKeysOf<Init> extends never ? [(Init | null | undefined)?, (Config | undefined)?] : [Init | null, (Config | undefined)?]) => import("swr").SWRResponse<Data, Error, Config>;
+    /** Hook for paginated/infinite loading */
+    useInfinite: <Path extends import("openapi-typescript-helpers").PathsWithMethod<import("../index").paths, "get">, R extends import("swr-openapi").TypesForGetRequest<import("../index").paths, Path>, Init extends import("type-fest").Exact<R["Init"], Init>, Data extends R["Data"], Error extends R["Error"], Config extends import("swr/infinite").SWRInfiniteConfiguration<Data, Error, import("swr").BareFetcher<Data>>>(path: Path, getInit: import("swr/infinite").SWRInfiniteKeyLoader<Data, Init | null>, config?: Config | undefined) => import("swr/infinite").SWRInfiniteResponse<Data, Error>;
+};
+export default createSwrHooks;
+//# sourceMappingURL=index.d.ts.map

package/dist/swr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/swr/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,KAAK,mBAAmB,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAA;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,mBAAmB,EAC3B,OAAO,GAAE,eAAoB;IAK3B,kEAAkE;;IAElE,qDAAqD;;IAErD,0CAA0C;;EAG7C;AAED,eAAe,cAAc,CAAA"}

package/dist/swr/index.js

@@ -0,0 +1,43 @@
+'use client';
+import { createImmutableHook, createInfiniteHook, createQueryHook, } from 'swr-openapi';
+/**
+ * Create SWR hooks from an authenticated Parallel Works client
+ *
+ * @example
+ * ```tsx
+ * import { Client } from '@parallelworks/client'
+ * import { createSwrHooks } from '@parallelworks/client/swr'
+ *
+ * const client = new Client('https://activate.parallel.works')
+ *   .withApiKey(process.env.NEXT_PUBLIC_PW_API_KEY!)
+ *
+ * export const { useQuery, useImmutable, useInfinite } = createSwrHooks(client)
+ *
+ * // In your component
+ * function BucketList() {
+ *   const { data, error, isLoading } = useQuery('/api/buckets')
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (error) return <div>Error: {error.message}</div>
+ *
+ *   return (
+ *     <ul>
+ *       {data?.map(org => <li key={org.id}>{org.name}</li>)}
+ *     </ul>
+ *   )
+ * }
+ * ```
+ */
+export function createSwrHooks(client, options = {}) {
+    const { prefix = 'api' } = options;
+    return {
+        /** Hook for standard queries with SWR caching and revalidation */
+        useQuery: createQueryHook(client, prefix),
+        /** Hook for immutable data that never revalidates */
+        useImmutable: createImmutableHook(client, prefix),
+        /** Hook for paginated/infinite loading */
+        useInfinite: createInfiniteHook(client, prefix),
+    };
+}
+export default createSwrHooks;
+//# sourceMappingURL=index.js.map

package/dist/swr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/swr/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAA;AAUpB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA2B,EAC3B,UAA2B,EAAE;IAE7B,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IAElC,OAAO;QACL,kEAAkE;QAClE,QAAQ,EAAE,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC;QACzC,qDAAqD;QACrD,YAAY,EAAE,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC;QACjD,0CAA0C;QAC1C,WAAW,EAAE,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC;KAChD,CAAA;AACH,CAAC;AAED,eAAe,cAAc,CAAA"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@parallelworks/client",
+  "version": "6.12.0",
+  "description": "Official TypeScript client for Parallel Works ACTIVATE API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./swr": {
+      "import": "./dist/swr/index.js",
+      "types": "./dist/swr/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "openapi-fetch": "^0.15.0"
+  },
+  "peerDependencies": {
+    "swr": "^2.0.0",
+    "swr-openapi": "^5.0.0",
+    "openapi-typescript-helpers": "^0.0.15",
+    "type-fest": "^4.0.0 || ^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "swr": {
+      "optional": true
+    },
+    "swr-openapi": {
+      "optional": true
+    },
+    "openapi-typescript-helpers": {
+      "optional": true
+    },
+    "type-fest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "openapi-typescript": "^7.9.1",
+    "openapi-typescript-helpers": "^0.0.15",
+    "type-fest": "^5.4.1",
+    "typescript": "^5.4.0",
+    "swr": "^2.3.6",
+    "swr-openapi": "^5.4.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/parallelworks/sdk.git",
+    "directory": "typescript"
+  },
+  "keywords": [
+    "parallelworks",
+    "client",
+    "api",
+    "activate",
+    "openapi"
+  ],
+  "author": "Parallel Works <support@parallelworks.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/parallelworks/sdk/issues"
+  },
+  "homepage": "https://github.com/parallelworks/sdk#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "generate": "openapi-typescript ../openapi.json -o ./src/types/api.d.ts",
+    "clean": "rm -rf dist"
+  }
+}