shipos 0.0.0

package/README.md

@@ -0,0 +1,225 @@
+# @shipos/sdk
+
+Official SDK for ShipOS feature flags, global configs, and customer identification.
+
+## Installation
+
+```bash
+bun add @shipos/sdk
+# or
+npm install @shipos/sdk
+```
+
+## Quick Start
+
+### Basic Usage (Vanilla JS/TS)
+
+```typescript
+import { createShipOS } from '@shipos/sdk';
+
+const shipos = createShipOS({
+  apiKey: 'your-api-key',
+  environment: 'production', // optional, defaults to 'production'
+});
+
+// Identify a customer
+await shipos.customers.signIn({
+  externalId: 'user-123',
+  metadata: { name: 'Jane', plan: 'pro' },
+});
+
+// Get all feature flags
+const flags = await shipos.featureFlags.getAll();
+console.log(flags); // { 'new-feature': true, 'beta-mode': false }
+
+// Get a single flag with default value
+const isEnabled = await shipos.featureFlags.get('new-feature', false);
+
+// Get a typed config
+interface PricingConfig {
+  plans: Array<{ name: string; price: number }>;
+}
+const pricing = await shipos.configs.get<PricingConfig>('pricing');
+```
+
+### React Integration
+
+```tsx
+import { ShipOSProvider, useFlag, useCustomer, Feature } from '@shipos/sdk/react';
+
+// Wrap your app with the provider
+function App() {
+  return (
+    <ShipOSProvider config={{ apiKey: 'your-api-key' }}>
+      <MyApp />
+    </ShipOSProvider>
+  );
+}
+
+// Identify users with useCustomer
+function MyApp() {
+  const { signIn } = useCustomer();
+
+  useEffect(() => {
+    signIn({ externalId: 'user-123', metadata: { plan: 'pro' } });
+  }, []);
+
+  return <Dashboard />;
+}
+
+// Use hooks in your components
+function Dashboard() {
+  const { enabled, isLoading } = useFlag('new-feature');
+
+  if (isLoading) return <div>Loading...</div>;
+
+  return enabled ? <NewFeature /> : <OldFeature />;
+}
+
+// Or use the Feature component
+function AnotherComponent() {
+  return (
+    <Feature flag="new-dashboard" fallback={<OldDashboard />}>
+      <NewDashboard />
+    </Feature>
+  );
+}
+```
+
+## API Reference
+
+### Core Client
+
+#### `createShipOS(config)`
+
+Creates a new ShipOS client instance.
+
+```typescript
+const shipos = createShipOS({
+  apiKey: string;        // Required: Your API key
+  baseUrl?: string;      // Optional: API base URL
+  environment?: string;  // Optional: Environment (default: 'production')
+  cacheTTL?: number;     // Optional: Cache TTL in ms (default: 60000)
+  debug?: boolean;       // Optional: Enable debug logging
+});
+```
+
+### Customers
+
+- `customers.signIn({ externalId, metadata? })` - Identify a customer
+- `customers.signOut()` - Clear customer context
+- `customers.get()` - Get current customer or null
+
+### Feature Flags
+
+- `featureFlags.getAll()` - Get all feature flags
+- `featureFlags.get(key, defaultValue?)` - Get a single flag
+- `featureFlags.refresh()` - Refresh flags (bypass cache)
+
+### Global Configs
+
+- `configs.get<T>(slug)` - Get a config by slug
+- `configs.refresh<T>(slug)` - Refresh a config (bypass cache)
+
+### Utilities
+
+- `clearCache()` - Clear the cache
+- `setEnvironment(env)` - Change environment
+- `getEnvironment()` - Get current environment
+
+### React Hooks
+
+#### `useCustomer()`
+
+Manage customer identification.
+
+```typescript
+const { customer, signIn, signOut } = useCustomer();
+```
+
+#### `useFlags()`
+
+Get all feature flags.
+
+```typescript
+const { flags, isLoading, error, refreshFlags } = useFlags();
+```
+
+#### `useFlag(key, defaultValue?)`
+
+Get a single feature flag.
+
+```typescript
+const { enabled, isLoading, error } = useFlag('my-feature', false);
+```
+
+#### `useConfig<T>(slug)`
+
+Get a configuration by slug.
+
+```typescript
+const { config, isLoading, error, refresh } = useConfig<MyConfig>('my-config');
+```
+
+### React Components
+
+#### `<Feature>`
+
+Conditionally render based on a flag.
+
+```tsx
+<Feature flag="my-feature" fallback={<Fallback />} loading={<Loading />}>
+  <EnabledContent />
+</Feature>
+```
+
+#### `<FeatureEnabled>`
+
+Render only when flag is enabled.
+
+```tsx
+<FeatureEnabled flag="my-feature">
+  <EnabledContent />
+</FeatureEnabled>
+```
+
+#### `<FeatureDisabled>`
+
+Render only when flag is disabled.
+
+```tsx
+<FeatureDisabled flag="my-feature">
+  <DisabledContent />
+</FeatureDisabled>
+```
+
+## Configuration
+
+### Environment Variables
+
+You can configure the SDK using environment variables:
+
+```bash
+SHIPOS_API_KEY=your-api-key
+SHIPOS_ENVIRONMENT=production
+SHIPOS_BASE_URL=https://api.shipos.app
+```
+
+### Server-Side Rendering (SSR)
+
+For SSR, you can pass initial flags to avoid loading states:
+
+```tsx
+// In your server component or getServerSideProps
+const shipos = createShipOS({ apiKey: process.env.SHIPOS_API_KEY });
+const initialFlags = await shipos.featureFlags.getAll();
+
+// Pass to provider
+<ShipOSProvider config={config} initialFlags={initialFlags}>
+  <App />
+</ShipOSProvider>
+```
+
+## License
+
+MIT

package/dist/cache.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Simple in-memory cache for SDK responses
+ */
+export declare class Cache {
+    private store;
+    private defaultTTL;
+    constructor(defaultTTL?: number);
+    /**
+     * Get a value from the cache
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Set a value in the cache
+     */
+    set<T>(key: string, data: T): void;
+    /**
+     * Delete a value from the cache
+     */
+    delete(key: string): void;
+    /**
+     * Clear all cached values
+     */
+    clear(): void;
+    /**
+     * Update the default TTL
+     */
+    setTTL(ttl: number): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,GAAE,MAAc;IAItC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAgB7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAOlC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG1B"}

package/dist/client.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ShipOS SDK Client
+ *
+ * Main client for interacting with the ShipOS API.
+ * Methods are organized into namespaced modules:
+ * - `featureFlags` - Feature flag operations
+ * - `configs` - Global config operations
+ * - `customers` - Customer identification
+ */
+import { FeatureFlagsModule } from "./modules/feature-flags";
+import { ConfigsModule } from "./modules/configs";
+import { CustomersModule } from "./modules/customers";
+import type { ShipOSConfig } from "./types";
+export declare class ShipOS {
+    private apiKey;
+    private baseUrl;
+    private environment;
+    private cache;
+    private debug;
+    private customerId;
+    /** Feature flag operations */
+    readonly featureFlags: FeatureFlagsModule;
+    /** Global config operations */
+    readonly configs: ConfigsModule;
+    /** Customer identification */
+    readonly customers: CustomersModule;
+    constructor(config: ShipOSConfig);
+    /**
+     * Log debug messages
+     */
+    private log;
+    /**
+     * Make an authenticated request to the API
+     */
+    private request;
+    /**
+     * Clear the cache
+     */
+    clearCache(): void;
+    /**
+     * Update the environment
+     */
+    setEnvironment(environment: string): void;
+    /**
+     * Get current environment
+     */
+    getEnvironment(): string;
+}
+/**
+ * Create a new ShipOS client instance
+ */
+export declare function createShipOS(config: ShipOSConfig): ShipOS;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,SAAS,CAAC;AAMtD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,UAAU,CAAuB;IAEzC,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;gBAExB,MAAM,EAAE,YAAY;IA2BhC;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;YACW,OAAO;IAsCrB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAMzC;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEzD"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ShipOS SDK
+ *
+ * Official SDK for ShipOS feature flags, global configs, and customer identification.
+ *
+ * @example
+ * ```typescript
+ * import { createShipOS } from '@shipos/sdk';
+ *
+ * const shipos = createShipOS({
+ *   apiKey: 'your-api-key',
+ *   environment: 'production',
+ * });
+ *
+ * // Identify a customer
+ * await shipos.customers.signIn({ externalId: 'user-123', metadata: { plan: 'pro' } });
+ *
+ * // Get all flags
+ * const flags = await shipos.featureFlags.getAll();
+ *
+ * // Get a single flag
+ * const isEnabled = await shipos.featureFlags.get('new-feature', false);
+ *
+ * // Get a config
+ * const pricing = await shipos.configs.get('pricing');
+ * ```
+ */
+export { ShipOS, createShipOS } from "./client";
+export { Cache } from "./cache";
+export type { ShipOSConfig, FlagsResponse, ConfigResponse, ApiError, CacheEntry, Result, CustomerInfo, SignInOptions, } from "./types";
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,UAAU,EACV,MAAM,EACN,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+class b{store=new Map;defaultTTL;constructor(S=60000){this.defaultTTL=S}get(S){let O=this.store.get(S);if(!O)return null;if(Date.now()-O.timestamp>this.defaultTTL)return this.store.delete(S),null;return O.data}set(S,O){this.store.set(S,{data:O,timestamp:Date.now()})}delete(S){this.store.delete(S)}clear(){this.store.clear()}setTTL(S){this.defaultTTL=S}}class j{ctx;constructor(S){this.ctx=S}async getAll(){let S=`flags:${this.ctx.getEnvironment()}`,O=this.ctx.cache.get(S);if(O)return this.ctx.log("Returning cached flags"),O;let w=await this.ctx.request("/v1/flags");return this.ctx.cache.set(S,w),w}async get(S,O=!1){return(await this.getAll())[S]??O}async refresh(){let S=`flags:${this.ctx.getEnvironment()}`;return this.ctx.cache.delete(S),this.getAll()}}class q{ctx;constructor(S){this.ctx=S}async get(S){let O=`config:${this.ctx.getEnvironment()}:${S}`,w=this.ctx.cache.get(O);if(w)return this.ctx.log(`Returning cached config: ${S}`),w;let G=await this.ctx.request(`/v1/config/${S}`);return this.ctx.cache.set(O,G),G}async refresh(S){let O=`config:${this.ctx.getEnvironment()}:${S}`;return this.ctx.cache.delete(O),this.get(S)}}class z{ctx;customer=null;constructor(S){this.ctx=S}async signIn(S){if(!S.externalId)throw Error("ShipOS: externalId is required for signIn");return this.ctx.log(`Signing in customer: ${S.externalId}`),this.customer={externalId:S.externalId,metadata:S.metadata},this.ctx.setCustomerId(S.externalId),await this.ctx.request("/v1/customers/identify",{method:"POST",body:{externalId:S.externalId,metadata:S.metadata??{}}}),this.ctx.log(`Customer signed in: ${S.externalId}`),this.customer}signOut(){this.ctx.log("Signing out customer"),this.customer=null,this.ctx.setCustomerId(null)}get(){return this.customer}}var Y="https://api.shipos.app",Z=60000,B="0.1.0";class J{apiKey;baseUrl;environment;cache;debug;customerId=null;featureFlags;configs;customers;constructor(S){if(!S.apiKey)throw Error("ShipOS: apiKey is required");this.apiKey=S.apiKey,this.baseUrl=S.baseUrl||Y,this.environment=S.environment||"production",this.cache=new b(S.cacheTTL||Z),this.debug=S.debug||!1;let O={request:this.request.bind(this),cache:this.cache,getEnvironment:this.getEnvironment.bind(this),log:this.log.bind(this),setCustomerId:(w)=>{this.customerId=w}};this.featureFlags=new j(O),this.configs=new q(O),this.customers=new z(O)}log(...S){if(this.debug)console.log("[ShipOS]",...S)}async request(S,O={}){let w=`${this.baseUrl}${S}`,G=O.method||"GET";this.log(`${G} ${w}`);let Q={"x-shipos-key":this.apiKey,"x-shipos-env":this.environment,"x-shipos-sdk-version":B,"Content-Type":"application/json"};if(this.customerId)Q["x-shipos-customer-id"]=this.customerId;let W={method:G,headers:Q};if(O.body&&G!=="GET")W.body=JSON.stringify(O.body);let I=await fetch(w,W);if(!I.ok){let X=await I.json().catch(()=>({error:`HTTP ${I.status}`,code:"HTTP_ERROR"}));throw Error(X.error||`Request failed: ${I.status}`)}return I.json()}clearCache(){this.cache.clear(),this.log("Cache cleared")}setEnvironment(S){this.environment=S,this.cache.clear(),this.log(`Environment changed to: ${S}`)}getEnvironment(){return this.environment}}function D(S){return new J(S)}export{D as createShipOS,J as ShipOS,b as Cache};

package/dist/modules/configs.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Configs Module
+ *
+ * Provides namespaced access to global configuration operations.
+ *
+ * @example
+ * ```typescript
+ * const pricing = await shipos.configs.get<PricingConfig>('pricing');
+ * ```
+ */
+import type { Cache } from "../cache";
+import type { ConfigResponse } from "../types";
+/**
+ * Internal context shared by the parent ShipOS client
+ */
+export interface ConfigsContext {
+    request: <T>(endpoint: string, options?: {
+        method?: string;
+        body?: unknown;
+    }) => Promise<T>;
+    cache: Cache;
+    getEnvironment: () => string;
+    log: (...args: unknown[]) => void;
+}
+export declare class ConfigsModule {
+    private ctx;
+    constructor(ctx: ConfigsContext);
+    /**
+     * Get a configuration by slug
+     *
+     * @param slug - The config slug
+     * @returns The config data
+     *
+     * @example
+     * ```typescript
+     * interface PricingConfig {
+     *   plans: Array<{ name: string; price: number }>;
+     * }
+     * const pricing = await shipos.configs.get<PricingConfig>('pricing');
+     * ```
+     */
+    get<T = Record<string, unknown>>(slug: string): Promise<ConfigResponse<T>>;
+    /**
+     * Refresh a config (bypass cache)
+     *
+     * @param slug - The config slug
+     * @returns Fresh config from the API
+     *
+     * @example
+     * ```typescript
+     * const freshConfig = await shipos.configs.refresh<PricingConfig>('pricing');
+     * ```
+     */
+    refresh<T = Record<string, unknown>>(slug: string): Promise<ConfigResponse<T>>;
+}
+//# sourceMappingURL=configs.d.ts.map

package/dist/modules/configs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configs.d.ts","sourceRoot":"","sources":["../../src/modules/configs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5F,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACnC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAiB;gBAEhB,GAAG,EAAE,cAAc;IAI/B;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAchF;;;;;;;;;;OAUG;IACG,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CAKrF"}

package/dist/modules/customers.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Customers Module
+ *
+ * Provides customer identification (sign-in) for the ShipOS SDK.
+ * When a customer is signed in, their external ID is sent with
+ * subsequent API requests for targeting and analytics.
+ *
+ * @example
+ * ```typescript
+ * await shipos.customers.signIn({ externalId: 'user-123', metadata: { plan: 'pro' } });
+ * const customer = shipos.customers.get();
+ * shipos.customers.signOut();
+ * ```
+ */
+import type { CustomerInfo, SignInOptions } from "../types";
+/**
+ * Internal context shared by the parent ShipOS client
+ */
+export interface CustomersContext {
+    request: <T>(endpoint: string, options?: {
+        method?: string;
+        body?: unknown;
+    }) => Promise<T>;
+    log: (...args: unknown[]) => void;
+    setCustomerId: (id: string | null) => void;
+}
+export declare class CustomersModule {
+    private ctx;
+    private customer;
+    constructor(ctx: CustomersContext);
+    /**
+     * Sign in a customer
+     *
+     * Identifies the customer by their external ID and optional metadata.
+     * The customer context is stored locally and sent to the API for
+     * tracking and future flag targeting.
+     *
+     * @param options - Sign-in options with externalId and optional metadata
+     *
+     * @example
+     * ```typescript
+     * await shipos.customers.signIn({
+     *   externalId: 'user-123',
+     *   metadata: { name: 'John', plan: 'pro' },
+     * });
+     * ```
+     */
+    signIn(options: SignInOptions): Promise<CustomerInfo>;
+    /**
+     * Sign out the current customer
+     *
+     * Clears the local customer context. Subsequent API requests
+     * will no longer include customer identification.
+     *
+     * @example
+     * ```typescript
+     * shipos.customers.signOut();
+     * ```
+     */
+    signOut(): void;
+    /**
+     * Get the current signed-in customer
+     *
+     * @returns The current customer info, or null if no customer is signed in
+     *
+     * @example
+     * ```typescript
+     * const customer = shipos.customers.get();
+     * if (customer) {
+     *   console.log(`Signed in as: ${customer.externalId}`);
+     * }
+     * ```
+     */
+    get(): CustomerInfo | null;
+}
+//# sourceMappingURL=customers.d.ts.map

package/dist/modules/customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../../src/modules/customers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5F,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5C;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,QAAQ,CAA6B;gBAEjC,GAAG,EAAE,gBAAgB;IAIjC;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA6B3D;;;;;;;;;;OAUG;IACH,OAAO,IAAI,IAAI;IAMf;;;;;;;;;;;;OAYG;IACH,GAAG,IAAI,YAAY,GAAG,IAAI;CAG3B"}

package/dist/modules/feature-flags.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Feature Flags Module
+ *
+ * Provides namespaced access to feature flag operations.
+ *
+ * @example
+ * ```typescript
+ * const flags = await shipos.featureFlags.getAll();
+ * const isEnabled = await shipos.featureFlags.get('new-feature', false);
+ * ```
+ */
+import type { Cache } from "../cache";
+import type { FlagsResponse } from "../types";
+/**
+ * Internal context shared by the parent ShipOS client
+ */
+export interface FeatureFlagsContext {
+    request: <T>(endpoint: string, options?: {
+        method?: string;
+        body?: unknown;
+    }) => Promise<T>;
+    cache: Cache;
+    getEnvironment: () => string;
+    log: (...args: unknown[]) => void;
+}
+export declare class FeatureFlagsModule {
+    private ctx;
+    constructor(ctx: FeatureFlagsContext);
+    /**
+     * Get all feature flags
+     *
+     * @returns Record of flag keys to boolean values
+     *
+     * @example
+     * ```typescript
+     * const flags = await shipos.featureFlags.getAll();
+     * // => { "new-dashboard": true, "beta-features": false }
+     * ```
+     */
+    getAll(): Promise<FlagsResponse>;
+    /**
+     * Get a single feature flag value
+     *
+     * @param key - The flag key
+     * @param defaultValue - Default value if flag is not found (defaults to false)
+     * @returns The flag value or default
+     *
+     * @example
+     * ```typescript
+     * const isEnabled = await shipos.featureFlags.get('new-dashboard', false);
+     * ```
+     */
+    get(key: string, defaultValue?: boolean): Promise<boolean>;
+    /**
+     * Refresh flags (bypass cache)
+     *
+     * @returns Fresh flags from the API
+     *
+     * @example
+     * ```typescript
+     * const freshFlags = await shipos.featureFlags.refresh();
+     * ```
+     */
+    refresh(): Promise<FlagsResponse>;
+}
+//# sourceMappingURL=feature-flags.d.ts.map

package/dist/modules/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../src/modules/feature-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5F,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACnC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,GAAG,CAAsB;gBAErB,GAAG,EAAE,mBAAmB;IAIpC;;;;;;;;;;OAUG;IACG,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IActC;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAKvE;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;CAKxC"}

package/dist/react/components.d.ts

@@ -0,0 +1,85 @@
+import type { ReactNode } from "react";
+/**
+ * Feature Component Props
+ */
+interface FeatureProps {
+    /** The feature flag key */
+    flag: string;
+    /** Content to render when the flag is enabled */
+    children: ReactNode;
+    /** Content to render when the flag is disabled (optional) */
+    fallback?: ReactNode;
+    /** Content to render while loading (optional) */
+    loading?: ReactNode;
+}
+/**
+ * Feature Component
+ *
+ * Conditionally renders content based on a feature flag.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <Feature flag="new-dashboard">
+ *   <NewDashboard />
+ * </Feature>
+ *
+ * // With fallback
+ * <Feature flag="new-dashboard" fallback={<OldDashboard />}>
+ *   <NewDashboard />
+ * </Feature>
+ *
+ * // With loading state
+ * <Feature flag="new-dashboard" loading={<Skeleton />}>
+ *   <NewDashboard />
+ * </Feature>
+ * ```
+ */
+export declare function Feature({ flag, children, fallback, loading, }: FeatureProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * FeatureEnabled Component Props
+ */
+interface FeatureEnabledProps {
+    /** The feature flag key */
+    flag: string;
+    /** Content to render when the flag is enabled */
+    children: ReactNode;
+}
+/**
+ * FeatureEnabled Component
+ *
+ * Only renders children when the flag is enabled.
+ * Simpler alternative to Feature when you don't need fallback.
+ *
+ * @example
+ * ```tsx
+ * <FeatureEnabled flag="beta-features">
+ *   <BetaBanner />
+ * </FeatureEnabled>
+ * ```
+ */
+export declare function FeatureEnabled({ flag, children }: FeatureEnabledProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * FeatureDisabled Component Props
+ */
+interface FeatureDisabledProps {
+    /** The feature flag key */
+    flag: string;
+    /** Content to render when the flag is disabled */
+    children: ReactNode;
+}
+/**
+ * FeatureDisabled Component
+ *
+ * Only renders children when the flag is disabled.
+ *
+ * @example
+ * ```tsx
+ * <FeatureDisabled flag="maintenance-mode">
+ *   <MainContent />
+ * </FeatureDisabled>
+ * ```
+ */
+export declare function FeatureDisabled({ flag, children }: FeatureDisabledProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=components.d.ts.map

package/dist/react/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/react/components.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;GAEG;AACH,UAAU,YAAY;IACpB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,QAAQ,EAAE,SAAS,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,QAAQ,EACR,QAAe,EACf,OAAc,GACf,EAAE,YAAY,2CAQd;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,mBAAmB,kDAQrE;AAED;;GAEG;AACH,UAAU,oBAAoB;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,oBAAoB,kDAQvE"}

package/dist/react/hooks.d.ts

@@ -0,0 +1,115 @@
+import type { CustomerInfo, SignInOptions } from "../types";
+/**
+ * Hook to get all feature flags
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { flags, isLoading, error } = useFlags();
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       {flags['new-feature'] && <NewFeature />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useFlags(): {
+    flags: import("..").FlagsResponse;
+    isLoading: boolean;
+    error: Error | null;
+    refreshFlags: () => Promise<void>;
+};
+/**
+ * Hook to get a single feature flag
+ *
+ * @param key - The flag key
+ * @param defaultValue - Default value if flag is not found
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { enabled, isLoading } = useFlag('new-feature', false);
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *
+ *   return enabled ? <NewFeature /> : <OldFeature />;
+ * }
+ * ```
+ */
+export declare function useFlag(key: string, defaultValue?: boolean): {
+    enabled: boolean;
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to get a configuration by slug
+ *
+ * @param slug - The config slug
+ *
+ * @example
+ * ```tsx
+ * interface PricingConfig {
+ *   plans: Array<{ name: string; price: number }>;
+ * }
+ *
+ * function PricingPage() {
+ *   const { config, isLoading, error, refresh } = useConfig<PricingConfig>('pricing');
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       {config?.plans.map(plan => (
+ *         <div key={plan.name}>{plan.name}: ${plan.price}</div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useConfig<T = Record<string, unknown>>(slug: string): {
+    config: T | null;
+    isLoading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+};
+/**
+ * Hook to manage customer identification
+ *
+ * @example
+ * ```tsx
+ * function UserProfile() {
+ *   const { customer, signIn, signOut } = useCustomer();
+ *
+ *   useEffect(() => {
+ *     // Sign in when user is authenticated
+ *     signIn({ externalId: 'user-123', metadata: { plan: 'pro' } });
+ *   }, []);
+ *
+ *   return (
+ *     <div>
+ *       {customer ? (
+ *         <>
+ *           <p>Signed in as: {customer.externalId}</p>
+ *           <button onClick={signOut}>Sign Out</button>
+ *         </>
+ *       ) : (
+ *         <p>Not signed in</p>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useCustomer(): {
+    customer: CustomerInfo | null;
+    signIn: (options: SignInOptions) => Promise<CustomerInfo>;
+    signOut: () => void;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/react/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/react/hooks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ;;;;;EAGvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe;;;;EAKjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM;;;;;EA0ClE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,IAUpB;IACH,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CACF"}

package/dist/react/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ShipOS SDK React Integration
+ *
+ * React hooks and components for ShipOS feature flags, configs, and customer identification.
+ *
+ * @example
+ * ```tsx
+ * import { ShipOSProvider, useFlag, useCustomer, Feature } from '@shipos/sdk/react';
+ *
+ * function App() {
+ *   return (
+ *     <ShipOSProvider config={{ apiKey: 'your-api-key' }}>
+ *       <Feature flag="new-feature">
+ *         <NewFeature />
+ *       </Feature>
+ *     </ShipOSProvider>
+ *   );
+ * }
+ * ```
+ */
+export { ShipOSProvider, useShipOS } from "./provider";
+export { useFlags, useFlag, useConfig, useCustomer } from "./hooks";
+export { Feature, FeatureEnabled, FeatureDisabled } from "./components";
+export type { ShipOSConfig, FlagsResponse, ConfigResponse, CustomerInfo, SignInOptions, } from "../types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGpE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGxE,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,UAAU,CAAC"}

package/dist/react/index.js

@@ -0,0 +1 @@
+class P{store=new Map;defaultTTL;constructor(G=60000){this.defaultTTL=G}get(G){let q=this.store.get(G);if(!q)return null;if(Date.now()-q.timestamp>this.defaultTTL)return this.store.delete(G),null;return q.data}set(G,q){this.store.set(G,{data:q,timestamp:Date.now()})}delete(G){this.store.delete(G)}clear(){this.store.clear()}setTTL(G){this.defaultTTL=G}}class _{ctx;constructor(G){this.ctx=G}async getAll(){let G=`flags:${this.ctx.getEnvironment()}`,q=this.ctx.cache.get(G);if(q)return this.ctx.log("Returning cached flags"),q;let z=await this.ctx.request("/v1/flags");return this.ctx.cache.set(G,z),z}async get(G,q=!1){return(await this.getAll())[G]??q}async refresh(){let G=`flags:${this.ctx.getEnvironment()}`;return this.ctx.cache.delete(G),this.getAll()}}class I{ctx;constructor(G){this.ctx=G}async get(G){let q=`config:${this.ctx.getEnvironment()}:${G}`,z=this.ctx.cache.get(q);if(z)return this.ctx.log(`Returning cached config: ${G}`),z;let J=await this.ctx.request(`/v1/config/${G}`);return this.ctx.cache.set(q,J),J}async refresh(G){let q=`config:${this.ctx.getEnvironment()}:${G}`;return this.ctx.cache.delete(q),this.get(G)}}class j{ctx;customer=null;constructor(G){this.ctx=G}async signIn(G){if(!G.externalId)throw Error("ShipOS: externalId is required for signIn");return this.ctx.log(`Signing in customer: ${G.externalId}`),this.customer={externalId:G.externalId,metadata:G.metadata},this.ctx.setCustomerId(G.externalId),await this.ctx.request("/v1/customers/identify",{method:"POST",body:{externalId:G.externalId,metadata:G.metadata??{}}}),this.ctx.log(`Customer signed in: ${G.externalId}`),this.customer}signOut(){this.ctx.log("Signing out customer"),this.customer=null,this.ctx.setCustomerId(null)}get(){return this.customer}}var C="https://api.shipos.app",k=60000,x="0.1.0";class w{apiKey;baseUrl;environment;cache;debug;customerId=null;featureFlags;configs;customers;constructor(G){if(!G.apiKey)throw Error("ShipOS: apiKey is required");this.apiKey=G.apiKey,this.baseUrl=G.baseUrl||C,this.environment=G.environment||"production",this.cache=new P(G.cacheTTL||k),this.debug=G.debug||!1;let q={request:this.request.bind(this),cache:this.cache,getEnvironment:this.getEnvironment.bind(this),log:this.log.bind(this),setCustomerId:(z)=>{this.customerId=z}};this.featureFlags=new _(q),this.configs=new I(q),this.customers=new j(q)}log(...G){if(this.debug)console.log("[ShipOS]",...G)}async request(G,q={}){let z=`${this.baseUrl}${G}`,J=q.method||"GET";this.log(`${J} ${z}`);let Y={"x-shipos-key":this.apiKey,"x-shipos-env":this.environment,"x-shipos-sdk-version":x,"Content-Type":"application/json"};if(this.customerId)Y["x-shipos-customer-id"]=this.customerId;let Q={method:J,headers:Y};if(q.body&&J!=="GET")Q.body=JSON.stringify(q.body);let Z=await fetch(z,Q);if(!Z.ok){let B=await Z.json().catch(()=>({error:`HTTP ${Z.status}`,code:"HTTP_ERROR"}));throw Error(B.error||`Request failed: ${Z.status}`)}return Z.json()}clearCache(){this.cache.clear(),this.log("Cache cleared")}setEnvironment(G){this.environment=G,this.cache.clear(),this.log(`Environment changed to: ${G}`)}getEnvironment(){return this.environment}}function F(G){return new w(G)}import{createContext as m,useContext as p,useState as H,useEffect as h,useCallback as U}from"react";import{jsxDEV as d}from"react/jsx-dev-runtime";var T=m(null);function f({config:G,children:q,initialFlags:z={}}){let[J]=H(()=>new w(G)),[Y,Q]=H(z),[Z,B]=H(Object.keys(z).length===0),[M,N]=H(null),[W,O]=H(null),D=U(async()=>{try{B(!0),N(null);let X=await J.featureFlags.getAll();Q(X)}catch(X){N(X instanceof Error?X:Error("Failed to fetch flags"))}finally{B(!1)}},[J]),L=U(async()=>{try{N(null);let X=await J.featureFlags.refresh();Q(X)}catch(X){N(X instanceof Error?X:Error("Failed to refresh flags"))}},[J]),E=U(async(X)=>{let V=await J.customers.signIn(X);return O(V),V},[J]),y=U(()=>{J.customers.signOut(),O(null)},[J]);h(()=>{if(Object.keys(z).length===0)D()},[D,z]);let S={client:J,flags:Y,isLoading:Z,error:M,refreshFlags:L,customer:W,signIn:E,signOut:y};return d(T.Provider,{value:S,children:q},void 0,!1,void 0,this)}function $(){let G=p(T);if(!G)throw Error("useShipOS must be used within a ShipOSProvider");return G}import{useState as v,useEffect as u,useCallback as b}from"react";function g(){let{flags:G,isLoading:q,error:z,refreshFlags:J}=$();return{flags:G,isLoading:q,error:z,refreshFlags:J}}function R(G,q=!1){let{flags:z,isLoading:J,error:Y}=$();return{enabled:z[G]??q,isLoading:J,error:Y}}function c(G){let{client:q}=$(),[z,J]=v(null),[Y,Q]=v(!0),[Z,B]=v(null),M=b(async()=>{try{Q(!0),B(null);let W=await q.configs.get(G);J(W)}catch(W){B(W instanceof Error?W:Error(`Failed to fetch config: ${G}`))}finally{Q(!1)}},[q,G]),N=b(async()=>{try{B(null);let W=await q.configs.refresh(G);J(W)}catch(W){B(W instanceof Error?W:Error(`Failed to refresh config: ${G}`))}},[q,G]);return u(()=>{M()},[M]),{config:z,isLoading:Y,error:Z,refresh:N}}function a(){let{customer:G,signIn:q,signOut:z}=$();return{customer:G,signIn:q,signOut:z}}import{jsxDEV as K,Fragment as A}from"react/jsx-dev-runtime";function l({flag:G,children:q,fallback:z=null,loading:J=null}){let{enabled:Y,isLoading:Q}=R(G);if(Q&&J)return K(A,{children:J},void 0,!1,void 0,this);return Y?K(A,{children:q},void 0,!1,void 0,this):K(A,{children:z},void 0,!1,void 0,this)}function r({flag:G,children:q}){let{enabled:z,isLoading:J}=R(G);if(J||!z)return null;return K(A,{children:q},void 0,!1,void 0,this)}function i({flag:G,children:q}){let{enabled:z,isLoading:J}=R(G);if(J||z)return null;return K(A,{children:q},void 0,!1,void 0,this)}export{$ as useShipOS,g as useFlags,R as useFlag,a as useCustomer,c as useConfig,f as ShipOSProvider,r as FeatureEnabled,i as FeatureDisabled,l as Feature};

package/dist/react/provider.d.ts

@@ -0,0 +1,61 @@
+import { type ReactNode } from "react";
+import { ShipOS, type ShipOSConfig, type FlagsResponse, type CustomerInfo, type SignInOptions } from "../index";
+/**
+ * ShipOS Context Value
+ */
+interface ShipOSContextValue {
+    /** The ShipOS client instance */
+    client: ShipOS;
+    /** All feature flags (cached) */
+    flags: FlagsResponse;
+    /** Whether flags are currently loading */
+    isLoading: boolean;
+    /** Error if flags failed to load */
+    error: Error | null;
+    /** Refresh flags from the API */
+    refreshFlags: () => Promise<void>;
+    /** Current signed-in customer */
+    customer: CustomerInfo | null;
+    /** Sign in a customer */
+    signIn: (options: SignInOptions) => Promise<CustomerInfo>;
+    /** Sign out the current customer */
+    signOut: () => void;
+}
+/**
+ * ShipOS Provider Props
+ */
+interface ShipOSProviderProps {
+    /** ShipOS configuration */
+    config: ShipOSConfig;
+    /** Child components */
+    children: ReactNode;
+    /** Initial flags (for SSR) */
+    initialFlags?: FlagsResponse;
+}
+/**
+ * ShipOS Provider
+ *
+ * Provides the ShipOS client, flags, and customer context to all child components.
+ *
+ * @example
+ * ```tsx
+ * import { ShipOSProvider } from '@shipos/sdk/react';
+ *
+ * function App() {
+ *   return (
+ *     <ShipOSProvider config={{ apiKey: 'your-api-key' }}>
+ *       <YourApp />
+ *     </ShipOSProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function ShipOSProvider({ config, children, initialFlags, }: ShipOSProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the ShipOS context
+ *
+ * @throws Error if used outside of ShipOSProvider
+ */
+export declare function useShipOS(): ShipOSContextValue;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/react/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,EACL,MAAM,EACN,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,UAAU,kBAAkB;IAC1B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,iCAAiC;IACjC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,iCAAiC;IACjC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,yBAAyB;IACzB,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,oCAAoC;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAID;;GAEG;AACH,UAAU,mBAAmB;IAC3B,2BAA2B;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,uBAAuB;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,QAAQ,EACR,YAAiB,GAClB,EAAE,mBAAmB,2CAqErB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C"}

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * ShipOS SDK Types
+ */
+/**
+ * Configuration options for the ShipOS client
+ */
+export interface ShipOSConfig {
+    /** Your ShipOS API key */
+    apiKey: string;
+    /** Base URL for the ShipOS API (defaults to production) */
+    baseUrl?: string;
+    /** Environment to fetch flags/configs for (defaults to 'production') */
+    environment?: string;
+    /** Cache TTL in milliseconds (defaults to 60000 - 1 minute) */
+    cacheTTL?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Feature flags response type
+ */
+export type FlagsResponse = Record<string, boolean>;
+/**
+ * Config response type (generic for typed configs)
+ */
+export type ConfigResponse<T = Record<string, unknown>> = T;
+/**
+ * API error response
+ */
+export interface ApiError {
+    error: string;
+    code?: string;
+}
+/**
+ * Cache entry with timestamp
+ */
+export interface CacheEntry<T> {
+    data: T;
+    timestamp: number;
+}
+/**
+ * Result type for async operations
+ */
+export type Result<T, E = Error> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+/**
+ * Customer information returned after sign-in
+ */
+export interface CustomerInfo {
+    /** External ID used to identify the customer */
+    externalId: string;
+    /** Optional metadata associated with the customer */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for signing in a customer
+ */
+export interface SignInOptions {
+    /** External ID used to identify the customer in your system */
+    externalId: string;
+    /** Optional JSON metadata to associate with the customer */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "shipos",
+  "version": "0.0.0",
+  "description": "ShipOS SDK for feature flags and global configs",
+  "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"
+    },
+    "./react": {
+      "import": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build:bundle": "bun build ./src/index.ts ./src/react/index.ts --outdir ./dist --target browser --format esm --external react",
+    "build": "bun run build:bundle -- --minify && bun run build:types",
+    "build:types": "tsc --emitDeclarationOnly --declaration --outDir ./dist",
+    "dev": "bun run build:bundle -- --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "shipos",
+    "feature-flags",
+    "config",
+    "sdk",
+    "react"
+  ],
+  "author": "",
+  "license": "UNLICENSED",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/react": "^19.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18 || ^19",
+    "typescript": "^5"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  }
+}