diff --git a/couchbase.android.ts b/couchbase.android.ts index e2fe7e4..3fd8f52 100644 --- a/couchbase.android.ts +++ b/couchbase.android.ts @@ -11,11 +11,21 @@ export class Couchbase { private manager: any; private database: any; - public constructor(databaseName: string) { + + public constructor(databaseName: string, encryptionKey?:string) { this.context = utils.ad.getApplicationContext(); try { this.manager = new com.couchbase.lite.Manager(new com.couchbase.lite.android.AndroidContext(this.context), null); - this.database = this.manager.getDatabase(databaseName); + if(!encryptionKey){ + this.database = this.manager.getDatabase(databaseName); + }else{ + let databaseOptions:any = new com.couchbase.lite.DatabaseOptions(); + databaseOptions.setCreate(true); + databaseOptions.setEncryptionKey(encryptionKey); + this.database = this.manager.openDatabase(databaseName, databaseOptions); + } + + } catch (exception) { console.error("MANAGER ERROR:", exception.message); } diff --git a/couchbase.d.ts b/couchbase.d.ts index b26a734..c348c46 100644 --- a/couchbase.d.ts +++ b/couchbase.d.ts @@ -1,12 +1,14 @@ declare module "nativescript-couchbase" { export class Couchbase { - constructor(databaseName: string); + constructor(databaseName: string, encryptionKey?: string); createDocument(data: Object, documentId?: string); getDocument(documentId: string); updateDocument(documentId: string, data: any); deleteDocument(documentId: string); destroyDatabase(); + closeDatabase():boolean; + openDatabase(name: string, key?: string); createView(viewName: string, viewRevision: string, callback: any); executeQuery(viewName: string, options?: any); createPullReplication(remoteUrl: string); diff --git a/couchbase.ios.ts b/couchbase.ios.ts index d55b572..3cc70cc 100644 --- a/couchbase.ios.ts +++ b/couchbase.ios.ts @@ -13,14 +13,19 @@ export class Couchbase { private manager: any; private database: any; - constructor(databaseName: String){ + constructor(databaseName: String, encryptionKey?:string){ this.manager = CBLManager.sharedInstance(); if (!this.manager){ console.log("MANAGER ERROR:Can not create share instance of CBLManager"); } var errorRef = new interop.Reference(); - - this.database = this.manager.databaseNamedError(databaseName, errorRef); + if(!encryptionKey){ + this.database = this.manager.databaseNamedError(databaseName, errorRef); + } else { + this.database = this.manager.registerEncryptionKeyForDatabaseNamed(databaseName, encryptionKey); + this.database = this.manager.databaseNamedError(databaseName, errorRef); + } + if (!this.database){ console.log(errorRef.value); @@ -190,6 +195,10 @@ export class Couchbase { } } + closeDatabase(){ + return this.database.close(); + } + private mapToJson(properties: Object){ var errorRef = new interop.Reference(); var result = ""; diff --git a/ng-demo/app/app.routing.ts b/ng-demo/app/app.routing.ts index 97ed102..1736e8b 100644 --- a/ng-demo/app/app.routing.ts +++ b/ng-demo/app/app.routing.ts @@ -1,13 +1,16 @@ import { Routes } from "@angular/router"; import { ListComponent } from "./components/list/list.component"; import { CreateComponent } from "./components/create/create.component"; +import { EncryptionComponent } from "./components/encryption/encryption.component"; export const appRoutes: Routes = [ { path: '', component: ListComponent }, - { path: "create", component: CreateComponent } + { path: "create", component: CreateComponent }, + { path: "encryption", component: EncryptionComponent } ]; export const appComponents: any = [ ListComponent, - CreateComponent + CreateComponent, + EncryptionComponent ]; \ No newline at end of file diff --git a/ng-demo/app/components/encryption/encryption.component.html b/ng-demo/app/components/encryption/encryption.component.html new file mode 100644 index 0000000..d96da32 --- /dev/null +++ b/ng-demo/app/components/encryption/encryption.component.html @@ -0,0 +1,19 @@ + + + + + + + + + + + + + + + + + + + diff --git a/ng-demo/app/components/encryption/encryption.component.ts b/ng-demo/app/components/encryption/encryption.component.ts new file mode 100644 index 0000000..801572d --- /dev/null +++ b/ng-demo/app/components/encryption/encryption.component.ts @@ -0,0 +1,47 @@ +import {Component} from "@angular/core"; +import {Location} from "@angular/common"; +import {CouchbaseInstance} from "../../couchbaseinstance"; + +@Component({ + selector: "encryption", + templateUrl: "./components/encryption/encryption.component.html" +}) +export class EncryptionComponent { + + //private couchbaseInstance: CouchbaseInstance; + private database: any; + logs: Array; + state: string; + + constructor(location: Location,private couchbaseInstance: CouchbaseInstance) { + + this.logs= new Array(); + //if(this.couchbaseInstance && th) + } + + save() { + // if(this.firstname != "" && this.lastname != "") { + // this.database.createDocument({ + // "firstname": this.firstname, + // "lastname": this.lastname + // }); + // this.location.back(); + // } + } + + open(name:string, key: string){ + this.database = this.couchbaseInstance.openDatabase(name, key); + if(!this.database){ + this.logs.push("Error on open database") + } + } + + close(){ + if(this.couchbaseInstance.closeDatabase()){ + this.logs.push("closed database") + }else { + this.logs.push("Error closing database"); + } + } + +} diff --git a/ng-demo/app/components/list/list.component.html b/ng-demo/app/components/list/list.component.html index 8559616..309f64a 100644 --- a/ng-demo/app/components/list/list.component.html +++ b/ng-demo/app/components/list/list.component.html @@ -1,10 +1,21 @@ - + + + + + + + + + + + + diff --git a/ng-demo/app/components/list/list.component.ts b/ng-demo/app/components/list/list.component.ts index 7532967..6baad9d 100644 --- a/ng-demo/app/components/list/list.component.ts +++ b/ng-demo/app/components/list/list.component.ts @@ -1,4 +1,4 @@ -import {Component, NgZone} from "@angular/core"; +import { Component, NgZone, OnInit } from '@angular/core'; import {Router} from "@angular/router"; import {Location} from "@angular/common"; import {CouchbaseInstance} from "../../couchbaseinstance"; @@ -7,20 +7,31 @@ import {CouchbaseInstance} from "../../couchbaseinstance"; selector: "my-app", templateUrl: "./components/list/list.component.html", }) -export class ListComponent { +export class ListComponent implements OnInit{ private database: any; private router: Router; private ngZone: NgZone; public personList: Array; - constructor(router: Router, location: Location, ngZone: NgZone, couchbaseInstance: CouchbaseInstance) { + constructor(router: Router, location: Location, ngZone: NgZone,public couchbaseInstance: CouchbaseInstance) { this.router = router; this.ngZone = ngZone; - this.database = couchbaseInstance.getDatabase(); + // this.database = couchbaseInstance.getDatabase(); this.personList = []; + location.subscribe((path) => { + this.refresh(); + }); + + } - couchbaseInstance.startSync(true); + ngOnInit(){ + if(!this.couchbaseInstance.getDatabase()){ + this.database = this.couchbaseInstance.openDatabase("mypassword"); + }else{ + this.database = this.couchbaseInstance.getDatabase(); + } + this.database.addDatabaseChangeListener((changes) => { let changeIndex; @@ -38,9 +49,7 @@ export class ListComponent { } }); - location.subscribe((path) => { - this.refresh(); - }); + this.refresh(); } @@ -49,12 +58,25 @@ export class ListComponent { this.router.navigate(["create"]); } + encryption(){ + this.router.navigate(["encryption"]); + } + + + + + private refresh() { this.personList = []; - let rows = this.database.executeQuery("people"); - for(let i = 0; i < rows.length; i++) { - this.personList.push(rows[i]); + if(this.database){ + let rows = this.database.executeQuery("people"); + for(let i = 0; i < rows.length; i++) { + this.personList.push(rows[i]); + } + }else{ + console.log("cant run database query on refresh, database is null"); } + } private indexOfObjectId(needle: string, haystack: any) { diff --git a/ng-demo/app/couchbaseinstance.ts b/ng-demo/app/couchbaseinstance.ts index 59e0dc5..85e45cf 100644 --- a/ng-demo/app/couchbaseinstance.ts +++ b/ng-demo/app/couchbaseinstance.ts @@ -10,33 +10,40 @@ export class CouchbaseInstance { private push: any; constructor() { - if(!this.isInstantiated) { - this.database = new Couchbase("test-database"); - this.database.createView("people", "1", (document, emitter) => { - emitter.emit(document._id, document); - }); - this.isInstantiated = true; - } + } - getDatabase() { + closeDatabase(){ + return this.database.closeDatabase(); + } + + openDatabase(name: string, key?: string){ + + this.database = new Couchbase(name,key); + this.database.createView("people", "1", (document, emitter) => { + emitter.emit(document._id, document); + }); + return this.database; + } + + getDatabase(): Couchbase { return this.database; } startSync(continuous: boolean) { - this.push = this.database.createPushReplication("http://192.168.57.1:4984/test-database"); - this.pull = this.database.createPullReplication("http://192.168.57.1:4984/test-database"); + // this.push = this.database.createPushReplication("http://192.168.57.1:4984/test-database"); + // this.pull = this.database.createPullReplication("http://192.168.57.1:4984/test-database"); - this.push.setContinuous(continuous); - this.pull.setContinuous(continuous); + // this.push.setContinuous(continuous); + // this.pull.setContinuous(continuous); - this.push.start(); - this.pull.start(); + // this.push.start(); + // this.pull.start(); } stopSync() { - this.push.stop(); - this.pull.stop(); + // this.push.stop(); + // this.pull.stop(); } } diff --git a/package.json b/package.json index 78dc274..5b336bf 100644 --- a/package.json +++ b/package.json @@ -20,6 +20,7 @@ "android-angular": "npm run prepare-angular; cd ng-demo; tns run android", "android-vanilla": "npm run prepare-vanilla; cd demo; tns run android", "ios-angular": "npm run prepare-angular; cd ng-demo; tns emulate ios", + "ios-angular-deploy": "npm run prepare-angular; cd ng-demo; tns deploy ios", "ios-vanilla": "npm run prepare-vanilla; cd demo; tns emulate ios" }, "repository": { diff --git a/platforms/android/include.gradle b/platforms/android/include.gradle index 14c145f..8f1ffd8 100644 --- a/platforms/android/include.gradle +++ b/platforms/android/include.gradle @@ -4,6 +4,7 @@ repositories { dependencies { compile 'com.couchbase.lite:couchbase-lite-android:1.3.1' + compile 'com.couchbase.lite:couchbase-lite-android-sqlcipher:+' compile 'com.google.code.gson:gson:2.6.2' } diff --git a/platforms/ios/CouchbaseLite.framework/CouchbaseLite b/platforms/ios/CouchbaseLite.framework/CouchbaseLite deleted file mode 100755 index ea77fed..0000000 Binary files a/platforms/ios/CouchbaseLite.framework/CouchbaseLite and /dev/null differ diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLAttachment.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLAttachment.h deleted file mode 100755 index 10b0471..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLAttachment.h +++ /dev/null @@ -1,65 +0,0 @@ -// -// CBLAttachment.h -// CouchbaseLite -// -// Created by Jens Alfke on 6/21/12. -// Copyright (c) 2012-2013 Couchbase, Inc. All rights reserved. -// - -#import -@class CBLDocument, CBLRevision, CBLSavedRevision; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** A binary attachment to a document revision. - Existing attachments can be gotten from -[CBLRevision attachmentNamed:]. - New attachments can be created by calling the -setAttachment:... methods of CBLNewRevision or - CBLModel. */ -@interface CBLAttachment : NSObject - -/** The owning document revision. */ -@property (readonly, retain) CBLRevision* revision; - -/** The owning document. */ -@property (readonly) CBLDocument* document; - -/** The filename. */ -@property (readonly, copy) NSString* name; - -/** The MIME type of the contents. */ -@property (readonly, nullable) NSString* contentType; - -/** The length in bytes of the contents. */ -@property (readonly) UInt64 length; - -/** The CouchbaseLite metadata about the attachment, that lives in the document. */ -@property (readonly) NSDictionary* metadata; - -/** The data of the attachment. */ -@property (readonly, nullable) NSData* content; - -/** Returns a stream from which you can read the data of the attachment. - Remember to close it when you're done. */ -- (NSInputStream*) openContentStream; - -/** The (file:) URL of the file containing the contents. - This property is somewhat deprecated and is made available only for use with platform APIs that - require file paths/URLs, e.g. some media playback APIs. Whenever possible, use the `content` - property or the `openContentStream` method instead. - The file must be treated as read-only! DO NOT MODIFY OR DELETE IT. - If the database is encrypted, attachment files are also encrypted and not directly readable, - so this property will return nil. */ -@property (readonly, nullable) NSURL* contentURL; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLAuthenticator.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLAuthenticator.h deleted file mode 100755 index 0f3c1e8..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLAuthenticator.h +++ /dev/null @@ -1,67 +0,0 @@ -// -// CBLAuthenticator.h -// CouchbaseLite -// -// Created by Jens Alfke on 4/11/14. -// Copyright (c) 2014 Couchbase, Inc. All rights reserved. - - -#import - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** The CBLAuthenticator protocol defines objects that can authenticate a user to a remote database - server. An object conforming to this protocol is acquired from the CBLAuthenticator _class_'s - factory methods, and is used by setting it as a CBLReplication's .authenticator property. - This protocol is currently entirely opaque and not intended for applications to implement. - The authenticator types are limited to those createable by factory methods. */ -@protocol CBLAuthenticator -// No user-servicable parts inside. -@end - - -/** The CBLAuthenticator class provides factory methods for creating authenticator objects, for use - with the .authenticator property of a CBLReplication. */ -@interface CBLAuthenticator : NSObject - -/** Creates an authenticator that will log in using HTTP Basic auth with the given user name and - password. This should only be used over an SSL/TLS connection, as otherwise it's very easy for - anyone sniffing network traffic to read the password. */ -+ (id) basicAuthenticatorWithName: (NSString*)name - password: (NSString*)password; - -/** Creates an authenticator that will authenticate to a Couchbase Sync Gateway server using - Facebook credentials. The token string must be an active Facebook login token. On iOS you can - acquire one from the Accounts framework, or you can use Facebook's SDK to implement the - login process. */ -+ (id) facebookAuthenticatorWithToken: (NSString*)token; - -/** Creates an authenticator that will authenticate to a Couchbase Sync Gateway server using the - user's email address, with the Persona protocol (http://persona.org). The "assertion" token - must have been acquired using the client-side Persona auth procedure; you can use the library - https://github.com/couchbaselabs/browserid-ios to do this. */ -+ (id) personaAuthenticatorWithAssertion: (NSString*)assertion; - -/** Creates an authenticator that will authenticate to a CouchDB server using OAuth version 1. - The parameters must have been acquired using the client-side OAuth login procedure. There are - several iOS and Mac implementations of this, such as - https://github.com/couchbaselabs/ios-oauthconsumer */ -+ (id) OAuth1AuthenticatorWithConsumerKey: (NSString*)consumerKey - consumerSecret: (NSString*)consumerSecret - token: (NSString*)token - tokenSecret: (NSString*)tokenSecret - signatureMethod: (NSString*)signatureMethod; - -@end - - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLDatabase.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLDatabase.h deleted file mode 100755 index 7da4a45..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLDatabase.h +++ /dev/null @@ -1,265 +0,0 @@ -// -// CBLDatabase.h -// CouchbaseLite -// -// Created by Jens Alfke on 6/17/12. -// Copyright (c) 2012-2013 Couchbase, Inc. All rights reserved. -// - -#import -#import "CBLView.h" -@class CBLManager, CBLDocument, CBLRevision, CBLSavedRevision, CBLView, CBLQuery, CBLReplication; -@protocol CBLValidationContext; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** Validation block, used to approve revisions being added to the database. - The block should call `[context reject]` or `[context rejectWithMessage:]` if the proposed - new revision is invalid. */ -typedef void (^CBLValidationBlock) (CBLRevision* newRevision, - id context); - -#define VALIDATIONBLOCK(BLOCK) ^void(CBLRevision* newRevision, id context)\ - {BLOCK} - -/** Filter block, used in changes feeds and replication. */ -typedef BOOL (^CBLFilterBlock) (CBLSavedRevision* revision, NSDictionary* __nullable params); - -#define FILTERBLOCK(BLOCK) ^BOOL(CBLSavedRevision* revision, NSDictionary* params) {BLOCK} - - -/** An external object that knows how to convert source code into an executable filter. */ -@protocol CBLFilterCompiler -- (CBLFilterBlock) compileFilterFunction: (NSString*)filterSource language: (NSString*)language; -@end - - -/** A CouchbaseLite database. */ -@interface CBLDatabase : NSObject - -/** The database's name. */ -@property (readonly) NSString* name; - -/** The database manager that owns this database. */ -@property (readonly) CBLManager* manager; - -/** The number of documents in the database. */ -@property (readonly) NSUInteger documentCount; - -/** The latest sequence number used. - Every new revision is assigned a new sequence number, so this property increases monotonically - as changes are made to the database. It can be used to check whether the database has changed - between two points in time. */ -@property (readonly) SInt64 lastSequenceNumber; - -/** The URL of the database in the REST API. You can access this URL within this process, - using NSURLConnection or other APIs that use that (such as XMLHTTPRequest inside a WebView), - but it isn't available outside the process. - This method is only available if you've linked with the CouchbaseLiteListener framework. */ -@property (readonly) NSURL* internalURL; - - -#pragma mark - HOUSEKEEPING: - -/** Closes a database. - This first stops all replications, and calls -saveAllModels: to save changes to CBLModel - objects. It returns NO if some models failed to save. */ -- (BOOL) close: (NSError**)error; - -/** Compacts the database file by purging non-current JSON bodies, pruning revisions older than - the maxRevTreeDepth, deleting unused attachment files, and vacuuming the SQLite database. */ -- (BOOL) compact: (NSError**)outError; - -/** The maximum depth of a document's revision tree (or, max length of its revision history.) - Revisions older than this limit will be deleted during a -compact: operation. - Smaller values save space, at the expense of making document conflicts somewhat more likely. */ -@property NSUInteger maxRevTreeDepth; - -/** Deletes the database. */ -- (BOOL) deleteDatabase: (NSError**)outError; - -/** Changes the database's unique IDs to new random values. - Ordinarily you should never need to call this method; it's only made public to fix databases - that are already affected by bug github.com/couchbase/couchbase-lite-ios/issues/145 . - Make sure you only call this once, to fix that problem, because every call has the side effect - of resetting all replications, making them run slow the next time. */ -- (BOOL) replaceUUIDs: (NSError**)outError; - - -#pragma mark - DOCUMENT ACCESS: - -/** Instantiates a CBLDocument object with the given ID. - Doesn't touch the on-disk database; a document with that ID doesn't even need to exist yet. - CBLDocuments are cached, so there will never be more than one instance (in this database) - at a time with the same documentID. */ -- (nullable CBLDocument*) documentWithID: (NSString*)docID; - -/** Instantiates a CBLDocument object with the given ID. - Unlike -documentWithID: this method loads the document from the database, and returns nil if - no such document exists. - CBLDocuments are cached, so there will never be more than one instance (in this database) - at a time with the same documentID. */ -- (nullable CBLDocument*) existingDocumentWithID: (NSString*)docID; - -/** Same as -documentWithID:. Enables "[]" access in Xcode 4.4+ */ -- (CBLDocument*)objectForKeyedSubscript: (NSString*)key; - -/** Creates a new CBLDocument object with no properties and a new (random) UUID. - The document will be saved to the database when you call -putProperties: on it. */ -- (CBLDocument*) createDocument; - - -#pragma mark - LOCAL DOCUMENTS: - - -/** Returns the contents of the local document with the given ID, or nil if none exists. */ -- (nullable NSDictionary*) existingLocalDocumentWithID: (NSString*)localDocID; - -/** Sets the contents of the local document with the given ID. Unlike CouchDB, no revision-ID - checking is done; the put always succeeds. If the properties dictionary is nil, the document - will be deleted. */ -- (BOOL) putLocalDocument: (nullable NSDictionary*)properties - withID: (NSString*)localDocID - error: (NSError**)outError; - -/** Deletes the local document with the given ID. */ -- (BOOL) deleteLocalDocumentWithID: (NSString*)localDocID - error: (NSError**)outError ; - - -#pragma mark - VIEWS AND OTHER CALLBACKS: - -/** Returns a query that matches all documents in the database. - This is like querying an imaginary view that emits every document's ID as a key. */ -- (CBLQuery*) createAllDocumentsQuery; - -/** Creates a one-shot query with the given map function. This is equivalent to creating an - anonymous CBLView and then deleting it immediately after querying it. It may be useful during - development, but in general this is inefficient if this map will be used more than once, - because the entire view has to be regenerated from scratch every time. */ -- (CBLQuery*) slowQueryWithMap: (CBLMapBlock)mapBlock; - -/** Returns a CBLView object for the view with the given name. - (This succeeds even if the view doesn't already exist, but the view won't be added to the database until the CBLView is assigned a map function.) */ -- (CBLView*) viewNamed: (NSString*)name; - -/** Returns the existing CBLView with the given name, or nil if none. */ -- (nullable CBLView*) existingViewNamed: (NSString*)name; - -/** Defines or clears a named document validation function. - Before any change to the database, all registered validation functions are called and given a - chance to reject it. (This includes incoming changes from a pull replication.) */ -- (void) setValidationNamed: (NSString*)validationName - asBlock: (nullable CBLValidationBlock)validationBlock; - -/** Returns the existing document validation function (block) registered with the given name. - Note that validations are not persistent -- you have to re-register them on every launch. */ -- (nullable CBLValidationBlock) validationNamed: (NSString*)validationName; - -/** Defines or clears a named filter function. - Filters are used by push replications to choose which documents to send. */ -- (void) setFilterNamed: (NSString*)filterName asBlock: (nullable CBLFilterBlock)filterBlock; - -/** Returns the existing filter function (block) registered with the given name. - Note that filters are not persistent -- you have to re-register them on every launch. */ -- (nullable CBLFilterBlock) filterNamed: (NSString*)filterName; - -/** Registers an object that can compile source code into executable filter blocks. */ -+ (void) setFilterCompiler: (nullable id)compiler; - -/** Returns the currently registered filter compiler (nil by default). */ -+ (nullable id) filterCompiler; - - -#pragma mark - TRANSACTIONS / THREADING: - -/** Runs the block within a transaction. If the block returns NO, the transaction is rolled back. - Use this when performing bulk write operations like multiple inserts/updates; it saves the - overhead of multiple SQLite commits, greatly improving performance. */ -- (BOOL) inTransaction: (BOOL(^)(void))block; - -/** Runs the block asynchronously on the database's dispatch queue or thread. - Unlike the rest of the API, this can be called from any thread, and provides a limited form - of multithreaded access to Couchbase Lite. */ -- (void) doAsync: (void (^)())block; - -/** Runs the block _synchronously_ on the database's dispatch queue or thread: this method does - not return until after the block has completed. - Unlike the rest of the API, this can _only_ be called from other threads/queues: If you call it - from the same thread or dispatch queue that the database runs on, **it will deadlock!** */ -- (void) doSync: (void (^)())block; - - -#pragma mark - REPLICATION: - -/** Returns an array of all current, running CBLReplications involving this database. */ -- (NSArray*) allReplications; - -/** Creates a replication that will 'push' this database to a remote database at the given URL. - This always creates a new replication, even if there is already one to the given URL. - You must call -start on the replication to start it. */ -- (nullable CBLReplication*) createPushReplication: (NSURL*)url; - -/** Creates a replication that will 'pull' from a remote database at the given URL to this database. - This always creates a new replication, even if there is already one from the given URL. - You must call -start on the replication to start it. */ -- (nullable CBLReplication*) createPullReplication: (NSURL*)url; - - -@end - - - - -/** This notification is posted by a CBLDatabase in response to document changes. - The notification's userInfo dictionary's "changes" key contains an NSArray of - CBLDatabaseChange objects that describe the revisions that were added. */ -extern NSString* const kCBLDatabaseChangeNotification; - - - - -/** The type of callback block passed to -[CBLValidationContext enumerateChanges:]. */ -typedef BOOL (^CBLChangeEnumeratorBlock) (NSString* key, - __nullable id oldValue, - __nullable id newValue); - - - -/** Context passed into a CBLValidationBlock. */ -@protocol CBLValidationContext - -/** The contents of the current revision of the document, or nil if this is a new document. */ -@property (readonly, nullable) CBLSavedRevision* currentRevision; - -/** Rejects the proposed new revision. */ -- (void) reject; - -/** Rejects the proposed new revision. Any resulting error will contain the provided message; - for example, if the change came from an external HTTP request, the message will be in the - response status line. The default message is "invalid document". */ -- (void) rejectWithMessage: (NSString*)message; - - -#pragma mark - CONVENIENCE METHODS: - -/** Returns an array of all the keys whose values are different between the current and new revisions. */ -@property (readonly) NSArray* changedKeys; - -/** Calls the 'enumerator' block for each key that's changed, passing both the old and new values. - If the block returns NO, the enumeration stops and rejects the revision, and the method returns - NO; else the method returns YES. */ -- (BOOL) validateChanges: (CBLChangeEnumeratorBlock)enumerator; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLDatabaseChange.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLDatabaseChange.h deleted file mode 100755 index 8a1b666..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLDatabaseChange.h +++ /dev/null @@ -1,46 +0,0 @@ -// -// CBLDatabaseChange.h -// CouchbaseLite -// -// Created by Jens Alfke on 1/18/13. -// Copyright (c) 2013 Couchbase, Inc. All rights reserved. -// -// - -#import - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** Identifies a change to a database, that is, a newly added document revision. - The CBLDocumentChangeNotification contains one of these in the "change" key of its - userInfo dictionary, and CBLDatabaseChangeNotification contains an NSArray in "changes". */ -@interface CBLDatabaseChange : NSObject - -/** The ID of the document that changed. */ -@property (readonly) NSString* documentID; - -/** The ID of the newly-added revision. */ -@property (readonly) NSString* revisionID; - -/** Is the new revision the document's current (default, winning) one? - If not, there's a conflict. */ -@property (readonly) BOOL isCurrentRevision; - -/** YES if the document is in conflict. (The conflict might pre-date this change.) */ -@property (readonly) BOOL inConflict; - -/** The remote database URL that this change was pulled from, if any. */ -@property (readonly, nullable) NSURL* source; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLDocument.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLDocument.h deleted file mode 100755 index 92a6ec0..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLDocument.h +++ /dev/null @@ -1,150 +0,0 @@ -// -// CBLDocument.h -// CouchbaseLite -// -// Created by Jens Alfke on 6/4/12. -// Copyright (c) 2012-2013 Couchbase, Inc. All rights reserved. -// - -#import "CBLDatabase.h" -@class CBLSavedRevision, CBLUnsavedRevision, CBLDatabaseChange; -@protocol CBLDocumentModel; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** A CouchbaseLite document (as opposed to any specific revision of it.) */ -@interface CBLDocument : NSObject - -/** The document's owning database. */ -@property (readonly) CBLDatabase* database; - -/** The document's ID. */ -@property (readonly) NSString* documentID; - -/** An abbreviated form of the the documentID that looks like "xxxx..xxxx". Useful in logging. */ -@property (readonly) NSString* abbreviatedID; - -/** Is this document deleted? (That is, does its current revision have the '_deleted' property?) */ -@property (readonly) BOOL isDeleted; - -/** Has this document either been deleted or removed from available Sync Gateway channels? - (That is, does its current revision have a '_deleted' or '_removed' property?) */ -@property (readonly) BOOL isGone; - -/** Deletes this document by adding a deletion revision. - This will be replicated to other databases. */ -- (BOOL) deleteDocument: (NSError**)outError; - -/** Purges this document from the database; this is more than deletion, it forgets entirely about it. - The purge will NOT be replicated to other databases. */ -- (BOOL) purgeDocument: (NSError**)outError; - - -#pragma mark REVISIONS: - -/** The ID of the current revision (if known; else nil). */ -@property (readonly, copy, nullable) NSString* currentRevisionID; - -/** The current/latest revision. This object is cached. */ -@property (readonly, nullable) CBLSavedRevision* currentRevision; - -/** The revision with the specified ID. */ -- (nullable CBLSavedRevision*) revisionWithID: (NSString*)revisionID; - -/** Returns the document's history as an array of CBLRevisions. (See CBLRevision's method.) */ -- (nullable NSArray*) getRevisionHistory: (NSError**)outError; - -/** Returns all the current conflicting revisions of the document. If the document is not - in conflict, only the single current revision will be returned. */ -- (nullable NSArray*) getConflictingRevisions: (NSError**)outError; - -/** Returns all the leaf revisions in the document's revision tree, - including deleted revisions (i.e. previously-resolved conflicts.) */ -- (nullable NSArray*) getLeafRevisions: (NSError**)outError; - -/** Creates an unsaved new revision whose parent is the currentRevision, - or which will be the first revision if the document doesn't exist yet. - You can modify this revision's properties and attachments, then save it. - No change is made to the database until/unless you save the new revision. */ -- (CBLUnsavedRevision*) newRevision; - - -#pragma mark PROPERTIES: - -/** The contents of the current revision of the document. - This is shorthand for self.currentRevision.properties. - Any keys in the dictionary that begin with "_", such as "_id" and "_rev", contain CouchbaseLite - metadata. */ -@property (readonly, copy, nullable) NSDictionary* properties; - -/** The user-defined properties, without the ones reserved by CouchDB. - This is based on -properties, with every key whose name starts with "_" removed. */ -@property (readonly, copy, nullable) NSDictionary* userProperties; - -/** Shorthand for [self.properties objectForKey: key]. */ -- (nullable id) propertyForKey: (NSString*)key; - -/** Same as -propertyForKey:. Enables "[]" access in Xcode 4.4+ */ -- (nullable id)objectForKeyedSubscript:(NSString*)key; - -/** Saves a new revision. The properties dictionary must have a "_rev" property whose ID matches the current revision's (as it will if it's a modified copy of this document's .properties - property.) */ -- (nullable CBLSavedRevision*) putProperties: (NSDictionary*)properties - error: (NSError**)outError; - -/** Saves a new revision by letting the caller update the existing properties. - This method handles conflicts by retrying (calling the block again). - The block body should modify the properties of the new revision and return YES to save or - NO to cancel. Be careful: the block can be called multiple times if there is a conflict! - @param block Will be called on each attempt to save. Should update the given revision's - properties and then return YES, or just return NO to cancel. - @param outError Will point to the error, if the method returns nil. (If the callback block - cancels by returning nil, the error will be nil.) If this parameter is NULL, no - error will be stored. - @return The new saved revision, or nil on error or cancellation. - */ -- (nullable CBLSavedRevision*) update: (BOOL(^)(CBLUnsavedRevision*))block - error: (NSError**)outError; - - -#pragma mark MODEL: - -/** Optional reference to an application-defined model object representing this document. - Usually this is a CBLModel, but you can implement your own model classes if you want. - Note that this is a weak reference. */ -@property (weak, nullable) id modelObject; - - -@end - - - -/** Protocol that CBLDocument model objects must implement. See the CBLModel class. */ -@protocol CBLDocumentModel -/** Called whenever a new revision is added to the document. - (Equivalent to kCBLDocumentChangeNotification.) */ -- (void) document: (CBLDocument*)doc - didChange: (CBLDatabaseChange*)change; -@end - - - -/** This notification is posted by a CBLDocument in response to a change, i.e. a new revision. - The notification's userInfo contains a "change" property whose value is a CBLDatabaseChange - containing details of the change. - NOTE: This is *not* a way to detect changes to all documents. Only already-existing CBLDocument - objects will post this notification, so when a document changes in the database but there is - not currently any CBLDocument instance representing it, no notification will be posted. - If you want to observe all document changes in a database, use kCBLDatabaseChangeNotification.*/ -extern NSString* const kCBLDocumentChangeNotification; - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLGeometry.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLGeometry.h deleted file mode 100755 index bb616f2..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLGeometry.h +++ /dev/null @@ -1,99 +0,0 @@ -// -// CBLGeometry.h -// CouchbaseLite -// -// Created by Jens Alfke on 9/22/13. -// Copyright (c) 2013 Couchbase, Inc. All rights reserved. -// - -#import - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** A 2D geometric point. */ -typedef struct CBLGeoPoint { - double x, y; -} CBLGeoPoint; - -/** A 2D geometric rectangle. - Note that unlike CGRect and NSRect, this stores max coords, not size. - A rectangle with max coords equal to the min is equivalent to a point. - It is illegal for the max coords to be less than the min. */ -typedef struct CBLGeoRect { - CBLGeoPoint min, max; -} CBLGeoRect; - - -#ifdef __cplusplus -extern "C" { -#endif - - -/** Compares two rectangles for equality. */ -static inline BOOL CBLGeoRectEqual(CBLGeoRect a, CBLGeoRect b) { - return a.min.x == b.min.x && a.min.y == b.min.y && a.max.x == b.max.x && a.max.y == b.max.y; -} - -/** Returns YES if a rectangle is empty, i.e. equivalent to a single point. */ -static inline BOOL CBLGeoRectIsEmpty(CBLGeoRect r) { - return r.min.x == r.max.x && r.min.y == r.max.y; -} - - -/** Converts a string of four comma-separated numbers ("x0,y0,x1,y1") to a rectangle. */ -BOOL CBLGeoCoordsStringToRect(NSString* coordsStr, CBLGeoRect* outRect); - - -#pragma mark - CONVERTING TO/FROM JSON: - -/** Converts a point to GeoJSON format. - For details see http://geojson.org/geojson-spec.html#point */ -NSDictionary* CBLGeoPointToJSON(CBLGeoPoint pt); - -/** Converts a rectangle to GeoJSON format (as a polygon.) - For details see http://geojson.org/geojson-spec.html#polygon */ -NSDictionary* CBLGeoRectToJSON(CBLGeoRect rect); - -/** Computes the bounding box of a GeoJSON object. - Currently only implemented for points and polygons. */ -BOOL CBLGeoJSONBoundingBox(NSDictionary* geoJSON, CBLGeoRect* outBBox); - - -/** Converts a point to a JSON-compatible array of two coordinates. */ -NSArray* CBLGeoPointToCoordPair(CBLGeoPoint pt); - -/** Converts a JSON array of two coordinates [x,y] back into a point. */ -BOOL CBLGeoCoordPairToPoint(NSArray* coords, CBLGeoPoint* outPoint); - -/** Converts a JSON array of four coordinates [x0, y0, x1, y1] to a rectangle. */ -BOOL CBLGeoCoordsToRect(NSArray* coords, CBLGeoRect* outRect); - -#pragma mark - KEYS FOR MAP FUNCTIONS: - -/** Returns a special value that, when emitted as a key, is indexed as a geometric point. - Used inside a map block, like so: `emit(CBLPointKey(3.0, 4.0), value);` */ -id CBLGeoPointKey(double x, double y); - -/** Returns a special value that, when emitted as a key, is indexed as a geometric rectangle. */ -id CBLGeoRectKey(double x0, double y0, double x1, double y1); - -/** Returns a special value that, when emitted as a key, is indexed as a GeoJSON - shape. Currently only its bounding box is stored. - Only points and polygons are supported; other shapes return nil. */ -id CBLGeoJSONKey(NSDictionary* geoJSON); - - -#ifdef __cplusplus -} -#endif - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLJSON.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLJSON.h deleted file mode 100755 index 7b54a85..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLJSON.h +++ /dev/null @@ -1,114 +0,0 @@ -// -// CBLJSON.h -// CouchbaseLite -// -// Created by Jens Alfke on 2/27/12. -// Copyright (c) 2012-2013 Couchbase, Inc. All rights reserved. -// - -#import - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** Identical to the corresponding NSJSON option flags. */ -enum { - CBLJSONReadingMutableContainers = (1UL << 0), - CBLJSONReadingMutableLeaves = (1UL << 1), - CBLJSONReadingAllowFragments = (1UL << 2) -}; -typedef NSUInteger CBLJSONReadingOptions; - -/** Identical to the corresponding NSJSON option flags, with one addition. */ -enum { - CBLJSONWritingPrettyPrinted = (1UL << 0), - - CBLJSONWritingAllowFragments = (1UL << 23) /**< Allows input to be an NSString or NSValue. */ -}; -typedef NSUInteger CBLJSONWritingOptions; - - -/** Useful extensions for JSON serialization/parsing. */ -@interface CBLJSON : NSJSONSerialization - -/** Same as -dataWithJSONObject... but returns an NSString. */ -+ (nullable NSString*) stringWithJSONObject:(id)obj - options:(CBLJSONWritingOptions)opt - error:(NSError**)error; - -/** Given valid JSON data representing a dictionary, inserts the contents of the given NSDictionary into it and returns the resulting JSON data. - This does not parse or regenerate the JSON, so it's quite fast. - But it will generate invalid JSON if the input JSON begins or ends with whitespace, or if the dictionary contains any keys that are already in the original JSON. */ -+ (NSData*) appendDictionary: (NSDictionary*)dict - toJSONDictionaryData: (NSData*)json; - -/** Same as above but inserts a pre-encoded JSON dictionary instead of an NSDictionary. */ -+ (NSData*) appendJSONDictionaryData: (NSData*)extraJson - toJSONDictionaryData: (NSData*)json; - -/** Encodes an NSDate as a string in ISO-8601 format. */ -+ (NSString*) JSONObjectWithDate: (NSDate*)date; -+ (NSString*) JSONObjectWithDate: (NSDate*)date timeZone:(NSTimeZone *)tz; - -/** Parses an ISO-8601 formatted date string to an NSDate object. - If the object is not a string, or not valid ISO-8601, it returns nil. */ -+ (nullable NSDate*) dateWithJSONObject: (id)jsonObject; - -/** Parses an ISO-8601 formatted date string to an absolute time (timeSinceReferenceDate). - If the object is not a string, or not valid ISO-8601, it returns a NAN value. */ -+ (CFAbsoluteTime) absoluteTimeWithJSONObject: (id)jsonObject; - -/** Follows a JSON-Pointer, returning the value pointed to, or nil if nothing. - See spec at: http://tools.ietf.org/html/draft-ietf-appsawg-json-pointer-04 */ -+ (nullable id) valueAtPointer: (NSString*)pointer inObject: (id)object; - -/** Encodes an NSData as a string in Base64 format. */ -+ (NSString*) base64StringWithData: (NSData*)data; - -/** Parses a Base64-encoded string into an NSData object. - If the object is not a string, or not valid Base64, it returns nil. */ -+ (nullable NSData*) dataWithBase64String: (id)jsonObject; - -/** Estimates the amount of memory used by the object and those it references. */ -+ (size_t) estimateMemorySize: (id)object; - -@end - - -/** Wrapper for an NSArray of JSON data, that avoids having to parse the data if it's not used. - NSData objects in the array will be parsed into native objects before being returned to the caller from -objectAtIndex. */ -@interface CBLLazyArrayOfJSON : NSArray - -/** Initialize a lazy array. - @param array An NSArray of NSData objects, each containing JSON. */ -- (instancetype) initWithMutableArray: (NSMutableArray*)array; -@end - - -typedef void (^CBLOnMutateBlock)(); - -/** Protocol for classes whose instances can encode themselves as JSON. - Such classes can be used directly as property types in CBLModel subclasses. */ -@protocol CBLJSONEncoding -- (instancetype) initWithJSON: (id)jsonObject; -- (id) encodeAsJSON; - -@optional -/** If an implementation has mutable persistent state, it should implement this method. - The implementation should save a copy of the block in an instance variable, and call the block - whenever the instance's state has changed such that -encodeAsJSON will now return a different - result. - This allows the object's owner (typically a CBLModel) to detect such changes and mark itself - as needing to be saved. */ -- (void) setOnMutate: (CBLOnMutateBlock)onMutate; -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLManager.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLManager.h deleted file mode 100755 index be57a84..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLManager.h +++ /dev/null @@ -1,167 +0,0 @@ -// -// CBLManager.h -// CouchbaseLite -// -// Created by Jens Alfke on 6/19/12. -// Copyright (c) 2012-2013 Couchbase, Inc. All rights reserved. -// - -#import -@class CBLDatabase; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - -/** Option flags for CBLManager initialization. */ -typedef struct CBLManagerOptions { - bool readOnly; /**< No modifications to databases are allowed. */ - NSDataWritingOptions fileProtection; /**< File protection/encryption options (iOS only) */ -} CBLManagerOptions; - - -/** Top-level CouchbaseLite object; manages a collection of databases as a CouchDB server does. - A CBLManager and all the objects descending from it may only be used on a single - thread. To work with databases on another thread, copy the database manager (by calling - -copy) and use the copy on the other thread. */ -@interface CBLManager : NSObject - -/** A shared per-process instance. This should only be used on the main thread. */ -+ (instancetype) sharedInstance; - -/** Returns YES if the given name is a valid database name. - (Only the characters in "abcdefghijklmnopqrstuvwxyz0123456789_$()+-/" are allowed.) */ -+ (BOOL) isValidDatabaseName: (NSString*)name; - -/** The default directory to use for a CBLManager. This is in the Application Support directory. */ -+ (NSString*) defaultDirectory; - -/** Default initializer. Stores databases in the default directory. */ -- (instancetype) init; - -/** Initializes a CouchbaseLite manager that stores its data at the given path. - @param directory Path to data directory. If it doesn't already exist it will be created. - @param options If non-NULL, a pointer to options (read-only and no-replicator). - @param outError On return, the error if any. */ -- (instancetype) initWithDirectory: (NSString*)directory - options: (const CBLManagerOptions* __nullable)options - error: (NSError**)outError; - -/** Creates a copy of this CBLManager, which can be used on a different thread. */ -- (instancetype) copy; - -/** Releases all resources used by the CBLManager instance and closes all its databases. */ -- (void) close; - -/** The root directory of this manager (as specified at initialization time.) */ -@property (readonly) NSString* directory; - -/** Should the databases and attachments be excluded from iCloud or Time Machine backup? - Defaults to NO. */ -@property BOOL excludedFromBackup; - -#pragma mark - DATABASES: - -/** Returns the database with the given name, creating it if it didn't already exist. - Multiple calls with the same name will return the same CBLDatabase instance. - NOTE: Database names may not contain capital letters! */ -- (nullable CBLDatabase*) databaseNamed: (NSString*)name - error: (NSError**)outError; - -/** Returns the database with the given name, or nil if it doesn't exist. - Multiple calls with the same name will return the same CBLDatabase instance. */ -- (nullable CBLDatabase*) existingDatabaseNamed: (NSString*)name - error: (NSError**)outError; - -/** Returns YES if a database with the given name exists. Does not open the database. */ -- (BOOL) databaseExistsNamed: (NSString*)name; - -/** Registers an encryption key for a database. This must be called before opening an encrypted - database, or before creating a database that's to be encrypted. - If the key is incorrect (or no key is given for an encrypted database), the subsequent call - to open the database will fail with an error with code 401. - To use this API, the database storage engine must support encryption. In the case of SQLite, - this means the application must be linked with SQLCipher instead of - regular SQLite. Otherwise opening the database will fail with an error. */ -- (BOOL) registerEncryptionKey: (nullable id)encryptionKey - forDatabaseNamed: (NSString*)name; - -/** Same as -existingDatabaseNamed:. Enables "[]" access in Xcode 4.4+ */ -- (nullable CBLDatabase*) objectForKeyedSubscript: (NSString*)key; - -/** An array of the names of all existing databases. */ -@property (readonly) NSArray* allDatabaseNames; - -/** Replaces or installs a database from a file. - This is primarily used to install a canned database on first launch of an app, in which case you should first check .exists to avoid replacing the database if it exists already. The canned database would have been copied into your app bundle at build time. - @param databaseName The name of the database to replace. - @param databasePath Path of the database file that should replace it. - @param attachmentsPath Path of the associated attachments directory, or nil if there are no attachments. - @param outError If an error occurs, it will be stored into this parameter on return. - @return YES if the database was copied, NO if an error occurred. */ -- (BOOL) replaceDatabaseNamed: (NSString*)databaseName - withDatabaseFile: (NSString*)databasePath - withAttachments: (NSString*)attachmentsPath - error: (NSError**)outError __attribute__((nonnull(1,2))); - -#pragma mark - CONCURRENCY: - -/** The dispatch queue used to serialize access to the database manager (and its child objects.) - Setting this is optional: by default the objects are bound to the thread on which the database - manager was instantiated. By setting a dispatch queue, you can call the objects from within that - queue no matter what the underlying thread is, and notifications will be posted on that queue - as well. */ -@property (strong, nullable) dispatch_queue_t dispatchQueue; - -/** Runs the block asynchronously on the database manager's dispatch queue or thread. - Unlike the rest of the API, this can be called from any thread, and provides a limited form - of multithreaded access to Couchbase Lite. */ -- (void) doAsync: (void (^)())block; - -/** Asynchronously dispatches a block to run on a background thread. The block will be given a - CBLDatabase instance to use; it must use that database instead of any CBL objects that are - in use on the surrounding code's thread. Otherwise thread-safety will be violated, and - Really Bad Things that are intermittent and hard to debug can happen. - (Note: Unlike most of the API, this method is thread-safe.) */ -- (void) backgroundTellDatabaseNamed: (NSString*)dbName to: (void (^)(CBLDatabase*))block; - -#pragma mark - OTHER API: - -/** The base URL of the database manager's REST API. You can access this URL within this process, - using NSURLConnection or other APIs that use that (such as XMLHTTPRequest inside a WebView), - but it isn't available outside the process. - This method is only available if you've linked with the CouchbaseLiteListener framework. */ -@property (readonly) NSURL* internalURL; - -/** Enables Couchbase Lite logging of the given type, process-wide. A partial list of types is here: - http://docs.couchbase.com/couchbase-lite/cbl-ios/#useful-logging-channels - It's usually more convenient to enable logging via command-line args, as discussed on that - same page; but in some environments you may not have access to the args, or may want to use - other criteria to enable logging. */ -+ (void) enableLogging: (NSString*)type; - -/** Redirects Couchbase Lite logging: instead of writing to the console/stderr, it will call the - given block. Passing a nil block restores the default behavior. */ -+ (void) redirectLogging: (nullable void (^)(NSString* type, NSString* message))callback; - - -@property (readonly, nonatomic, nullable) NSMutableDictionary* customHTTPHeaders; - -@end - - -/** Returns the version of Couchbase Lite */ -extern NSString* CBLVersion( void ); - -/** NSError domain used for HTTP status codes returned by a lot of Couchbase Lite APIs -- - for example code 404 is "not found", 403 is "forbidden", etc. */ -extern NSString* const CBLHTTPErrorDomain; - - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLModel.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLModel.h deleted file mode 100755 index 139ce6a..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLModel.h +++ /dev/null @@ -1,250 +0,0 @@ -// -// CBLModel.h -// CouchbaseLite -// -// Created by Jens Alfke on 8/26/11. -// Copyright (c) 2011-2013 Couchbase, Inc. All rights reserved. -// - -#import "MYDynamicObject.h" -#import "CBLDocument.h" - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - -@class CBLAttachment, CBLDatabase; - - -NS_REQUIRES_PROPERTY_DEFINITIONS // Don't let compiler auto-synthesize properties in subclasses -/** Generic model class for CouchbaseLite documents. - There's a 1::1 mapping between these and CBLDocuments; call +modelForDocument: to get (or create) a model object for a document, and .document to get the document of a model. - You should subclass this and declare properties in the subclass's @@interface. As with NSManagedObject, you don't need to implement their accessor methods or declare instance variables; simply note them as '@@dynamic' in the class @@implementation. The property value will automatically be fetched from or stored to the document, using the same name. - Supported scalar types are bool, char, short, int, double. These map to JSON numbers, except 'bool' which maps to JSON 'true' and 'false'. (Use bool instead of BOOL.) - Supported object types are NSString, NSNumber, NSData, NSDate, NSArray, NSDictionary, NSDecimalNumber. (NSData and NSDate are not native JSON; they will be automatically converted to/from strings in base64 and ISO date formats, respectively. NSDecimalNumber is not native JSON as well; it will be converted to/from string.) - Additionally, a property's type can be a pointer to a CBLModel subclass. This provides references between model objects. The raw property value in the document must be a string whose value is interpreted as a document ID. - NSArray-valued properties may be restricted to a specific item class. See the documentation of +itemClassForArrayProperty: for details. */ -@interface CBLModel : MYDynamicObject - -/** Returns the CBLModel associated with a CBLDocument, or creates & assigns one if necessary. - If the CBLDocument already has an associated model, it's returned. Otherwise a new one is instantiated. - If you call this on CBLModel itself, it'll delegate to the CBLModelFactory to decide what class to instantiate; this lets you map different classes to different "type" property values, for instance. - If you call this method on a CBLModel subclass, it will always instantiate an instance of that class; e.g. [MyWidgetModel modelForDocument: doc] always creates a MyWidgetModel. */ -+ (instancetype) modelForDocument: (CBLDocument*)document; - -/** Returns a new "untitled" CBLModel with a new unsaved document. - The document won't be written to the database until -save is called. */ -+ (instancetype) modelForNewDocumentInDatabase: (CBLDatabase*)database; - -/** The document this item is associated with. Will be nil if it's new and unsaved. */ -@property (readonly, strong, nullable) CBLDocument* document; - -/** The database the item's document belongs to. - Setting this property will assign the item to a database, creating a document. - Setting it to nil will delete its document from its database. */ -@property (retain, nullable) CBLDatabase* database; - -/** Is this model new, never before saved? */ -@property (readonly) bool isNew; - -#pragma mark - SAVING: - -/** Writes any changes to a new revision of the document. - Returns YES without doing anything, if no changes have been made. */ -- (BOOL) save: (NSError**)outError; - -/** Should changes be saved back to the database automatically? - Defaults to NO, requiring you to call -save manually. */ -@property (nonatomic) bool autosaves; - -/** How long to wait after the first change before auto-saving, if autosaves is true. - Default value is 0.0; subclasses can override this to add a delay. */ -@property (readonly) NSTimeInterval autosaveDelay; - -/** Does this model have unsaved changes? */ -@property (readonly) bool needsSave; - -/** The document's current properties (including unsaved changes) in externalized JSON format. - This is what will be written to the CBLDocument when the model is saved. */ -- (NSDictionary*) propertiesToSave; - -/** Removes any changes made to properties and attachments since the last save. */ -- (void) revertChanges; - -/** Deletes the document from the database. - You can still use the model object afterwards, but it will refer to the deleted revision. */ -- (BOOL) deleteDocument: (NSError**)outError; - -/** The time interval since the document was last changed externally (e.g. by a "pull" replication. - This value can be used to highlight recently-changed objects in the UI. */ -@property (readonly) NSTimeInterval timeSinceExternallyChanged; - -/** Bulk-saves changes to multiple model objects (which must all be in the same database). - The saves are performed in one transaction, for efficiency. - Any unchanged models in the array are ignored. - See also: -[CBLDatabase saveAllModels:]. - @param models An array of CBLModel objects, which must all be in the same database. - @param outError On return, the error (if the call failed.) - @return A RESTOperation that saves all changes, or nil if none of the models need saving. */ -+ (BOOL) saveModels: (NSArray*)models - error: (NSError**)outError; - -/** Resets the timeSinceExternallyChanged property to zero. */ -- (void) markExternallyChanged; - -#pragma mark - PROPERTIES & ATTACHMENTS: - -/** Gets a property by name. - You can use this for document properties that you haven't added @@property declarations for. */ -- (nullable id) getValueOfProperty: (NSString*)property; - -/** Sets a property by name. - You can use this for document properties that you haven't added @@property declarations for. */ -- (BOOL) setValue: (nullable id)value - ofProperty: (NSString*)property; - - -/** Follows an _inverse_ relationship: returns the other models in the database that have a - property named `inverseProperty` that points to this object. For example, if model class - ListItem has a property 'list' that's a relation to a List model, then calling this method - on a List instance, with relation 'list', will return all the ListItems that refer to this List. - - Specifically, what this does is run a CBLQuery that finds documents whose `relation` - property value is equal to the document ID of the receiver. (And if `fromClass` is given, - it's restricted to documents whose `type` property is one of the ones mapped to `fromClass` - in the CBLModelFactory.) - @param relation The property name to look at - @param fromClass (Optional) The CBLModel subclass to restrict the search to. - @return An array of model objects found, or nil on error. */ -- (NSArray*) findInverseOfRelation: (NSString*)relation - fromClass: (nullable Class)fromClass; - - -/** The names of all attachments (array of strings). - This reflects unsaved changes made by creating or deleting attachments. */ -@property (readonly, nullable) NSArray* attachmentNames; - -/** Looks up the attachment with the given name (without fetching its contents). */ -- (nullable CBLAttachment*) attachmentNamed: (NSString*)name; - -/** Creates, updates or deletes an attachment. - The attachment data will be written to the database when the model is saved. - @param name The attachment name. By convention, this looks like a filename. - @param mimeType The MIME type of the content. - @param content The body of the attachment. If this is nil, any existing attachment with this - name will be deleted. */ -- (void) setAttachmentNamed: (NSString*)name - withContentType: (NSString*)mimeType - content: (NSData*)content; - -/** Creates, updates or deletes an attachment whose body comes from a file. - (The method takes a URL, but it must be a "file:" URL. Remote resources are not supported.) - The file need only be readable. It won't be moved or altered in any way. - The attachment data will be copied from the file into the database when the model is saved. - The file needs to be preserved until then, but afterwards it can safely be deleted. - @param name The attachment name. By convention, this looks like a filename. - @param mimeType The MIME type of the content. - @param fileURL The URL of a local file whose contents should be copied into the attachment. - If this is nil, any existing attachment with this name will be deleted.*/ -- (void) setAttachmentNamed: (NSString*)name - withContentType: (NSString*)mimeType - contentURL: (NSURL*)fileURL; - -/** Deletes (in memory) any existing attachment with the given name. - The attachment will be deleted from the database at the same time as property changes are saved. */ -- (void) removeAttachmentNamed: (NSString*)name; - - -#pragma mark - PROTECTED (FOR SUBCLASSES TO OVERRIDE) - - -/* Called when the model's initializer is called when the model object is created. You should override this if you need to initialize - any ivars or perform custom initialization when the model object is created. - */ -- (void)awakeFromInitializer; - -/** The document ID to use when creating a new document. - Default is nil, which means to assign no ID (the server will assign one). */ -- (NSString*) idForNewDocumentInDatabase: (CBLDatabase*)db __attribute__((nonnull)); - -/** Called when the model's properties are reloaded from the document. - This happens both when initialized from a document, and after an external change. */ -- (void) didLoadFromDocument; - -/** Returns the database in which to look up the document ID of a model-valued property. - Defaults to the same database as the receiver's document. You should override this if a document property contains the ID of a document in a different database. */ -- (CBLDatabase*) databaseForModelProperty: (NSString*)propertyName __attribute__((nonnull)); - -/** Marks the model as having unsaved content, ensuring that it will get saved after a short interval (if .autosaves is YES) or when -save or -[CBLDatabase saveAllModels] are called. - You don't normally need to call this, since property setters call it for you. One case where you'd need to call it is if you want to manage mutable state in your own properties and not store the changes into dynamic properties until it's time to save. In that case you should also override -propertiesToSave and update the dynamic properties accordingly before chaining to the superclass method. */ -- (void) markNeedsSave; - -/** Called while saving a document, before building the new revision's dictionary. - This method can modify property values if it wants to. */ -- (void) willSave: (nullable NSSet*)changedPropertyNames; - -/** If you want properties to be saved in the document when it's deleted (in addition to the required "_deleted":true) override this method to return those properties. - This is called by -deleteDocument:. The default implementation returns {"_deleted":true}. */ -- (NSDictionary*) propertiesToSaveForDeletion; - -/** General method for declaring the class of items in a property of type NSArray*. - Given the property name, the override should return a class that all items must inherit from, - or nil if the property is untyped. Supported classes are CBLModel (or any subclass), - NSData, NSDate, NSDecimalNumber, and any JSON-compatible class (NSNumber, NSString, etc.) - If you don't recognize the property name you should call the superclass method. - - The default implementation of this method checks for the existence of a class method with - selector of the form +propertyItemClass where 'property' is replaced by the actual property - name. If such a method exists it is called, and must return a class. - - In general you'll find it easier to implement the '+propertyItemClass' method(s) rather - than overriding this one. */ -+ (nullable Class) itemClassForArrayProperty: (NSString*)property; - -/** General method for declaring the that an array-of-models-valued property is a computed inverse - of a relation from another class. - Given the property name, the override should return the name of the relation property in the - item class (the one returned by +itemClassForArrayProperty:). If it returns nil, then this - property will be interpreted as an explicit JSON property whose value is an array of strings - corresponding to the other models. - - The default implementation of this method checks for the existence of a class method with - selector of the form +propertyInverseRelation where 'property' is replaced by the actual - property name. If such a method exists it is called, and must return a string. - - In general you'll find it easier to implement the '+propertyInverseRelation' method(s) rather - than overriding this one. */ -+ (nullable NSString*) inverseRelationForArrayProperty: (NSString*)property; - -/** The type of document. This is optional, but is commonly used in document databases - to distinguish different types of documents. CBLModelFactory can use this property to - determine what CBLModel subclass to instantiate for a document. */ -@property (copy, nonatomic, nullable) NSString* type; - -@end - - - -/** CBLDatabase methods for use with CBLModel. */ -@interface CBLDatabase (CBLModel) - -/** All CBLModels associated with this database whose needsSave is true. */ -@property (readonly) NSArray* unsavedModels; - -/** Saves changes to all CBLModels associated with this database whose needsSave is true. */ -- (BOOL) saveAllModels: (NSError**)outError; - -/** Immediately runs any pending autosaves for all CBLModels associated with this database. - (On iOS, this will automatically be called when the application is about to quit or go into the - background. On Mac OS it is NOT called automatically.) */ -- (BOOL) autosaveAllModels: (NSError**)outError; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLModelFactory.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLModelFactory.h deleted file mode 100755 index 77e051f..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLModelFactory.h +++ /dev/null @@ -1,72 +0,0 @@ -// -// CBLModelFactory.h -// CouchbaseLite -// -// Created by Jens Alfke on 11/22/11. -// Copyright (c) 2011-2013 Couchbase, Inc. All rights reserved. -// - -#import "CBLDatabase.h" -@class CBLDocument; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** A configurable mapping from CBLDocument to CBLModel. - It associates a model class with a value of the document's "type" property. */ -@interface CBLModelFactory : NSObject - -/** Returns a global shared CBLModelFactory that's consulted by all databases. - Mappings registered in this instance will be used as a fallback by all other instances if they don't have their own. */ -+ (instancetype) sharedInstance; - -/** Given a document, attempts to return a CBLModel for it. - If the document's modelObject property is set, it returns that value. - If the document's "type" property has been registered, instantiates the associated class. - Otherwise returns nil. */ -- (id) modelForDocument: (CBLDocument*)document; - -/** Associates a value of the "type" property with a CBLModel subclass. - When a document with this type value is loaded as a model, the given subclass will be - instantiated (unless you explicitly instantiate a different CBLModel subclass.) - As a bonus, when a model of this class is created with a new document, the document's "type" - property will be set to the associated value. - @param classOrName Either a CBLModel subclass, or its class name as an NSString. - @param type The value value of a document's "type" property that should indicate this class. */ -- (void) registerClass: (id)classOrName - forDocumentType: (NSString*)type; - -/** Returns the appropriate CBLModel subclass for this document. - The default implementation just passes the document's "type" property value to -classForDocumentType:, but subclasses could override this to use different properties (or even the document ID) to decide. */ -- (nullable Class) classForDocument: (CBLDocument*)document; - -/** Looks up the CBLModel subclass that's been registered for a document type. */ -- (Class) classForDocumentType: (NSString*)type; - -/** Looks up the document type for which the given class has been registered. - If it's unregistered, or registered with multiple types, returns nil. */ -- (nullable NSString*) documentTypeForClass: (Class)modelClass; - -/** Looks up the document types for which the given class has been registered. */ -- (NSArray*) documentTypesForClass: (Class)modelClass; - -@end - - -@interface CBLDatabase (CBLModelFactory) - -/** The CBLModel factory object to be used by this database. - Every database has its own instance by default, but you can set this property to use a different one -- either to use a custom subclass, or to share a factory among multiple databases, or both. */ -@property (retain, nullable) CBLModelFactory* modelFactory; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLQuery+FullTextSearch.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLQuery+FullTextSearch.h deleted file mode 100755 index 3b6e0e9..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLQuery+FullTextSearch.h +++ /dev/null @@ -1,90 +0,0 @@ -// -// CBLQuery+FullTextSearch.h -// CouchbaseLite -// -// Created by Jens Alfke on 9/21/13. -// Copyright (c) 2013 Couchbase, Inc. All rights reserved. -// - -#import "CBLQuery.h" - - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - -/** CBLQuery interface for full-text searches. - To use this, the view's map function must have emitted full-text strings as keys - using the CBLTextKey() function. */ -@interface CBLQuery (FullTextSearch) - -/** Query string for a full-text search; works only if the view's map function has triggered full- - text indexing by emitting strings wrapped by CBLTextKey(). - The query rows produced by this search will be instances of CBLFullTextQueryRow. - - The query string will be broken up into words. "Noise" words like "the" and "hello" (also - called "stop-words") are ignored. - - The result will include a row corresponding to every emitted CBLTextKey() that contains _any_ - of the words in the query. Word matching tries to account for (English) grammatical variations - like plurals and verb tenses, so for example "cat" will match "cats" and "type" will match - "typing". - - **NOTE:** Full-text views have no keys, so the key-related query properties will be ignored. - They also can't be reduced or grouped, so those properties are ignored too. */ -@property (copy, nullable) NSString* fullTextQuery; - -/** If set to YES, the query will collect snippets of the text surrounding each match, available - via the CBLFullTextQueryRow's -snippetWithWordStart:wordEnd: method. - (NOTE: ForestDB currently does not support snippets.) */ -@property BOOL fullTextSnippets; - -/** If YES (the default) the full-text query result rows will be sorted by (approximate) relevance. - If set to NO, the rows will be returned in the order the documents were added to the database, - i.e. essentially unordered; this is somewhat faster, so it can be useful if you don't care - about the ordering of the rows. - (NOTE: ForestDB currently does not support ranking.) */ -@property BOOL fullTextRanking; - -@end - - - -/** A result row from a full-text query. - A CBLQuery with its .fullTextQuery property set will produce CBLFullTextQueryRows. */ -@interface CBLFullTextQueryRow : CBLQueryRow - -/** The text emitted when the view was indexed (the argument to CBLTextKey()) which contains the - match(es). */ -@property (readonly, nullable) NSString* fullText; - -/** Returns a short substring of the full text containing at least some of the matched words. - This is useful to display in search results, and is faster than fetching the .fullText. - NOTE: The "fullTextSnippets" property of the CBLQuery must be set to YES to enable this; - otherwise the result will be nil. - @param wordStart A delimiter that will be inserted before every instance of a match. - @param wordEnd A delimiter that will be inserted after every instance of a match. */ -- (NSString*) snippetWithWordStart: (NSString*)wordStart - wordEnd: (NSString*)wordEnd; - -/** The number of query words that were found in the fullText. - (If a query word appears more than once, only the first instance is counted.) */ -@property (readonly) NSUInteger matchCount; - -/** The character range in the fullText of a particular match. */ -- (NSRange) textRangeOfMatch: (NSUInteger)matchNumber; - -/** The index of the search term matched by a particular match. Search terms are the individual - words in the full-text search expression, skipping duplicates and noise/stop-words. They're - numbered from zero. */ -- (NSUInteger) termIndexOfMatch: (NSUInteger)matchNumber; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLQuery+Geo.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLQuery+Geo.h deleted file mode 100755 index 6ebdc00..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLQuery+Geo.h +++ /dev/null @@ -1,57 +0,0 @@ -// -// CBLQuery+Geo.h -// CouchbaseLite -// -// Created by Jens Alfke on 9/23/13. -// Copyright (c) 2013 Couchbase, Inc. All rights reserved. -// - -#import "CBLQuery.h" -#import "CBLGeometry.h" - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** CBLQuery interface for geo-queries. - To use this, the view's map function must have emitted geometries (points, rects, etc.) - as keys using the functions CBLGeoPointKey(), CBLGeoRectKey(), or CBLGeoJSONKey(). */ -@interface CBLQuery (Geo) - -/** The geometric bounding box to search. Setting this property causes the query to - search geometries rather than keys. */ -@property CBLGeoRect boundingBox; - -@end - - -/** A result row from a CouchbaseLite geo-query. - A CBLQuery with its .boundingBox property set will produce CBLGeoQueryRows. */ -@interface CBLGeoQueryRow : CBLQueryRow - -/** The row's geo bounding box in native form. - If the emitted geo object was a point, the boundingBox's min and max will be equal. - Note: The coordinates may have slight round-off error, because SQLite internally stores bounding - boxes as 32-bit floats, but the coordinates are always rounded outwards -- making the bounding - box slightly larger -- to avoid false negatives in searches. */ -@property (readonly, nonatomic) CBLGeoRect boundingBox; - -/** The GeoJSON object emitted as the key of the emit() call by the map function. - The format is a parsed GeoJSON point or polygon; see http://geojson.org/geojson-spec */ -@property (readonly, nullable) NSDictionary* geometry; - -/** The GeoJSON object type of the row's geometry. - Usually @"Point" or @"Rectangle", but may be another type if the emitted key was GeoJSON. - (The "Rectangle" type is not standard GeoJSON.) */ -@property (readonly, nonatomic, nullable) NSString* geometryType; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLQuery.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLQuery.h deleted file mode 100755 index 3744f41..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLQuery.h +++ /dev/null @@ -1,296 +0,0 @@ -// -// CBLQuery.h -// CouchbaseLite -// -// Created by Jens Alfke on 6/18/12. -// Copyright (c) 2012-2013 Couchbase, Inc. All rights reserved. -// - -#import - -@class CBLDatabase, CBLDocument; -@class CBLLiveQuery, CBLQueryEnumerator, CBLQueryRow; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -typedef NS_ENUM(unsigned, CBLAllDocsMode) { - kCBLAllDocs, /**< Normal behavior for all-docs query */ - kCBLIncludeDeleted, /**< Will include rows for deleted documents */ - kCBLShowConflicts, /**< Rows will indicate conflicting revisions */ - kCBLOnlyConflicts, /**< Will _only_ return rows for docs in conflict */ - kCBLBySequence /**< Order by sequence number (i.e. chronologically) */ -}; - - -/** Query options to allow out-of-date results to be returned in return for faster queries. */ -typedef NS_ENUM(unsigned, CBLIndexUpdateMode) { - kCBLUpdateIndexBefore, /**< Always update index if needed before querying (default) */ - kCBLUpdateIndexNever, /**< Don't update the index; results may be out of date */ - kCBLUpdateIndexAfter /**< Update index _after_ querying (results may still be out of date) */ -}; - - -/** Represents a query of a CouchbaseLite 'view', or of a view-like resource like _all_documents. */ -@interface CBLQuery : NSObject - -/** The database that contains this view. */ -@property (readonly) CBLDatabase* database; - -/** The maximum number of rows to return. Defaults to 'unlimited' (UINT_MAX). */ -@property NSUInteger limit; - -/** The number of initial rows to skip. Default value is 0. - Should only be used with small values. For efficient paging, use startKey and limit.*/ -@property NSUInteger skip; - -/** Should the rows be returned in descending key order? Default value is NO. */ -@property BOOL descending; - -/** If non-nil, the key value to start at. */ -@property (copy, nullable) id startKey; - -/** If non-nil, the key value to end after. */ -@property (copy, nullable) id endKey; - -/** If non-nil, the document ID to start at. - (Useful if the view contains multiple identical keys, making .startKey ambiguous.) */ -@property (copy, nullable) NSString* startKeyDocID; - -/** If non-nil, the document ID to end at. - (Useful if the view contains multiple identical keys, making .endKey ambiguous.) */ -@property (copy, nullable) NSString* endKeyDocID; - -/** If YES (the default) the startKey (or startKeyDocID) comparison uses ">=". Else it uses ">". */ -@property BOOL inclusiveStart; - -/** If YES (the default) the endKey (or endKeyDocID) comparison uses "<=". Else it uses "<". */ -@property BOOL inclusiveEnd; - -/** If nonzero, enables prefix matching of string or array keys. - * A value of 1 treats the endKey itself as a prefix: if it's a string, keys in the index that - come after the endKey, but begin with the same prefix, will be matched. (For example, if the - endKey is "foo" then the key "foolish" in the index will be matched, but not "fong".) Or if - the endKey is an array, any array beginning with those elements will be matched. (For - example, if the endKey is [1], then [1, "x"] will match, but not [2].) If the key is any - other type, there is no effect. - * A value of 2 assumes the endKey is an array and treats its final item as a prefix, using the - rules above. (For example, an endKey of [1, "x"] will match [1, "xtc"] but not [1, "y"].) - * A value of 3 assumes the key is an array of arrays, etc. - Note that if the .descending property is also set, the search order is reversed and the above - discussion applies to the startKey, _not_ the endKey. */ -@property NSUInteger prefixMatchLevel; - -/** An optional array of NSSortDescriptor objects; overrides the default by-key ordering. - Key-paths are interpreted relative to a CBLQueryRow object, so they should start with - "value" to refer to the value, or "key" to refer to the key. - A limited form of array indexing is supported, so you can refer to "key[1]" or "value[0]" if - the key or value are arrays. This only works with indexes from 0 to 3. */ -@property (copy, nullable) NSArray* sortDescriptors; - -/** An optional predicate that filters the resulting query rows. - If present, it's called on every row returned from the query, and if it returns NO - the row is skipped. - Key-paths are interpreted relative to a CBLQueryRow, so they should start with - "value" to refer to the value, or "key" to refer to the key. */ -@property (strong, nullable) NSPredicate* postFilter; - -/** Determines whether or when the view index is updated. By default, the index will be updated - if necessary before the query runs -- this guarantees up-to-date results but can cause a - delay. The "Never" mode skips updating the index, so it's faster but can return out of date - results. The "After" mode is a compromise that may return out of date results but if so will - start asynchronously updating the index after the query so future results are accurate. */ -@property CBLIndexUpdateMode indexUpdateMode; - -/** If non-nil, the query will fetch only the rows with the given keys. */ -@property (copy, nullable) NSArray* keys; - -/** If set to YES, disables use of the reduce function. - (Equivalent to setting "?reduce=false" in the REST API.) */ -@property BOOL mapOnly; - -/** If non-zero, enables grouping of results, in views that have reduce functions. */ -@property NSUInteger groupLevel; - -/** If set to YES, the results will include the entire document contents of the associated rows. - These can be accessed via CBLQueryRow's -documentProperties property. - This slows down the query, but can be a good optimization if you know you'll need the entire - contents of each document. */ -@property BOOL prefetch; - -/** Changes the behavior of a query created by -queryAllDocuments. - * In mode kCBLAllDocs (the default), the query simply returns all non-deleted documents. - * In mode kCBLIncludeDeleted, it also returns deleted documents. - * In mode kCBLShowConflicts, the .conflictingRevisions property of each row will return the - conflicting revisions, if any, of that document. - * In mode kCBLOnlyConflicts, _only_ documents in conflict will be returned. - (This mode is especially useful for use with a CBLLiveQuery, so you can be notified of - conflicts as they happen, i.e. when they're pulled in by a replication.) */ -@property CBLAllDocsMode allDocsMode; - -/** Sends the query to the server and returns an enumerator over the result rows (Synchronous). - Note: In a CBLLiveQuery you should access the .rows property instead. */ -- (nullable CBLQueryEnumerator*) run: (NSError**)outError; - -/** Starts an asynchronous query. Returns immediately, then calls the onComplete block when the - query completes, passing it the row enumerator (or an error). */ -- (void) runAsync: (void (^)(CBLQueryEnumerator*, NSError*))onComplete __attribute__((nonnull)); - -/** Returns a live query with the same parameters. */ -- (CBLLiveQuery*) asLiveQuery; - -@end - - -/** A CBLQuery subclass that automatically refreshes the result rows every time the database - changes. All you need to do is use KVO to observe changes to the .rows property. */ -@interface CBLLiveQuery : CBLQuery - -/** The shortest interval at which the query will update, regardless of how often the - database changes. Defaults to 0.5 sec. Increase this if the query is expensive and - the database updates frequently, to limit CPU consumption. */ -@property (nonatomic) NSTimeInterval updateInterval; - -/** Starts observing database changes. The .rows property will now update automatically. (You - usually don't need to call this yourself, since accessing or observing the .rows property will - call -start for you.) */ -- (void) start; - -/** Stops observing database changes. Calling -start or .rows will restart it. */ -- (void) stop; - -/** The current query results; this updates as the database changes, and can be observed using KVO. - Its value will be nil until the initial asynchronous query finishes. */ -@property (readonly, strong, nullable) CBLQueryEnumerator* rows; - -/** Blocks until the intial asynchronous query finishes. - After this call either .rows or .lastError will be non-nil. */ -- (BOOL) waitForRows; - -/** If non-nil, the error of the last execution of the query. - If nil, the last execution of the query was successful. */ -@property (readonly, nullable) NSError* lastError; - -/** Call this method to notify that the query parameters have been changed, the CBLLiveQuery object - should re-run the query. */ -- (void) queryOptionsChanged; - -@end - - -/** Enumerator on a CBLQuery's result rows. - The objects returned are instances of CBLQueryRow. */ -@interface CBLQueryEnumerator : NSEnumerator - -/** The number of rows returned in this enumerator */ -@property (readonly) NSUInteger count; - -/** The database's current sequenceNumber at the time the view was generated. */ -@property (readonly) UInt64 sequenceNumber; - -/** YES if the database has changed since the view was generated. */ -@property (readonly) BOOL stale; - -/** The next result row. This is the same as -nextObject but with a checked return type. */ -- (nullable CBLQueryRow*) nextRow; - -/** Random access to a row in the result */ -- (CBLQueryRow*) rowAtIndex: (NSUInteger)index; - -/** Resets the enumeration so the next call to -nextObject or -nextRow will return the first row. */ -- (void) reset; - -/** Re-sorts the rows based on the given sort descriptors. - This operation requires that all rows be loaded into memory, so you can't have previously - called -nextObject, -nextRow or for...in on this enumerator. (But it's fine to use them - _after_ calling this method.) - You can call this method multiple times with different sort descriptors, but the effects - on any in-progress enumeration are undefined. - The items in the array can be NSSortDescriptors or simply NSStrings. An NSString will be - treated as an NSSortDescriptor with the string as the keyPath; prefix with a "-" for descending - sort. - Key-paths are interpreted relative to a CBLQueryRow, so they should start with - "value" to refer to the value, or "key" to refer to the key. - A limited form of array indexing is supported, so you can refer to "key[1]" or "value[0]" if - the key or value are arrays. This only works with indexes from 0 to 3. */ -- (void) sortUsingDescriptors: (NSArray*)sortDescriptors; - -@end - - -/** A result row from a CouchbaseLite view query. - Full-text and geo queries return subclasses -- see CBLFullTextQueryRow and CBLGeoQueryRow. */ -@interface CBLQueryRow : NSObject - -/** The row's key: this is the first parameter passed to the emit() call that generated the row. */ -@property (readonly) id key; - -/** The row's value: this is the second parameter passed to the emit() call that generated the - row. */ -@property (readonly, nullable) id value; - -/** The ID of the document described by this view row. - This is not necessarily the same as the document that caused this row to be emitted; see the - discussion of the .sourceDocumentID property for details. */ -@property (readonly, nullable) NSString* documentID; - -/** The ID of the document that caused this view row to be emitted. - This is the value of the "id" property of the JSON view row. - It will be the same as the .documentID property, unless the map function caused a related - document to be linked by adding an "_id" key to the emitted value; in this case .documentID - will refer to the linked document, while sourceDocumentID always refers to the original - document. - In a reduced or grouped query the value will be nil, since the rows don't correspond to - individual documents. */ -@property (readonly, nullable) NSString* sourceDocumentID; - -/** The revision ID of the document this row was mapped from. */ -@property (readonly) NSString* documentRevisionID; - -@property (readonly) CBLDatabase* database; - -/** The document this row was mapped from. - This will be nil if a grouping was enabled in the query, because then the result rows don't - correspond to individual documents. */ -@property (readonly, nullable) CBLDocument* document; - -/** The properties of the document this row was mapped from. - To get this, you must have set the .prefetch property on the query; else this will be nil. - (You can still get the document properties via the .document property, of course. But it - takes a separate call to the database. So if you're doing it for every row, using - .prefetch and .documentProperties is faster.) */ -@property (readonly, nullable) NSDictionary* documentProperties; - -/** If this row's key is an array, returns the item at that index in the array. - If the key is not an array, index=0 will return the key itself. - If the index is out of range, returns nil. */ -- (nullable id) keyAtIndex: (NSUInteger)index; - -/** Convenience for use in keypaths. Returns the key at the given index. */ -//@property (readonly, nullable) id key0, key1, key2, key3; -@property (readonly, nullable) id key0; -@property (readonly, nullable) id key1; -@property (readonly, nullable) id key2; -@property (readonly, nullable) id key3; - -/** The database sequence number of the associated doc/revision. */ -@property (readonly) UInt64 sequenceNumber; - -/** Returns all conflicting revisions of the document, as an array of CBLRevision, or nil if the - document is not in conflict. - The first object in the array will be the default "winning" revision that shadows the others. - This is only valid in an allDocuments query whose allDocsMode is set to kCBLShowConflicts - or kCBLOnlyConflicts; otherwise it returns nil. */ -@property (readonly, nullable) NSArray* conflictingRevisions; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLQueryBuilder.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLQueryBuilder.h deleted file mode 100755 index e85af2d..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLQueryBuilder.h +++ /dev/null @@ -1,97 +0,0 @@ -// -// CBLQueryBuilder.h -// CouchbaseLite -// -// Created by Jens Alfke on 8/4/14. -// Copyright (c) 2014-2015 Couchbase, Inc. All rights reserved. -// - -#import -@class CBLDatabase, CBLView, CBLQuery, CBLQueryEnumerator; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** A higher-level interface to views and queries that feels more like a traditional query language - or like Core Data's NSFetchRequest. - - A CBLQueryBuilder is a template for creating families of queries. You should create an instance - for a generalized query, leaving "$"-prefixed placeholder variables in your "where" predicate - for any values that won't be known until the query needs to run. Then at query time, you give - the builder values for the variables and it creates a query. - - (Note: CBLQueryBuilder is not cross-platform since its API is based on the Cocoa Foundation - classes NSPredicate, NSExpression and NSSortDescriptor. Other implementations of Couchbase Lite - will have equivalent functionality based on their platforms' APIs and idioms.) -*/ -@interface CBLQueryBuilder : NSObject - -/** Initializes a CBLQueryBuilder. - @param database The database to index and query. - @param valueTemplate The result values you want, expressed either as keypath strings or - NSExpressions; in either case they're evaluated relative to the - document being indexed. - @param predicateStr A predicate template string that specifies the condition(s) that a - document's properties must match. Often includes "$"-prefixed variables that will - be filled in at query time, like key ranges. - (See Apple's predicate syntax documentation: http://goo.gl/8ty3xG ) - @param sortDescriptors The sort order you want the results in. Items in the array can be - NSSortDescriptors or NSStrings. A string will be interpreted as a sort descriptor - with that keyPath; prefix it with "-" to indicate descending order. - If the order of query rows is unimportant, pass nil. - @param outError If the builder doesn't know how to handle the input, this will be filled in - with an NSError describing the problem. - @return The initialized CBLQueryBuilder, or nil on error. */ -- (instancetype) initWithDatabase: (nullable CBLDatabase*)database - select: (nullable NSArray*)valueTemplate - where: (NSString*)predicateStr - orderBy: (nullable NSArray*)sortDescriptors - error: (NSError**)outError; - -/** Initializes a CBLQueryBuilder. - This is an alternate initializer that takes an NSPredicate instead of a predicate template - string; see the main initializer for details. */ -- (instancetype) initWithDatabase: (nullable CBLDatabase*)database - select: (nullable NSArray*)valueTemplate - wherePredicate: (NSPredicate*)predicate - orderBy: (nullable NSArray*)sortDescriptors - error: (NSError**)outError; - -/** Initializes a CBLQueryBuilder, using an explicitly chosen view. - See the main initializer for details. */ -- (instancetype) initWithView: (CBLView*)view - select: (NSArray*)valueTemplate - wherePredicate: (NSPredicate*)predicate - orderBy: (nullable NSArray*)sortDescriptors - error: (NSError**)outError; - -/** The view the query builder is using. */ -@property (readonly, nonatomic) CBLView* view; - -/** A human-readable string that explains in pseudocode what the query builder is doing. - It shows what the map function does, and what the query's properties will be set to. - This is intended for troubleshooting and debugging purposes only. */ -@property (readonly, nonatomic) NSString* explanation; - -/** Creates a query, given a set of values for the variables. - @param context A dictionary mapping variable names to values. The names should not include - the dollar signs used in the predicate string; if a predicate referred to - $FOO, the dictionary key should be @"FOO". - @return The configured query, ready to run. */ -- (CBLQuery*) createQueryWithContext: (nullable NSDictionary*)context; - -/** A convenience method that creates a query and runs it. See -createQueryWithContext:. */ -- (nullable CBLQueryEnumerator*) runQueryWithContext: (nullable NSDictionary*)context - error: (NSError**)outError; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLReplication.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLReplication.h deleted file mode 100755 index 80cf5c6..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLReplication.h +++ /dev/null @@ -1,216 +0,0 @@ -// -// CBLReplication.h -// CouchbaseLite -// -// Created by Jens Alfke on 6/22/12. -// Copyright (c) 2012-2013 Couchbase, Inc. All rights reserved. -// - -#import -@class CBLDatabase; -@protocol CBLAuthenticator; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** Describes the current status of a replication. */ -typedef NS_ENUM(unsigned, CBLReplicationStatus) { - kCBLReplicationStopped, /**< The replication is finished or hit a fatal error. */ - kCBLReplicationOffline, /**< The remote host is currently unreachable. */ - kCBLReplicationIdle, /**< Continuous replication is caught up and waiting for more changes.*/ - kCBLReplicationActive /**< The replication is actively transferring data. */ -} ; - - -/** A 'push' or 'pull' replication between a local and a remote database. - Replications can be one-shot or continuous. */ -@interface CBLReplication : NSObject - -/** The local database being replicated to/from. */ -@property (nonatomic, readonly) CBLDatabase* localDatabase; - -/** The URL of the remote database. */ -@property (nonatomic, readonly) NSURL* remoteURL; - -/** Does the replication pull from (as opposed to push to) the target? */ -@property (nonatomic, readonly) BOOL pull; - - -#pragma mark - OPTIONS: - -/** Should the target database be created if it doesn't already exist? (Defaults to NO). */ -@property (nonatomic) BOOL createTarget; - -/** Should the replication operate continuously? (Defaults to NO). - A continuous replication keeps running (with 'idle' status) after updating the target database. - It monitors the source database and copies new revisions as soon as they're available. - Continuous replications keep running until the app quits or they're stopped. */ -@property (nonatomic) bool continuous; - -/** Name of an optional filter function to run on the source server. - Only documents for which the function returns true are replicated. - * For a pull replication, the name looks like "designdocname/filtername". - * For a push replication, use the name under which you registered the filter with the CBLDatabase. */ -@property (nonatomic, copy, nullable) NSString* filter; - -/** Parameters to pass to the filter function. - Should map strings to strings. */ -@property (nonatomic, copy, nullable) NSDictionary* filterParams; - -/** List of Sync Gateway channel names to filter by; a nil value means no filtering, i.e. all - available channels will be synced. - Only valid for pull replications whose source database is on a Couchbase Sync Gateway server. - (This is a convenience that just reads or changes the values of .filter and .query_params.) */ -@property (nonatomic, copy, nullable) NSArray* channels; - -/** Sets the documents to specify as part of the replication. */ -@property (copy, nullable) NSArray *documentIDs; - -/** Extra HTTP headers to send in all requests to the remote server. - Should map strings (header names) to strings. */ -@property (nonatomic, copy, nullable) NSDictionary* headers; - -/** Specifies which class of network the replication will operate over. - Default value is nil, which means replicate over all networks. - Set to "WiFi" (or "!Cell") to replicate only over WiFi, - or to "Cell" (or "!WiFi") to replicate only over cellular. */ -@property (nonatomic, copy, nullable) NSString* network; - -/** An optional JSON-compatible dictionary of extra properties for the replicator. */ -@property (nonatomic, copy, nullable) NSDictionary* customProperties; - - -#pragma mark - AUTHENTICATION: - -/** An object that knows how to authenticate with a remote server. - CBLAuthenticator is an opaque protocol; instances can be created by calling the factory methods - of the class of the same name. */ -@property (nonatomic, strong, nullable) id authenticator; - -/** The credential (generally username+password) to use to authenticate to the remote database. - This can either come from the URL itself (if it's of the form "http://user:pass@example.com") - or be stored in the NSURLCredentialStorage, which is a wrapper around the Keychain. */ -@property (nonatomic, strong, nullable) NSURLCredential* credential; - -/** OAuth parameters that the replicator should use when authenticating to the remote database. - Keys in the dictionary should be "consumer_key", "consumer_secret", "token", "token_secret", - and optionally "signature_method". */ -@property (nonatomic, copy, nullable) NSDictionary* OAuth; - -/** The base URL of the remote server, for use as the "origin" parameter when requesting Persona or - Facebook authentication. */ -@property (readonly, nullable) NSURL* personaOrigin; - -/** Adds a cookie to the shared NSHTTPCookieStorage that will be sent to the remote server. This - is useful if you've obtained a session cookie through some external means and need to tell the - replicator to send it for authentication purposes. - This method constructs an NSHTTPCookie from the given parameters, as well as the remote server - URL's host, port and path. - If you already have an NSHTTPCookie object for the remote server, you can simply add it to the - sharedHTTPCookieStorage yourself. - If you have a "Set-Cookie:" response header, you can use NSHTTPCookie's class methods to parse - it to a cookie object, then add it to the sharedHTTPCookieStorage. */ -- (void) setCookieNamed: (NSString*)name - withValue: (NSString*)value - path: (NSString*)path - expirationDate: (NSDate*)expirationDate - secure: (BOOL)secure; - -/** Deletes the named cookie from the shared NSHTTPCookieStorage for the remote server's URL. */ -- (void) deleteCookieNamed: (NSString *)name; - -/** Adds additional SSL root certificates to be trusted by the replicator, or entirely overrides the - OS's default list of trusted root certs. - @param certs An array of SecCertificateRefs of root certs that should be trusted. Most often - these will be self-signed certs, but they might also be the roots of nonstandard CAs. - @param onlyThese If NO, the given certs are appended to the system's built-in list of trusted - root certs; if YES, it replaces them (so *only* the given certs will be trusted.) */ -+ (void) setAnchorCerts: (nullable NSArray*)certs onlyThese: (BOOL)onlyThese; - -/** The server's SSL certificate. This will be NULL until the first HTTPS response is received - from the server. */ -@property (readonly, nullable) SecCertificateRef serverCertificate; - -#pragma mark - STATUS: - -/** Starts the replication, asynchronously. - Has no effect if the replication is already running. - You can monitor its progress by observing the kCBLReplicationChangeNotification it sends, - or by using KVO to observe its .running, .status, .error, .total and .completed properties. */ -- (void) start; - -/** Stops replication, asynchronously. - Has no effect if the replication is not running. */ -- (void) stop; - -/** Restarts a running replication. - Has no effect if the replication is not running. */ -- (void) restart; - -/** Suspends/resumes a replication. - On iOS a replication will suspend itself when the app goes into the background, and resume - when the app is re-activated. If your app receives a push notification while suspended and needs - to run the replication to download new data, your handler should set suspended to NO to resume - replication, and then set the property back to YES when it's done. */ -@property BOOL suspended; - -/** The replication's current state, one of {stopped, offline, idle, active}. */ -@property (nonatomic, readonly) CBLReplicationStatus status; - -/** YES while the replication is running, NO if it's stopped. - Note that a continuous replication never actually stops; it only goes idle waiting for new - data to appear. */ -@property (nonatomic, readonly) BOOL running; - -/** The error status of the replication, or nil if there have not been any errors since it started. */ -@property (nonatomic, readonly, strong, nullable) NSError* lastError; - -/** The number of completed changes processed, if the task is active, else 0 (observable). */ -@property (nonatomic, readonly) unsigned completedChangesCount; - -/** The total number of changes to be processed, if the task is active, else 0 (observable). */ -@property (nonatomic, readonly) unsigned changesCount; - - -/** The IDs of documents that have local changes that have not yet been pushed to the server - by this replication. This only considers documents that this replication would push: documents - that aren't matched by its filter or documentIDs (if any) are ignored. - If the replication hasn't started yet, or if it's encountered an error, or if it's not a push - replication at all, the value of this property is nil. */ -@property (readonly, nullable) NSSet* pendingDocumentIDs; - -/** Returns YES if a document has local changes that this replication will push to its server, but - hasn't yet. This only considers documents that this replication would push: it returns NO for - a document that isn't matched by its filter or documentIDs, even if that document has local - changes. */ -- (BOOL) isDocumentPending: (CBLDocument*)doc; - - -#ifdef CBL_DEPRECATED -@property (nonatomic, copy) NSString* facebookEmailAddress - __attribute__((deprecated("set authenticator property instead"))); -- (BOOL) registerFacebookToken: (NSString*)token forEmailAddress: (NSString*)email - __attribute__((deprecated("set authenticator property instead"))); -- (BOOL) registerPersonaAssertion: (NSString*)assertion - __attribute__((deprecated("set authenticator property instead"))); -@property (nonatomic, copy) NSString* personaEmailAddress - __attribute__((deprecated("set authenticator property instead"))); -#endif - -@end - - -/** This notification is posted by a CBLReplication when any of these properties change: - {status, running, error, completed, total}. It's often more convenient to observe this - notification rather than observing each property individually. */ -extern NSString* const kCBLReplicationChangeNotification; - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLRevision.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLRevision.h deleted file mode 100755 index 6d9b6e6..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLRevision.h +++ /dev/null @@ -1,158 +0,0 @@ -// -// CBLRevision.h -// CouchbaseLite -// -// Created by Jens Alfke on 6/17/12. -// Copyright (c) 2012-2013 Couchbase, Inc. All rights reserved. -// - -#import -@class CBLDocument, CBLDatabase, CBLAttachment, CBLSavedRevision, CBLUnsavedRevision; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** A revision of a CBLDocument. - This is the abstract base class of CBLSavedRevision (existing revisions) and CBLNewRevision - (revisions yet to be saved). */ -@interface CBLRevision : NSObject - -/** The document this is a revision of. */ -@property (readonly, weak) CBLDocument* document; - -/** The database this revision's document belongs to. */ -@property (readonly) CBLDatabase* database; - -/** Does this revision mark the deletion of its document? - (In other words, does it have a "_deleted" property?) */ -@property (readonly) BOOL isDeletion; - -/** Does this revision mark the deletion or removal (from available channels) of its document ? - (In other words, does it have a "_deleted_ or "_removed" property?) */ -@property (readonly) BOOL isGone; - -/** The ID of this revision. Will be nil if this is an unsaved CBLNewRevision. */ -@property (readonly, nullable) NSString* revisionID; - -/** The revision this one is a child of. */ -@property (readonly, nullable) CBLSavedRevision* parentRevision; - -/** The ID of the parentRevision. */ -@property (readonly, nullable) NSString* parentRevisionID; - -/** Returns the ancestry of this revision as an array of CBLRevisions, in chronological order. - Older revisions are NOT guaranteed to have their properties available. */ -- (NSArray*) getRevisionHistory: (NSError**)outError; - -/** The revision's contents as parsed from JSON. - Keys beginning with "_" are defined and reserved by CouchbaseLite; others are app-specific. - The first call to this method may need to fetch the properties from disk, but subsequent calls - are very cheap. */ -@property (readonly, nullable) NSDictionary* properties; - -/** The user-defined properties, without the ones reserved by CouchbaseLite. - This is based on -properties, with every key whose name starts with "_" removed. */ -@property (readonly, copy, nullable) NSDictionary* userProperties; - -/** Shorthand for [self.properties objectForKey: key]. */ -- (nullable id) propertyForKey: (NSString*)key; - -/** Same as -propertyForKey:. Enables "[]" access in Xcode 4.4+ */ -- (nullable id) objectForKeyedSubscript: (NSString*)key; - -#pragma mark ATTACHMENTS - -/** The names of all attachments (an array of strings). */ -@property (readonly, nullable) NSArray* attachmentNames; - -/** Looks up the attachment with the given name (without fetching its contents yet). */ -- (nullable CBLAttachment*) attachmentNamed: (NSString*)name; - -/** All attachments, as CBLAttachment objects. */ -@property (readonly, nullable) NSArray* attachments; - -@end - - - -/** An existing revision of a CBLDocument. Most of its API is inherited from CBLRevisionBase. */ -@interface CBLSavedRevision : CBLRevision - -/** Are this revision's properties available? They may not be if the revision is an ancestor and - either the database has been compacted, or the revision was replicated from another db. */ -@property (readonly) BOOL propertiesAvailable; - -/** Creates a new mutable child revision whose properties and attachments are initially identical - to this one's, which you can modify and then save. */ -- (CBLUnsavedRevision*) createRevision; - -/** Creates and saves a new revision with the given properties. - This will fail with a 412 error if the receiver is not the current revision of the document. */ -- (nullable CBLSavedRevision*) createRevisionWithProperties: (nullable NSDictionary*)properties - error: (NSError**)outError; - -/** Deletes the document by creating a new deletion-marker revision. */ -- (nullable CBLSavedRevision*) deleteDocument: (NSError**)outError; - -@end - - - -/** An unsaved new revision. Most of its API is inherited from CBLRevisionBase. */ -@interface CBLUnsavedRevision : CBLRevision - -// These properties are overridden to be settable: -@property (readwrite) BOOL isDeletion; -@property (readwrite, copy, nullable) NSMutableDictionary* properties; -@property (readwrite, copy, nullable) NSDictionary* userProperties; -- (void) setObject: (nullable id)object forKeyedSubscript: (NSString*)key; - -/** Saves the new revision to the database. - This will fail with a 412 error if its parent (the revision it was created from) is not the current revision of the document. - Afterwards you should use the returned CBLSavedRevision instead of this object. - @return A new CBLSavedRevision representing the saved form of the revision. */ -- (nullable CBLSavedRevision*) save: (NSError**)outError; - -/** A special variant of -save: that always adds the revision, even if its parent is not the - current revision of the document. - This can be used to resolve conflicts, or to create them. If you're not certain that's what you - want to do, you should use the regular -save: method instead. */ -- (nullable CBLSavedRevision*) saveAllowingConflict: (NSError**)outError; - -/** Creates, updates or deletes an attachment. - The attachment data will be written to the database when the revision is saved. - @param name The attachment name. By convention, this looks like a filename. - @param mimeType The MIME type of the content. - @param content The body of the attachment, or nil to remove the attachment. */ -- (void) setAttachmentNamed: (NSString*)name - withContentType: (nullable NSString*)mimeType - content: (nullable NSData*)content; - -/** Creates, updates or deletes an attachment whose body comes from a file. - (The method takes a URL, but it must be a "file:" URL. Remote resources are not supported.) - The file need only be readable. It won't be moved or altered in any way. - The attachment data will be copied from the file into the database when the revision is saved. - The file needs to be preserved until then, but afterwards it can safely be deleted. - @param name The attachment name. By convention, this looks like a filename. - @param mimeType The MIME type of the content. - @param fileURL The URL of a local file whose contents should be copied into the attachment. */ -- (void) setAttachmentNamed: (NSString*)name - withContentType: (nullable NSString*)mimeType - contentURL: (nullable NSURL*)fileURL; - -/** Removes the attachment with the given name. - When this revision is saved, it won't include the attachment. However, the attachment will - still be present in the parent revision, until the database is next compacted. */ -- (void) removeAttachmentNamed: (NSString*)name; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLUITableSource.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLUITableSource.h deleted file mode 100755 index b090b27..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLUITableSource.h +++ /dev/null @@ -1,123 +0,0 @@ -// -// CBLUITableSource.h -// CouchbaseLite -// -// Created by Jens Alfke on 8/2/11. -// Copyright 2011-2013 Couchbase, Inc. All rights reserved. -// - -#import -@class CBLDocument, CBLLiveQuery, CBLQueryRow; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#endif - - -/** A UITableView data source driven by a CBLLiveQuery. - It populates the table rows from the query rows, and automatically updates the table as the - query results change when the database is updated. - A CBLUITableSource can be created in a nib. If so, its tableView outlet should be wired up to - the UITableView it manages, and the table view's dataSource outlet should be wired to it. */ -@interface CBLUITableSource : NSObject = 60000) - , UIDataSourceModelAssociation -#endif - > -/** The table view to manage. */ -@property (nonatomic, retain) IBOutlet UITableView* tableView; - -/** The query whose rows will be displayed in the table. */ -@property (retain) CBLLiveQuery* query; - -/** Rebuilds the table from the query's current .rows property. */ --(void) reloadFromQuery; - - -#pragma mark Row Accessors: - -/** The current array of CBLQueryRows being used as the data source for the table. */ -@property (nonatomic, readonly, nullable) NSArray* rows; - -/** Convenience accessor to get the row object for a given table row index. */ -- (nullable CBLQueryRow*) rowAtIndex: (NSUInteger)index; - -/** Convenience accessor to find the index path of the row with a given document. */ -- (nullable NSIndexPath*) indexPathForDocument: (CBLDocument*)document; - -/** Convenience accessor to return the query row at a given index path. */ -- (nullable CBLQueryRow*) rowAtIndexPath: (NSIndexPath*)path; - -/** Convenience accessor to return the document at a given index path. */ -- (nullable CBLDocument*) documentAtIndexPath: (NSIndexPath*)path; - - -#pragma mark Displaying The Table: - -/** If non-nil, specifies the property name of the query row's value that will be used for the table row's visible label. - If the row's value is not a dictionary, or if the property doesn't exist, the property will next be looked up in the document's properties. - If this doesn't meet your needs for labeling rows, you should implement -couchTableSource:willUseCell:forRow: in the table's delegate. */ -@property (copy, nullable) NSString* labelProperty; - - -#pragma mark Editing The Table: - -/** Is the user allowed to delete rows by UI gestures? (Defaults to YES.) */ -@property (nonatomic) BOOL deletionAllowed; - -/** Deletes the documents at the given row indexes, animating the removal from the table. */ -- (BOOL) deleteDocumentsAtIndexes: (NSArray*)indexPaths - error: (NSError**)outError; - -/** Asynchronously deletes the given documents, animating the removal from the table. */ -- (BOOL) deleteDocuments: (NSArray*)documents - error: (NSError**)outError; - -@end - - -/** Additional methods for the table view's delegate, that will be invoked by the CBLUITableSource. */ -@protocol CBLUITableDelegate -@optional - -/** Allows delegate to return its own custom cell, just like -tableView:cellForRowAtIndexPath:. - If this returns nil the table source will create its own cell, as if this method were not implemented. */ -- (UITableViewCell *)couchTableSource:(CBLUITableSource*)source - cellForRowAtIndexPath:(NSIndexPath *)indexPath; - -/** Called after the query's results change, before the table view is reloaded. */ -- (void)couchTableSource:(CBLUITableSource*)source - willUpdateFromQuery:(CBLLiveQuery*)query; - -/** Called after the query's results change to update the table view. If this method is not implemented by the delegate, reloadData is called on the table view.*/ -- (void)couchTableSource:(CBLUITableSource*)source - updateFromQuery:(CBLLiveQuery*)query - previousRows:(NSArray *)previousRows; - -/** Called from -tableView:cellForRowAtIndexPath: just before it returns, giving the delegate a chance to customize the new cell. */ -- (void)couchTableSource:(CBLUITableSource*)source - willUseCell:(UITableViewCell*)cell - forRow:(CBLQueryRow*)row; - -/** Called when the user wants to delete a row. - If the delegate implements this method, it will be called *instead of* the - default behavior of deleting the associated document. - @param source The CBLUITableSource - @param row The query row corresponding to the row to delete - @return True if the row was deleted, false if not. */ -- (bool)couchTableSource:(CBLUITableSource*)source - deleteRow:(CBLQueryRow*)row; - -/** Called upon failure of a document deletion triggered by the user deleting a row. */ -- (void)couchTableSource:(CBLUITableSource*)source - deleteFailed:(NSError*)error; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CBLView.h b/platforms/ios/CouchbaseLite.framework/Headers/CBLView.h deleted file mode 100755 index 5aff434..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CBLView.h +++ /dev/null @@ -1,131 +0,0 @@ -// -// CBLView.h -// CouchbaseLite -// -// Created by Jens Alfke on 6/19/12. -// Copyright (c) 2012-2013 Couchbase, Inc. All rights reserved. -// - -#import -@class CBLDatabase, CBLQuery; - -#if __has_feature(nullability) // Xcode 6.3+ -#pragma clang assume_nonnull begin -#else -#define nullable -#define __nullable -#define __nonnull -#endif - - -typedef enum { - kCBLMapReduceIndex = 1, /**< Regular map/reduce index with JSON keys. */ - kCBLFullTextIndex, /**< Keys must be strings and will be indexed by the words they contain. */ - kCBLGeoIndex /**< Geo-query index; not supported yet. */ -} CBLViewIndexType; - - -typedef void (^CBLMapEmitBlock)(id key, __nullable id value); - - -/** A "map" function called when a document is to be added to a view. - @param doc The contents of the document being analyzed. - @param emit A block to be called to add a key/value pair to the view. Your block can call it zero, one or multiple times. */ -typedef void (^CBLMapBlock)(NSDictionary* doc, CBLMapEmitBlock emit); - -/** A "reduce" function called to summarize the results of a view. - @param keys An array of keys to be reduced (or nil if this is a rereduce). - @param values A parallel array of values to be reduced, corresponding 1::1 with the keys. - @param rereduce YES if the input values are the results of previous reductions. - @return The reduced value; almost always a scalar or small fixed-size object. */ -typedef __nonnull id (^CBLReduceBlock)(NSArray* __nonnull keys, - NSArray* __nonnull values, - BOOL rereduce); - - -#define MAPBLOCK(BLOCK) ^(NSDictionary* doc, void (^emit)(id key, id value)){BLOCK} -#define REDUCEBLOCK(BLOCK) ^id(NSArray* keys, NSArray* values, BOOL rereduce){BLOCK} - - -/** Returns a special value that, when emitted as a key, causes the given text to be indexed with - the full-text indexer. Used inside a map block, like so: `emit(CBLTextKey(longText), value);` */ -FOUNDATION_EXTERN id CBLTextKey(NSString* text); - -/** An external object that knows how to map source code of some sort into executable functions. */ -@protocol CBLViewCompiler -- (nullable CBLMapBlock) compileMapFunction: (NSString*)mapSource language: (NSString*)language; -- (nullable CBLReduceBlock) compileReduceFunction: (NSString*)reduceSource - language: (NSString*)language; -@end - - -/** A "view" in a CouchbaseLite database -- essentially a persistent index managed by map/reduce. - The view can be queried using a CBLQuery. */ -@interface CBLView : NSObject - -/** The database that owns this view. */ -@property (readonly) CBLDatabase* database; - -/** The name of the view. */ -@property (readonly) NSString* name; - -/** The map function that controls how index rows are created from documents. */ -@property (readonly, nullable) CBLMapBlock mapBlock; - -/** The optional reduce function, which aggregates together multiple rows. */ -@property (readonly, nullable) CBLReduceBlock reduceBlock; - -/** Defines a view's functions. - The view's definition is given as an Objective-C block (or NULL to delete the view). The body of the block should call the 'emit' block (passed in as a paramter) for every key/value pair it wants to write to the view. - Since the function itself is obviously not stored in the database (only a unique string identifying it), you must re-define the view on every launch of the app! If the database needs to rebuild the view but the function hasn't been defined yet, it will fail and the view will be empty, causing weird problems later on. - It is very important that this block be a law-abiding map function! As in other languages, it must be a "pure" function, with no side effects, that always emits the same values given the same input document. That means that it should not access or change any external state; be careful, since blocks make that so easy that you might do it inadvertently! - The block may be called on any thread, or on multiple threads simultaneously. This won't be a problem if the code is "pure" as described above, since it will as a consequence also be thread-safe. - @param mapBlock The map function. The MAPBLOCK macro makes it easier to declare this. - @param reduceBlock The reduce function, or nil for none. The REDUCEBLOCK macro makes it easier to declare this. - @param version An arbitrary string that will be stored persistently along with the index. Usually a string literal like @"1". If you subsequently change the functionality of the map or reduce function, change this string as well: the call will detect that it's different and will clear the index so it can be rebuilt by the new function. - @return YES if the view was updated and the index cleared; NO if the version stayed the same. */ -- (BOOL) setMapBlock: (CBLMapBlock)mapBlock - reduceBlock: (nullable CBLReduceBlock)reduceBlock - version: (NSString*)version; - -/** Defines a view that has no reduce function. - See -setMapBlock:reduceBlock:version: for more details. */ -- (BOOL) setMapBlock: (CBLMapBlock)mapBlock - version: (NSString*)version; - -/** If this property is set, only documents whose "type" property is equal to its value will be - passed to the map block and indexed. This can speed up indexing. - Just like the map block, this property is not persistent; it needs to be set at runtime before - the view is queried. And if its value changes, the view's version also needs to change. */ -@property (copy) NSString* documentType; - -/** Is the view's index currently out of date? */ -@property (readonly) BOOL stale; - -/** The last sequence number indexed so far. */ -@property (readonly) SInt64 lastSequenceIndexed; - -/** Deletes the view's persistent index. It will be regenerated on the next query. */ -- (void) deleteIndex; - -/** Deletes the view, persistently. */ -- (void) deleteView; - -/** Creates a new query object for this view. The query can be customized and then executed. */ -- (CBLQuery*) createQuery; - -/** Utility function to use in reduce blocks. Totals an array of NSNumbers. */ -+ (NSNumber*) totalValues: (NSArray*)values; - -/** Registers an object that can compile map/reduce functions from source code. */ -+ (void) setCompiler: (nullable id)compiler; - -/** The registered object, if any, that can compile map/reduce functions from source code. */ -+ (nullable id) compiler; - -@end - - -#if __has_feature(nullability) -#pragma clang assume_nonnull end -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/CouchbaseLite.h b/platforms/ios/CouchbaseLite.framework/Headers/CouchbaseLite.h deleted file mode 100755 index efe78a2..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/CouchbaseLite.h +++ /dev/null @@ -1,38 +0,0 @@ -// -// CouchbaseLite.h -// CouchbaseLite -// -// Created by Jens Alfke on 12/2/11. -// Copyright (c) 2011-2013 Couchbase, Inc. All rights reserved. -// -// Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file -// except in compliance with the License. You may obtain a copy of the License at -// http://www.apache.org/licenses/LICENSE-2.0 -// Unless required by applicable law or agreed to in writing, software distributed under the -// License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, -// either express or implied. See the License for the specific language governing permissions -// and limitations under the License. - - -#define CBL_DEPRECATED // Enable deprecated methods. - -#import "CBLManager.h" -#import "CBLDatabase.h" -#import "CBLDatabaseChange.h" -#import "CBLDocument.h" -#import "CBLRevision.h" -#import "CBLAttachment.h" -#import "CBLView.h" -#import "CBLQuery.h" -#import "CBLQuery+FullTextSearch.h" -#import "CBLQuery+Geo.h" -#import "CBLQueryBuilder.h" -#import "CBLAuthenticator.h" -#import "CBLReplication.h" -#import "CBLModel.h" -#import "CBLModelFactory.h" -#import "CBLJSON.h" - -#if TARGET_OS_IPHONE -#import "CBLUITableSource.h" -#endif diff --git a/platforms/ios/CouchbaseLite.framework/Headers/MYDynamicObject.h b/platforms/ios/CouchbaseLite.framework/Headers/MYDynamicObject.h deleted file mode 100755 index 68eb2ea..0000000 --- a/platforms/ios/CouchbaseLite.framework/Headers/MYDynamicObject.h +++ /dev/null @@ -1,73 +0,0 @@ -// -// MYDynamicObject.h -// MYUtilities -// -// Created by Jens Alfke on 8/6/09. -// Copyright 2009 Jens Alfke. All rights reserved. -// - -#import - - -/** A generic class with runtime support for dynamic properties. - You can subclass this and declare properties in the subclass without needing to implement them or make instance variables; simply note them as '@@dynamic' in the @@implementation. - The dynamic accessors will be bridged to calls to -getValueOfProperty: and setValue:ofProperty:, allowing you to easily store property values in an NSDictionary or other container. */ -@interface MYDynamicObject : NSObject - -/** Returns the names of all properties defined in this class and superclasses up to MYDynamicObject. */ -+ (NSSet*) propertyNames; - -/** Returns the value of a named property. - This method will only be called for properties that have been declared in the class's @@interface using @@property. - You must override this method -- the base implementation just raises an exception. */ -- (id) getValueOfProperty: (NSString*)property; - -/** Sets the value of a named property. - This method will only be called for properties that have been declared in the class's @@interface using @@property, and are not declared readonly. - You must override this method -- the base implementation just raises an exception. - @return YES if the property was set, NO if it isn't settable; an exception will be raised. - Default implementation returns NO. */ -- (BOOL) setValue: (id)value ofProperty: (NSString*)property; - - -// FOR SUBCLASSES TO CALL: - -/** Given the name of an object-valued property, returns the class of the property's value. - Returns nil if the property doesn't exist, or if its type isn't an object pointer or is 'id'. */ -+ (Class) classOfProperty: (NSString*)propertyName; - -+ (NSString*) getterKey: (SEL)sel; -+ (NSString*) setterKey: (SEL)sel; - -// ADVANCED STUFF FOR SUBCLASSES TO OVERRIDE: - -+ (IMP) impForGetterOfProperty: (NSString*)property ofClass: (Class)propertyClass; -+ (IMP) impForSetterOfProperty: (NSString*)property ofClass: (Class)propertyClass; -+ (IMP) impForGetterOfProperty: (NSString*)property ofProtocol: (Protocol*)propertyProtocol; -+ (IMP) impForSetterOfProperty: (NSString*)property ofProtocol: (Protocol*)propertyProtocol; -+ (IMP) impForGetterOfProperty: (NSString*)property ofType: (const char*)propertyType; -+ (IMP) impForSetterOfProperty: (NSString*)property ofType: (const char*)propertyType; - -@end - -/** Given an Objective-C class object, a property name, and a BOOL for whether the property should be readwrite, - return YES if a property with the name exists , NO otherwise. - If setter argument is YES but property is declared readonly, also returns NO. - Information about the property is returned by reference: the subclass of cls that declares the property, - and the property string part of the property attributes string. - */ -BOOL MYGetPropertyInfo(Class cls, - NSString *propertyName, - BOOL setter, - Class *declaredInClass, - const char* *propertyType); - - -/** Given an Objective-C property type string, returns the property type as a Class object, - or nil if a class does not apply or no such property is present. - See Property Type String section of the Objective-C Runtime Programming Guide - for more information about the format of the string. */ -Class MYClassFromType(const char* propertyType); - -/** Same as MYClassFromType, except for protocols. */ -Protocol* MYProtocolFromType(const char* propertyType); diff --git a/platforms/ios/CouchbaseLite.framework/Info.plist b/platforms/ios/CouchbaseLite.framework/Info.plist deleted file mode 100755 index e69605d..0000000 Binary files a/platforms/ios/CouchbaseLite.framework/Info.plist and /dev/null differ diff --git a/platforms/ios/CouchbaseLite.framework/Modules/module.modulemap b/platforms/ios/CouchbaseLite.framework/Modules/module.modulemap deleted file mode 100755 index a67e269..0000000 --- a/platforms/ios/CouchbaseLite.framework/Modules/module.modulemap +++ /dev/null @@ -1,12 +0,0 @@ -framework module CouchbaseLite { - umbrella header "CouchbaseLite.h" - - link "libsqlite3.dylib" - link "libz.dylib" - link framework "CFNetwork.framework" - link framework "Security.framework" - link framework "SystemConfiguration.framework" - - export * - module * { export * } -} diff --git a/platforms/ios/PodFile b/platforms/ios/PodFile new file mode 100644 index 0000000..be91c2a --- /dev/null +++ b/platforms/ios/PodFile @@ -0,0 +1,2 @@ +pod 'couchbase-lite-ios', '~> 1.3' +pod 'couchbase-lite-ios/SQLCipher', '1.3.1' diff --git a/platforms/ios/build.xcconfig b/platforms/ios/build.xcconfig index 5fbf1fc..f617157 100755 --- a/platforms/ios/build.xcconfig +++ b/platforms/ios/build.xcconfig @@ -1 +1 @@ -OTHER_LDFLAGS = $(inherited) -lsqlite3 -framework CFNetwork -framework SystemConfiguration +OTHER_LDFLAGS = $(inherited) -framework CFNetwork -framework SystemConfiguration