@tandem-language-exchange/content-store 1.0.2 → 1.0.4

package/dist/client/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/client/cli.js

@@ -0,0 +1,72 @@
+import { Command } from 'commander';
+import { config } from './config';
+import { ContentStore } from '../shared/s3';
+import { fetchBundles, queryBundle } from '../shared/bundles';
+const program = new Command();
+program
+    .name('content-store')
+    .description('Sync CMS content to S3')
+    .version('1.0.0');
+program
+    .command('fetch')
+    .description('Download latest bundles from S3 to the local filesystem')
+    .requiredOption('--cms <provider>', 'CMS provider: contentful | sanity')
+    .requiredOption('--types <types>', 'Comma-separated content types to fetch')
+    .option('--output <directory>', 'Output directory', './content-cache')
+    .action(async (opts) => {
+    const cms = opts.cms;
+    if (!['contentful', 'sanity'].includes(cms)) {
+        console.error(`Invalid CMS provider: ${cms}`);
+        process.exit(1);
+    }
+    const contentTypes = opts.types.split(',').map((s) => s.trim());
+    const store = new ContentStore(config.s3);
+    try {
+        const files = await fetchBundles(store, opts.output, {
+            cms,
+            contentTypes,
+        });
+        console.log('Fetched bundles:');
+        for (const [type, filePath] of Object.entries(files)) {
+            console.log(`  ${type} -> ${filePath}`);
+        }
+    }
+    catch (err) {
+        console.error('Fetch failed:', err);
+        process.exit(1);
+    }
+});
+program
+    .command('query')
+    .description('Query a previously fetched bundle from the local filesystem')
+    .requiredOption('--cms <provider>', 'CMS provider: contentful | sanity')
+    .requiredOption('--type <type>', 'Content type to query')
+    .option('--output <directory>', 'Directory where bundles are stored', './content-cache')
+    .option('--fields <json>', 'Filter by fields (JSON object, e.g. \'{"columns":"2"}\')')
+    .option('--select <props>', 'Comma-separated properties to include in results')
+    .option('--limit <n>', 'Maximum number of results', parseInt)
+    .option('--include <n>', 'Depth of nested references to include', parseInt)
+    .action(async (opts) => {
+    const cms = opts.cms;
+    if (!['contentful', 'sanity'].includes(cms)) {
+        console.error(`Invalid CMS provider: ${cms}`);
+        process.exit(1);
+    }
+    try {
+        const results = await queryBundle(opts.output, cms, opts.type, {
+            fields: opts.fields ? JSON.parse(opts.fields) : undefined,
+            select: opts.select
+                ? opts.select.split(',').map((s) => s.trim())
+                : undefined,
+            limit: opts.limit,
+            include: opts.include,
+        });
+        console.log(JSON.stringify(results, null, 2));
+    }
+    catch (err) {
+        console.error('Query failed:', err);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/client/cli.js.map

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

package/dist/client/config.d.ts

@@ -0,0 +1,6 @@
+import type { S3Config, CMSProvider } from '../shared/types';
+import { SharedConfig } from '../shared/config';
+export type { CMSProvider, S3Config };
+export interface ClientConfig {
+}
+export declare const config: ClientConfig & SharedConfig;

package/dist/client/config.js

@@ -0,0 +1,8 @@
+import dotenv from 'dotenv';
+import { config as sharedConfig } from '../shared/config';
+dotenv.config({ path: '.env.local' });
+dotenv.config();
+export const config = {
+    ...sharedConfig
+};
+//# sourceMappingURL=config.js.map

package/dist/client/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAe,MAAM,IAAI,YAAY,EAAC,MAAM,kBAAkB,CAAC;AAEtE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,EAAE,CAAC;AAOhB,MAAM,CAAC,MAAM,MAAM,GAAgC;IAC/C,GAAG,YAAY;CAClB,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { ContentStoreSDK } from './sdk/index.js';
-export type { SDKConfig, FetchBundlesOptions, QueryOptions } from './sdk/index.js';
-export { fetchBundles, queryBundle, trimDepth } from './shared/bundles.js';
-export { ContentStore } from './shared/s3.js';
-export type { CMSProvider, S3Config } from './shared/types.js';
+export { ContentStoreSDK } from './sdk/index';
+export type { SDKConfig, FetchBundlesOptions, QueryOptions } from './sdk/index';
+export { fetchBundles, queryBundle, trimDepth } from './shared/bundles';
+export { ContentStore } from './shared/s3';
+export type { CMSProvider, S3Config } from './shared/types';

package/dist/index.js

@@ -1,4 +1,4 @@
-export { ContentStoreSDK } from './sdk/index.js';
-export { fetchBundles, queryBundle, trimDepth } from './shared/bundles.js';
-export { ContentStore } from './shared/s3.js';
+export { ContentStoreSDK } from './sdk/index';
+export { fetchBundles, queryBundle, trimDepth } from './shared/bundles';
+export { ContentStore } from './shared/s3';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/sdk/client.d.ts

@@ -1,5 +1,5 @@
-import type { S3Config, CMSProvider } from '../shared/types.js';
-import { type FetchBundlesOptions, type QueryOptions } from '../shared/bundles.js';
+import type { S3Config, CMSProvider } from '../shared/types';
+import { type FetchBundlesOptions, type QueryOptions } from '../shared/bundles';
 export type { FetchBundlesOptions, QueryOptions };
 export interface SDKConfig {
     s3: S3Config;

package/dist/sdk/client.js

@@ -1,5 +1,5 @@
-import { ContentStore } from '../shared/s3.js';
-import { fetchBundles, queryBundle, } from '../shared/bundles.js';
+import { ContentStore } from '../shared/s3';
+import { fetchBundles, queryBundle, } from '../shared/bundles';
 export class ContentStoreSDK {
     store;
     outputDir;

package/dist/sdk/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/sdk/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,YAAY,EACZ,WAAW,GAGZ,MAAM,sBAAsB,CAAC;AAU9B,MAAM,OAAO,eAAe;IAClB,KAAK,CAAe;IACpB,SAAS,CAAS;IAE1B,YAAY,MAAiB;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAChB,OAA4B;QAE5B,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,GAAgB,EAChB,WAAmB,EACnB,UAAwB,EAAE;QAE1B,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/sdk/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,WAAW,GAGZ,MAAM,mBAAmB,CAAC;AAU3B,MAAM,OAAO,eAAe;IAClB,KAAK,CAAe;IACpB,SAAS,CAAS;IAE1B,YAAY,MAAiB;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAChB,OAA4B;QAE5B,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,GAAgB,EAChB,WAAmB,EACnB,UAAwB,EAAE;QAE1B,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/sdk/index.d.ts

@@ -1,5 +1,5 @@
-export { ContentStoreSDK } from './client.js';
-export type { SDKConfig, FetchBundlesOptions, QueryOptions } from './client.js';
-export { fetchBundles, queryBundle, trimDepth } from '../shared/bundles.js';
-export { ContentStore } from '../shared/s3.js';
-export type { S3Config, CMSProvider } from '../shared/types.js';
+export { ContentStoreSDK } from './client';
+export type { SDKConfig, FetchBundlesOptions, QueryOptions } from './client';
+export { fetchBundles, queryBundle, trimDepth } from '../shared/bundles';
+export { ContentStore } from '../shared/s3';
+export type { S3Config, CMSProvider } from '../shared/types';

package/dist/sdk/index.js

@@ -1,4 +1,4 @@
-export { ContentStoreSDK } from './client.js';
-export { fetchBundles, queryBundle, trimDepth } from '../shared/bundles.js';
-export { ContentStore } from '../shared/s3.js';
+export { ContentStoreSDK } from './client';
+export { fetchBundles, queryBundle, trimDepth } from '../shared/bundles';
+export { ContentStore } from '../shared/s3';
 //# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/shared/bundles.d.ts

@@ -1,5 +1,5 @@
-import type { CMSProvider } from './types.js';
-import { ContentStore } from './s3.js';
+import type { CMSProvider } from './types';
+import { ContentStore } from './s3';
 export interface FetchBundlesOptions {
     cms: CMSProvider;
     contentTypes: string[];

package/dist/shared/config.d.ts

@@ -0,0 +1,6 @@
+import type { S3Config, CMSProvider } from './types';
+export type { CMSProvider, S3Config };
+export interface SharedConfig {
+    s3: S3Config;
+}
+export declare const config: SharedConfig;

package/dist/shared/config.js

@@ -0,0 +1,12 @@
+import dotenv from 'dotenv';
+dotenv.config({ path: '.env.local' });
+dotenv.config();
+export const config = {
+    s3: {
+        bucket: process.env.CONTENT_STORE_S3_BUCKET ?? '',
+        region: process.env.CONTENT_STORE_S3_REGION ?? 'eu-central-1',
+        accessKeyId: process.env.AWS_ACCESS_KEY ?? '',
+        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY ?? '',
+    }
+};
+//# sourceMappingURL=config.js.map

package/dist/shared/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shared/config.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,EAAE,CAAC;AAQhB,MAAM,CAAC,MAAM,MAAM,GAAiB;IAChC,EAAE,EAAE;QACA,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE;QACjD,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,cAAc;QAC7D,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE;QAC7C,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE;KAC3D;CACJ,CAAC"}

package/dist/shared/s3.d.ts

@@ -1,4 +1,4 @@
-import type { S3Config } from './types.js';
+import type { S3Config } from './types';
 export declare class ContentStore {
     private client;
     private bucket;

package/dist/shared/sync/engine.d.ts

@@ -0,0 +1,17 @@
+import type { CMSProvider } from '../config.js';
+export interface SyncResultEntry {
+    contentType: string;
+    itemCount: number;
+    versionedKey: string;
+    latestKey: string;
+}
+export interface SyncResult {
+    cms: CMSProvider;
+    timestamp: number;
+    entries: SyncResultEntry[];
+    errors: Array<{
+        contentType: string;
+        error: string;
+    }>;
+}
+export declare function runSync(cms: CMSProvider, contentTypes?: string[]): Promise<SyncResult>;

package/dist/shared/sync/engine.js

@@ -0,0 +1,38 @@
+import { config } from '../config.js';
+import { createAdapter } from '../adapters/index.js';
+import { ContentStore } from '../../shared/s3.js';
+export async function runSync(cms, contentTypes) {
+    const adapter = createAdapter(cms);
+    const store = new ContentStore(config.s3);
+    const timestamp = Math.floor(Date.now() / 1000);
+    console.log(`\nStarting sync from ${cms} at ${new Date(timestamp * 1000).toISOString()}`);
+    const typesToSync = contentTypes && contentTypes.length > 0
+        ? contentTypes
+        : await adapter.getContentTypes();
+    console.log(`Content types to sync: ${typesToSync.join(', ')}\n`);
+    const entries = [];
+    const errors = [];
+    for (const contentType of typesToSync) {
+        try {
+            const result = await adapter.fetchAll(contentType);
+            const versionedKey = store.buildVersionedKey(cms, contentType, timestamp);
+            await store.upload(versionedKey, result.items);
+            const latestKey = await store.copyToLatest(versionedKey, cms, contentType);
+            entries.push({
+                contentType,
+                itemCount: result.total,
+                versionedKey,
+                latestKey,
+            });
+            console.log(`  + ${contentType}: ${result.total} items -> ${versionedKey}`);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            errors.push({ contentType, error: message });
+            console.error(`  x ${contentType}: ${message}`);
+        }
+    }
+    console.log(`\nSync complete: ${entries.length} succeeded, ${errors.length} failed\n`);
+    return { cms, timestamp, entries, errors };
+}
+//# sourceMappingURL=engine.js.map

package/dist/shared/sync/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/shared/sync/engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAgBlD,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAgB,EAChB,YAAuB;IAEvB,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,wBAAwB,GAAG,OAAO,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAE1F,MAAM,WAAW,GACf,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;QACrC,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;IAEtC,OAAO,CAAC,GAAG,CAAC,0BAA0B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAElE,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,MAAM,GAAkD,EAAE,CAAC;IAEjE,KAAK,MAAM,WAAW,IAAI,WAAW,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAEnD,MAAM,YAAY,GAAG,KAAK,CAAC,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;YAC1E,MAAM,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAE/C,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;YAE3E,OAAO,CAAC,IAAI,CAAC;gBACX,WAAW;gBACX,SAAS,EAAE,MAAM,CAAC,KAAK;gBACvB,YAAY;gBACZ,SAAS;aACV,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CACT,OAAO,WAAW,KAAK,MAAM,CAAC,KAAK,aAAa,YAAY,EAAE,CAC/D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,OAAO,WAAW,KAAK,OAAO,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CACT,oBAAoB,OAAO,CAAC,MAAM,eAAe,MAAM,CAAC,MAAM,WAAW,CAC1E,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7C,CAAC"}

package/dist/shared/sync/retry.d.ts

@@ -0,0 +1,7 @@
+import type { RetryConfig } from '../config.js';
+/**
+ * Executes `fn` with automatic retry + exponential backoff.
+ * Rate-limit (429) responses are handled specially: if the API provides a
+ * Retry-After / reset header, that value is respected instead of computed backoff.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, { maxRetries, baseDelayMs, maxDelayMs }: RetryConfig): Promise<T>;

package/dist/shared/sync/retry.js

@@ -0,0 +1,57 @@
+/**
+ * Inspects an error to determine if it represents an API rate-limit (HTTP 429).
+ * Returns the suggested wait time in ms when available, otherwise `0` to signal
+ * that the caller should fall back to computed backoff.  Returns `null` when the
+ * error is *not* a rate-limit error.
+ */
+function rateLimitDelayMs(err) {
+    const e = err;
+    if (e?.status === 429 || e?.statusCode === 429) {
+        const reset = e?.headers?.['x-contentful-ratelimit-reset'];
+        return reset ? parseFloat(reset) * 1000 : 0;
+    }
+    const resp = e?.response;
+    if (resp?.status === 429) {
+        const headers = resp?.headers;
+        const reset = headers?.['x-contentful-ratelimit-reset'];
+        return reset ? parseFloat(reset) * 1000 : 0;
+    }
+    return null;
+}
+function computeDelay(attempt, baseDelayMs, maxDelayMs) {
+    const exponential = baseDelayMs * Math.pow(2, attempt);
+    const jitter = Math.random() * baseDelayMs;
+    return Math.min(exponential + jitter, maxDelayMs);
+}
+/**
+ * Executes `fn` with automatic retry + exponential backoff.
+ * Rate-limit (429) responses are handled specially: if the API provides a
+ * Retry-After / reset header, that value is respected instead of computed backoff.
+ */
+export async function withRetry(fn, { maxRetries, baseDelayMs, maxDelayMs }) {
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (attempt === maxRetries)
+                throw err;
+            const rlDelay = rateLimitDelayMs(err);
+            let delay;
+            if (rlDelay !== null) {
+                delay =
+                    rlDelay > 0 ? rlDelay : computeDelay(attempt, baseDelayMs, maxDelayMs);
+                console.warn(`  Rate limited (attempt ${attempt + 1}/${maxRetries}). ` +
+                    `Waiting ${Math.round(delay)}ms…`);
+            }
+            else {
+                delay = computeDelay(attempt, baseDelayMs, maxDelayMs);
+                console.warn(`  Request failed (attempt ${attempt + 1}/${maxRetries}): ` +
+                    `${err.message}. Retrying in ${Math.round(delay)}ms…`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    throw new Error('withRetry: unreachable');
+}
+//# sourceMappingURL=retry.js.map

package/dist/shared/sync/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/shared/sync/retry.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,GAAY;IACpC,MAAM,CAAC,GAAG,GAA8B,CAAC;IAEzC,IAAI,CAAC,EAAE,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,UAAU,KAAK,GAAG,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAI,CAAC,EAAE,OAA8C,EAAE,CAChE,8BAA8B,CAC/B,CAAC;QACF,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,EAAE,QAA+C,CAAC;IAChE,IAAI,IAAI,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,EAAE,OAA6C,CAAC;QACpE,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,8BAA8B,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CACnB,OAAe,EACf,WAAmB,EACnB,UAAkB;IAElB,MAAM,WAAW,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,MAAM,EAAE,UAAU,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAe;IAEpD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,OAAO,KAAK,UAAU;gBAAE,MAAM,GAAG,CAAC;YAEtC,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,KAAa,CAAC;YAElB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,KAAK;oBACH,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;gBACzE,OAAO,CAAC,IAAI,CACV,2BAA2B,OAAO,GAAG,CAAC,IAAI,UAAU,KAAK;oBACvD,WAAW,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CACpC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;gBACvD,OAAO,CAAC,IAAI,CACV,6BAA6B,OAAO,GAAG,CAAC,IAAI,UAAU,KAAK;oBACzD,GAAI,GAAa,CAAC,OAAO,iBAAiB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CACnE,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tandem-language-exchange/content-store",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,10 +13,11 @@
   "files": [
     "dist/index.*",
     "dist/sdk/",
+    "dist/client/",
     "dist/shared/"
   ],
   "bin": {
-    "fetch-content-bundles": "dist/server/cli.js fetch"
+    "fetch-content-bundles": "dist/client/cli.js fetch"
   },
   "engines": {
     "npm": "^11.3.0",