@molecule/api-bonds-default-express 1.0.0

package/dist/schemas.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Common zod schemas extracted from inline duplicates across the fleet:
+ * - 91 apps inline `z.object({ id: z.string().min(1) })`
+ * - 43 apps inline `z.object({ id: z.string().uuid() })`
+ *
+ * @module
+ */
+import { z } from 'zod';
+/**
+ * Standard route-param schema for `:id`. Accepts any non-empty string.
+ * Pair with `validateParams(idParamSchema)`.
+ */
+export declare const idParamSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Strict variant of `idParamSchema` that requires a UUID. Use when the
+ * underlying column is a uuid.
+ */
+export declare const uuidParamSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;GAGG;AACH,eAAO,MAAM,aAAa;;iBAAsC,CAAA;AAEhE;;;GAGG;AACH,eAAO,MAAM,eAAe;;iBAAsC,CAAA"}

package/dist/schemas.js

@@ -0,0 +1,18 @@
+/**
+ * Common zod schemas extracted from inline duplicates across the fleet:
+ * - 91 apps inline `z.object({ id: z.string().min(1) })`
+ * - 43 apps inline `z.object({ id: z.string().uuid() })`
+ *
+ * @module
+ */
+import { z } from 'zod';
+/**
+ * Standard route-param schema for `:id`. Accepts any non-empty string.
+ * Pair with `validateParams(idParamSchema)`.
+ */
+export const idParamSchema = z.object({ id: z.string().min(1) });
+/**
+ * Strict variant of `idParamSchema` that requires a UUID. Use when the
+ * underlying column is a uuid.
+ */
+export const uuidParamSchema = z.object({ id: z.string().uuid() });

package/dist/setup.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Default Express-based API bond wirings.
+ *
+ * Centralizes the 10 byte-identical `api/src/bonds/<name>.ts` setup
+ * functions that every flagship app shipped before this package
+ * existed. Each function preserves the legacy name (`setupConfigEnv`,
+ * `setupDatabasePostgresql`, ...) so per-app `bonds/<name>.ts` files
+ * can become 1-line re-exports without changing `bonds/index.ts` call
+ * sites.
+ *
+ * @module
+ */
+/** Wires `@molecule/api-config-env` to `@molecule/api-config`. */
+export declare function setupConfigEnv(): void;
+/** Wires `@molecule/api-database-postgresql` to `@molecule/api-database`. */
+export declare function setupDatabasePostgresql(): void;
+/** Wires `@molecule/api-jwt-jsonwebtoken` to `@molecule/api-jwt`. */
+export declare function setupJwtJsonwebtoken(): void;
+/** Wires `@molecule/api-middleware-body-parser-express` to `@molecule/api-middleware-body-parser`. */
+export declare function setupMiddlewareBodyParserExpress(): void;
+/** Wires `@molecule/api-middleware-cookie-parser-express` to `@molecule/api-middleware-cookie-parser`. */
+export declare function setupMiddlewareCookieParserExpress(): void;
+/** Wires `@molecule/api-middleware-cors-express` to `@molecule/api-middleware-cors`. */
+export declare function setupMiddlewareCorsExpress(): void;
+/** Wires `@molecule/api-password-bcrypt` to `@molecule/api-password`. */
+export declare function setupPasswordBcrypt(): void;
+/** Wires `@molecule/api-secrets-env` to `@molecule/api-secrets`. */
+export declare function setupSecretsEnv(): void;
+/** Registers the device service from `@molecule/api-resource-device` on the bond system. */
+export declare function setupServiceDevice(): void;
+/** Wires `@molecule/api-two-factor-otplib` to `@molecule/api-two-factor`. */
+export declare function setupTwoFactorOtplib(): void;
+/** Wires `@molecule/api-emails-mailgun` to `@molecule/api-emails`. */
+export declare function setupEmailsMailgun(): void;
+/** Registers `@molecule/api-payments-stripe` as a named `'stripe'` payments provider. */
+export declare function setupPaymentsStripe(): void;
+/** Registers the plan + paymentRecord services from `@molecule/api-resource-payment`. */
+export declare function setupServicePayment(): void;
+/** Wires `@molecule/api-search-meilisearch` to `@molecule/api-search`. */
+export declare function setupSearchMeilisearch(): void;
+/** Wires `@molecule/api-uploads-s3` to `@molecule/api-uploads`. */
+export declare function setupUploadsS3(): void;
+/** Wires `@molecule/api-image-sharp` to `@molecule/api-image`. */
+export declare function setupImageSharp(): Promise<void>;
+/** Wires `@molecule/api-permissions-custom` to `@molecule/api-permissions`. */
+export declare function setupPermissionsCustom(): Promise<void>;
+/** Wires `@molecule/api-reporting-database` to `@molecule/api-reporting`. */
+export declare function setupReportingDatabase(): Promise<void>;
+/** Wires `@molecule/api-realtime-socketio` to `@molecule/api-realtime`. */
+export declare function setupRealtimeSocketio(): Promise<void>;
+/** Wires `@molecule/api-realtime-ws` to `@molecule/api-realtime`. */
+export declare function setupRealtimeWs(): Promise<void>;
+/** Wires `@molecule/api-realtime-sse` to `@molecule/api-realtime`. */
+export declare function setupRealtimeSse(): Promise<void>;
+/** Wires `@molecule/api-cron-node-cron` to `@molecule/api-cron`. */
+export declare function setupCronNodeCron(): Promise<void>;
+/** Wires `@molecule/api-encryption-aes` to `@molecule/api-encryption`. */
+export declare function setupEncryptionAes(): Promise<void>;
+/** Wires `@molecule/api-push-notifications-web-push` to `@molecule/api-push-notifications`. */
+export declare function setupPushNotificationsWebPush(): Promise<void>;
+/** Wires `@molecule/api-import-export-csv` to `@molecule/api-import-export`. */
+export declare function setupImportExportCsv(): Promise<void>;
+/** Registers `@molecule/api-ai-anthropic` as a named `'anthropic'` AI provider. */
+export declare function setupAiAnthropic(): Promise<void>;
+/** Wires `@molecule/api-audit-database` to `@molecule/api-audit`. */
+export declare function setupAuditDatabase(): Promise<void>;
+/** Wires `@molecule/api-pdf-pdfkit` to `@molecule/api-pdf`. */
+export declare function setupPdfPdfkit(): Promise<void>;
+/** Wires a no-op default analytics provider so `@molecule/api-analytics` calls succeed. */
+export declare function setupApiAnalyticsDefault(): Promise<void>;
+/** Wires `@molecule/api-geolocation-mapbox` to `@molecule/api-geolocation`. */
+export declare function setupGeolocationMapbox(): Promise<void>;
+/**
+ * Wires `@molecule/api-error-tracking-sentry` to `@molecule/api-error-tracking`.
+ *
+ * Safe to wire unconditionally: without `SENTRY_DSN` the Sentry provider is a
+ * documented no-op (the boot config report flags the missing key), so an app
+ * that hasn't configured Sentry yet boots and runs untouched.
+ */
+export declare function setupErrorTrackingSentry(): Promise<void>;
+/**
+ * Wires `@molecule/api-error-tracking-console` to `@molecule/api-error-tracking`.
+ *
+ * Zero-credential development default: captures are logged as structured
+ * lines through the bonded logger instead of being sent to a remote service.
+ */
+export declare function setupErrorTrackingConsole(): Promise<void>;
+/** Wires `@molecule/api-cache-redis` to `@molecule/api-cache`. */
+export declare function setupCacheRedis(): Promise<void>;
+/**
+ * Wires `@molecule/api-queue-memory` to `@molecule/api-queue` — the
+ * zero-credential in-process queue (single-process/dev; swap to
+ * redis/rabbitmq/sqs for multi-instance production).
+ */
+export declare function setupQueueMemory(): Promise<void>;
+/**
+ * Wires `@molecule/api-queue-redis` to `@molecule/api-queue`. Outside
+ * production, when `REDIS_URL` is absent, falls back to
+ * `@molecule/api-queue-memory` — the zero-credential in-process queue — so
+ * queue-backed features (background jobs, async delivery workers) run out of
+ * the box, mirroring `setupCacheRedis`.
+ */
+export declare function setupQueueRedis(): Promise<void>;
+/** Registers `@molecule/api-ai-openai` as a named `'openai'` AI provider. */
+export declare function setupAiOpenai(): Promise<void>;
+/** Wires `@molecule/api-ai-embeddings-openai` to `@molecule/api-ai-embeddings`. */
+export declare function setupAiEmbeddingsOpenai(): Promise<void>;
+/** Wires `@molecule/api-webhook-http` to `@molecule/api-webhook`. */
+export declare function setupWebhookHttp(): Promise<void>;
+/** Wires `@molecule/api-ai-vector-store-pgvector` to `@molecule/api-ai-vector-store`. */
+export declare function setupAiVectorStorePgvector(): Promise<void>;
+/** Wires `@molecule/api-ai-speech-openai` to `@molecule/api-ai-speech`. */
+export declare function setupAiSpeechOpenai(): Promise<void>;
+/** Wires `@molecule/api-workflow-database` to `@molecule/api-workflow`. */
+export declare function setupWorkflowDatabase(): Promise<void>;
+/** Wires `@molecule/api-http-fetch` to `@molecule/api-http`. */
+export declare function setupHttpFetch(): Promise<void>;
+/** Registers `@molecule/api-notifications-webhook` as a named `'webhook'` notifications provider. */
+export declare function setupNotificationsWebhook(): Promise<void>;
+/** Wires `@molecule/api-geolocation-google` to `@molecule/api-geolocation`. */
+export declare function setupGeolocationGoogle(): Promise<void>;
+/** Wires `@molecule/api-media-streaming-hls` to `@molecule/api-media-streaming`. */
+export declare function setupMediaStreamingHls(): Promise<void>;
+/**
+ * Wires `@molecule/api-rate-limit-memory` to `@molecule/api-rate-limit`.
+ *
+ * This is the default brute-force-protection backend for `mlcl`-generated apps
+ * (single-instance). Multi-instance deployments should swap in
+ * `@molecule/api-rate-limit-redis` so the throttle is shared across replicas.
+ */
+export declare function setupRateLimitMemory(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

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