@trokky/trokky 2.0.3

package/dist/adapters/filesystem/filesystem-adapter.d.ts

@@ -0,0 +1,80 @@
+import { StorageAdapter, Document, DocumentData, ListOptions, MediaFile, MediaMetadata, MediaListResult, Migration, User, UserListOptions, AppToken, AppTokenListOptions, WebhookConfig, WebhookListOptions, AuditContext } from '../../core/index.js';
+import { FilesystemAdapterConfig } from './types.js';
+/**
+ * @deprecated FilesystemAdapter is deprecated. Use the split storage architecture instead:
+ *
+ * ```ts
+ * // Old way (deprecated)
+ * const adapter = new FilesystemAdapter({ contentDir: './content', mediaDir: './media' })
+ *
+ * // New way (recommended)
+ * const trokky = await TrokkyExpress.create({
+ *   storage: {
+ *     data: { adapter: 'filesystem-data', options: { contentDir: './data/content' } },
+ *     media: { adapter: 'filesystem-media', options: { mediaDir: './data/media' } }
+ *   }
+ * })
+ * ```
+ *
+ * This provides better separation of concerns, improved scalability, and clearer configuration.
+ * See migration guide in docs for more details.
+ */
+export declare class FilesystemAdapter implements StorageAdapter {
+    private config;
+    private readonly MAX_FILE_SIZE;
+    private readonly MAX_DOCUMENT_SIZE;
+    constructor(config?: FilesystemAdapterConfig);
+    private initializeDirectories;
+    getDocument(collection: string, id: string): Promise<Document | null>;
+    saveDocument(collection: string, id: string, data: DocumentData, auditContext?: AuditContext): Promise<Document>;
+    listDocuments(collection: string, options?: ListOptions): Promise<Document[]>;
+    deleteDocument(collection: string, id: string): Promise<void>;
+    uploadFile(file: File, metadata: MediaMetadata): Promise<MediaFile>;
+    getFile(id: string): Promise<MediaFile | null>;
+    updateFile(id: string, metadata: Record<string, any>): Promise<MediaFile>;
+    getFileContent(id: string): Promise<ArrayBuffer | null>;
+    deleteFile(id: string): Promise<void>;
+    listMedia(options?: ListOptions): Promise<MediaListResult>;
+    getUser(id: string): Promise<User | null>;
+    saveUser(id: string, userData: Partial<User>): Promise<User>;
+    listUsers(options?: UserListOptions): Promise<User[]>;
+    deleteUser(id: string): Promise<void>;
+    getUserByUsername(username: string): Promise<User | null>;
+    getUserByEmail(email: string): Promise<User | null>;
+    getUserByOAuthProvider(provider: string, providerId: string): Promise<User | null>;
+    getAppToken(id: string): Promise<AppToken | null>;
+    saveAppToken(id: string, tokenData: Partial<AppToken>): Promise<AppToken>;
+    listAppTokens(options?: AppTokenListOptions): Promise<AppToken[]>;
+    deleteAppToken(id: string): Promise<void>;
+    getAppTokenByHash(hash: string): Promise<AppToken | null>;
+    getWebhook(id: string): Promise<WebhookConfig | null>;
+    saveWebhook(id: string, webhookData: Partial<WebhookConfig>): Promise<WebhookConfig>;
+    listWebhooks(options?: WebhookListOptions): Promise<WebhookConfig[]>;
+    deleteWebhook(id: string): Promise<void>;
+    private getTokenPath;
+    private getWebhookPath;
+    private matchesEventPattern;
+    healthCheck(): Promise<boolean>;
+    migrate(migrations: Migration[]): Promise<void>;
+    private getDocumentPath;
+    private getMediaPath;
+    private getMediaMetadataPath;
+    private getUserPath;
+    private validateSecurePath;
+    private validateFileExtension;
+    private validateMediaMetadata;
+    private safeParseJSON;
+    private atomicWriteFile;
+    private dateReplacer;
+    private dateReviver;
+    private reviveDatesInObject;
+    private fileToBuffer;
+    private matchesFilter;
+    private sortDocuments;
+    saveVariantFile(parentId: string, variantName: string, buffer: Buffer, format: string): Promise<string>;
+    getVariantUrl(parentId: string, variantName: string): string;
+    private updateVariantUrls;
+    getVariantContent(parentId: string, variantName: string): Promise<ArrayBuffer | null>;
+    deleteVariantFiles(parentId: string): Promise<void>;
+}
+//# sourceMappingURL=filesystem-adapter.d.ts.map

package/dist/adapters/filesystem/filesystem-adapter.d.ts.map

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