digital-products 2.0.1

package/dist/sdk.js

@@ -0,0 +1,128 @@
+/**
+ * SDK() - Define a software development kit
+ */
+import { registerProduct } from './product.js';
+/**
+ * Create an SDK definition
+ *
+ * @example
+ * ```ts
+ * const mySDK = SDK({
+ *   id: 'my-sdk',
+ *   name: 'My SDK',
+ *   description: 'JavaScript SDK for My API',
+ *   version: '1.0.0',
+ *   language: 'typescript',
+ *   api: 'my-api',
+ *   exports: [
+ *     Export('function', 'createClient', 'Create an API client', {
+ *       parameters: {
+ *         apiKey: 'API key for authentication',
+ *         baseUrl: 'Optional base URL',
+ *       },
+ *       returns: 'API client instance',
+ *     }),
+ *     Export('class', 'APIClient', 'Main API client', {
+ *       methods: [
+ *         Export('function', 'get', 'GET request', {
+ *           parameters: { path: 'Request path' },
+ *           returns: 'Response data',
+ *         }),
+ *         Export('function', 'post', 'POST request', {
+ *           parameters: { path: 'Request path', data: 'Request body' },
+ *           returns: 'Response data',
+ *         }),
+ *       ],
+ *     }),
+ *   ],
+ *   install: 'npm install my-sdk',
+ *   examples: [
+ *     Example(
+ *       'Basic Usage',
+ *       'Create a client and make a request',
+ *       `import { createClient } from 'my-sdk'
+ *
+ * const client = createClient({ apiKey: 'YOUR_API_KEY' })
+ * const users = await client.get('/users')
+ * console.log(users)`
+ *     ),
+ *   ],
+ * })
+ * ```
+ */
+export function SDK(config) {
+    const sdk = {
+        type: 'sdk',
+        id: config.id,
+        name: config.name,
+        description: config.description,
+        version: config.version,
+        language: config.language,
+        api: config.api,
+        exports: config.exports,
+        install: config.install,
+        docs: config.docs,
+        examples: config.examples,
+        metadata: config.metadata,
+        tags: config.tags,
+        status: config.status || 'active',
+    };
+    return registerProduct(sdk);
+}
+/**
+ * Helper to create an SDK export
+ *
+ * @example
+ * ```ts
+ * const fn = Export('function', 'calculateTotal', 'Calculate order total', {
+ *   parameters: {
+ *     items: ['Array of order items'],
+ *     taxRate: 'Tax rate (number)',
+ *   },
+ *   returns: 'Total amount (number)',
+ * })
+ *
+ * const cls = Export('class', 'OrderManager', 'Manage orders', {
+ *   methods: [
+ *     Export('function', 'create', 'Create order', {
+ *       parameters: { order: 'Order data' },
+ *       returns: 'Created order',
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+export function Export(type, name, description, options) {
+    return {
+        type,
+        name,
+        description,
+        parameters: options?.parameters,
+        returns: options?.returns,
+        methods: options?.methods,
+    };
+}
+/**
+ * Helper to create an SDK example
+ *
+ * @example
+ * ```ts
+ * const example = Example(
+ *   'Authentication',
+ *   'How to authenticate with the API',
+ *   `const client = createClient({
+ *     apiKey: process.env.API_KEY,
+ *   })`,
+ *   '{ authenticated: true }'
+ * )
+ * ```
+ */
+export function Example(title, description, code, output) {
+    return {
+        title,
+        description,
+        code,
+        output,
+    };
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,UAAU,GAAG,CAAC,MAAmC;IACrD,MAAM,GAAG,GAAkB;QACzB,IAAI,EAAE,KAAK;QACX,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;KAClC,CAAA;IAED,OAAO,eAAe,CAAC,GAAG,CAAC,CAAA;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,MAAM,CACpB,IAAuB,EACvB,IAAY,EACZ,WAAmB,EACnB,OAIC;IAED,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,WAAW;QACX,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,OAAO,EAAE,OAAO,EAAE,OAAO;QACzB,OAAO,EAAE,OAAO,EAAE,OAAO;KAC1B,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,OAAO,CACrB,KAAa,EACb,WAAmB,EACnB,IAAY,EACZ,MAAe;IAEf,OAAO;QACL,KAAK;QACL,WAAW;QACX,IAAI;QACJ,MAAM;KACP,CAAA;AACH,CAAC"}

package/dist/site.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Site() - Define a website
+ */
+import type { SiteDefinition, NavigationDefinition, SEOConfig, AnalyticsConfig } from './types.js';
+/**
+ * Create a site definition
+ *
+ * @example
+ * ```ts
+ * const docsSite = Site({
+ *   id: 'docs',
+ *   name: 'Documentation Site',
+ *   description: 'Product documentation',
+ *   version: '1.0.0',
+ *   generator: 'fumadocs',
+ *   structure: {
+ *     home: '/docs/index.mdx',
+ *     docs: [
+ *       '/docs/getting-started.mdx',
+ *       '/docs/api-reference.mdx',
+ *     ],
+ *   },
+ *   navigation: [
+ *     Nav('Home', '/'),
+ *     Nav('Docs', '/docs', {
+ *       children: [
+ *         Nav('Getting Started', '/docs/getting-started'),
+ *         Nav('API Reference', '/docs/api-reference'),
+ *       ],
+ *     }),
+ *   ],
+ *   seo: {
+ *     titleTemplate: '%s | My Product',
+ *     description: 'Official documentation for My Product',
+ *     keywords: ['docs', 'api', 'reference'],
+ *   },
+ *   analytics: {
+ *     provider: 'plausible',
+ *     id: 'docs.example.com',
+ *   },
+ * })
+ * ```
+ */
+export declare function Site(config: Omit<SiteDefinition, 'type'>): SiteDefinition;
+/**
+ * Helper to create a navigation item
+ *
+ * @example
+ * ```ts
+ * const nav = Nav('Documentation', '/docs', {
+ *   icon: 'book',
+ *   children: [
+ *     Nav('Getting Started', '/docs/getting-started'),
+ *     Nav('API Reference', '/docs/api'),
+ *   ],
+ * })
+ * ```
+ */
+export declare function Nav(label: string, href: string, options?: Omit<NavigationDefinition, 'label' | 'href'>): NavigationDefinition;
+/**
+ * Helper to configure SEO
+ *
+ * @example
+ * ```ts
+ * const seo = SEO({
+ *   titleTemplate: '%s | My Site',
+ *   description: 'My awesome site',
+ *   keywords: ['keyword1', 'keyword2'],
+ *   ogImage: '/og-image.png',
+ *   twitterCard: 'summary_large_image',
+ * })
+ * ```
+ */
+export declare function SEO(config: SEOConfig): SEOConfig;
+/**
+ * Helper to configure analytics
+ *
+ * @example
+ * ```ts
+ * const analytics = Analytics('google', 'G-XXXXXXXXXX')
+ * const analytics = Analytics('plausible', 'example.com')
+ * ```
+ */
+export declare function Analytics(provider: AnalyticsConfig['provider'], id: string, config?: Record<string, unknown>): AnalyticsConfig;
+//# sourceMappingURL=site.d.ts.map

package/dist/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAGlG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,cAAc,CAmBzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,MAAM,CAAC,GACrD,oBAAoB,CAMtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAEhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,EACrC,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,eAAe,CAEjB"}

package/dist/site.js

@@ -0,0 +1,113 @@
+/**
+ * Site() - Define a website
+ */
+import { registerProduct } from './product.js';
+/**
+ * Create a site definition
+ *
+ * @example
+ * ```ts
+ * const docsSite = Site({
+ *   id: 'docs',
+ *   name: 'Documentation Site',
+ *   description: 'Product documentation',
+ *   version: '1.0.0',
+ *   generator: 'fumadocs',
+ *   structure: {
+ *     home: '/docs/index.mdx',
+ *     docs: [
+ *       '/docs/getting-started.mdx',
+ *       '/docs/api-reference.mdx',
+ *     ],
+ *   },
+ *   navigation: [
+ *     Nav('Home', '/'),
+ *     Nav('Docs', '/docs', {
+ *       children: [
+ *         Nav('Getting Started', '/docs/getting-started'),
+ *         Nav('API Reference', '/docs/api-reference'),
+ *       ],
+ *     }),
+ *   ],
+ *   seo: {
+ *     titleTemplate: '%s | My Product',
+ *     description: 'Official documentation for My Product',
+ *     keywords: ['docs', 'api', 'reference'],
+ *   },
+ *   analytics: {
+ *     provider: 'plausible',
+ *     id: 'docs.example.com',
+ *   },
+ * })
+ * ```
+ */
+export function Site(config) {
+    const site = {
+        type: 'site',
+        id: config.id,
+        name: config.name,
+        description: config.description,
+        version: config.version,
+        generator: config.generator || 'next',
+        structure: config.structure,
+        navigation: config.navigation,
+        seo: config.seo,
+        analytics: config.analytics,
+        deployment: config.deployment,
+        metadata: config.metadata,
+        tags: config.tags,
+        status: config.status || 'active',
+    };
+    return registerProduct(site);
+}
+/**
+ * Helper to create a navigation item
+ *
+ * @example
+ * ```ts
+ * const nav = Nav('Documentation', '/docs', {
+ *   icon: 'book',
+ *   children: [
+ *     Nav('Getting Started', '/docs/getting-started'),
+ *     Nav('API Reference', '/docs/api'),
+ *   ],
+ * })
+ * ```
+ */
+export function Nav(label, href, options) {
+    return {
+        label,
+        href,
+        ...options,
+    };
+}
+/**
+ * Helper to configure SEO
+ *
+ * @example
+ * ```ts
+ * const seo = SEO({
+ *   titleTemplate: '%s | My Site',
+ *   description: 'My awesome site',
+ *   keywords: ['keyword1', 'keyword2'],
+ *   ogImage: '/og-image.png',
+ *   twitterCard: 'summary_large_image',
+ * })
+ * ```
+ */
+export function SEO(config) {
+    return config;
+}
+/**
+ * Helper to configure analytics
+ *
+ * @example
+ * ```ts
+ * const analytics = Analytics('google', 'G-XXXXXXXXXX')
+ * const analytics = Analytics('plausible', 'example.com')
+ * ```
+ */
+export function Analytics(provider, id, config) {
+    return { provider, id, config };
+}
+//# sourceMappingURL=site.js.map

package/dist/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,IAAI,CAAC,MAAoC;IACvD,MAAM,IAAI,GAAmB;QAC3B,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM;QACrC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ;KAClC,CAAA;IAED,OAAO,eAAe,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,GAAG,CACjB,KAAa,EACb,IAAY,EACZ,OAAsD;IAEtD,OAAO;QACL,KAAK;QACL,IAAI;QACJ,GAAG,OAAO;KACX,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,GAAG,CAAC,MAAiB;IACnC,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CACvB,QAAqC,EACrC,EAAU,EACV,MAAgC;IAEhC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAA;AACjC,CAAC"}